fputs, fputws

Article
06/09/2015

Écrit une chaîne dans un flux.

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 de retour

Chacune de ces fonctions retourne une valeur non négative s'il est réussi. En cas d'erreur, fputs et fputws retournent EOF. Si str ou stream est un pointeur null, ces fonctions invoquent le gestionnaire de paramètres non valides, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions définissent errno avec la valeur EINVAL et puis fputs retourne EOF, et fputws retourne WEOF.

Consultez _doserrno, errno, _sys_errlist et _sys_nerr pour plus d'informations sur ces éléments et autres codes d'erreur.

Notes

Chacune de ces fonctions copie str dans le stream de sortie à la position actuelle. fputws copie l'argument à caractère large str à stream comme une chaîne de caractères multi-octets ou chaîne à caractères larges selon que stream est ouvert en mode texte ou en mode binaire, respectivement. Aucune fonction ne copie le caractère nul de fin.

Ces deux fonctions se comportent de la même façon si le flux est ouvert en mode ANSI. fputs ne prend pas en charge actuellement la sortie dans un flux UNICODE.

Mappages de routines de texte générique

Routine TCHAR.H	_UNICODE & _MBCS non définis	_MBCS défini	_UNICODE défini
_fputts	fputs	fputs	fputws

Configuration requise

Fonction	En-tête requis
fputs	<stdio.h>
fputws	<stdio.h> ou <wchar.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é.

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 );
}