puts
, _putws
öğesine stdout
bir dize yazar.
Sözdizimi
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Parametreler
str
Çıkış dizesi.
Dönüş değeri
Başarılı olursa, olumsuz olmayan bir değer döndürür. Başarısız puts
olursa döndürür EOF
; başarısız olursa _putws
döndürür WEOF
. Boş bir işaretçiysestr
, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, işlevler olarak EINVAL
ayarlanır errno
ve veya WEOF
döndürürEOF
.
Bunlar ve diğer hata kodları hakkında bilgi için bkz. errno
, _doserrno
, _sys_errlist
ve _sys_nerr
.
Açıklamalar
İşlev, puts
standart çıkış akışına stdout
yazar str
ve dizenin sonlandırıcı null karakterini ('\0') çıkış akışında yeni satır karakteriyle ('\n') değiştirir.
_putws
, öğesinin puts
geniş karakterli sürümüdür; akış ANSI modunda açıldığında iki işlev aynı şekilde davranır. puts
şu anda UNICODE akışına çıkışı desteklemez.
_putwch
geçerli CONSOLE LOCALE ayarını kullanarak Unicode karakterler yazar.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı 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 |
---|---|---|---|
_putts |
puts |
puts |
_putws |
Gereksinimler
Yordam | Gerekli başlık |
---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Konsol Evrensel Windows Platformu (UWP) uygulamalarında desteklenmez. C çalışma zamanı işlevlerinin UWP uygulamalarında kullanabilmesi için önce konsolu stdin
, , stdout
ve stderr
ile ilişkilendirilmiş standart akış tanıtıcılarının yeniden yönlendirilmesi gerekir. Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Kitaplıklar
C çalışma zamanı kitaplıklarının tüm sürümleri.
Örnek
// crt_puts.c
// This program uses puts to write a string to stdout.
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Çıktı
Hello world from puts!