fputs, fputws

Artykuł
03/26/2013

Napisz ciąg do strumienia.

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

Parametry

str
Ciąg danych wyjściowych.
stream
Wskaźnik, aby FILE struktury.

Wartość zwracana

Każda z tych funkcji zwraca wartość nieujemną, jeżeli się powiedzie.On an error, fputs returns EOF, and fputws returns WEOF.Jeśli str lub stream jest pusty wskaźnik, funkcje te wywołuje procedurę obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, ustaw te funkcje errno do EINVAL i powrót EOF lub WEOF.

Zobacz _doserrno, errno, _sys_errlist i _sys_nerr więcej informacji na temat tych i innych kodów błędów.

Uwagi

Każdej z tych funkcji kopie w str w wyniku stream w bieżącym położeniu.fputwskopiuje argumentu szerokich znaków str do stream jako ciąg znaków wielobajtowych lub łańcucha szerokich znaków czy stream jest otwierany w trybie tekstowym lub w trybie binarnym, odpowiednio.Żadna funkcja kopiuje kończącego znaku null.

Dwie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI.fputsaktualnie nie obsługuje dane wyjściowe do strumienia UNICODE.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_fputts	fputs	fputs	fputws

Wymagania

Funkcja	Wymaganego nagłówka
fputs	<stdio.h>
fputws	<stdio.h> lub <wchar.h>

Konsola nie jest obsługiwana w Windows Store aplikacji.Związanych z konsolą, dojścia do strumienia standard stdin, stdout, i stderr, muszą być przeniesione, aby funkcje uruchomieniowej C mogą być użyte w Windows Store aplikacji.Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

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