Spec-Zone.ru › C

fputs

Определено в заголовочном файле <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

См. также

printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s
(C99)(C11)(C11)(C11)(C11)
выводит форматированные данные в stdout, файловый поток или буфер
(функция)
puts
записывает строку символов в stdout
(функция)
fgets
считывает строку символов из файлового потока
(функция)
Документация C++ для fputs

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

Spec-Zone.ru

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