puts, _putws

Записывает строку stdoutв .

Синтаксис

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

Параметры

str
Выходная строка.

Возвращаемое значение

Возвращает неотрицательное значение в случае успешного выполнения. Если ошибка завершается EOFошибкой, возвращается; при puts_putws сбое возвращаетсяWEOF. Если str имеет значение NULL, вызывается обработчик недопустимых параметров, как описано в разделе "Проверка параметров". Если выполнение разрешено продолжить, функции, установленные errnoEINVAL и возвращаемые 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!

См. также

Потоковый ввод-вывод
fputs, fputws
fgets, fgetws