basic_string::append

Artigo
06/09/2015

Adiciona caracteres ao final de uma cadeia de caracteres.

basic_string<CharType, Traits, Allocator>& append(
    const value_type* _Ptr
);
basic_string<CharType, Traits, Allocator>& append(
    const value_type* _Ptr,
    size_type _Count
);
basic_string<CharType, Traits, Allocator>& append(
    const basic_string<CharType, Traits, Allocator>& _Str,
    size_type _Off,
    size_type _Count
);
basic_string<CharType, Traits, Allocator>& append(
    const basic_string<CharType, Traits, Allocator>& _Str
);
basic_string<CharType, Traits, Allocator>& append(
    size_type _Count, 
    value_type _Ch
);
template<class InputIterator>
    basic_string<CharType, Traits, Allocator>& append(
        InputIterator _First, 
        InputIterator _Last
    );
basic_string<CharType, Traits, Allocator>& append(
    const_pointer _First,
    const_pointer _Last
);
basic_string<CharType, Traits, Allocator>& append(
    const_iterator _First,
    const_iterator _Last
);

Parâmetros

_Ptr
Para C - cadeia de caracteres a ser acrescentada.
_Str
A cadeia de caracteres cujos caracteres devem ser anexados.
_Off
O índice da parte da cadeia de caracteres de origem que fornece os caracteres a serem acrescentados.
_Count
O número de caracteres a ser adicionado, no máximo, a cadeia de caracteres de origem.
_Ch
O valor de caractere a ser adicionado.
_First
Um iterador de entrada que trata o primeiro elemento no intervalo a ser adicionado.
_Last
Um iterador, um const_pointer, ou um const_iterator de entrada que trata a posição dessa elemento além do mais recente no intervalo ser anexado.

Valor de retorno

Uma referência ao objeto de cadeia de caracteres que está sendo anexado com os caracteres passada por função de membro.

Comentários

Os caracteres podem ser anexados a uma cadeia de caracteres usando operator+= ou funções de membro append ou push_back. operator+= acrescenta valores de um único argumento quando a função de membro de append de vários argumento permitir que uma parte específica de uma cadeia de caracteres especificada é adicionado.

Exemplo

// basic_string_append.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( ) 
{
   using namespace std;

   // The first member function
   // appending a C-string to a string
   string str1a ( "Hello " );
   cout << "The original string str1 is: " << str1a << endl;
   const char *cstr1a = "Out There ";
   cout << "The C-string cstr1a is: " << cstr1a << endl;
   str1a.append ( cstr1a );
   cout << "Appending the C-string cstr1a to string str1 gives: " 
        << str1a << "." << endl << endl;

   // The second member function
   // appending part of a C-string to a string
   string str1b ( "Hello " );
   cout << "The string str1b is: " << str1b << endl;
   const char *cstr1b = "Out There ";
   cout << "The C-string cstr1b is: " << cstr1b << endl;
   str1b.append ( cstr1b , 3 );
   cout << "Appending the 1st part of the C-string cstr1b "
        << "to string str1 gives: " << str1b << "." 
        << endl << endl;

   // The third member function
   // appending part of one string to another
   string str1c ( "Hello " ), str2c ( "Wide World " );
   cout << "The string str2c is: " << str2c << endl;
   str1c.append ( str2c , 5 , 5 );
   cout << "The appended string str1 is: " 
        << str1c << "." << endl << endl;

   // The fourth member function
   // appending one string to another in two ways,
   // comparing append and operator [ ]
   string str1d ( "Hello " ), str2d ( "Wide " ), str3d ( "World " );
   cout << "The  string str2d is: " << str2d << endl;
   str1d.append ( str2d );
   cout << "The appended string str1d is: " 
        << str1d << "." << endl;
   str1d += str3d;
   cout << "The doubly appended strig str1 is: " 
        << str1d << "." << endl << endl;

   // The fifth member function
   // appending characters to a string
   string str1e ( "Hello " );
   str1e.append ( 4 , '!' );
   cout << "The string str1 appended with exclamations is: " 
        << str1e << endl << endl;

   // The sixth member function
   // appending a range of one string to another
   string str1f ( "Hello " ), str2f ( "Wide World " );
   cout << "The string str2f is: " << str2f << endl;
   str1f.append ( str2f.begin ( ) + 5 , str2f.end ( ) - 1 );
   cout << "The appended string str1 is: " 
        << str1f << "." << endl << endl;
}

Requisitos

Cabeçalho: <cadeia de caracteres>

Namespace: std

Consulte também

Referência

Classe basic_string

basic_string::append (Exemplos da STL)

Partilhar via