Namespaces
Variants

puts

From cppreference.net
< c ‎ | io
Определено в заголовочном файле <stdio.h>
int puts ( const char * str ) ;

Записывает каждый символ из строки с нулевым завершением str и один дополнительный символ новой строки ' \n ' в выходной поток stdout , как если бы повторно выполнялась функция fputc .

Завершающий нулевой символ из str не записывается.

Содержание

Параметры

str - строка символов для записи

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

При успешном выполнении возвращает неотрицательное значение.

При неудаче возвращает EOF и устанавливает индикатор ошибки (см. ferror() ) для stream .

Примечания

Функция puts добавляет символ новой строки к выводу, тогда как fputs функция этого не делает.

Различные реализации возвращают разные неотрицательные числа: некоторые возвращают последний записанный символ, некоторые возвращают количество записанных символов (или INT_MAX если строка была длиннее этого), некоторые просто возвращают неотрицательную константу.

Типичной причиной сбоя для puts является нехватка места в файловой системе, когда stdout перенаправлен в файл.

Пример

#include <stdio.h>
int main(void)
{
    int rc = puts("Hello World");
    if (rc == EOF)
        perror("puts()"); // POSIX requires that errno is set
}

Вывод:

Hello World

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.21.7.9 Функция puts (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.21.7.9 Функция puts (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.21.7.9 Функция puts (стр. 333)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.19.7.10 Функция puts (стр: 299)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
  • 7.9.7.10 Функция puts

Смотрите также

записывает строку символов в файловый поток
(функция)
выводит форматированные данные в stdout , файловый поток или буфер
(функция)