std::basic_string_view<CharT,Traits>::basic_string_view

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

Funciones miembro basic_string_view::basic_string_view basic_string_view::operator= Iteradores basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend Acceso a elementos basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data Capacidad basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty Modificadores basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

Operaciones basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of Constantes basic_string_view::npos Funciones no miembro operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) operator<< operator""sv Clases auxiliares hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) Guías de deducción(C++20)

 

<tbody> </tbody>

constexpr basic_string_view() noexcept;	(1)	(desde C++17)
constexpr basic_string_view(const basic_string_view& other) noexcept = default;	(2)	(desde C++17)
constexpr basic_string_view(const CharT* s, size_type count);	(3)	(desde C++17)
constexpr basic_string_view(const CharT* s);	(4)	(desde C++17)
template<typename It, typename End> constexpr basic_string_view(It first, End last);	(5)	(desde C++20)

1) Constructor por defecto. Construye una vista sobre cadena vacía (basic_string_view). Después de la construcción, data() es igual a nullptr, y size() es igual a 0.

2) Constructor de copia. Construye una vista sobre cadena con el mismo contenido que other. Después de la construcción, data() es igual a other.data(), y size() es igual a other.size().

3) Construye una vista sobre cadena de los primeros count caracteres del array de caracteres iniciando con el elemento al que apunta s. s puede contener caracteres nulos. El comportamiento es indefinido si [s, s+count) no es un rango válido (aun cuando el constructor no pueda acceder a ninguno de los elementos de este rango). Después de la construcción, data() es igual a s, and size() es igual a count.

4) Construye una vista sobre cadena a partir de la cadena terminada en nulo a la que apunta s, no incluyendo el caracter terminador nulo. La longitud de la vista se determina como si fuera mediante Traits::length(s). El comportamiento es indefinido si [s, s+Traits::length(s)) no es un rango válido. Después de la construcción, data() es igual a s, y size() es igual a Traits::length(s).

5) Construye una vista sobre cadena (basic_string_view) sobre el rango [first, last). El comportamiento es indefinido si [first, last) no es un rango válido, si It en realidad no modela a contiguous_iterator, o si End en realidad no modela a sized_sentinel_for para It. Después de la construcción, data() es igual a std::to_address(first), y size() es igual a last - first.

See More

Esta sobrecarga solo participa en la resolución de sobrecargas si

• It satisface a contiguous_iterator,
• End satisface a sized_sentinel_for para It,
• std::iter_value_t<It> y CharT son el mismo tipo, y
• End no es convertible a std::size_t.

Parámetros

other	-	Otra vista con la cual inicializar la vista sobre cadena.
s	-	Puntero a un array de caracteres o a una cadena estilo C con la cual inicializar la vista sobre cadena.
count	-	El número de caracteres a incluir en la vista sobre cadena.
first	-	Iterador al primer carácter de la secuencia.
last	-	Iterador al último carácter de la secuencia más uno u otro centinela.

Complejidad

1-3,5) Constante.

4) Lineal en la longitud de s.

Ejemplo

Ejecuta este código

#include <iostream>
#include <string>
#include <string_view>
int main()
{
    std::wstring_view wcstr_v = L"xyzzy";

    char array[3] = {'B', 'a', 'r'};
    std::string_view array_v(array, std::size(array));

    std::string cppstr = "Foo";
    std::string_view cppstr_v(cppstr); 

    std::cout << cppstr_v << '\n'
              << array_v << '\n'
              << wcstr_v.size() << '\n';
}

Salida:

Foo
Bar
5

Véase también

operator=

Asigna una vista. (función miembro pública)