Archivo de encabezado de la biblioteca estándar <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

 

Archivos de encabezado de la biblioteca estándar

Apoyo del lenguaje <cfloat> <climits> <compare>(C++20) <coroutine>(C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint>(C++11) <cstdlib> <exception> <initializer_list>(C++11)    <limits> <new> <source_location>(C++20) <stdfloat>(C++23) <typeinfo> <version>(C++20) Conceptos <concepts>(C++20) Diagnósticos <cassert> <cerrno> <debugging>(C++26) <stacktrace>(C++23) <stdexcept> <system_error>(C++11) Gestión de memoria <memory> <memory_resource>(C++17) <scoped_allocator>(C++11) Metaprogramación <type_traits>(C++11) <ratio>(C++11)

Servicios generales <any>(C++17) <bitset> <bit>(C++20) <charconv>(C++17) <expected>(C++23) <format>(C++20) <functional> <optional>(C++17) <tuple>(C++11) <typeindex>(C++11) <utility> <variant>(C++17) Contenedores <array>(C++11) <deque> <flat_map>(C++23) <flat_set>(C++23) <forward_list>(C++11) <inplace_vector>(C++26)    <list> <map> <mdspan>(C++23) <queue> <set> <span>(C++20) <stack> <unordered_map>(C++11) <unordered_set>(C++11) <vector> Iteradores <iterator> Rangos <generator>(C++23) <ranges>(C++20)

Algoritmos <algorithm> <numeric> Cadenas <cctype> <cstring> <cuchar>(C++11) <cwchar> <cwctype> <string_view>(C++17) <string> Procesamiento de texto <clocale> <codecvt>(C++11/17/26*) <locale> <regex>(C++11) <text_encoding>(C++26)    Numéricos <cfenv>(C++11) <cmath> <complex> <linalg>(C++26) <numbers>(C++20) <random>(C++11) <simd>(C++26) <valarray> Tiempo <chrono>(C++11) <ctime> Compatibilidad con C <ccomplex>(C++11/17/20*) <ciso646>(hasta C++20) <cstdalign>(C++11/17/20*) <cstdbool>(C++11/17/20*) <ctgmath>(C++11/17/20*)

Entrada/Salida <cinttypes>(C++11) <cstdio> <filesystem>(C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print>(C++23) <spanstream>(C++23) <sstream> <streambuf> <strstream>(C++98/26*) <syncstream>(C++20) Apoyo para concurrencia <atomic>(C++11) <barrier>(C++20) <condition_variable>(C++11) <future>(C++11) <hazard_pointer>(C++26) <latch>(C++20) <mutex>(C++11) <rcu>(C++26) <semaphore>(C++20) <shared_mutex>(C++14) <stdatomic.h>(C++23) <stop_token>(C++20) <thread>(C++11) Apoyo de ejecución <execution>(C++17)

 

Este archivo de encabezado es parte de la biblioteca de cadenas.

Clases

basic_string_view (C++17)	Vista sobre cadena de solo lectura. (plantilla de clase)
std::string_view	std::basic_string_view<char>
std::u8string_view	std::basic_string_view<char8_t>(C++20)
std::u16string_view	std::basic_string_view<char16_t>
std::u32string_view	std::basic_string_view<char32_t>
std::wstring_view	std::basic_string_view<wchar_t>
std::hash<std::string_view>std::hash<std::wstring_view>std::hash<std::u8string_view>std::hash<std::u16string_view>std::hash<std::u32string_view> (C++17)(C++17)(C++20)(C++17)(C++17)	Apoyo de generación de dispersión para vistas sobre cadena (especialización de plantilla de clase)

Funciones

operator==operator!=operator<operator>operator<=operator>=operator<=> (eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(eliminado en C++20)(C++20)	Compara dos vistas sobre cadena lexicográficamente. (plantilla de función)
operator<<	Realiza salida de flujo en vistas sobre cadena. (plantilla de función)

Sinopsis

namespace std {   // plantilla de clase basic_string_viewtemplate<typename charT, typename traits = char_traits<charT>>class basic_string_view;   // funciones no miembro de comparacióntemplate<typename charT, typename traits>constexprbool operator==(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;template<typename charT, typename traits>constexprbool operator!=(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;template<typename charT, typename traits>constexprbool operator<(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;template<typename charT, typename traits>constexprbool operator>(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;template<typename charT, typename traits>constexprbool operator<=(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;template<typename charT, typename traits>constexprbool operator>=(basic_string_view<charT, traits> x, basic_string_view<charT, traits> y)noexcept;/* sobrecargas de funciones de comparación adicionales suficientes */   // insertadores y extractorestemplate<typename charT, typename traits> basic_ostream<charT, traits>& operator<<(basic_ostream<charT, traits>& os, basic_string_view<charT, traits> str);   // nombres de tipos definidos (typedef) de basic_string_viewusing string_view = basic_string_view<char>;using u8string_view = basic_string_view<char8_t>;using u16string_view = basic_string_view<char16_t>;using u32string_view = basic_string_view<char32_t>;using wstring_view = basic_string_view<wchar_t>;   // soporte para hash (resumen)template<typename T>struct hash;template<>struct hash<string_view>;template<>struct hash<u8string_view>;template<>struct hash<u16string_view>;template<>struct hash<u32string_view>;template<>struct hash<wstring_view>;   inlinenamespace literals {inlinenamespace string_view_literals {// sufijo para los literales de basic_string_viewconstexpr string_view operator "" sv(constchar* str, size_t len)noexcept;constexpr u8string_view operator "" sv(const char8_t* str, size_t len)noexcept;constexpr u16string_view operator "" sv(constchar16_t* str, size_t len)noexcept;constexpr u32string_view operator "" sv(constchar32_t* str, size_t len)noexcept;constexpr wstring_view operator "" sv(constwchar_t* str, size_t len)noexcept;}}}// namespace std

Plantilla de clase std::basic_string_view

namespace std {template<typename charT, typename traits = char_traits<charT>>class basic_string_view {public:// tipostypedef traits traits_type;typedef charT value_type;typedef charT* pointer;typedefconst charT* const_pointer;typedef charT& reference;typedefconst charT& const_reference;typedef/*definido por la implementación*/ const_iterator;typedef const_iterator iterator;typedef reverse_iterator<const_iterator> const_reverse_iterator;typedef const_reverse_iterator reverse_iterator;typedef size_t size_type;typedef ptrdiff_t difference_type;staticconstexpr size_type npos = size_type(-1);   // construcción y asignaciónconstexpr basic_string_view()noexcept;constexpr basic_string_view(const basic_string_view&)noexcept=default; basic_string_view &operator=(const basic_string_view&)noexcept=default;constexpr basic_string_view(const charT* str);constexpr basic_string_view(const charT* str, size_type len);   // soporte de iteradoresconstexpr const_iterator begin()constnoexcept;constexpr const_iterator end()constnoexcept;constexpr const_iterator cbegin()constnoexcept;constexpr const_iterator cend()constnoexcept;constexpr const_reverse_iterator rbegin()constnoexcept;constexpr const_reverse_iterator rend()constnoexcept;constexpr const_reverse_iterator crbegin()constnoexcept;constexpr const_reverse_iterator crend()constnoexcept;   // capacidadconstexpr size_type size()constnoexcept;constexpr size_type length()constnoexcept;constexpr size_type max_size()constnoexcept;[[nodiscard]]constexprbool empty()constnoexcept;   // acceso a elementosconstexpr const_reference operator[](size_type pos)const;constexpr const_reference at(size_type pos)const;constexpr const_reference front()const;constexpr const_reference back()const;constexpr const_pointer data()constnoexcept;   // modificadoresconstexprvoid remove_prefix(size_type n);constexprvoid remove_suffix(size_type n);constexprvoid swap(basic_string_view& s)noexcept;   constexpr size_type copy(charT* s, size_type n, size_type pos =0)const;constexpr basic_string_view substr(size_type pos =0, size_type n = npos)const;constexprint compare(basic_string_view s)constnoexcept;constexprint compare(size_type pos1, size_type n1, basic_string_view s)const;constexprint compare(size_type pos1, size_type n1, basic_string_view s, size_type pos2, size_type n2)const;constexprint compare(const charT* s)const;constexprint compare(size_type pos1, size_type n1, const charT* s)const;constexprint compare(size_type pos1, size_type n1, const charT* s, size_type n2)const;constexprbool starts_with(basic_string_view x)constnoexcept;constexprbool starts_with(charT x)constnoexcept;constexprbool starts_with(const charT* x)const;constexprbool ends_with(basic_string_view x)constnoexcept;constexprbool ends_with(charT x)constnoexcept;constexprbool ends_with(const charT* x)const;constexpr size_type find(basic_string_view s, size_type pos =0)constnoexcept;constexpr size_type find(charT c, size_type pos =0)constnoexcept;constexpr size_type find(const charT* s, size_type pos, size_type n)const;constexpr size_type find(const charT* s, size_type pos =0)const;constexpr size_type rfind(basic_string_view s, size_type pos = npos)constnoexcept;constexpr size_type rfind(charT c, size_type pos = npos)constnoexcept;constexpr size_type rfind(const charT* s, size_type pos, size_type n)const;constexpr size_type rfind(const charT* s, size_type pos = npos)const;constexpr size_type find_first_of(basic_string_view s, size_type pos =0)constnoexcept;constexpr size_type find_first_of(charT c, size_type pos =0)constnoexcept;constexpr size_type find_first_of(const charT* s, size_type pos, size_type n)const;constexpr size_type find_first_of(const charT* s, size_type pos =0)const;constexpr size_type find_last_of(basic_string_view s, size_type pos = npos)constnoexcept;constexpr size_type find_last_of(charT c, size_type pos = npos)constnoexcept;constexpr size_type find_last_of(const charT* s, size_type pos, size_type n)const;constexpr size_type find_last_of(const charT* s, size_type pos = npos)const;constexpr size_type find_first_not_of(basic_string_view s, size_type pos =0)constnoexcept;constexpr size_type find_first_not_of(charT c, size_type pos =0)constnoexcept;constexpr size_type find_first_not_of(const charT* s, size_type pos, size_type n)const;constexpr size_type find_first_not_of(const charT* s, size_type pos =0)const;constexpr size_type find_last_not_of(basic_string_view s,size_type pos = npos)constnoexcept;constexpr size_type find_last_not_of(charT c, size_type pos = npos)constnoexcept;constexpr size_type find_last_not_of(const charT* s, size_type pos, size_type n)const;constexpr size_type find_last_not_of(const charT* s, size_type pos = npos)const;private: const_pointer data_;// solo exposición size_type size_;// solo exposición};   }