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 возвращает все элементы, которые были успешно преобразованы.

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

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