Namespaces
Variants

fputs

С ru.cppreference.net
 
 
Файловый ввод/вывод
Типы и объекты
        
Функции
Доступ к файлам
(C95)
Неформатированный ввод/вывод
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)

Форматированный ввод
Прямой ввод/вывод
Форматированный вывод
Позиционирование в файле
Обработка ошибок
Операции с файлами
 
Определено в заголовке <stdio.h>
int fputs( const char* str, FILE* stream );
(до C99)
int fputs( const char* restrict str, FILE* restrict stream );
(начиная с C99)

Записывает каждый символ из строки, завершающейся нулём, str в выходной поток stream, как если бы многократно выполнялся вызов fputc.

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

Параметры

str - строка символов, завершающаяся нулём, для записи
stream - выходной поток

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

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

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

Примечания

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

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

Пример

#include <stdio.h>
 
int main(void)
{
    int rc = fputs("Hello World", stdout);

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

Вывод:

Hello World

Ссылки

  • Стандарт C23 (ISO/IEC 9899:2024):
  • 7.21.7.4 Функция fputs (стр.: TBD)
  • Стандарт C17 (ISO/IEC 9899:2018):
  • 7.21.7.4 Функция fputs (стр.: TBD)
  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.21.7.4 Функция fputs (стр.: 331-332)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.19.7.4 Функция fputs (стр.: 297)
  • Стандарт C89/C90 (ISO/IEC 9899:1990):
  • 4.9.7.4 Функция fputs

См. также

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