basic_string::basic_string

Artículo
02/19/2013

Crea una cadena que está vacía, inicializado por caracteres específicos, o es una copia de todo o parte de otra cadena (terminado en null) del objeto string o del estilo de C.

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
La C cadena cuyos caracteres que se utilizan para inicializar string que es construido.Este valor no puede ser un puntero nulo.
_Al
La clase del asignador de almacenamiento para el objeto string que es construido.
_Count
el número de caracteres que se inicializará.
_Right
La cadena para inicializar la cadena que lo construye.
_Roff
El índice de un carácter de una cadena que es la primera que se utilizará para inicializar los valores de caracteres de la cadena que lo construye.
_Ch
El carácter que se va a copiar en la cadena que lo construye.
_First
Un iterador, un const_pointer, o un const_iterator de entrada que dirige el primer elemento del intervalo de origen que se va a insertar.
_Last
Un iterador, un const_pointer, o un const_iterator de entrada que dirige la posición que está más allá del último elemento del intervalo de origen que se va a insertar.

Valor devuelto

Una referencia al objeto string que está siendo construido por los constructores.

Comentarios

Todos los constructores almacenan basic_string::allocator_type e inicializan la secuencia controlada.El objeto de asignador es el argumento al, si existe.Para el constructor de copias, es right.basic_string::get_allocator().De lo contrario, es Alloc().

La secuencia controlada inicializa una copia de la secuencia de operando especificados por los operandos restantes.Un constructor sin una secuencia de operando especifica una secuencia controlada inicial vacía.Si es InputIterator un entero escribir en un constructor de plantilla, el _First, _Last de operando se comporta igual que (size_type)_First, (value_type)_Last.

Ejemplo

// 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;
}

Output

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.