Se recomienda usar Visual Studio 2017

<iostream>

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Declara los objetos que controlan la lectura y escritura en los flujos estándar. Suele ser el único encabezado que es necesario incluir para realizar la entrada y salida de un programa de C++.

#include <iostream>  
  

Los objetos se dividen en dos grupos:

  • CIN, cout, cerr, y colapse son byte orientada a servicios, realizar transferencias de bytes en vez de convencionales.

  • wcin, wcout, wcerr, y wclog se amplia orientación, traducir a y desde los caracteres anchos que el programa se manipula internamente.

Tras realizar determinadas operaciones en un flujo, como la entrada estándar, no es posible realizar operaciones de orientación en ese mismo flujo. Por lo tanto, un programa no puede funcionar indistintamente en ambos cin y wcin, por ejemplo.

Todos los objetos declaran en este recurso compartido de encabezado de una propiedad peculiar, se puede suponer que se construyen antes de todos los objetos estáticos definen en una unidad de traducción que incluye <> </> >. De igual forma, se puede suponer que estos objetos no se destruyen antes que los destructores de todos esos objetos estáticos que se definen. (Sin embargo, los flujos de salida se vacían durante la finalización del programa). Por lo tanto, puede leer o escribir sin ningún riesgo en los flujos estándar antes de iniciar el programa y después de la finalización del programa.

Pero esta garantía no es universal. Un constructor estático puede llamar a una función en otra unidad de traducción. La función a la que se llama no puede suponer que se han construido los objetos que se declaran en el encabezado, dada la incertidumbre del orden con el que las unidades de traducción participan en la construcción estática. Para utilizar estos objetos en este contexto, primero debe construir un objeto de clase ios_base:: init.

Objetos de flujo global

CerrEspecifica el flujo global cerr.
CINEspecifica el flujo global cin.
CLOGEspecifica el flujo global clog.
coutEspecifica el flujo global cout.
wcerrEspecifica el flujo global wcerr.
wcinEspecifica el flujo global wcin.
wclogEspecifica el flujo global wclog.
wcoutEspecifica el flujo global wcout.

Cerr

El objeto cerr controla la salida a un búfer de la secuencia asociada al objeto stderr, declarado en <> </> >.

extern ostream cerr;  

Valor devuelto

Un ostream objeto.

Comentarios

El objeto controla las inserciones no almacenado en búfer a la salida de error estándar como una secuencia de bytes. Una vez que se construye el objeto, la expresión cerr. marcas & unitbuf es distinto de cero, y cerr.tie() == &cout.

Ejemplo

// iostream_cerr.cpp  
// compile with: /EHsc  
#include <iostream>  
#include <fstream>  
  
using namespace std;  
  
void TestWide( )   
{  
   int i = 0;  
   wcout << L"Enter a number: ";  
   wcin >> i;  
   wcerr << L"test for wcerr" << endl;  
   wclog << L"test for wclog" << endl;     
}  
  
int main( )   
{  
   int i = 0;  
   cout << "Enter a number: ";  
   cin >> i;  
   cerr << "test for cerr" << endl;  
   clog << "test for clog" << endl;  
   TestWide( );  
}  

CIN

Especifica el flujo global cin.

extern istream cin;  

Valor devuelto

Un istream objeto.

Comentarios

El objeto controla extracciones desde la entrada estándar como una secuencia de bytes. Una vez que se construye el objeto, la llamada cin. tie devuelve & cout.

Ejemplo

En este ejemplo, cin establece el error en la secuencia de bits cuando encuentra caracteres no numéricos. El sistema borra el bit de error y quita el carácter no válido de la secuencia para continuar.

// iostream_cin.cpp  
// compile with: /EHsc  
#include <iostream>  
using namespace std;  
  
int main()  
{  
   int x;  
   cout << "enter choice:";  
   cin >> x;  
   while (x < 1 || x > 4)  
   {  
      cout << "Invalid choice, try again:";  
      cin >> x;  
      // not a numeric character, probably  
      // clear the failure and pull off the non-numeric character  
      if (cin.fail())  
      {  
         cin.clear();  
         char c;  
         cin >> c;  
      }  
   }  
}  

CLOG

Especifica el flujo global clog.

extern ostream clog;  

Valor devuelto

Un ostream objeto.

Comentarios

Los controles de objeto almacenado en búfer las inserciones a la salida de error estándar como una secuencia de bytes.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de clog.

cout

Especifica el flujo global cout.

extern ostream cout;  

Valor devuelto

Un ostream objeto.

Comentarios

El objeto controla las inserciones en la salida estándar como una secuencia de bytes.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de cout.

wcerr

Especifica el flujo global wcerr.

extern wostream wcerr;  

Valor devuelto

Un wostream objeto.

Comentarios

El objeto controla las inserciones no almacenado en búfer a la salida de error estándar como una secuencia amplia. Una vez que se construye el objeto, la expresión wcerr. marcas & unitbuf es distinto de cero.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de wcerr.

wcin

Especifica el flujo global wcin.

extern wistream wcin;  

Valor devuelto

Un wistream objeto.

Comentarios

El objeto controla extracciones desde la entrada estándar como una secuencia amplia. Una vez que se construye el objeto, la llamada wcin. tie devuelve & wcout.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de wcin.

wclog

Especifica el flujo global wclog.

extern wostream wclog;  

Valor devuelto

Un wostream objeto.

Comentarios

Los controles de objeto almacenado en búfer las inserciones a la salida de error estándar como una secuencia amplia.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de wclog.

wcout

Especifica el flujo global wcout.

extern wostream wcout;  

Valor devuelto

Un wostream objeto.

Comentarios

El objeto controla las inserciones en la salida estándar como secuencia amplia.

Ejemplo

Consulte cerr para obtener un ejemplo del uso de wcout.

Las instancias CString de una instrucción wcout deben convertirse a const wchar_t*, como se muestra en el siguiente ejemplo.

 
    CString cs("meow");

    wcout <<(const wchar_t*) cs <<endl;  

Para obtener más información, consulte operaciones básicas de CString.

Referencia de archivos de encabezado
Seguridad para subprocesos en la biblioteca estándar de C++
iostream de programación
Convenciones de iostreams

Mostrar: