fputs, fputws

Zapisuje ciąg w strumieniu.

Składnia

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

Parametry

str
Ciąg wyjściowy.

stream
Wskaźnik do FILE struktury.

Wartość zwracana

Każda z tych funkcji zwraca wartość nienegacyjną, jeśli zakończy się pomyślnie. Po błędzie fputs i fputws zwróć polecenie EOF. Jeśli str lub stream jest wskaźnikiem o wartości null, te funkcje wywołują nieprawidłową procedurę obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonywanie jest dozwolone do kontynuowania, te funkcje są ustawione errno na EINVAL , a następnie zwracają wartość EOF.

Aby uzyskać więcej informacji na temat kodów błędów, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Każda z tych funkcji kopiuje str do danych wyjściowych stream w bieżącym położeniu. fputws Kopiuje argument str szerokoznaczny do stream jako ciąg znaków wielobajtowych lub ciąg znaków szeroki, gdy stream jest otwarty w trybie tekstowym lub w trybie binarnym, odpowiednio. Żadna z funkcji nie kopiuje znaku null zakończenia.

Obie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI. fputs obecnie nie obsługuje danych wyjściowych do strumienia UNICODE.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby go zmienić, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_fputts	fputs	fputs	fputws

Wymagania

Function	Wymagany nagłówek
fputs	<stdio.h>
fputws	<stdio.h> lub <wchar.h>

Konsola nie jest obsługiwana w aplikacjach platformy platforma uniwersalna systemu Windows (UWP). Standardowe dojścia strumienia skojarzone z konsolą —stdinstdout i stderr— muszą zostać przekierowane, zanim funkcje środowiska uruchomieniowego języka C będą mogły ich używać w aplikacjach platformy UWP. Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

// 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.

Zobacz też

We/Wy strumienia
fgets, fgetws
gets, _getws
puts, _putws