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
См. также
|
(C99)(C11)(C11)(C11)(C11) | выводит форматированные данные в stdout, файловый поток или буфер (функция) |
записывает строку символов в stdout (функция) |
|
| считывает строку символов из файлового потока (функция) |
|
Документация C++ для fputs |
|
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/c/io/fputs