Spec-Zone.ru › C++

std::puts

Определён в заголовочном файле <cstdio>
int puts( const char *str );

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

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

Параметры

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

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

В случае успеха возвращает неотрицательное значение

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

Примечания

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

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

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

Пример

#include <cstdio>
 
int main()
{
    int rc = std::puts("Hello World");

    if (rc == EOF)
        std::perror("puts()"); // POSIX requires that errno is set
}

Вывод:

Hello World

См. также

fputs
записывает строку символов в файловый поток
(функция)
printffprintfsprintfsnprintf
(C++11)
выводит форматированные данные в stdout, файловый поток или буфер
(функция)
Документация по C для puts

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/io/c/puts

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API