fputs, fputws

Article
03/26/2013

Entrez une chaîne dans un flux.

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

Paramètres

str
Output la chaîne.
stream
Pointeur vers la structure d' FILE .

Valeur de retour

Chacune de ces fonctions retourne une valeur négative s'il est réussi.Sur une erreur, fputs retourne EOF, et retourne WEOFd' fputws .Si str ou stream est un pointeur null, ces fonctions appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, ces errno défini par fonctions à EINVAL et EOF de retour ou WEOF.

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

Notes

Chacune de ces fonctions des copies str à la sortie stream à la position actuelle.fputws copie l'argument à caractère élargi str à stream comme une chaîne de caractères multioctets ou chaîne à caractères larges selon qu' stream est ouvert en mode texte ou le mode binaire, respectivement.Aucune ne fonctionnent copiez le caractère NULL de fin.

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

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_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 d' Windows Store .Les handles standard de flux de données associés à la console, stdin, stdout, et stderr, doivent être redirigés pour que les fonctions runtime C peuvent les utiliser dans des applications d' Windows Store .Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

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