basic_string Class

Artículo
03/15/2013

Las secuencias controladas por un objeto de la plantilla clase basic_string son la clase de cadena estándar de C++ y normalmente se conocen como cadenas, pero no deben confundirse con las cadenas terminadas en null C-utilizadas a lo largo de la biblioteca estándar de C++.La clase string es un contenedor que permite el uso de cadenas como tipos normales, como, por ejemplo, mediante las operaciones de comparación y de concatenación, iteradores y algoritmos STL y la copia y asignación de asignador de clase de memoria administrada.

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

Parámetros

CharType
El tipo de datos de un solo carácter para almacenarse en la cadena.La biblioteca estándar de C++ proporciona dos especializaciones de esta clase de plantilla, con las definiciones de tipo cadena, para los elementos de tipo char, y wstring, para los elementos de tipo wchar_t.
Traits
Varias propiedades importantes de la CharType se describen los elementos de una especialización basic_string por la clase rasgos.
Allocator
El tipo que representa el objeto asignador almacenado que encapsula los detalles acerca de la asignación y desasignación de memoria de la cadena.El valor predeterminado es Asignador*<Type>.*

Muchas funciones de miembro requieren una secuencia de operando de elementos.Puede especificar tal una secuencia de operando varias formas.

Elemento	Descripción
_Ch	Un elemento con el valor de carácter _Ch.
_Count, _Ch	Una repetición de _Count elementos con el valor _Ch.
_Ptr	Una secuencia de terminación nula, como una cadena de C, con un CharType de tipo char, a partir _Ptr (que no debe ser un puntero nulo), donde el elemento final es el valor de value_type y no forma parte de la secuencia de operando.
_Ptr, _Count	Una secuencia de _Count elementos, empezando por _Ptr.
_Str	La secuencia especificada por un objeto basic_string.
_Str, _Off, _Count	La subcadena del objeto basic_string _Str con hasta _Count elementos (o hasta el final de la cadena, lo que ocurra primero) comenzando por la posición _Off.
_First, _Last	Una secuencia de elementos delimitados por los iteradores _First y _Last, en el intervalo [_First, _Last), que pueden superponerse a la secuencia controlada por el objeto de cadena que se denomina cuya función miembro.

Si un argumento de posición (como _Off) es más allá del final de la cadena en una llamada a un basic_string función de miembro, la función informa de un error de fuera de intervalo al lanzar un objeto de tipo out_of_range clase.

Si se pide una función para generar una secuencia de más de max_size elementos, la función informa un error de longitud al lanzar un objeto de tipo length_error clase.

Referencias, punteros y los iteradores que designan los elementos de la secuencia controlada pueden convertirse en no válidos después de cualquier llamada a una función que modifica la secuencia controlada o después de la primera llamada a una no-const una función miembro.

Constructores

basic_string

Crea una cadena que está vacío o inicializado por caracteres específicos o es una copia de todos o parte de otro objeto de cadena o cadena de C.

Typedefs

allocator_type	Un tipo que representa el allocator clase para un objeto de cadena.
const_iterator	Un tipo que proporciona un iterador de acceso aleatorio que puede tener acceso y leer un const elemento de la cadena.
const_pointer	Un tipo que proporciona un puntero a un const elemento de una cadena.
const_reference	Un tipo que proporciona una referencia a un const elemento almacenado en una cadena para leer y realizar const las operaciones.
const_reverse_iterator	Un tipo que proporciona un iterador de acceso aleatorio que puede lee ninguno const elemento de la cadena.
difference_type	Un tipo que proporciona la diferencia entre dos iteradores que hacen referencia a elementos dentro de la misma cadena.
Iterador	Un tipo que proporciona un iterador de acceso aleatorio que puede leer o modificar cualquier elemento en una cadena.
nPos	Un valor entero sin signo inicializado a – 1 indica cualquiera "no encontrado" o "todos los caracteres restantes" cuando se produce un error en una función de búsqueda.
pointer	Un tipo que proporciona un puntero a un elemento de carácter en una matriz de cadena o carácter.
Referencia .	Un tipo que proporciona una referencia a un elemento almacenado en una cadena.
reverse_iterator	Un tipo que proporciona un iterador de acceso aleatorio que puede leer o modificar un elemento en una cadena invertida.
size_type	Un tipo integral sin signo del número de elementos en una cadena.
traits_type	Un tipo de los rasgos de carácter de los elementos almacenados en una cadena.
value_type	Un tipo que representa el tipo de caracteres almacenados en una cadena.

Funciones miembro

append	Agrega caracteres al final de una cadena.
assign	Asigna nuevos valores de carácter para el contenido de una cadena.
at	Devuelve una referencia al elemento en la ubicación especificada en la cadena.
back
begin	Devuelve un iterador direccionamiento del primer elemento de la cadena.
c_str	Convierte el contenido de una cadena como una cadena terminada en null, estilo de C.
capacity	Devuelve el mayor número de elementos que se pueden almacenar en una cadena sin aumentar la asignación de memoria de la cadena.
cbegin	Devuelve un iterador const direccionamiento del primer elemento de la cadena.
cend	Devuelve un iterador const que se ocupa de la ubicación del éxito del último elemento de una cadena.
clear	Borra todos los elementos de una cadena.
compare	Compara una cadena con una cadena especificada para determinar si las dos cadenas son iguales o si uno es la manera lexicográfica menor que el otro.
copy	Copia un número especificado de caracteres como máximo de desde una posición indizada en una cadena de origen en una matriz de caracteres de destino.Obsoleto.Utilice basic_string::_Copy_s en su lugar.
crbegin	Devuelve un iterador const que se ocupa el primer elemento de una cadena invertida.
crend	Devuelve un iterador const que se ocupa de la ubicación del éxito del último elemento de una cadena invertida.
_Copy_s	Copia un número especificado de caracteres como máximo de desde una posición indizada en una cadena de origen en una matriz de caracteres de destino.
datos	Convierte el contenido de una cadena en una matriz de caracteres.
empty	Comprueba si la cadena contiene caracteres.
end	Devuelve un iterador que se ocupa de la ubicación del éxito del último elemento de una cadena.
Borrar	Quita un elemento o un intervalo de elementos en una cadena de una posición especificada.
find	Busca una cadena hacia delante para la primera aparición de una subcadena que coincide con una secuencia de caracteres especificada.
find_first_not_of	Búsquedas a través de una cadena para el primer carácter que no es cualquier elemento de una cadena especificada.
find_first_of	Búsquedas a través de una cadena para el primer carácter que coincide con cualquier elemento de una cadena especificada.
find_last_not_of	Búsquedas a través de una cadena para el último carácter que no es cualquier elemento de una cadena especificada.
find_last_of	Búsquedas a través de una cadena para el último carácter es un elemento de una cadena especificada.
front	Devuelve una referencia al primer elemento de una cadena.
get_allocator	Devuelve una copia de la allocator objeto que se utiliza para construir la cadena.
Insertar	Inserta un elemento o un número de elementos o un intervalo de elementos en la cadena en la posición especificada.
length	Devuelve el número actual de elementos en una cadena.
max_size	Devuelve el número máximo de caracteres que puede contener una cadena.
pop_back	Borra el último elemento de la cadena.
push_back	Agrega un elemento al final de la cadena.
rbegin	Devuelve un iterador para el primer elemento de una cadena invertida.
rend	Devuelve un iterador que señala más allá del último elemento de una cadena invertida.
replace	Reemplaza los elementos de una cadena en la posición especificada por los caracteres especificados o copiado de otros rangos o cadenas o cadenas de C.
reserve	Establece la capacidad de la cadena en un número al menos tan grande como un número especificado.
resize	Especifica un nuevo tamaño de una cadena, anexar o borrando elementos según sea necesario.
rfind	Busca una cadena en una dirección hacia atrás la primera aparición de una subcadena que coincide con una secuencia de caracteres especificada.
shrink_to_fit	Descarta el exceso de capacidad de la cadena.
size	Devuelve el número actual de elementos en una cadena.
SUBSTR	Copia una subcadena de como máximo un número de caracteres de una cadena, comenzando desde una posición especificada.
swap	El contenido de dos cadenas de Exchange.

Operadores

operador +=	Añade caracteres en una cadena.
operator=	Asigna nuevos valores de carácter para el contenido de una cadena.
operator[]	Proporciona una referencia al carácter con el índice especificado en una cadena.

Requisitos

Encabezado: <string>

Espacio de nombres: std

Vea también

Referencia

Seguridad para subprocesos de la biblioteca estándar de C++

Otros recursos

miembros basic_string

miembros de <cadena>