std::experimental:: basic_string_view

Fusionado en ISO C++ La funcionalidad descrita en esta página fue fusionada en el estándar principal de ISO C++ a partir de 3/2016, consulte std::basic_string_view (desde C++17)

Definido en el encabezado <experimental/string_view>
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_string_view ;		(library fundamentals TS)

La plantilla de clase basic_string_view describe un objeto que puede hacer referencia a una secuencia contigua constante de char -like objects con el primer elemento de la secuencia en la posición cero.

Una implementación típica contiene solo dos miembros: un puntero a constante CharT y un tamaño.

Se proporcionan varios typedefs para tipos de caracteres comunes:

Definido en el encabezado <experimental/string_view>
Tipo	Definición
std::experimental::string_view	std :: experimental :: basic_string_view < char >
std::experimental::wstring_view	std :: experimental :: basic_string_view < wchar_t >
std::experimental::u16string_view	std :: experimental :: basic_string_view < char16_t >
std::experimental::u32string_view	std :: experimental :: basic_string_view < char32_t >

Contenidos 1 Parámetros de plantilla 2 Tipos de miembros 3 Funciones miembro 3.1 Iteradores 3.2 Acceso a elementos 3.3 Capacidad 3.4 Modificadores 3.5 Operaciones 4 Constantes 5 Funciones no miembro 5.1 Entrada/salida 6 Clases auxiliares 7 Macros de prueba de características

Parámetros de plantilla

CharT	-	tipo de carácter
Traits	-	clase de rasgos que especifica las operaciones sobre el tipo de carácter

Tipos de miembros

Tipo de miembro	Definición
traits_type	Traits
value_type	CharT
pointer	CharT*
const_pointer	const CharT*
reference	CharT&
const_reference	const CharT&
const_iterator	definido por la implementación LegacyRandomAccessIterator
iterator	const_iterator
reverse_iterator	const_reverse_iterator
const_reverse_iterator	std:: reverse_iterator < const_iterator >
size_type	std::size_t
difference_type	std::ptrdiff_t

Nota: iterator y const_iterator son el mismo tipo porque las vistas de cadena son vistas sobre secuencias de caracteres constantes.

Funciones miembro

(constructor)	construye un basic_string_view (función miembro pública)
operator=	asigna una vista (función miembro pública)
Iteradores
begin cbegin	devuelve un iterador al inicio (función miembro pública)
end cend	devuelve un iterador al final (función miembro pública)
rbegin crbegin	devuelve un iterador inverso al principio (función miembro pública)
rend crend	devuelve un iterador inverso al final (función miembro pública)
Acceso a elementos
operator[]	acceder al carácter especificado (función miembro pública)
at	accede al carácter especificado con verificación de límites (función miembro pública)
front	accede al primer carácter (función miembro pública)
back	accede al último carácter (función miembro pública)
data	devuelve un puntero al primer carácter de una vista (función miembro pública)
Capacidad
size length	devuelve el número de caracteres (función miembro pública)
max_size	devuelve el número máximo de caracteres (función miembro pública)
empty	verifica si la vista está vacía (función miembro pública)
Modificadores
remove_prefix	reduce la vista moviendo su inicio hacia adelante (función miembro pública)
remove_suffix	reduce la vista moviendo su final hacia atrás (función miembro pública)
swap	intercambia los contenidos (función miembro pública)
Operaciones
to_string operator basic_string	crea una cadena desde la vista (función miembro pública)
copy	copia caracteres (función miembro pública)
substr	devuelve una subcadena (función miembro pública)
compare	compara dos vistas (función miembro pública)
find	encontrar caracteres en la vista (función miembro pública)
rfind	encontrar la última ocurrencia de una subcadena (función miembro pública)
find_first_of	encontrar primera ocurrencia de caracteres (función miembro pública)
find_last_of	encontrar última ocurrencia de caracteres (función miembro pública)
find_first_not_of	encontrar primera ausencia de caracteres (función miembro pública)
find_last_not_of	encontrar última ausencia de caracteres (función miembro pública)
Constantes
npos [static]	valor especial. El significado exacto depende del contexto (constante de miembro público estático)

Funciones no miembro

operator== operator!= operator< operator> operator<= operator>=	compara lexicográficamente dos vistas (plantilla de función)
Entrada/salida
operator<<	realiza salida de flujo en vistas (plantilla de función)

Clases auxiliares

std::hash <std::experimental::string_view> std::hash <std::experimental::wstring_view> std::hash <std::experimental::u16string_view> std::hash <std::experimental::u32string_view>

soporte de hash para vistas (especialización de plantilla de clase)

Macros de prueba de características

__cpp_lib_experimental_string_view

un valor de al menos 201411 indica que la plantilla basic_string_view es compatible (constante macro)