14.2.11 Форматированный ввод

Octave предоставляет функции scanf, fscanf, и sscanf для чтения форматированного ввода. Существуют две формы каждой из этих функций. Одна может использоваться для извлечения векторов данных из файла, а другая более похожа на функции языка C.

: [val, count, errmsg] = fscanf (fid, template, size) ¶

: [v1, v2, …, count, errmsg] = fscanf (fid, template, "C") ¶

В первом варианте читается из fid в соответствии с template, возвращая результат в матрице val.

Необязательный аргумент size определяет количество считываемых данных и может быть одним из

Inf

Считывается как можно больше, возвращая столбец.

nr

Считывается до nr элементов, возвращая столбец.

[nr, Inf]

Считывается как можно больше, возвращая матрицу с nr строками. Если количество прочитанных элементов не является точным кратным nr, последний столбец дополняется нулями.

[nr, nc]

Считывается до nr * nc элементов, возвращая матрицу с nr строками. Если количество прочитанных элементов не является точным кратным nr, последний столбец дополняется нулями.

Если size опущено, предполагается значение Inf.

Строка возвращается, если template определяет только преобразования символов.

Количество успешно прочитанных элементов возвращается в count.

Если произошла ошибка, errmsg содержит зависящее от системы сообщение об ошибке.

Во второй форме читается из fid в соответствии с template, где каждый спецификатор преобразования в template соответствует одному скалярному возвращаемому значению. Эта форма более «похожа на C» и также совместима с предыдущими версиями Octave. Количество успешных преобразований возвращается в count

Полное описание синтаксиса строки шаблона см. в разделе «Форматированный ввод» руководства GNU Octave.

См. также: fgets, fgetl, fread, scanf, sscanf, fopen.

: [val, count, errmsg] = scanf (template, size) ¶

: [v1, v2, …, count, errmsg] = scanf (template, "C") ¶

Это эквивалентно вызову fscanf с fid = stdin.

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

См. также: fscanf, sscanf, printf.

: [val, count, errmsg, pos] = sscanf (string, template, size) ¶

: [v1, v2, …, count, errmsg] = sscanf (string, template, "C") ¶

Это похоже на fscanf, за исключением того, что символы берутся из строки string вместо потока.

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

См. также: fscanf, scanf, sprintf.

Вызовы scanf внешне похожи на вызовы printf, поскольку произвольные аргументы считываются под управлением строки шаблона. Хотя синтаксис спецификаций преобразования в шаблоне очень похож на синтаксис спецификаций преобразования printf, интерпретация шаблона ориентирована больше на ввод в свободном формате и простое сопоставление шаблонов, а не на форматирование фиксированных полей. Например, большинство scanf преобразований пропускают любое количество «пробелов» (включая пробелы, табуляцию и новые строки) во входном файле, и для числовых преобразований ввода нет понятия точности, как есть для соответствующих преобразований вывода. Обычно ожидается, что символы, не являющиеся пробелами в шаблоне, точно совпадают с символами во входном потоке. Например, обратите внимание, что sscanf анализирует строку и пробелы по-разному при использовании смешанных числовых и строковых типов вывода:

teststr = "1 is a lonely number";
sscanf (teststr, "%s is a %s")
⇒ 1lonelynumber

sscanf (teststr, "%g is a %s")
⇒
     1
   108
   111
   110
   101
   108
   121

[a, b, c] = sscanf ("1 is a lonely number", "%g is a %s %s", "C")
⇒ a =  1
⇒ b = lonely
⇒ c = number

При возникновении несоответствия scanf возвращается немедленно, оставляя первый несовпадающий символ в качестве следующего символа для чтения из потока, и scanf возвращает все элементы, которые были успешно преобразованы.

Функции форматированного ввода используются не так часто, как функции форматированного вывода. Отчасти это связано с тем, что для их правильного использования требуется определенная внимательность. Другая причина заключается в том, что восстановить после ошибки сопоставления трудно.

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