_cputs, _cputws
Met une chaine 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 avec /ZW.
int _cputs(
const char *str
);
int _cputws(
const wchar_t *str
);
Paramètres
- str
Chaîne de sortie.
Valeur de retour
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 terminée par le caractère NULL qui est désignée par str directement à la console. Une combinaison chariot de ligne de retour (CR-LF) n'est pas automatiquement annexé à la chaine.
Cette fonction valide son paramètre. Si str est NULLValidation de paramètre. Si l'exécution est autorisée à se poursuivre, errno est défini à la valeur EINVAL et -1 est retourné.
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 |
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 sur la compatibilité, consultez Compatibilité.
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 );
}
Sortie
Hello world (courtesy of _cputs)!
Hello world (courtesy of _cputws)!