append [C++ Reference]
Keywords: string,append
Date: 2009-02-08T20:35:28-0800

[[append]]
C++ Reference
Translations of this page?:

- en
- br-pt
- cn
- fr
- it
- jp
- pl
- ru
- tr

## append

Syntax:

        #include <string>
        string& append( const string& str );
        string& append( const char* str );
        string& append( const string& str, size_type index, size_type len );
        string& append( const char* str, size_type num );
        string& append( size_type num, char ch );
        string& append( input_iterator start, input_iterator end );

The append function either:

- (1&2)appends `str` on to the end of the current string,
- (3)appends a substring of `str` starting at `index` that is `len` characters long on to the end of the current string,
- (4)appends first num characters from str on to string
- (5)appends `num` repetitions of `ch` on to the end of the current string,
- (6)appends the sequence denoted by `start` and `end` on to the end of the current string.

For example, the following code uses append to add 10 copies of the '!' character to a string:

         string str = "Hello World";
         str.append( 10, '!' );
         cout << str << endl;

That code displays:

         Hello World!!!!!!!!!!

In the next example, append() is used to concatenate a substring of one string onto another string:

       string str1 = "Eventually I stopped caring... ";
       string str2 = "but that was the '80s so nobody noticed.";

       str1.append( str2, 25, 15 );
       cout << "str1 is " << str1 << endl;

When run, the above code displays:

       str1 is Eventually I stopped caring... nobody noticed.

Edit this page • Old revisions
• • • Login • Index • Recent changes • RSS • cc •