puts, _putws
Écrit une chaîne dans stdout.
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Paramètres
- str
Chaîne de sortie.
Valeur de retour
Retourne une valeur positive en cas de succès. Si puts échoue, il retourne EOF; si _putws échoue, il retourne WEOF. Si str est un pointeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction définit errno à la valeur EINVAL et retourne EOF ou WEOF.
Pour plus d'informations sur ces codes d'erreur et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.
Notes
La fonction puts écrit str dans le flux de sortie standard stdout, en remplaçant le caractère null de fin de la chaîne ("\0 ") avec un caractère de saut de ligne ("\n ") dans le flux de sortie.
_putws est la version à caractères élargis de puts; les deux fonctions se comportent de la même manière si le flux est ouvert en mode ANSI. puts ne prend pas en charge actuellement la sortie dans un flux UNICODE.
Sous Windows 2000 et versions ultérieures, _putwch écrit les caractères Unicode à l'aide des paramètres régionaux de CONSOLE.
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Configuration requise
Routine |
En-tête requis |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
La console n'est pas prise en charge dans les applications Windows Store . Les handles de flux standard associés à la console, stdin, stdout et stderr doivent être redirigés pour que les fonctions runtime C puissent les utiliser dans les applications Windows Store . Pour plus d'informations sur la compatibilité, consultez Compatibilité.
Bibliothèques
Toutes les versions des bibliothèques Runtime C.
Exemple
// crt_puts.c
/* This program uses puts to write a string to stdout.
*/
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Sortie
Hello world from puts!