Partager via

_cputs, _cputws

  • Article

Place une chaîne dans la console.

Important

Cette API ne peut pas être utilisée dans les applications qui s’exécutent dans le Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.

Syntaxe

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

Paramètres

str
Chaîne de sortie.

Valeur retournée

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

Notes

La fonction _cputs écrit la chaîne se terminant par null que str indique directement à la console. Une combinaison de saut de ligne de retour chariot (CR-LF) n’est pas ajoutée automatiquement à la chaîne.

Cette fonction valide son paramètre. Si str a la valeur NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à continuer, errno est définie EINVALsur , et -1 est retourné.

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Mappages de routines de texte générique

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

Spécifications

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

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des 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 );
}

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

Voir aussi

Console et port d’entrée/sortie (E/S)
_putch, _putwch