puts, _putws

Zapíše řetězec do stdout.

Syntaxe

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

Parametry

str
Výstupní řetězec

Vrácená hodnota

Vrátí nenenegativní hodnotu, pokud je úspěšná. Pokud puts selže, vrátí EOFse ; pokud _putws selže, vrátí WEOF. Pokud str je ukazatel null, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je provádění povoleno pokračovat, funkce nastavené errno na EINVAL a vrátit EOF nebo WEOF.

Informace o těchto a dalších kódech chyb naleznete v tématu , , , a_sys_nerr . _sys_errlist_doserrnoerrno

Poznámky

Funkce puts zapisuje str do standardního výstupního datového proudu stdouta nahradí ukončující znak null řetězce (\0) znakem nového řádku (\n) ve výstupním datovém proudu.

_putws je širokoznačná verze puts; dvě funkce se chovají stejně, pokud je datový proud otevřen v režimu ANSI. puts v současné době nepodporuje výstup do datového proudu UNICODE.

_putwch zapíše znaky Unicode pomocí aktuálního nastavení NÁRODNÍHO PROSTŘEDÍ KONZOLY.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_putts	puts	puts	_putws

Požadavky

Rutina	Požadovaný hlavičkový soubor
puts	<stdio.h>
_putws	<stdio.h>

Konzola není podporována v aplikacích pro Univerzální platforma Windows (UPW). Standardní zpracování datových proudů, které jsou přidružené ke konzole , a , stderrmusí být přesměrovány před tím, stdinstdoutnež je funkce runtime jazyka C mohou používat v aplikacích pro UPW. Další informace o kompatibilitě najdete v tématu Kompatibilita.

Knihovny

Všechny verze knihoven runtime jazyka C.

Příklad

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

Výstup

Hello world from puts!

Viz také

Vstupně-výstupní operace streamu
fputs, fputws
fgets, fgetws