_cputs, _cputws

Article
03/12/2013

Place une chaîne dans la console.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /ZW.

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

Paramètres

str
Output la chaîne.

Valeur de retour

En cas de réussite, retourne 0 d' _cputs .Si la fonction échoue, elle retourne une valeur différente de zéro.

Notes

La fonction d' _cputs écrit la chaîne terminée par le caractère NULL qui est pointée pointe vers str directement dans la console.Un mélange de la puissance de retour- ligne de chariot (CR-LF) n'est pas automatiquement ajouté à la chaîne.

Cette fonction valide paramètre.Si str est null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errno a la valeur EINVAL et -1 est retourné.

Mappages de routines de texte générique

Routine de Tchar.h	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_cputts	_cputs	_cputs	_cputws

Configuration requise

Routine	En-tête requis	En-tête facultatif
_cputs	<conio.h>	<errno.h>
_cputws	<conio.h>	<errno.h>

Pour plus d'informations de compatibilité, consultez Compatibilité.

Bibliothèques

Toutes les versions d' Bibliothèques runtime C.

Exemple

// 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 );
}

Sortie

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

Voir aussi

Référence

E/S de console et de port

_putch, _putwch

Partager via