Compartir a través de


basic_string Class

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.

syxtdd4f.collapse_all(es-es,VS.110).gifConstructores

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.

syxtdd4f.collapse_all(es-es,VS.110).gifTypedefs

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.

syxtdd4f.collapse_all(es-es,VS.110).gifFunciones 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.

syxtdd4f.collapse_all(es-es,VS.110).gifOperadores

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>