std:: basic_stringbuf
|
Definido en el encabezado
<sstream>
|
||
|
template
<
class
CharT,
|
||
std::basic_stringbuf
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::basic_string
.
Las implementaciones típicas de
std::basic_stringbuf
mantienen un objeto de tipo
std::basic_string
o un contenedor de secuencia redimensionable equivalente directamente como miembro de datos y lo utilizan tanto como la secuencia de caracteres controlada (el array donde apuntan los seis punteros de
std::basic_streambuf
) como la secuencia de caracteres asociada (la fuente de caracteres para todas las operaciones de entrada y el destino para la salida).
Además, una implementación típica contiene un miembro de datos de tipo std::ios_base::openmode para indicar el modo de E/S del flujo asociado (solo entrada, solo salida, entrada/salida, al final, etc.).
|
Si se utiliza la estrategia de sobreasignación en overflow() , se puede almacenar un puntero adicional de marca de agua alta para rastrear el último carácter inicializado. |
(since C++11) |
Se proporcionan varios typedefs para tipos de caracteres comunes:
|
Definido en el encabezado
<sstream>
|
|
| Tipo | Definición |
std::stringbuf
|
std :: basic_stringbuf < char > |
std::wstringbuf
|
std :: basic_stringbuf < 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
|
allocator_type
|
Allocator
|
Miembros solo de exposición
buf
|
el
std::
basic_string
<
CharT, Traits, Allocator
>
utilizado como búfer subyacente
( objeto miembro solo para exposición* ) |
mode
|
el
std::ios_base::openmode
del flujo asociado
( objeto miembro solo para exposición* ) |
|
inicializa las secuencias de entrada y salida
( función miembro solo para exposición* ) |
Funciones miembro públicas
construye un objeto
basic_stringbuf
(función miembro pública) |
|
|
(C++11)
|
asigna un objeto
basic_stringbuf
(función miembro pública) |
|
(C++11)
|
intercambia dos objetos
basic_stringbuf
(función miembro pública) |
|
(destructor)
[virtual]
(implicitly declared)
|
destruye un objeto
basic_stringbuf
y la cadena que contiene
(función miembro pública virtual) |
|
reemplaza u obtiene una copia de la cadena de caracteres asociada
(función miembro pública) |
|
|
(C++20)
|
obtiene una copia del asignador de memoria asociado con el contenedor de secuencia interno
(función miembro pública) |
|
(C++20)
|
obtiene una vista sobre la secuencia de caracteres subyacente
(función miembro pública) |
Funciones miembro protegidas
|
[virtual]
|
devuelve el siguiente carácter disponible en la secuencia de entrada
(función miembro protegida virtual) |
|
[virtual]
|
devuelve un carácter a la secuencia de entrada
(función miembro protegida virtual) |
|
[virtual]
|
añade un carácter a la secuencia de salida
(función miembro protegida virtual) |
|
[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++11)
|
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) |
Configuraciones Regionales |
|
|
[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>
)
|