puts, _putwsputs, _putws

Écrit une chaîne dans stdout.Writes a string to stdout.

SyntaxeSyntax

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

ParamètresParameters

strstr
Chaîne de sortie.Output string.

Valeur de retourReturn Value

Retourne une valeur non négative si l’opération aboutit.Returns a nonnegative value if successful. Si put échoue, elle retourne EOF; Si _putws échoue, elle retourne WEOF.If puts fails, it returns EOF; if _putws fails, it returns WEOF. Si Str est un pointeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans validation de paramètre.If str is a null pointer, the invalid parameter handler is invoked, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, les fonctions définissent errno sur EINVAL et retournent EOF ou WEOF.If execution is allowed to continue, the functions set errno to EINVAL and return EOF or WEOF.

Pour plus d’informations sur ces codes d’erreur et les autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.For information on these and other error codes, see _doserrno, errno, _sys_errlist, and _sys_nerr.

NotesRemarks

La fonction put écrit Str dans le flux de sortie standard stdout, en remplaçant le caractère null de fin de la chaîne (' \ 0 ') par un caractère de saut de ligne (' \n') dans le flux de sortie.The puts function writes str to the standard output stream stdout, replacing the string's terminating null character ('\0') with a newline character ('\n') in the output stream.

_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._putws is the wide-character version of puts; the two functions behave identically if the stream is opened in ANSI mode. put ne prend pas actuellement en charge la sortie dans un flux Unicode.puts doesn't currently support output into a UNICODE stream.

_putwch écrit des caractères Unicode en utilisant les paramètres régionaux actuels de la console._putwch writes Unicode characters using the current CONSOLE LOCALE setting.

Mappages de routines de texte génériqueGeneric-Text Routine Mappings

Routine TCHAR.HTCHAR.H routine _UNICODE et _MBCS non définis_UNICODE & _MBCS not defined _MBCS défini_MBCS defined _UNICODE défini_UNICODE defined
_putts_putts putsputs putsputs _putws_putws

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
putsputs <stdio.h><stdio.h>
_putws_putws <stdio.h><stdio.h>

La console n’est pas prise en charge dans les applications de plateforme Windows universelle (UWP).The console is not supported in Universal Windows Platform (UWP) apps. Les handles de flux standard associés à la console, stdin, stdoutet stderr, doivent être redirigés pour que les fonctions runtime C puissent les utiliser dans les applications UWP.The standard stream handles that are associated with the console, stdin, stdout, and stderr, must be redirected before C run-time functions can use them in UWP apps. Pour plus d'informations sur la compatibilité, voir Compatibilité.For additional compatibility information, see Compatibility.

BibliothèquesLibraries

Toutes les versions des bibliothèques Runtime C.All versions of the C run-time libraries.

ExempleExample

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

SortieOutput

Hello world from puts!

Voir aussiSee also

E/S de fluxStream I/O
fputs, fputwsfputs, fputws
fgets, fgetwsfgets, fgetws