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.