XStringViews-constructors {Biostrings} | R Documentation |
A set of basic functions for creating or modifying XStringViews objects.
adjacentViews(subject, width, gapwidth=0) XStringViews(x, subjectClass, collapse="")
subject |
An XString object or a single string. |
width |
An integer vector containing the widths of the views. |
gapwidth |
An integer vector containing the widths of the gaps between the views. |
x |
An XString object or a character vector for XStringViews .
An XStringViews object for trim and subviews .
|
subjectClass |
The class to be given to the subject of the XStringViews object
created and returned by the function.
Must be the name of one of the direct XString subtypes i.e.
"BString" , "DNAString" , "RNAString"
or "AAString" .
|
collapse |
An optional character string to be inserted between the views of the XStringViews object created and returned by the function. |
The adjacentViews
function returns an XStringViews object
containing views on subject
with widths given in the width
vector and separated by gaps of width gapwidth
.
The first view starts at position 1.
The XStringViews
constructor will try to create an XStringViews
object from the value passed to its x
argument.
If x
itself is an XStringViews object, the returned
object is obtained by coercing its subject to the class specified by
subjectClass
.
If x
is an XString object, the returned object is made of
a single view that starts at the first letter and ends at the last letter
of x
(in addition x
itself is coerced to the class
specified by subjectClass
when specified).
If x
is a character vector, the returned object has one view
per character string in x
(and its subject is an instance of
the class specified by subjectClass
).
These functions return an XStringViews object y
.
length(y)
(the number of views in y
)
is length(width)
for the adjacentViews
function.
For the XStringViews
constructor, length(y)
is 1
when x
is an XString object and length(x)
otherwise.
XStringViews-class, XString-class
adjacentViews("abcdefghij", 4:2, gapwidth=1) v12 <- Views(DNAString("TAATAATG"), start=-2:9, end=0:11) XStringViews(v12, subjectClass="RNAString") XStringViews(AAString("MARKSLEMSIR*")) XStringViews("abcdefghij", subjectClass="BString")