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
См. также
| записывает строку символов в файловый поток (функция) |
|
|
(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