basic_string::basic_string

Artigo
06/09/2015

Constrói uma cadeia de caracteres que está vazia, inicializado por caracteres específicos, ou é uma cópia de todos ou parte de outra cadeia de caracteres do objeto de cadeia de caracteres ou de estilo 2.0 (c) com terminação nula.

basic_string();
explicit basic_string(
    const allocator_type& _Al
);
basic_string(
    const basic_string& _Right
);
basic_string(
    basic_string&& _Right
);
basic_string(
    const basic_string& _Right, 
    size_type _Roff,
    size_type _Count = npos
);
basic_string(
    const basic_string& _Right, 
    size_type _Roff,
    size_type _Count, 
    const allocator_type& _Al
);
basic_string(
    const value_type *_Ptr, 
    size_type _Count
);
basic_string(
    const value_type *_Ptr, 
    size_type _Count,
    const allocator_type& _Al
);
basic_string(
    const value_type *_Ptr
);
basic_string(
    const value_type *_Ptr,
    const allocator_type& _Al
);
basic_string(
    size_type _Count, 
    value_type _Ch
);
basic_string(
    size_type _Count, 
    value_type _Ch,
    const allocator_type& _Al
);
template <class InputIterator>
    basic_string(
        InputIterator _First, 
        InputIterator _Last
    );
template <class InputIterator>
    basic_string(
        InputIterator _First, 
        InputIterator _Last, 
        const allocator_type& _Al
    );
basic_string(
   const_pointer _First,
   const_pointer _Last
);
basic_string(
   const_iterator _First,
   const_iterator _Last
);

Parâmetros

_Ptr
Para C - cadeia de caracteres cujos caracteres devem ser usada para inicializar string que está sendo construído. Esse valor não pode ser um ponteiro nulo.
_Al
A classe do alocador de armazenamento do objeto de cadeia de caracteres que está sendo construído.
_Count
O número de caracteres a ser inicializados.
_Right
A cadeia de caracteres para inicializar a cadeia de caracteres que está sendo construída.
_Roff
O índice de um caractere em uma cadeia de caracteres que é a primeira a ser usada para inicializar valores de caractere para a cadeia de caracteres que está sendo construída.
_Ch
O valor de caractere a ser copiado na cadeia de caracteres que está sendo construída.
_First
Um iterador, um const_pointer, ou um const_iterator de entrada que trata o primeiro elemento no intervalo de origem a ser inserido.
_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 de origem ser inserido.

Valor de retorno

Uma referência ao objeto de cadeia de caracteres que está sendo construído pelos construtores.

Comentários

Todos os construtores e armazenam basic_string::allocator_type iniciar a sequência controlada. O objeto do alocador é o argumento al, se houver. Para o construtor de impressão, é right.basic_string::get_allocator(). Caso contrário, será Alloc().

A sequência controlada é inicializada para uma cópia de sequência do operando especificada pelos operandos restantes. Um construtor sem uma sequência inicial do operando especifica uma sequência vazia controlada. Se InputIterator é um inteiro digitar um construtor de modelo, o _First, _Last de sequência do operando se comportará da mesma maneira que (size_type)_First, (value_type)_Last.

Exemplo

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

int main( )
{
   using namespace std;

   // The first member function initializing with a C-string
   const char *cstr1a = "Hello Out There.";
   basic_string <char> str1a ( cstr1a , 5);
   cout << "The string initialized by C-string cstr1a is: "
        << str1a << "." << endl;

   // The second member function initializing with a string
   string  str2a ( "How Do You Do?" );
   basic_string <char> str2b ( str2a , 7 , 7 );
   cout << "The string initialized by part of the string cstr2a is: "
        << str2b << "." << endl;

   // The third member function initializing a string
   // with a number of characters of a specific value
   basic_string <char> str3a ( 5, '9' );
   cout << "The string initialized by five number 9s is: "
        << str3a << endl;

   // The fourth member function creates an empty string
   // and string with a specified allocator
   basic_string <char> str4a;
   string str4b;
   basic_string <char> str4c ( str4b.get_allocator( ) );
   if (str4c.empty ( ) )
      cout << "The string str4c is empty." << endl;
   else
      cout << "The string str4c is not empty." << endl;

   // The fifth member function initializes a string from
   // another range of characters
   string str5a ( "Hello World" );
   basic_string <char> str5b ( str5a.begin ( ) + 5 , str5a.end ( ) );
   cout << "The string initialized by another range is: "
        << str5b << "." << endl;
}

Saída

The string initialized by C-string cstr1a is: Hello.
The string initialized by part of the string cstr2a is: You Do?.
The string initialized by five number 9s is: 99999
The string str4c is empty.
The string initialized by another range is:  World.