Стандартные потоки. Объявление этой функции имеет следующий вид

Функция feof()

Функция fclose()

Функция fopen()

Объявление этой функции имеет следующий вид.

#include<stdio.h>

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

Эта функция открывает поток и связывает с ним определенный файл. Первый параметр (filename) рассматриваемой функции определяет открываемый файл. Второй параметр функции (mode) задает режим, в котором должен быть открыт файл.

В случае успеха функция вернет указатель типа FILE* на созданную структуру данных. Этот указатель может использоваться файловыми функциями для выполнения операций ввода – вывода. В случае возникновения ошибки функция fopen() вернет нулевой указатель.

В следующем фрагменте программного кода функция используется для открытия файла с именем file1.txt в режиме записи. Предполагается, что файл находится в текущем каталоге (иначе необходимо указывать путь к каталогу). Во фрагменте используется обычный прием, который состоит в проверке значения, возвращаемого функцией fopen().

FILE* fp;
if ((fp = fopen(“file1.txt”, “w”)) == NULL)
{
printf(“Не могу открыть файл file1.txt”);
exit(1);
}

Возможные режимы открытия потоков представлены в приводимой ниже таблице

Режим	Пояснение
r	Открыть текстовый поток и связать его с существующим файлом
w	Открыть текстовый поток и связать его с вновь созданным файлом
a	Открыть текстовый файл в режиме дозаписи. Если файл еще не существует, то он будет создан.
rb, wb и ab	Отличаются соответственно от режимов r, w и a только тем, что открывают двоичный поток.
r+, w+ и a+	Отличаются соответственно от режимов r, w и a только тем, что поток открывается в режиме чтения / записи.
r+b, w+b и a+b	Отличаются соответственно от режимов rb, wb и ab только тем, что поток открываются в режиме чтения / записи.

Объявление этой функции имеет следующий вид.

#include<stdio.h>

int fсlose(FILE* stream);

Функция fclose() закрывает поток stream. Перед закрытием потока все связанные с ним буферы сбрасываются. При успешном выполнении функция fclose() возвращает 0, а в случае ошибки – EOF.

Объявление рассматриваемой функции имеет следующий вид:

#include<stdio.h>
int feof(FILE* stream);

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

Если указатель текущей позиции файла установлен на конец файла, то функция feof() вернет ненулевое значение, в противном случае возвращается нуль.

В начале выполнения программы автоматически открываются три стандартных потока.

Поток	Файловый указатель	Внешнее устройство
Ввода	stdin	клавиатура
Вывода	stdout	Экран дисплея
Ошибок	stderr	Экран дисплея

42.2.6. Классификация функций потокового ввода – вывода

Все функции потокового ввода – вывода можно разделить на четыре категории:

· форматированный ввод – вывод,

· посимвольный ввод – вывод,

· построковый ввод – вывод,

· блоковый ввод – вывод.

42.2.7. Форматированный ввод – вывод

При форматированном вводе - выводе используются следующие функции:

· fprintf() – для записи в файл,

· fsсanf() - для чтения из файла.

Функция fprintf() объявлена следующим образом:

#include<stdio.h>

int fpintf(FILE* stream, const char * format[, аргумент, …]);

Рассматриваемая функция является обобщенным вариантом функции printf(). Здесь появился дополнительный параметр stream, которого нет в функции printf. Параметр stream является указателем на поток, который должен быть предварительно открыт функцией fopen().

Функция fprintf() возвращает число выведенных символов или отрицательное число, если произошла ошибка вывода.

Функция fscanf() объявлена следующим образом:

#include<stdio.h>

int fscanf(FILE* stream, const char * format[, указатель, …]);

Эта функция в свою очередь является обобщенным вариантом функции scanf(). Здесь также появился дополнительный параметр stream – указатель на поток.

В результате своего выполнения функция fscanf() возвращает количество просмотренных, преобразованных и сохраненных входных полей; отсканированные, но несохраненные поля не учитываются. При достижении конца файла функция fscanf() возвращает значение EOF. Если ни одного поля не сохранено, то функция вернет нуль.

42.2.8. Построковый ввод – вывод

Для организации построкового ввода – вывода могут использоваться следующие функции:

· fputs(),

· fgets().

Функция fputs() объявлена следующим образом:

#include<stdio.h>

int fputs(const char * s, FILE* stream);

Функция fputs() выводит строку, на которую установлен указатель s в поток, на который установлен указатель stream. Символ ‘\0’, завершающий выводимую строку в поток не записывается. Если в процессе записи имела место ошибка, то рассматриваемая функция вернет EOF, в случае успеха возвращаемым значением функции fputs() является неотрицательное числа.

Функция fgets() объявлена следующим образом:

#include<stdio.h>

char *fputs(char * s, int n, FILE* stream);

Функция fgets() читает не более n – 1 символов из потока на, который установлен указатель stream, в символьный массив, на который установлен указатель s. Существуют два способа завершения процесса чтения символов:

· прочитан символ новая строка (‘\n’),

· прочитан n – 1 символ.

В первом случае прочитанный символ новая строка записывается в символьный массив, а затем строка завершается нуль – символом. Во втором случае символ новая строка оказывается непрочтенным и незаписанным в символьный массив. Однако и в этом случае в символьный массив будет записан нуль – символ.

После успешного выполнения функция fgets() возвращает указатель на символьный массив, в который производилась запись. Если имело место достижение конца файла при условии, что ни один символ не был прочитан, возвращаемым значением функции fscanf() является NULL, а содержимое массива, на который установлен указатель s, оказывается неименным.

42.2.9. Блоковый ввод – вывод

Блоковый ввод – вывод обеспечивается функциями fread() и fwrite().

Объявление функции fwrite() имеет следующий вид:

#include<stdio.h>

size_tfwrite(const void * ptr, size_t n, size_t nmemb, FILE* stream);

Функция fwrite() помещает до nmemb элементов (блоков), каждый из которых размером size, из массива адресуемого указателем ptr, в поток, на который установлен указатель stream.

Функция fwrite() возвращает число успешно записанных элементов (блоков). Это значение может оказаться меньше, чем nmemb, если имеет место ошибка.

#include<stdio.h>

size_tfread(void * ptr, size_t n, size_t nmemb, FILE* stream);

Функция fwrite() читает до nmemb элементов (блоков), каждый из которых размером size, в массив адресуемого указателем ptr, из потока, на который установлен указатель stream.

Функция fread() возвращает число успешно прочитанных элементов (блоков). Это значение может оказаться меньше, чем nmemb, если имеет место ошибка или обнаружен конец файла.

Дата добавления: 2014-01-06