fputs, fputws

Článek
06/09/2015

Zapíše řetězec do datového proudu.

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

Parametry

str
Výstupní řetězec.
stream
Ukazatel na strukturu FILE.

Vrácená hodnota

Každá z těchto funkcí vrací nezáporné hodnoty, pokud je úspěšné.On an error, fputs and fputws return EOF.Pokud str nebo stream je nulový ukazatel, tyto funkce vyvolat obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění chcete-li pokračovat, tyto funkce set errno k EINVAL a fputs vrátí EOF, a fputws vrátí WEOF.

Další informace o těchto a dalších chybových kódech viz _doserrno, errno, _sys_errlist, and _sys_nerr.

Poznámky

Každá z těchto funkcí kopie str na výstup stream na aktuální pozici.fputwszkopíruje celý znak argument str k stream jako vícebajtové znakové řetězce nebo jako řetězec širokého znaku podle zda stream je otevřen v textu nebo binárním režimu, v uvedeném pořadí.Žádná funkce kopíruje ukončující znak null.

Tyto dvě funkce se chovají stejně jako v případě, že datový proud je otevřen v režimu ANSI.fputs aktuálně nepodporuje výstup v proudu UNICODE.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_fputts	fputs	fputs	fputws

Požadavky

Funkce	Požadované záhlaví
fputs	<stdio.h>
fputws	<stdio.h> nebo <wchar.h>

Konzola není v aplikacích Windows Store podporována.Standardní datový proud popisovačů, které jsou spojeny s konzolou – stdin, stdout a stderr, musí být přesměrován před použitím funkcí jazyka C run-time je v aplikacích Windows Store.Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

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