append

Sintaxe:

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

A função append:

• (1&2)acrescenta str no fim da string actual,
• (3)acrescenta uma substring de str começada em index e com um comprimento de len caracteres no fim da string actual,
• (4)acrescenta os num primeiros caracteres de str à string
• (5)acrescenta num repetições de ch no fim da string actual,
• (6)acrescenta a sequência denotada por start e end no fim da string actual.

Por exemplo, o código seguinte usa append para adicionar 10 cópias do caracter '!' a uma string:

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

Este código mostra:

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

No exemplo seguinte, append() é usada para concatenar uma substring de uma string noutra 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;

Quando executado, o código acima mostra:

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