fputs, fputws

Écrit une chaîne dans un flux.

Syntaxe

int fputs(
   const char *str,
   FILE *stream
);
int fputws(
   const wchar_t *str,
   FILE *stream
);

Paramètres

str
Chaîne de sortie.

stream
Pointeur vers la structure FILE .

Valeur retournée

Chacune de ces fonctions retourne une valeur non négative si elle réussit. En cas d’erreur, fputs et fputws retournent EOF. Si str ou stream est un pointeur Null, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à continuer, ces fonctions sont définies errno sur EINVAL et retournent EOF.

Pour plus d’informations sur les codes d’erreur, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Notes

Chacune de ces fonctions copie str vers la sortie stream à la position actuelle. fputws copie l’argument str de caractère large sous stream la forme d’une chaîne de caractères multioctets ou d’une chaîne à caractères larges lorsqu’elle stream est ouverte en mode texte ou en mode binaire, respectivement. Aucune fonction ne copie le caractère Null de fin.

Les deux fonctions se comportent de la même façon si le flux est ouvert en mode ANSI. fputs ne prend pas en charge la sortie vers un flux UNICODE pour l’instant.

Par défaut, l’état global de cette fonction est limité à l’application. Pour le modifier, consultez l’é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 consolestdin , stdoutet stderrdoivent être redirigés avant que les fonctions runtime C puissent les utiliser dans les applications UWP. Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}

Hello world from fputs.

Voir aussi

E/S de flux
fgets, fgetws
gets, _getws
puts, _putws