std:: basic_spanbuf
|
Definido en el encabezado
<spanstream>
|
||
|
template
<
class
CharT,
|
(desde C++23) | |
std::basic_spanbuf
es un
std::basic_streambuf
cuya secuencia de caracteres asociada es una secuencia residente en memoria de caracteres arbitrarios, que puede inicializarse desde o hacerse disponible como una instancia de
std::
span
<
CharT
>
.
std::basic_spanbuf
realiza E/S en un búfer fijo, y por lo tanto no intenta obtener un nuevo búfer cuando el búfer subyacente se agota.
Se proporcionan varios typedefs para tipos de caracteres comunes:
|
Definido en el encabezado
<spanstream>
|
|
| Tipo | Definición |
std::spanbuf
|
std :: basic_spanbuf < char > |
std::wspanbuf
|
std :: basic_spanbuf < wchar_t > |
Contenidos |
Tipos de miembros
| Tipo de miembro | Definición |
char_type
|
CharT
|
traits_type
|
Traits
; el programa está mal formado si
Traits::char_type
no es
CharT
.
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Miembros de datos
| Nombre del miembro | Definición |
mod
(privado)
|
Un
std::ios_base::openmode
que registra el modo de apertura.
( objeto miembro solo para exposición* ) |
buf
(privado)
|
Un
std::
span
<
CharT
>
que referencia al búfer subyacente.
( objeto miembro solo para exposición* ) |
Funciones miembro
Funciones miembro públicas |
|
construye un objeto
basic_spanbuf
(función miembro pública) |
|
|
(destructor)
[virtual]
|
destruye el objeto
basic_spanbuf
(función miembro pública virtual) |
asigna un objeto
basic_spanbuf
(función miembro pública) |
|
intercambia dos objetos
basic_spanbuf
(función miembro pública) |
|
|
obtiene o inicializa un búfer subyacente según el modo
(función miembro pública) |
|
Funciones miembro protegidas |
|
|
[virtual]
|
intenta reemplazar la secuencia de caracteres controlada con un array
(función miembro protegida virtual) |
|
[virtual]
|
reposiciona el siguiente puntero en la secuencia de entrada, secuencia de salida, o ambas, usando direccionamiento relativo
(función miembro protegida virtual) |
|
[virtual]
|
reposiciona el siguiente puntero en la secuencia de entrada, secuencia de salida, o ambas usando direccionamiento absoluto
(función miembro protegida virtual) |
Funciones no miembro
|
(C++23)
|
especializa el algoritmo
std::swap
(plantilla de función) |
Heredado de std:: basic_streambuf
Tipos de miembros
| Tipo de miembro | Definición |
char_type
|
CharT
|
traits_type
|
Traits
; el programa está mal formado si
Traits::char_type
no es
CharT
.
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Funciones miembro
|
[virtual]
|
destruye el objeto
basic_streambuf
(función miembro pública virtual de
std::basic_streambuf<CharT,Traits>
)
|
Locales |
|
|
cambia la configuración regional asociada e invoca
imbue
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
obtiene una copia de la configuración regional asociada
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
Posicionamiento |
|
|
invoca
setbuf
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoca
seekoff
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoca
seekpos
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoca
sync
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
Área de obtención |
|
|
obtiene el número de caracteres inmediatamente disponibles en el área de obtención
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
avanza la secuencia de entrada, luego lee un carácter sin avanzar nuevamente
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
(eliminado en C++17)
|
lee un carácter de la secuencia de entrada y avanza la secuencia
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
lee un carácter de la secuencia de entrada sin avanzar la secuencia
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoca
xsgetn
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
Área de escritura |
|
|
escribe un carácter en el área de escritura y avanza el siguiente puntero
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoca
xsputn
(
)
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
Reinserción |
|
|
devuelve un carácter a la secuencia de entrada
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
|
mueve el siguiente puntero en la secuencia de entrada hacia atrás una posición
(función miembro pública de
std::basic_streambuf<CharT,Traits>
)
|
|
Funciones miembro protegidas
construye un objeto
basic_streambuf
(función miembro protegida) |
|
|
(C++11)
|
reemplaza un objeto
basic_streambuf
(función miembro protegida) |
|
(C++11)
|
intercambia dos objetos
basic_streambuf
(función miembro protegida) |
Locales |
|
|
[virtual]
|
reacciona a un cambio de la configuración regional asociada
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
Posicionamiento |
|
|
[virtual]
|
reemplaza el búfer con un arreglo definido por el usuario, si está permitido
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
reposiciona el siguiente puntero en la secuencia de entrada, secuencia de salida, o ambas, usando direccionamiento relativo
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
reposiciona el siguiente puntero en la secuencia de entrada, secuencia de salida, o ambas usando direccionamiento absoluto
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
sincroniza los búferes con la secuencia de caracteres asociada
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
Obtener área |
|
|
[virtual]
|
obtiene el número de caracteres disponibles para entrada en la secuencia de entrada asociada, si se conoce
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lee caracteres de la secuencia de entrada asociada al área de obtención
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lee caracteres de la secuencia de entrada asociada al área de obtención y avanza el siguiente puntero
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lee múltiples caracteres de la secuencia de entrada
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
devuelve un puntero al inicio, al carácter actual y al final del área de obtención
(función miembro protegida) |
|
|
avanza el siguiente puntero en la secuencia de entrada
(función miembro protegida) |
|
|
reposiciona los punteros de inicio, siguiente y fin de la secuencia de entrada
(función miembro protegida) |
|
Área de put |
|
|
[virtual]
|
escribe múltiples caracteres en la secuencia de salida
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
escribe caracteres a la secuencia de salida asociada desde el área de escritura
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
|
devuelve un puntero al inicio, al carácter actual y al final del área de escritura
(función miembro protegida) |
|
|
avanza el puntero siguiente de la secuencia de salida
(función miembro protegida) |
|
|
reposiciona los punteros de inicio, siguiente y fin de la secuencia de salida
(función miembro protegida) |
|
Putback |
|
|
[virtual]
|
coloca un carácter de vuelta en la secuencia de entrada, posiblemente modificando la secuencia de entrada
(función miembro protegida virtual de
std::basic_streambuf<CharT,Traits>
)
|
Notas
std::basic_spanbuf
no posee el búfer subyacente.
Es responsabilidad de los programadores asegurar que el búfer subyacente esté en su tiempo de vida cuando sea utilizado por un objeto
std::basic_spanbuf
. Puede ser necesaria sincronización adicional si más de un hilo opera el mismo búfer subyacente a través de diferentes objetos
std::basic_spanbuf
.
| Macro de prueba de características | Valor | Estándar | Característica |
|---|---|---|---|
__cpp_lib_spanstream
|
202106L
|
(C++23) |
std::spanbuf
,
std::spanstream
|
Véase también
|
implementa dispositivo de cadena sin formato
(plantilla de clase) |
|
|
(obsoleto en C++98)
(eliminado en C++26)
|
implementa dispositivo de array de caracteres sin formato
(clase) |