Sdílet prostřednictvím

fputs, fputws

  • Článek

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

Syntaxe

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

Parametry

str
Výstupní řetězec

stream
Ukazatel na FILE strukturu.

Vrácená hodnota

Každá z těchto funkcí vrátí nenegativní hodnotu, pokud je úspěšná. Při chybě fputs a fputws vrátit EOF. Pokud str nebo stream je ukazatel null, tyto funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, tyto funkce jsou nastaveny errno na EINVAL a pak vrátit EOF.

Další informace o kódech chyb naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

Každá z těchto funkcí se zkopíruje str do výstupu stream na aktuální pozici. fputws Zkopíruje argument str širokého znaku jako stream řetězec s vícebajtovými znaky nebo řetězec širokého znaku při stream otevření v textovém režimu nebo v binárním režimu. Žádná funkce nekopírovala ukončující znak null.

Dvě funkce se chovají stejně, pokud je datový proud otevřen v režimu ANSI. fputs v současné době nepodporuje výstup do datového proudu UNICODE.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Pokud ho chcete změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_fputts fputs fputs fputws

Požadavky

Function Požadovaný hlavičkový soubor
fputs <stdio.h>
fputws <stdio.h> nebo <wchar.h>

Konzola není podporována v aplikacích pro Univerzální platforma Windows (UPW). Standardní stream zpracovává, které jsou přidružené ke konzole –stdin a stderr– musí být přesměrovány, stdoutaby je funkce modulu runtime jazyka C mohly používat v aplikacích pro UPW. Další informace o kompatibilitě najdete 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 );
}

Hello world from fputs.

Viz také

Vstupně-výstupní operace streamu
fgets, fgetws
gets, _getws
puts, _putws