basic_string.html

STL_doc

basic_string(const basic_string& s, 
             size_type pos = 0, size_type n = npos)
</pre>
</TD>
<TD VAlign=top>
 <A href="Container.html">Container</A>, <tt>basic_string</tt>
</TD>
<TD VAlign=top>
Generalization of the copy constructor.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string(const charT*)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Construct a string from a null-terminated character array.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string(const charT* s, size_type n)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Construct a string from a character array and a length.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string(size_type n, charT c)</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Create a string with <tt>n</tt> copies of <tt>c</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template &lt;class InputIterator&gt;
basic_string(InputIterator first, InputIterator last)
</pre>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Create a string from a range.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>~basic_string()</tt>
</TD>
<TD VAlign=top>
 <A href="Container.html">Container</A>
</TD>
<TD VAlign=top>
The destructor.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator=(const basic_string&amp;)</tt>
</TD>
<TD VAlign=top>
 <A href="Container.html">Container</A>
</TD>
<TD VAlign=top>
The assignment operator
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator=(const charT* s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Assign a null-terminated character array to a string.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator=(charT c)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Assign a single character to a string.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>void reserve(size_t)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
See below.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>void swap(basic_string&amp;)</tt>
</TD>
<TD VAlign=top>
 <A href="Container.html">Container</A>
</TD>
<TD VAlign=top>
Swaps the contents of two strings.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
iterator insert(iterator pos,
                const T&amp; x)
</pre>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Inserts <tt>x</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template &lt;class <A href="InputIterator.html">InputIterator</A>&gt;
void insert(iterator pos,
            InputIterator f, InputIterator l)
<A href="#1">[1]</A>
</pre>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Inserts the range <tt>[first, last)</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
void insert(iterator pos, 
            size_type n, const T&amp; x)
</pre>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Inserts <tt>n</tt> copies of <tt>x</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; insert(size_type pos, const basic_string&amp; s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Inserts <tt>s</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
basic_string&amp; insert(size_type pos, 
                     const basic_string&amp; s, 
                     size_type pos1, size_type n)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Inserts a substring of <tt>s</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; insert(size_type pos, const charT* s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Inserts <tt>s</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; insert(size_type pos, const charT* s, size_type n)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Inserts the first n characters of <tt>s</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; insert(size_type pos, size_type n, charT c)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Inserts <tt>n</tt> copies of <tt>c</tt> before <tt>pos</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; append(const basic_string&amp; s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append <tt>s</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
basic_string&amp; append(const basic_string&amp; s, 
                     size_type pos, size_type n)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append a substring of <tt>s</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; append(const charT* s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append <tt>s</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; append(const charT* s, size_type n)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append the first <tt>n</tt> characters of <tt>s</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; append(size_type n, charT c)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append <tt>n</tt> copies of <tt>c</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template &lt;class InputIterator&gt;
basic_string&amp; append(InputIterator first, InputIterator last)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append a range to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>void push_back(charT c)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Append a single character to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator+=(const basic_string&amp; s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Equivalent to <tt>append(s)</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator+=(const charT* s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Equivalent to <tt>append(s)</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; operator+=(charT c)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Equivalent to <tt>push_back(c)</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>iterator erase(iterator p)</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Erases the character at position <tt>p</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>iterator erase(iterator first, iterator last)</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Erases the range <tt>[first, last)</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; erase(size_type pos = 0, size_type n = npos)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Erases a range.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>void clear()</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Erases the entire container.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>void resize(size_type n, charT c = charT())</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Appends characters, or erases characters from the end, as necessary
   to make the string's length exactly <tt>n</tt> characters.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; assign(const basic_string&amp;)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Synonym for <tt>operator=</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre> 
basic_string&amp; assign(const basic_string&amp; s, 
                     size_type pos, size_type n)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Assigns a substring of <tt>s</tt> to <tt>*this</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; assign(const charT* s, size_type n)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Assigns the first <tt>n</tt> characters of <tt>s</tt> to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; assign(const charT* s)</tt>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Assigns a null-terminated array of characters to <tt>*this</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<tt>basic_string&amp; assign(size_type n, charT c)</tt>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Erases the existing characters and replaces them by <tt>n</tt> copies of <tt>c</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
template &lt;class InputIterator&gt;
basic_string&amp; assign(InputIterator first, InputIterator last)
</pre>
</TD>
<TD VAlign=top>
 <A href="Sequence.html">Sequence</A>
</TD>
<TD VAlign=top>
Erases the existing characters and replaces them by <tt>[first, last)</tt>
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
basic_string&amp; replace(size_type pos, size_type n, 
                      const basic_string&amp; s)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Replaces a substring of <tt>*this</tt> with the string <tt>s</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
basic_string&amp; replace(size_type pos, size_type n, 
                      const basic_string&amp; s, 
                      size_type pos1, size_type n1)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Replaces a substring of <tt>*this</tt> with a substring of <tt>s</tt>.
</TD>
</TR>
<TR>
<TD VAlign=top>
<pre>
basic_string&amp; replace(size_type pos, size_type n, 
                      const charT* s, size_type n1)
</pre>
</TD>
<TD VAlign=top>
<tt>basic_string</tt>
</TD>
<TD VAlign=top>
Replaces a substring of <tt>*this</tt> with the first <tt>n1</tt> characters of <tt>s</tt>.
</TD>