puts, _putws
Записывает строку в stdout.
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Параметры
- str
Выходная строка.
Возвращаемое значение
Возвращает неотрицательное значение при успехе. Если puts завершается ошибкой, возвращается EOF; если _putws завершается ошибкой, возвращается значение WEOF. Если str является пустым указателем, то вызывается обработчик недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эти функции устанавливают для errno значение EINVAL и возвращают EOF или WEOF.
Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.
Заметки
Функция puts записывает str в стандартный поток вывода stdout, заменив завершающий символ('\0') символом новой строки ('\n') в потоке вывода.
_putws является версией puts для расширенных символов; две функции ведут себя одинаково, если поток открывается в режиме ANSI. puts в настоящее время не поддерживает вывод в поток в юникоде.
В Windows 2000 и более поздних версиях, _putwch записывает символы Юникода с помощью текущего параметра языкового стандарта консоли.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Все версии библиотек времени выполнения C.
Пример
// crt_puts.c
/* This program uses puts to write a string to stdout.
*/
#include <stdio.h>
int main( void )
{
puts( "Hello world from puts!" );
}
Output
Hello world from puts!