fputs, fputws

Akışa bir dize yazar.

Sözdizimi

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

Parametreler

str
Çıkış dizesi.

stream
Yapı işaretçisi FILE .

Dönüş değeri

Bu işlevlerin her biri başarılı olursa, olumsuz olmayan bir değer döndürür. Bir hatada fputs ve fputws döndür.EOF veya str stream null işaretçiyse, bu işlevler Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisini çağırır. Yürütmenin devam etmesi için izin verilirse, bu işlevler olarak EINVAL ayarlanır errno ve döndürürEOF.

Hata kodları hakkında daha fazla bilgi için bkz. errno, _doserrno, _sys_errlistve _sys_nerr.

Açıklamalar

Bu işlevlerin her biri çıkışa stream geçerli konumda kopyalanırstr. fputws , geniş karakter bağımsız değişkenini str stream , sırasıyla metin modunda veya ikili modda açıldığında çok baytlı bir dize veya geniş karakterli bir dize stream olarak kopyalar. İki işlev de sonlandırıcı null karakteri kopyalar.

Akış ANSI modunda açıldığında iki işlev aynı şekilde davranır. fputs şu anda UNICODE akışına çıkışı desteklemez.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bunu değiştirmek için bkz . CRT'de Genel durum.

Genel metin yordamı eşlemeleri

TCHAR.H yordamı _UNICODE ve _MBCS tanımlanmadı _MBCS tanımlanan _UNICODE tanımlanan
_fputts fputs fputs fputws

Gereksinimler

İşlev Gerekli başlık
fputs <stdio.h>
fputws <stdio.h> veya <wchar.h>

Konsol Evrensel Windows Platformu (UWP) uygulamalarında desteklenmez. C çalışma zamanı işlevlerinin UWP uygulamalarında kullanabilmesi için konsolla ilişkilendirilmiş standart akış tanıtıcılarının (stdinstdout, ve stderr) yeniden yönlendirilmesi gerekir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

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

Ayrıca bkz.

Akış G/Ç
fgets, fgetws
gets, _getws
puts, _putws