| Class Specialization CStyle String Allows adaption of strings to C-style strings.
Container
String
CStyle String
String<TValue, CStyle> Parameters
TValue | The value type, that is the type of the items/characters stored in the string. Note: TValue must be a simple type.???(Link) Remarks: Use Value to get the value type for a given class.
Specialization of String Implements Container Metafunctions
DefaultOverflowExplicit | The default overflow strategy for explicit resize. (String)
DefaultOverflowImplicit | The default overflow strategy for implicit resize. (String)
Infix | Infix sequence type. (String)
IsSequence | Determines whether a container stores its elements in sequential order. (String)
Iterator | Type of iterator objects that are used to traverse the container. (String)
Position | Type of an object that represents a position in a container. (String)
Prefix | Prefix sequence type. (String)
SAValue | The default alphabet type of a suffix array, i.e. the type to store a position of a string or string set. (String)
Spec | The spec of a class. (String)
Suffix | Suffix sequence type. (String)
Functions
append | Concatenate two containers. (String)
assign | Assigns one object to another object. (String)
assignValue | Assigns value to item. (Container)
atNil | Tests whether iterator is at nil position. (String)
back | The last item in container. (Container)
begin | The begin of a container. (String)
beginPosition | Begin position of object in host. (String)
canParseString | Test whether an automaton can parse a string completely. (String)
capacity | The maximal length. (String)
clear | Resets an object. (String)
collectLeaves | Returns all leaves underneath a given vertex. (String)
create | Makes an object to owner of its content.
createOracle | Creates a factor oracle. (String)
createOracleOnReverse | Creates a factor oracle for the reversed string. (String)
createSuffixTrie | Creates a trie of all suffixes of a text. (String)
createTrie | Creates a trie. (String)
createTrieOnReverse | Creates a trie for all reversed keywords. (String)
dependent | Test whether object depends on other objects.
determineConsensusSeq | Determines the consensus pattern of a given profile. (String)
empty | Test a container for being empty. (String)
end | The end of a container. (String)
endPosition | End position of object in host. (String)
erase | Erases a part of a container (String)
extendSeed | Extends a seed. (String)
extendSeeds | Extenstion of seeds. (String)
fill | Resizes and fills a container. (String)
front | The first item in container. (Container)
getAlignment | Constructs a alignment from a ChainedSeed. (String)
getDistanceMatrix | Computes a pairwise distance matrix from an alignment graph. (String)
getSuccessor | Gets the successor for a given vertex and an edge label. For an automaton a single character is required whereas for a word graph getSuccessor takes a string. (String)
getValue | Access to the value. (Container)
goDown | Iterates down one edge or a path in a tree. (String)
goNil | Moves iterator to nil position. (String)
heaviestIncreasingSubsequence | Computes the heaviest increasing subsequence. (String)
id | A value that identifies the underlying sequence. (String)
infix | Creates infix object. (String)
infixWithLength | Creates infix object. (String)
iter | Iterator to item at given position. (String)
length | The number of items/characters. (String)
longestCommonSubsequence | Computes the longest common subsequence. (String)
longestIncreasingSubsequence | Computes the longest increasing subsequence. (String)
moveValue | Assigns value to item. (Container)
parseString | Parses a string one character at a time and moves accordingly in the automaton. (String)
position | Position of an iterator. (Container)
prefix | Creates prefix object. (String)
replace | Replaces a part of a container with another container. (String)
resize | Changes the length. (String)
resizeSpace | Makes free space in container (String)
scoreSeed | Calculates the score of a seed. (String)
setHaystack | Sets the haystack of a Finder object. (String)
setNeedle | Sets the needle of a Pattern object and optionally induces preprocessing. (String)
shareResources | Determines whether two sequences share the same resource. (String)
slowNjTree | Computes a guide tree from a distance matrix. (String)
stringSetLimits | Retrieves a string of delimiter positions of a StringSet which is needed for local<->global position conversions. (String)
stringToShape | Takes a shape given as a string of '1' (relevant position) and '0' (irrelevant position) and converts it into a Shape object. (String)
suffix | Creates suffix object. (String)
toCString | Access sequence as c-style string. (String)
topological_sort | Performs a topological sort on a directed acyclic graph (DAG). (String)
upgmaTree | Computes a guide tree from a distance matrix. (String)
value | Reference to the value. (String)
Remarks The purpose of this class is to access to the content of a sequence in a "zero terminated string" style. This can be useful if SEQAN classes has to be integrated in programs that use char arrays to store strings. Instances of String<TValue, CStyle> can implicitely converted to a TValue * that points to a zero terminated CStyle of TValue. The stored c-style string object can be set by constructors or assignment. The content of a c-style string can eighter be stored in a separate buffer, that is the source string is copied. Or the buffer of the source string itself is used instead, in this case the c-style string depends on the source string and gets invalid as soon as the buffer of the source string is destroyed. Hence, this class is a kind of adaptor from an arbitrary SEQAN string to char arrays. Of course, the opposite way is possible too: Read here about adapting char arrays to SEQAN strings. Examples //Create a string str: String<char> str = "this is a test string"; //Create a c-style string object for str: String<char, CStyle> c_style = str; //Now use c_style as char array: strcmp(c_style, "compare it to this string"); If the c-style string is needed only temporarily, the function toCString can be used: String<char> str = "this is a test string"; strcmp(toCString(str), "compare it to this string"); Example Programs ModReverse, ModView, Nested Modifiers See Also create SeqAn - Sequence Analysis Library - www.seqan.de