_cputs, _cputws

Escribe una cadena en la consola.

Importante
Esta API no se puede utilizar en las aplicaciones que se ejecutan en Windows en tiempo de ejecución.Para obtener más información, vea Funciones CRT no compatibles con /ZW.

int _cputs(  const char *str ); int _cputws( const wchar_t *str );

Parámetros

• str
  Cadena de salida.

Valor devuelto

Si es correcto, _cputs devuelve 0.Si se produce un error en la función, devuelve un valor distinto de cero.

Comentarios

La función de _cputs escribe la cadena terminada en null notificada por a str directamente en la consola.Una combinación de fuente de la retorno- línea de carro (CR-LF) automáticamente no se anexa a la cadena.

Esta función valida su parámetro.Si str es nulo, se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, errno se establece en EINVAL y se devuelve -1.

Asignaciones de la rutina de Genérico- texto

Rutina de Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_cputts	_cputs	_cputs	_cputws

Requisitos

Rutina	Encabezado necesario	Encabezado opcional
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Para obtener más información de compatibilidad, vea Compatibilidad.

Bibliotecas

Todas las versiones de Bibliotecas en tiempo de ejecución de C.

Ejemplo

// crt_cputs.c
// compile with: /c
// This program first displays a string to the console.


#include <conio.h>
#include <errno.h>

void print_to_console(char* buffer)
{
   int retval;
   retval = _cputs( buffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputs( "Invalid buffer in print_to_console.\r\n");
       }
       else
         _cputs( "Unexpected error in print_to_console.\r\n");
   }
}


void wprint_to_console(wchar_t* wbuffer)
{
   int retval;
   retval = _cputws( wbuffer );
   if (retval)
   {
       if (errno == EINVAL)
       {
         _cputws( L"Invalid buffer in wprint_to_console.\r\n");
       }
       else
         _cputws( L"Unexpected error in wprint_to_console.\r\n");
   }
}

int main()
{
  
   // String to print at console. 
   // Notice the \r (return) character. 
   char* buffer = "Hello world (courtesy of _cputs)!\r\n";
   wchar_t *wbuffer = L"Hello world (courtesy of _cputws)!\r\n";
   print_to_console(buffer);
   wprint_to_console( wbuffer );
}

Output

Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!

Vea también

Referencia

E/S de la consola y de puerto

_putch, _putwch