std::basic_osyncstream

 

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 E/S

Manipuladores de E/S

E/S estilo C

Búferes

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (en desuso en C++98)

basic_syncbuf (C++20)

Flujos

Abstracciones

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

E/S de archivos

basic_ifstream

basic_ofstream

basic_fstream

E/S de cadenas

basic_istringstream

basic_ostringstream

basic_stringstream

E/S de arrays

istrstream (en desuso en C++98)

ostrstream (en desuso en C++98)

strstream (en desuso en C++98)

Salida sincronizada

basic_osyncstream (C++20)

Tipos

streamoff

streamsize

fpos

Interfaz de categoría de error

iostream_category (C++11)

io_errc (C++11)

 

std::basic_osyncstream

Funciones miembro públicas

basic_osyncstream::basic_osyncstream

basic_osyncstream::operator=

basic_osyncstream::~basic_osyncstream

basic_osyncstream::rdbuf

basic_osyncstream::get_wrapped

basic_osyncstream::emit

 

<tbody> </tbody>

Definido en el archivo de encabezado <syncstream>
template< class CharT, class Traits = std::char_traits<CharT>, class Allocator = std::allocator<CharT> > class basic_osyncstream: public std::basic_ostream<CharT, Traits>		(desde C++20)

See More

La plantilla de clase std::basic_osyncstream es un contenedor conveniente para std::basic_syncbuf. Proporciona un mecanismo para sincronizar hilos que escriben en el mismo flujo.

Se puede usar con una variable nombrada:

{
    std::osyncstream synced_out(std::cout); // envoltorio sincronizado para std::cout
    synced_out << "¡Hola, ";
    synced_out << "mundo!";
    synced_out << std::endl; // se anota la descarga, pero aún no se ha realizado
    synced_out << "¡y más!\n";
} // los caracteres se transfieren y std::cout se descarga

así como con un temporal:

std::osyncstream(std::cout) << "¡Hola, " << "mundo!" << '\n';

Proporciona la garantía de que todos los resultados realizados en el mismo búfer de destino final (std::cout en los ejemplos anteriores) estarán libres de carreras de datos y no se intercalarán ni distorsionarán de ninguna manera, siempre que cada escritura en ese búfer de destino final se cree a través de instancias (posiblemente diferentes) de std::basic_osyncstream.

La implementación típica de std::basic_osyncstream contiene solo un miembro: el std::basic_syncbuf envuelto.

Inheritance diagram

También se definen dos especializaciones para tipos de caracteres comunes:

Definido en el archivo de encabezado <syncstream>
Tipo	Definición
osyncstream	basic_osyncstream<char>
wosyncstream	basic_osyncstream<wchar_t>

Tipos miembro

Tipo 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
streambuf_type	std::basic_streambuf<CharT, Traits>
syncbuf_type	std::basic_syncbuf<CharT, Traits, Allocator>

Funciones miembro

(constructor)	Construye un objeto basic_osyncstream. (función miembro pública)
operator=	Asigna un objeto basic_osyncstream. (función miembro pública)
(destructor)	Destruye el objeto basic_osyncstream y emite su búfer interno. (función miembro pública)
rdbuf	Obtiene un puntero al objeto basic_syncbuf subyacente. (función miembro pública)
get_wrapped	Obtiene un puntero al búfer del flujo de destino final. (función miembro pública)
emit	Llama a emit en el objeto basic_syncbuf subyacente para transmitir sus datos internos al destino final. (función miembro pública)

Heredado de std::basic_ostream

Funciones miembro

Salida con formato
operator<<	Inserta datos con formato. (función miembro pública de std::basic_ostream<CharT,Traits>)
Salida sin formato
put	Inserta un carácter. (función miembro pública de std::basic_ostream<CharT,Traits>)
write	Inserta un bloque de caracteres. (función miembro pública de std::basic_ostream<CharT,Traits>)
Posicionamiento
tellp	Devuelve el indicador de la posición de salida. (función miembro pública de std::basic_ostream<CharT,Traits>)
seekp	Establece el indicador de la posición de salida. (función miembro pública de std::basic_ostream<CharT,Traits>)
Misceláneas
flush	(función miembro pública de std::basic_ostream<CharT,Traits>)

Clases miembro

sentry

Implementa lógica básica para la preparación de las operaciones de salida del flujo. (clase miembro pública de std::basic_ostream<CharT,Traits>)

Heredado de std::basic_ios

Tipos miembro

Tipo miembro	Definición
char_type	CharT
traits_type	Traits
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Funciones miembro

Funciones de estado
good	Verifica si no ha ocurrido ningún error; es decir, las operaciones de E/S se encuentran disponibles. (función miembro pública de std::basic_ios<CharT,Traits>)
eof	Verifica si se ha alcanzado el fin de archivo. (función miembro pública de std::basic_ios<CharT,Traits>)
fail	Verifica si ha ocurrido un error. (función miembro pública de std::basic_ios<CharT,Traits>)
bad	Verifica si ha ocurrido un error irrecuperable. (función miembro pública de std::basic_ios<CharT,Traits>)
operator!	Verifica si ha ocurrido un error (sinónimo de std::basic_ios::fail). (función miembro pública de std::basic_ios<CharT,Traits>)
operator void*operator bool (hasta C++11)(desde C++11)	Verifica si no se ha producido ningún error (sinónimo de !fail()). (función miembro pública de std::basic_ios<CharT,Traits>)
rdstate	Devuelve los indicadores de estado. (función miembro pública de std::basic_ios<CharT,Traits>)
setstate	Establece los indicadores de estado. (función miembro pública de std::basic_ios<CharT,Traits>)
clear	Modifica indicadores de estado. (función miembro pública de std::basic_ios<CharT,Traits>)
Formato
copyfmt	Copia información de formato. (función miembro pública de std::basic_ios<CharT,Traits>)
fill	Gestiona el carácter de relleno. (función miembro pública de std::basic_ios<CharT,Traits>)
Misceláneas
exceptions	Gestiona la máscara de excepciones. (función miembro pública de std::basic_ios<CharT,Traits>)
imbue	Establece la configuración regional. (función miembro pública de std::basic_ios<CharT,Traits>)
rdbuf	Gestiona el búfer del flujo asociado. (función miembro pública de std::basic_ios<CharT,Traits>)
tie	Gestiona el flujo enlazado. (función miembro pública de std::basic_ios<CharT,Traits>)
narrow	Estrecha caracteres. (función miembro pública de std::basic_ios<CharT,Traits>)
widen	Ensancha caracteres. (función miembro pública de std::basic_ios<CharT,Traits>)

Heredado de std::ios_base

Funciones miembro

Formato
flags	Gestiona los indicadores de formato. (función miembro pública de std::ios_base)
setf	Establece un indicador de formato específico. (función miembro pública de std::ios_base)
unsetf	Borra el indicador de formato específico. (función miembro pública de std::ios_base)
precision	Gestiona la precisión decimal de las operaciones de punto flotante. (función miembro pública de std::ios_base)
width	Gestiona la anchura de campo. (función miembro pública de std::ios_base)
Configuración regional
imbue	Establece la configuración regional. (función miembro pública de std::ios_base)
getloc	Devuelve la configuración regional actual. (función miembro pública de std::ios_base)
Array extensible interno
xalloc [estático]	Devuelve un entero único para todo el programa que es seguro de usar como índice para pword() e iword() (función miembro estática pública de std::ios_base)
iword	Cambia el tamaño del almacenamiento privado si es necesario y accede al elemento long en el índice dado. (función miembro pública de std::ios_base)
pword	Cambia el tamaño del almacenamiento privado si es necesario y el acceso al elemento void* en el índice dado. (función miembro pública de std::ios_base)
Misceláneas
register_callback	Registra la función de devolución de llamada de un evento. (función miembro pública de std::ios_base)
sync_with_stdio [estático]	Establece si las bibliotecas de E/S de C++ y de C son interoperables. (función miembro estática pública de std::ios_base)
Clases miembro
failure	Excepción de flujo. (clase miembro pública de std::ios_base)
Init	Inicializa los objetos flujo estándar. (clase miembro pública de std::ios_base)

Tipos miembro y constantes
Tipo	Explicación
openmode	Tipo del modo de apertura del flujo. También se definen las siguientes constantes: Constante Explicación app Busca hasta al final del flujo antes de cada escritura. binary Abrir en modo binario. in Abrir para lectura. out Abrir para escritura. trunc Descartar el contenido del flujo al abrir. ate Busca hasta al final del flujo inmediatamente después de abrirlo. noreplace (C++23) Abrir en modo exclusivo. (typedef)
fmtflags	Tipo de los indicadores de formato. También se definen las siguientes constantes: Constante Explicación dec Usar base decimal para E/S de enteros. Véase std::dec. oct Usar base octal para E/S de enteros. Véase std::oct. hex Usar base hexadecimal para E/S de enteros. Véase std::hex. basefield dec|oct|hex. Útil para operaciones de enmascaramiento. left Ajuste a la izquierda (agrega caracteres de relleno a la derecha). Véase std::left. right Ajuste a la derecha (agrega caracteres de relleno a la izquierda). Véase std::right. internal Ajuste interno (agrega caracteres de relleno al punto interno designado). Véase std::internal. adjustfield left|right|internal. Útil para operaciones de enmascaramiento. scientific Generar tipos de punto flotante usando notación científica, o notación hexadecimal si se combina con fixed. Véase std::scientific. fixed Generar tipos de punto flotante usando notación fija o notación hexadecimal si se combina con scientific. Véase std::fixed. floatfield scientific|fixed. Útil para operaciones de enmascaramiento. boolalpha Insertar y extraer el tipo bool en formato alfanumérico. Véase std::boolalpha. showbase Generar un prefijo indicando la base numérica para salida de enteros. Requiere el indicador de moneda en E/S monetaria. Véase std::showbase. showpoint Generar un carácter de punto decimal incondicionalmente para salida de números de punto flotante. Véase std::showpoint. showpos Generar un carácter + para salida numérica no negativa. Véase std::showpos. skipws Omitir los espacios en blanco iniciales antes de ciertas operaciones de entrada. Véase std::skipws. unitbuf Descargar la salida después de cada operación de salida. Véase std::unitbuf. uppercase Reemplazar ciertas letras minúsculas con sus equivalentes en mayúsculas en ciertas operaciones de salida. Véase std::uppercase. (typedef)
iostate	Estado del tipo de flujo. También se definen las siguientes constantes: Constante Explicación goodbit No hay error. badbit Error de flujo no recuperable. failbit Operación de entrada/salida fallida (error de formateo o extracción). eofbit La secuencia de entrada asociada ha alcanzado el fin de archivo. (typedef)
seekdir	El tipo de la dirección de búsqueda. También se definen las siguientes constantes: Constante Explicación beg El comienzo de un flujo. end El final de un flujo cur La posición actual del indicador de posición del flujo (typedef)
event	Especifica el tipo de evento. (enum)
event_callback	Tipo de la función de devolución de llamada. (typedef)