puts

int puts( const char* str );

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

Завершающий нулевой символ из 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:2023):
• 7.21.7.9 Функция puts (p: TBD)
• Стандарт C17 (ISO/IEC 9899:2018):
• 7.21.7.9 Функция puts (p: TBD)
• Стандарт C11 (ISO/IEC 9899:2011):
• 7.21.7.9 Функция puts (p: 333)
• Стандарт C99 (ISO/IEC 9899:1999):
• 7.19.7.10 Функция puts (p: 299)
• Стандарт C89/C90 (ISO/IEC 9899:1990):
• 7.9.7.10 Функция puts

См. также