std::basic_string
De cppreference.com
| Definido en el archivo de encabezado <string>
|
||
| template< typename CharT, |
(1) | |
| namespace pmr { template <typename CharT, typename Traits = std::char_traits<CharT>> |
(2) | (desde C++17) |
La plantilla de clase basic_string (cadena básica) almacena y manipula secuencias de objetos similares a caracteres char, que son objetos no-array de tipo de diseño estándar trivial . La clase no depende ni del tipo de carácter ni de la naturaleza de las operaciones sobre ese tipo. Las definiciones de las operaciones se suministran mediante el parámetro de plantilla Traits --una especialización de std::char_traits o una clase de rasgos compatibles. Traits::char_type y CharT deben nombrar el mismo tipo; de otra forma, el programa está mal formado.
Los elementos de una cadena básica (basic_string) se almacenan contiguamente, es decir, para un basic_string s, &*(s.begin() + n) == &*s.begin() + n para cualquier n en [0, s.size()), o, de manera equivalente, un puntero a s[0] puede pasarse a funciones que esperan un puntero al primer elemento de un CharT[] terminado en nulo (desde C++11).
std::basic_string satisface los requerimientos de AllocatorAwareContainer, SequenceContainer y ContiguousContainer (desde C++17)
Se proporcionan varias definiciones de tipo (typedefs) para tipos de carácter comunes:
| Definido en el archivo de encabezado
<string> | |
| Tipo | Definición |
| std::string | std::basic_string<char> |
| std::wstring | std::basic_string<wchar_t> |
| std::u8string (C++20) | std::basic_string<char8_t> |
| std::u16string (C++11) | std::basic_string<char16_t> |
| std::u32string (C++11) | std::basic_string<char32_t> |
| std::pmr::string (C++17) | std::pmr::basic_string<char> |
| std::pmr::wstring (C++17) | std::pmr::basic_string<wchar_t> |
| std::pmr::u8string (C++20) | std::pmr::basic_string<char8_t> |
| std::pmr::u16string (C++17) | std::pmr::basic_string<char16_t> |
| std::pmr::u32string (C++17) | std::pmr::basic_string<char32_t> |
Contenido |
[editar] Parámetros de plantilla
| CharT | - | Tipo de carácter. |
| Traits | - | Clase de rasgos que especifica las operaciones sobre el tipo de carácter. |
| Allocator | - | Tipo de asignador (Allocator) utilizado para asignar almacenamiento interno. |
[editar] Tipos miembro
| Tipo miembro | Definición | ||||
traits_type
|
Traits
| ||||
value_type
|
CharT
| ||||
allocator_type
|
Allocator
| ||||
size_type
|
| ||||
difference_type
|
| ||||
reference
|
Allocator::reference (hasta C++11)value_type& (desde C++11)
| ||||
const_reference
|
Allocator::const_reference (hasta C++11)const value_type& (desde C++11)
| ||||
pointer
|
Allocator::pointer (hasta C++11)std::allocator_traits<Allocator>::pointer (desde C++11) | ||||
const_pointer
|
Allocator::const_pointer (hasta C++11) std::allocator_traits<Allocator>::const_pointer (desde C++11) | ||||
iterator
|
IteradorDeAccesoAleatorioLegado | ||||
const_iterator
|
IteradorDeAccesoAleatorioLegado constante | ||||
reverse_iterator
|
std::reverse_iterator<iterator> | ||||
const_reverse_iterator
|
std::reverse_iterator<const_iterator> |
[editar] Funciones miembro
Construye una cadena basic_string (función miembro pública) | |
| (destructor) |
Destruye la cadena, desasignando almacenamiento interno si se utiliza. (función miembro pública) |
| Asigna valores a la cadena (función miembro pública) | |
| Asigna caracteres a una cadena (función miembro pública) | |
| Devuelve el asignador asociado (función miembro pública) | |
Acceso a elementos | |
| Accede al carácter especificado con comprobación de límites (función miembro pública) | |
| Accede al carácter especificado (función miembro pública) | |
| (C++11) |
Accede al primer carácter (función miembro pública) |
| (C++11) |
Accede al último carácter (función miembro pública) |
| Devuelve un puntero al primer carácter de una cadena (función miembro pública) | |
| Devuelve una versión de la cadena que es un array de caracteres no modificable de C estándar (función miembro pública) | |
| (C++17) |
Devuelve una vista sobre cadena no modificable de la cadena completa. (función miembro pública) |
Iteradores | |
| (C++11) |
Devuelve un iterador al principio (función miembro pública) |
| (C++11) |
Devuelve un iterador al final (función miembro pública) |
| (C++11) |
Devuelve un iterador inverso al principio (función miembro pública) |
| (C++11) |
Devuelve un iterador inverso al final (función miembro pública) |
Capacidad | |
| Comprueba si la cadena está vacía (función miembro pública) | |
| Devuelve el número de caracteres (función miembro pública) | |
| Devuelve el número máximo de caracteres (función miembro pública) | |
| Reserva almacenamiento (función miembro pública) | |
| Devuelve el número de caracteres que pueden almacenarse en el almacenamiento asignado actual (función miembro pública) | |
| (C++11) |
Reduce el uso de memoria liberando memoria no utilizada. (función miembro pública) |
Operaciones | |
| Borra el contenido (función miembro pública) | |
| Inserta caracteres (función miembro pública) | |
| Borra caracteres (función miembro pública) | |
| Añade un carácter al final (función miembro pública) | |
| (C++11) |
Elimina el último carácter (función miembro pública) |
| Añade caracteres al final (función miembro pública) | |
| Añade caracteres al final (función miembro pública) | |
| Compara dos cadenas (función miembro pública) | |
| (C++20) |
Comprueba si la cadena comienza con el prefijo dado. (función miembro pública) |
| (C++20) |
Comprueba si la cadena termina con el sufijo dado (función miembro pública) |
| Reemplaza todas las apariciones de los caracteres especificados (función miembro pública) | |
| Devuelve una subcadena (función miembro pública) | |
| Copia caracteres (función miembro pública) | |
| Cambia el número de caracteres almacenados (función miembro pública) | |
| Intercambia el contenido (función miembro pública) | |
Búsqueda | |
| Encuentra caracteres en la cadena (función miembro pública) | |
| Encuentra la última aparición de una subcadena (función miembro pública) | |
| Encuentra la primera aparición de caracteres (función miembro pública) | |
| Encuentra la primera ausencia de caracteres (función miembro pública) | |
| Encuentra la última aparición de caracteres (función miembro pública) | |
| Encuentra la última ausencia de caracteres (función miembro pública) | |
Constantes | |
| [estático] |
Valor especial. El significado exacto depende del contexto (constante miembro pública estática) |
[editar] Funciones no miembro
| Concatena dos cadenas, o una cadena y un carácter (plantilla de función) | |
| Comparación lexicográfica de dos cadenas de texto (plantilla de función) | |
| Especializa el algoritmo std::swap (plantilla de función) | |
| Borra todos los elementos que satisfacen un criterio específico. (plantilla de función) | |
Entrada/salida | |
| Realiza secuencia de E/S en cadenas de texto (plantilla de función) | |
| Lee datos de un flujo de E/S a una cadena (función) | |
Conversiones numéricas | |
| (C++11)(C++11)(C++11) |
Convierte una cadena a un entero con signo (función) |
| (C++11)(C++11) |
Convierte una cadena a un entero sin signo (función) |
| (C++11)(C++11)(C++11) |
Convierte una cadena en un valor de punto flotante (función) |
| (C++11) |
Convierte un valor de punto flotante o entero a una cadena string. (función) |
| (C++11) |
Convierte un valor de punto flotante o entero a una cadena wstring. (función) |
[editar] Literales
| Definido en el espacio de nombres
std::literals::string_literals | |
| (C++14) |
Convierte un literal de array de caracteres a basic_string (función) |
[editar] Clases auxiliares
| (C++11)(C++11)(C++11)(C++11) |
Apoyo de generación de dispersión para cadenas (especialización de plantilla de clase) |
