fputs, fputws

Artykuł
06/09/2015

Zapisuje ciąg do strumienia.

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

Parametry

str
Ciąg wyjściowy.
stream
Wskaźnik na FILE strukturę.

Wartość zwracana

Każda z tych funkcji zwraca wartość nieujemną, jeśli się powiedzie.On an error, fputs and fputws return EOF.Jeśli str lub stream jest pusty wskaźnik tych funkcji Wywołaj obsługę nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowana, zestaw tych funkcji errno do EINVAL a fputs zwraca EOF, i fputws zwraca WEOF.

Aby uzyskać więcej informacji na temat tych i innych kodów błędu, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.

Uwagi

Każda z tych funkcji kopii str w wyniku stream w bieżącym położeniu.fputwskopiuje argument szeroko charakter str do stream jako ciąg znaków wielobajtowych lub ciąg znaków wide według czy stream jest otwierany w trybie tekst lub binarny, odpowiednio.Żadna funkcja kopiuje kończącego znaku null.

Te dwie funkcje zachowują się identycznie, jeżeli strumień jest otwarty w trybie ANSI.fputs aktualnie nie obsługuje danych wyjściowych w strumieniu UNICODE.

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_UNICODE zdefiniowany
_fputts	fputs	fputs	fputws

Wymagania

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

Konsola nie jest obsługiwana w aplikacjach Windows Store.Standardowe uchwyty strumienia powiązane z konsolą—stdin, stdout, i stderr—muszą zostać przekierowane zanim będą wykorzystane przez funkcje środowiska uruchomieniowego C w aplikacjach Windows Store.Dodatkowe informacje 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 );
}