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_errlist
i _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 zdefiniowany |
_UNICODE zdefiniowany |
---|---|---|---|
_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ą —stdin
stdout
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.