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. En puts cas d’échec, elle retourne EOF; en _putws cas d’échec, elle retourne WEOF. S’il str s’agit d’un pointeur Null, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. 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 d’erreur et d’autres codes d’erreur, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

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 routine de texte générique

Routine TCHAR.H	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_putts	puts	puts	_putws

Spécifications

Routine	En-tête requis
puts	<stdio.h>
_putws	<stdio.h>

La console n’est pas prise en charge dans les applications plateforme Windows universelle (UWP). Les handles de flux standard associés à la console, stdinet stdoutstderrdoivent être redirigés avant que les fonctions d’exécution 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