basic_string::append

Artigo
02/24/2013

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
C -- a 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 ser anexados.
_Count
O número de caracteres a ser anexado, no máximo, a cadeia de caracteres de origem.
_Ch
O valor de caracteres a ser anexada.
_First
Um iterador de entrada que trata o primeiro elemento no intervalo a ser anexada.
_Last
Um iterador, um const_pointer, ou um const_iterator de entrada que trata a posição da além do último elemento no intervalo ser anexada.

Valor de retorno

Uma referência ao objeto de cadeia de caracteres que está sendo concatenado com os caracteres passados pela 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 ú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 adicionando.

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: <string>

namespace: STD

Consulte também

Referência

basic_string Class

basic_string::append (STL Samples)

Compartilhar via