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 atindex
that islen
characters long on to the end of the current string, - (4)appends first num characters from str on to string
- (5)appends
num
repetitions ofch
on to the end of the current string, - (6)appends the sequence denoted by
start
andend
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.