puts, _putws
Zapisuje ciąg do stdout.
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Parametry
- str
Ciąg wyjściowy.
Wartość zwracana
Zwraca wartość nieujemną, jeśli kończy się pomyślnie.Jeśli puts nie powiedzie się, zwraca EOF; jeśli _putws nie powiedzie się, zwraca WEOF.Jeśli str jest pustym wskaźnikiem, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, funkcje ustawiają errno jako EINVAL i zwracają EOF lub WEOF.
Aby uzyskać informacje na temat tych i innych kodów błędu, zobacz _doserrno, errno, _sys_errlist, and _sys_nerr.
Uwagi
puts funkcja pisze str do strumienia wyjścia standardowego stdout, zastępując znak kończący ciągu null (\0) znakiem nowego wiersza (\n) w strumieniu wyjściowym.
_putws jest wersją znaków dwubajtowych puts; dwie funkcje zachowują się identycznie, jeśli strumień jest otwarty w trybie ANSI.puts aktualnie nie obsługuje danych wyjściowych w strumieniu UNICODE.
W systemie Windows 2000 i późniejszym _putwch zapisuje znaki Unicode przy użyciu bieżących ustawień regionalnych konsoli.
Rutynowe mapowania zwykłego tekstu
Procedura Tchar.h |
_UNICODE & _MBCS nie zdefiniowano |
_MBCS zdefiniowano |
_UNICODE zdefiniowany |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Wymagania
Procedura |
Wymagany nagłówek |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Konsola nie jest obsługiwana w aplikacjach Windows Store.Standardowe uchwyty strumienia powiązane z konsolą—stdin, stdout, i stderr—muszą zostać przekierowane zanim będą wykorzystane przez funkcje środowiska uruchomieniowego C w aplikacjach Windows Store.Dodatkowe informacje o zgodności – zobacz: Zgodność.
Biblioteki
Wszystkie wersje Bibliotek uruchomieniowych 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!" );
}
Dane wyjściowe
Hello world from puts!