2.32.2. Форматные преобразования при работе с файлами (fprintf, fscanf).

Даже в том случае, когда строка, записываемая в файл, представляет собой цепочку символов, она обязана подвергнуться преобразованию (форматированию) по следующим причинам:

– в оперативной памяти каждый символ представлен двумя байтами, а в файле – одним;

– для того, чтобы отделить одну строку от другой, вслед за последним символом на диск должна быть записана пара соответствующих управляющих кодов.

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

Приведем пример форматной записи в текстовый файл:

>> f_id=fopen('sample.dat','wt'); % Открываем текстовый файл

>> x=fprintf(f_id,'%s\n','qwerty'); % Выводим строку в файл

>> fclose(f_id);

Форматные указатели всегда начинаются с символа %. В представленном примере такой указатель один – '%s', причем он означает, что перед записью на диск требуется преобразовать строку 'qwerty'. Управляющая комбинация '\n', следующая за форматным указателем записывается в файл как признак конца строки. Первый аргумент функции fprintf задает номер открытого файла. Заметим, что в качесте последнего может выступать число -1, и тогда данные передаются в файл стандартного вывода, т.е. в командное окно:

>> fprintf(1,'%s\n','qwerty')

qwerty

Аналогичная картина имеет место и при остутствии первого аргумента:

>> fprintf('%s\n','qwerty')

qwerty

Второй входной аргумент функции fprintf представлен строкой, содержащей форматные указатели и так называемые литеральные константы, к которым относятся все символы, не принадлежащие к форматным указателям. Литеральные константы включаются в выводимую строку без каких-либо преобразований. К литеральным константам в последнем примере относится, в частности, признак конца строки. Количество указателей в строке форматов может может не соответствовать количеству преобразуемых данных. Заметим, что этим MATLAB существенным образом отличается от других систем программирования. Если длина списка формальных указателей меньше, чем количество преобразуемых данных, то список циклически повторяется. Так, например, имеем:

>> fprintf('%5d',1,2,3,4)

1 2 3 4

Форматный указатель '%5d' в данном случае повторился четыре раза. Если количество указателей формата превышает длину выводимого списка, то лишние форматные указатели игнорируются:

>> fprintf('%d %f %e',4,7)

4 7.000000

Данные, подлежащие преобразованию перед записью в файл, задаются

третьим и последующими аргументами входными аргументами функции fprintf. Так, например, если требуется записать в очередную строку текстового файла два целых и одно вещественное значения переменных x, y и z, то это можно реализовать следующим образом:

>> x=123;

>> y=2015;

>> z=2.34567;

>> fprintf('%5d %d %8.3f\n',x,y,z);

123 2015 2.346

Значение переменной x преобразуется в формат целого числа (свидетельством этому является буква d в первом форматном указателе) и для его записи в выводной строке отводится 5 позиций. Между первым и вторым форматными указателями располагается один пробел, который считается литерной константой, разделяющей первое и второе числа. Значение переменной y преобразуется по формату %d и занимает в выводной строке 4 позиции. После второго числа вставляется еще один литеральный пробел, расположенный между вторым и третьим указателями формата. Следующие 8 позиций отведены для результата преобразования вещественного числа (свидетельством этому является буква f в третьем форматном указателе), у которого сохраняются три значащие цифры в дробной части (результат форматного преобразования при этом округляется в соответствии с общепринятыми математическими правилами).

В целом, следует отметить, что форматные указатели, используемые в функции fprintf, были привнесены в MATLAB после определенной модификации из языка программирования C++. Одной из важнейших модификаций в этом смысле является возможность использования матрицы в качестве элемента выводного списка (в этом случае список форматных указателей определяет преобразование каждого элемента очередного столбца матрицы).

В общем случае указатель формата начинается с символа '%', после которого могут быть расположены три необязательные компоненты – флажки, ширина (w) и точность (.n). Указатель завершается при этом одним из символов, характеризующих тип преобразования данных и представленных в таблице 2.32.3. Следует отметить, что использование целочисленных форматов (%d, %i, %u, %x, %X, %o) предполагает, что преобразуемое значение в самом деле является целым. При использовании целочисленных форматов для преобразования вещественного значения, перед выводом в файл такие величины необходимо округлить с помощью соответствующих функций (fix, round, floor или ceil).

Таблица 2.32.3. Символы, характеризующие тип преобразования данных.

Символ формата	Формат результата
d	Преобразование целочисленного значения в десятичное число со знаком
i	Преобразование целочисленного значения в десятичное число со знаком
o	Преобразование целочисленного значения в восьмеричное число со знаком
u	Преобразование целочисленного значения в десятичное число без знака
x	Преобразование целочисленного значения в шестнадцатеричное число без знака с использованием строчных букв a, b, c, ..., f в качестве цифр
X	Преобразование целочисленного значения в шестнадцатеричное число без знака с использованием заглавных букв A, B, C, ..., F в качестве цифр
f	Преобразование числового значения в вещественное число с фиксированной точкой
е	Преобразование числового значения в вещественное число с плавающей точкой (признак порядка – буква е)
E	Преобразование числового значения в вещественное число с плавающей точкой (признак порядка – буква E)
g	Преобразование числового значения в вещественное число с фиксированной или плавающей плавающей точкой в зависимости от того, какой формат числа занимает меньше места (незначащие нули в дробной части не выводятся)
G	Преобразование числового значения в вещественное число с фиксированной или плавающей плавающей точкой в зависимости от того, какой формат числа занимает меньше места (незначащие нули в дробной части не выводятся)
s	Преобразование текстового значения в строку символов.
c	Преобразование единственного символа

В качестве флажков, следующих непосредственно после символа '%', могут использоваться следующие символы:

– знак '-' – для вывода очередного символьного или числового значения, начиная с левой границы текущего поля (левый прижим; по умолчанию выводимое значение приближается к правой границе текущего поля);

– символ '+' – для обязательного включения знака числа (традиционно знак «плюс» у положительных чисел опускается);

– символ 'пробел' – для вывода пробела вместо знака положительного числа (традиционно такой пробел игнорируется);

– символ '#' – для формирования префиксов у восьмеричных и шестнадцатеричных чисел.

Ширина w, задаваемая целым числом, определяет количество позиций в текущем поле строки, в которых должна разместиться преобразуемая величина. Ширине может предшествовать цифра 0, и в таком случае старшие незначащие позиции чисел заполняются не пробелами, а нулями.

Точность n, следующая за шириной и отделяемая от нее точкой, как правило, определяет количество значащих цифр у вещественного числа в дробной части. Тем не менее, согласно правилам языка программирования C++ точность может быть использована и в сочетании с соответствующими форматными преобразованиями целых чисел (в этом случае преобразуемое число должно содержать в своей символьной записи не менее, чем n цифр, причем если их меньше, то старшие позиции числа дополняются недостающим количеством нулей (так, при преобразовании строки по формату '10.5s' в файл попадут не более 5 первых символов, прижатых к правой границе поля, содержащего 10 позиций) и даже строк.

Среди литеральных констант в командной строке кроме уже упомянутого ранее признака конца строки ('\n') могут использоваться и другие управляющие символы, называемые в литературе Esc-последовательности. Перечень последних представлен в таблице 2.32.4.

Таблица 2.32.4. Esc-последовательности.

Символ	Описание
\b	Удаление предшествующего символа (Backspace)
\f	Перевод страницы (Form feed)
\n	Перевод строки (New line)
\r	Возврат каретки (Carriage return)
\t	Горизонтальная табуляция (Horizontal tab)

Заметим, что некоторые символы командной строки задействованы как управляющие:

– с символа % начинается форматный указатель;

– одиночная кавычка ' открывает и закрывает строку форматов;

– обратная косая черта \ использована в Esc-последовательностях.

Для включения таких символов в состав литеральных констант и демонстрации их явного отличия (во избежание путаницы) от управляющих комбинаций, в форматной строке действуют следующие соглашения:

– %% – воспринимается как символ процента;

– \\ – воспринимается как обратная косая черта;

– '' – воспринимается как одиночная кавычка;

– \” – воспринимается как двойная кавычка.

Заметим, что в случае, если в текстовый файл с помощью функции fprintf записывается единственная строка, строка форматных указателей может быть опущена.

Выборка данных из текстового файла может быть произведена с помощью функции fscanf, обращение к которой в общем случае имеет вид:

[a n]=fscanf(f_id,'format',m);

где a – принимающий массив, в элементы которого заносятся считываемые данные; n – количество фактически считанных значений; f_id – номер открытого файла; format – список форматных указателей, в соответствии с которым осуществляется преобразование считываемых данных; m – количество запрашиваемых данных.

Заметим, что обязательными параметрами в представленном обращении являются массив a, идентификатор f_id и хотя бы один форматный указатель в списке format. Отсутствие количества запрашиваемых значений или константа Inf в качестве третьего параметра воспринимаются как задание прочитать данные до конца файла. Если количество запрашиваемых значений задано числом m, то считываемые данные размещаются в векторе-столбце размерности mх1. Тем не менее, задав количество запрашиваемых данных в виде вектора размерности [p q], можно прочитать данные из файла в матрицу размерности pхq.

Форматные указатели, задаваемые в строке формата у функции fscanf, почти совпадают с соответствующими форматными указателями у функции fprintf (см. таблицу 2.32.3). Отметим, что если на этапе вывода точность имеет определенный смысл, то на стадии ввода она, по сути, не играет роли. При считывании вещественных данных из текстового файла указатели типа %f, %e и %g выполняют одинаковые функции, преобразуя считанное значение в формат типа double. Форматные указатели типа %d и %i выбирают из очередного поля текстового файла целочисленные данные, однако в элементы принимающего массива результат заносится в формате double.

Если форматный указатель начинается с комбинации '%*', то соответствующее значение, считанное из файла, в принимающий массив не передается (это правило дает возможность пропускать ненужные данные).

Форматные указатели типа '%s' на выводе и на вводе действуют по-разному. Строка данных, записываемая в файл, может содержать, например, пробелы. Однако при чтении единичного элемента по формату '%s', это чтение прерывается на первом же пробеле. При запросе чтения более чем одного элемента, соответствующие «белые пробелы», встречающиеся в текстовой строке, игнорируются.