puts, _putws
Записывает строку stdoutв .
Синтаксис
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
Параметры
str
Выходная строка.
Возвращаемое значение
Возвращает неотрицательное значение в случае успешного выполнения. Если ошибка завершается EOFошибкой, возвращается; при puts _putws сбое возвращаетсяWEOF. Если str имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжить, функции, установленные errno EINVAL и возвращаемые EOF или WEOFвозвращаемые.
Дополнительные сведения об этих и других кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.
Замечания
Функция puts записывает str в стандартный выходной поток stdout, заменив завершающийся пустой символ строки ('\0') новым символом ('\n') в выходном потоке.
Функция _putws является версией функции puts с расширенными символами; обе функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция puts на данный момент не поддерживает вывод данных в поток в кодировке Юникод.
_putwch записывает символы Юникода с помощью текущего параметра LOCALE КОНСОЛИ.
По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.
Сопоставления подпрограмм универсального текста
| Подпрограмма TCHAR.H | _UNICODE и _MBCS не определен |
_MBCS Определенные |
_UNICODE Определенные |
|---|---|---|---|
_putts |
puts |
puts |
_putws |
Требования
| Маршрут | Обязательный заголовок |
|---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
Консоль не поддерживается в приложениях универсальная платформа Windows (UWP). Стандартные дескрипторы потока, связанные с консолью, stdinstdoutи stderr, должны быть перенаправлены перед тем, как функции времени выполнения C могут использовать их в приложениях UWP. Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Все версии библиотек времени выполнения языка 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!" );
}
Выходные данные
Hello world from puts!