puts, _putws

Écrit une chaîne dans stdout.

Syntaxe

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Paramètres

str
Chaîne de sortie.

Valeur retournée

Retourne une valeur non négative si l’opération aboutit. Si puts échoue, la valeur EOF est retournée ; si _putws échoue, la valeur WEOF est retournée. 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 à continuer, les fonctions définies errno sur EINVAL et renvoyées EOF ou WEOF.

Pour plus d’informations sur ces codes et d’autres codes d’erreur, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

Notes

La puts fonction écrit str dans le flux stdoutde sortie standard, en remplaçant le caractère null de fin de la chaîne ('\0') par un caractère de nouvelle ligne ('\n') dans le flux de sortie.

_putws est la version à caractères larges 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 la sortie vers un flux UNICODE pour l’instant.

_putwch écrit des caractères Unicode à l’aide du paramètre local console actuel.

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

Spécifications

La console n’est pas prise en charge dans les applications de la plateforme Windows universelle (UWP). Les handles de flux standard associés à la console (stdin, stdout et stderr) doivent être redirigés pour que les fonctions de runtime C puissent les utiliser dans les applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.

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!

Voir aussi

E/S de flux
fputs, fputws
fgets, fgetws