Spec-Zone.ru › C++

std::puts

Defined in header <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/w/cpp/io/c/puts

Spec-Zone.ru

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