Input/output library

C++ incluye las siguientes bibliotecas de entrada/salida: una biblioteca de E/S basada en flujos de estilo OOP , familia de funciones basadas en impresión (desde C++23) , y el conjunto estándar de funciones de E/S estilo C .

Contenidos 1 E/S basada en flujos 1.1 Abstracción 1.2 Implementación de E/S de archivos 1.3 Implementación de E/S de cadenas 1.4 Implementaciones de E/S de arreglos 1.5 Salida sincronizada (desde C++20) 1.6 Typedefs 1.7 Objetos de flujo estándar predefinidos 1.8 Manipuladores de E/S 1.9 Tipos 1.10 Interfaz de categoría de error (desde C++11) 2 Funciones de impresión (desde C++23) 3 E/S estilo C 4 Véase también

E/S Basada en Flujos

La biblioteca de entrada/salida basada en flujos está organizada alrededor de dispositivos abstractos de entrada/salida. Estos dispositivos abstractos permiten que el mismo código maneje entrada/salida hacia archivos, flujos de memoria, o dispositivos adaptadores personalizados que realizan operaciones arbitrarias (ej. compresión) sobre la marcha.

La mayoría de las clases están basadas en plantillas, por lo que pueden adaptarse a cualquier tipo de carácter básico. Se proporcionan typedefs separados para los tipos de carácter básico más comunes ( char y wchar_t ). Las clases están organizadas en la siguiente jerarquía:

Abstracción
Definido en el encabezado <ios>
ios_base	gestiona banderas de formato y excepciones de entrada/salida (clase)
basic_ios	gestiona un búfer de flujo arbitrario (plantilla de clase)
Definido en el encabezado <streambuf>
basic_streambuf	abstrae un dispositivo crudo (plantilla de clase)
Definido en el encabezado <ostream>
basic_ostream	envuelve un dispositivo abstracto dado ( std::basic_streambuf ) y proporciona una interfaz de salida de alto nivel (plantilla de clase)
Definido en el encabezado <istream>
basic_istream	envuelve un dispositivo abstracto dado ( std::basic_streambuf ) y proporciona una interfaz de entrada de alto nivel (plantilla de clase)
basic_iostream	envuelve un dispositivo abstracto dado ( std::basic_streambuf ) y proporciona una interfaz de entrada/salida de alto nivel (plantilla de clase)
Implementación de E/S de archivos
Definido en el encabezado <fstream>
basic_filebuf	implementa dispositivo de archivo sin formato (plantilla de clase)
basic_ifstream	implementa operaciones de entrada de flujo de archivos de alto nivel (plantilla de clase)
basic_ofstream	implementa operaciones de salida de flujo de archivos de alto nivel (plantilla de clase)
basic_fstream	implementa operaciones de entrada/salida de flujo de archivos de alto nivel (plantilla de clase)
Implementación de E/S de cadenas
Definido en el encabezado <sstream>
basic_stringbuf	implementa dispositivo de cadena sin formato (plantilla de clase)
basic_istringstream	implementa operaciones de entrada de flujo de cadena de alto nivel (plantilla de clase)
basic_ostringstream	implementa operaciones de salida de flujo de cadena de alto nivel (plantilla de clase)
basic_stringstream	implementa operaciones de entrada/salida de flujo de cadena de alto nivel (plantilla de clase)
Implementaciones de E/S de Array
Definido en el encabezado <spanstream>
basic_spanbuf (C++23)	implementa un dispositivo de búfer de caracteres fijo sin formato (plantilla de clase)
basic_ispanstream (C++23)	implementa operaciones de entrada de búfer de caracteres fijo (plantilla de clase)
basic_ospanstream (C++23)	implementa operaciones de salida con búfer de caracteres fijo (plantilla de clase)
basic_spanstream (C++23)	implementa operaciones de entrada/salida con búfer de caracteres fijo (plantilla de clase)
Definido en el encabezado <strstream>
strstreambuf (obsoleto en C++98) (eliminado en C++26)	implementa dispositivo de array de caracteres sin formato (clase)
istrstream (obsoleto en C++98) (eliminado en C++26)	implementa operaciones de entrada de arreglos de caracteres (clase)
ostrstream (obsoleto en C++98) (eliminado en C++26)	implementa operaciones de salida de arreglos de caracteres (clase)
strstream (deprecated in C++98) (removed in C++26)	implementa operaciones de entrada/salida con arrays de caracteres (clase)
Salida sincronizada (since C++20)
Definido en el encabezado <syncstream>
basic_syncbuf (C++20)	envoltura de dispositivo de salida sincronizada (plantilla de clase)
basic_osyncstream (C++20)	envoltura de flujo de salida sincronizado (plantilla de clase)

Typedefs

Las siguientes definiciones de tipos para tipos de caracteres comunes se proporcionan en el espacio de nombres std :

Tipo	Definición
Definido en el encabezado <ios>
std::ios	std:: basic_ios < char >
std::wios	std:: basic_ios < wchar_t >
Definido en el encabezado <streambuf>
std::streambuf	std:: basic_streambuf < char >
std::wstreambuf	std:: basic_streambuf < wchar_t >
Definido en el encabezado <istream>
std::istream	std:: basic_istream < char >
std::wistream	std:: basic_istream < wchar_t >
std::iostream	std:: basic_iostream < char >
std::wiostream	std:: basic_iostream < wchar_t >
Definido en el encabezado <ostream>
std::ostream	std:: basic_ostream < char >
std::wostream	std:: basic_ostream < wchar_t >
Definido en el encabezado <fstream>
std::filebuf	std:: basic_filebuf < char >
std::wfilebuf	std:: basic_filebuf < wchar_t >
std::ifstream	std:: basic_ifstream < char >
std::wifstream	std:: basic_ifstream < wchar_t >
std::ofstream	std:: basic_ofstream < char >
std::wofstream	std:: basic_ofstream < wchar_t >
std::fstream	std:: basic_fstream < char >
std::wfstream	std:: basic_fstream < wchar_t >
Definido en el encabezado <sstream>
std::stringbuf	std:: basic_stringbuf < char >
std::wstringbuf	std:: basic_stringbuf < wchar_t >
std::istringstream	std:: basic_istringstream < char >
std::wistringstream	std:: basic_istringstream < wchar_t >
std::ostringstream	std:: basic_ostringstream < char >
std::wostringstream	std:: basic_ostringstream < wchar_t >
std::stringstream	std:: basic_stringstream < char >
std::wstringstream	std:: basic_stringstream < wchar_t >
Definido en el encabezado <spanstream>
std::spanbuf (C++23)	std:: basic_spanbuf < char >
std::wspanbuf (C++23)	std:: basic_spanbuf < wchar_t >
std::ispanstream (C++23)	std:: basic_ispanstream < char >
std::wispanstream (C++23)	std:: basic_ispanstream < wchar_t >
std::ospanstream (C++23)	std:: basic_ospanstream < char >
std::wospanstream (C++23)	std:: basic_ospanstream < wchar_t >
std::spanstream (C++23)	std:: basic_spanstream < char >
std::wspanstream (C++23)	std:: basic_spanstream < wchar_t >
Definido en el encabezado <syncstream>
std::syncbuf (C++20)	std:: basic_syncbuf < char >
std::wsyncbuf (C++20)	std:: basic_syncbuf < wchar_t >
std::osyncstream (C++20)	std:: basic_osyncstream < char >
std::wosyncstream (C++20)	std:: basic_osyncstream < wchar_t >

Objetos de flujo estándar predefinidos

Definido en el encabezado <iostream>
cin wcin	lee del flujo de entrada estándar de C stdin (objeto global)
cout wcout	escribe al flujo de salida estándar de C stdout (objeto global)
cerr wcerr	escribe al flujo de error estándar de C stderr , sin búfer (objeto global)
clog wclog	escribe al flujo de error estándar de C stderr (objeto global)

Manipuladores de E/S

La biblioteca de E/S basada en flujos utiliza manipuladores de E/S (por ejemplo, std::boolalpha , std::hex , etc.) para controlar el comportamiento de los flujos.

Tipos

Se definen los siguientes tipos auxiliares:

Definido en el encabezado <ios>
streamoff	representa la posición relativa de archivo/flujo (desplazamiento desde fpos), suficiente para representar cualquier tamaño de archivo (typedef)
streamsize	representa el número de caracteres transferidos en una operación de E/S o el tamaño de un búfer de E/S (typedef)
fpos	representa posición absoluta en un flujo o archivo (class template)

Se proporcionan los siguientes nombres typedef para std:: fpos < std:: mbstate_t > :

Definido en el encabezado <iosfwd>
Tipo	Definición
std::streampos	std:: fpos < std:: char_traits < char > :: state_type >
std::wstreampos	std:: fpos < std:: char_traits < wchar_t > :: state_type >
std::u8streampos (C++20)	std:: fpos < std:: char_traits < char8_t > :: state_type >
std::u16streampos (C++11)	std:: fpos < std:: char_traits < char16_t > :: state_type >
std::u32streampos (C++11)	std:: fpos < std:: char_traits < char32_t > :: state_type >

Interfaz de categoría de error (desde C++11)

Definido en el encabezado <ios>
io_errc (C++11)	los códigos de error de flujo de E/S (enum)
iostream_category (C++11)	identifica la categoría de error de iostream (función)

Funciones de impresión (desde C++23)

Las funciones de la familia print con soporte Unicode que realizan E/S formateada en texto que ya está formateado. Ofrecen todos los beneficios de rendimiento de std::format , son independientes de la configuración regional por defecto, reducen el estado global, evitan la asignación de un objeto temporal std::string y la llamada a operator << , y en general hacen que el formateo sea más eficiente en comparación con iostreams y stdio .

Se proporcionan las siguientes funciones similares a impresión:

Definido en el encabezado <print>
print (C++23)	imprime en stdout o un flujo de archivo usando representación formateada de los argumentos (plantilla de función)
println (C++23)	igual que std::print excepto que cada impresión termina con una nueva línea adicional (plantilla de función)
vprint_unicode vprint_unicode_buffered (C++23)	imprime en stdout o un flujo de archivo compatible con Unicode usando representación de argumentos con borrado de tipo (función)
vprint_nonunicode vprint_nonunicode_buffered (C++23)	imprime en stdout o un flujo de archivo usando representación de argumentos con borrado de tipo (función)
Definido en el encabezado <ostream>
print (std::ostream) (C++23)	genera representación formateada de los argumentos (plantilla de función)
println (std::ostream) (C++23)	genera representación formateada de los argumentos con ' \n ' añadido (plantilla de función)

E/S estilo C

C++ también incluye las funciones de entrada/salida definidas por C , como std::fopen , std::getc , etc.

Véase también

Biblioteca del sistema de archivos (desde C++17)