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 zdefiniowany |
_UNICODE zdefiniowany |
|---|---|---|---|
_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!