puts, _putws

Zapisuje ciąg w pliku stdout.

Składnia

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

Parametry

str
Ciąg wyjściowy.

Wartość zwracana

Zwraca wartość nienależącą do wartości, jeśli operacja powiedzie się. Jeśli zakończy się niepowodzeniem, zwraca wartość ; jeśli puts_putws się nie powiedzie, zwraca wartość WEOF.EOF Jeśli str jest wskaźnikiem o wartości null, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Walidacja parametru. Jeśli wykonywanie jest dozwolone do kontynuowania, funkcje ustawione errno na EINVAL i zwracają EOF lub WEOF.

Aby uzyskać informacje na temat tych i innych kodów błędów, zobacz errno, _doserrno, _sys_errlisti _sys_nerr.

Uwagi

Funkcja puts zapisuje str w standardowym strumieniu stdoutwyjściowym , zastępując ciąg znakiem zerowym ("\0") znakiem nowego wiersza ('\n') w strumieniu wyjściowym.

_putws jest wersją putso szerokim znaku ; obie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI. puts obecnie nie obsługuje danych wyjściowych do strumienia UNICODE.

_putwch zapisuje znaki Unicode przy użyciu bieżącego ustawienia USTAWIEŃ REGIONALNYCH KONSOLI.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_putts	puts	puts	_putws

Wymagania

Procedura	Wymagany nagłówek
puts	<stdio.h>
_putws	<stdio.h>

Konsola nie jest obsługiwana w aplikacjach platformy platforma uniwersalna systemu Windows (UWP). Standardowe dojścia strumienia skojarzone z konsolą programu stdin, stdouti i stderrmuszą zostać przekierowane, zanim funkcje czasu wykonywania języka C będą mogły ich używać w aplikacjach platformy UWP. Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Przykład

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

#include <stdio.h>

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

Wynik

Hello world from puts!

Zobacz też

We/Wy strumienia
fputs, fputws
fgets, fgetws