Основы программирования в Linux
вернуться

Мэтью Нейл
Шрифт:

Далее приведена синтаксическая запись функции:

#include <stdio.h>

FILE *fopen(const char *filename, const char *mode);

Функция

fopen
открывает файл, заданный в параметре
filename
, и ассоциирует с ним поток. Параметр
mode
описывает, как файл должен быть открыт. Он задается одной из следующих строк:

"

r
" или "
rb
" — открыть только для чтения;

"

w
" или "
wb
" — открыть для записи, укоротить до нулевой длины;

"

а
" или "
ab
" — открыть для записи, дописывать в конец файла;

"

r+
" или "
rb+
" или "
r+b
" — открыть для изменения (чтение и запись);

"

w+
" или "
wb+
" или "
w+b
" — открыть для изменения, укоротить до нулевой длины;

"

a+
" или "
ab+
" или "
а+b
" — открыть для изменения, дописывать в конец файла. Символ
b
означает, что файл бинарный, а не текстовый.

Примечание

В отличие от MS-DOS, системы UNIX и Linux не делают различий между текстовыми и бинарными файлами. UNIX и Linux обрабатывают их одинаково с эффективностью обработки бинарных файлов. Важно также учесть, что параметр

mode
должен быть строкой, а не символом. Всегда применяйте двойные кавычки, а не апострофы.

В случае успешного завершения функция

fopen
возвращает ненулевой указатель на структуру
FILE*
. В случае сбоя она вернет значение
NULL
, определенное в файле stdio.h.

Количество доступных потоков ограничено, как и число дескрипторов файлов. Реальное предельное значение содержится в определенной в файле stdio.h константе

FOPEN_MAX
и всегда не менее 8, а в ОС Linux обычно 16.

fread

Библиотечная функция

fread
применяется для чтения данных из файлового потока. Данные считываются из потока
stream
в буфер данных, заданный в параметре
ptr
. Функции
fread
и
fwrite
имеют дело с записями данных. Записи описываются размером
size
и количеством передаваемых записей
nitems
. Функция возвращает количество записей (а не байтов), успешно считанных в буфер данных. При достижении конца файла может быть возвращено меньше записей, чем
nitems
, вплоть до нуля.

Далее приведена синтаксическая запись функции:

#include <stdio.h>

size_t fread(void *ptr, size_t size, size_t nitems, FILE *stream);

Как и в других функциях стандартного ввода/вывода, записывающих данные в буфер, выделять место для данных и проверять ошибки должен программист. См. также функции

ferror
и
feof
далее в этой главе.

fwrite

Интерфейс библиотечной функции

fwrite
аналогичен интерфейсу функции
fread
. Она принимает записи данных из заданного буфера данных и записывает их в поток вывода. Функция возвращает количество успешно записанных записей.

Далее приведена синтаксическая запись функции:

#include <stdio.h>

size_t fwrite(const void *ptr, size_t size, size_t nitems, FILE *stream);

Примечание

Имейте в виду, что функции

fread
и
fwrite
не рекомендуется применять со структурированными данными. Частично проблема заключается в том, что файлы, записанные функцией fwrite, могут быть непереносимыми между машинами с разной архитектурой.

fclose

Библиотечная функция

fclose
закрывает заданный поток stream, заставляя записать все незаписанные данные. Важно применять функцию
fclose
, поскольку библиотека stdio будет использовать буфер для данных. Если программе нужна уверенность в том, что все данные записаны, следует вызвать
fclose
. Имейте в виду, что функция
fclose
вызывается автоматически для всех файловых потоков, которые все еще открыты к моменту нормального завершения программы, но при этом у вас, конечно же, не будет возможности проверить ошибки, о которых сообщает
fclose
.

Далее приведена синтаксическая запись функции:

#include <stdio.h>

int fclose(FILE* stream);

fflush

Библиотечная функция

fflush
вызывает немедленную запись всех данных файлового потока, ждущих выполнения операции записи. Вы можете применять ее, например, чтобы убедиться, что интерактивное приглашение отправлено на терминал до того, как делается попытка считать ответ. Эта функция также полезна, если вы хотите, прежде чем продолжить выполнение, убедиться в том, что важные данные помещены на диск. Ее можно применять в некоторых случаях при отладке программы, чтобы быть уверенным в том, что программа действительно записывает данные, а не зависла. При вызове функции
fclose
выполняется неявная операция
fflush
, поэтому перед
fclose
не нужно вызывать функцию
fflush
.