14.2.12 Синтаксис преобразования входных данных

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

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

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

Спецификации преобразования в шаблоне строки scanf имеют общий вид:

% flags width type conversion

Более подробно, спецификация преобразования ввода состоит из начального символа '%', за которым следуют последовательно:

• Необязательный флаговый символ '*', который указывает на игнорирование текста, считанного для этой спецификации. Когда scanf находит спецификацию преобразования, использующую этот флаг, он считывает входные данные, как указано остальной частью спецификации преобразования, но отбрасывает эти входные данные, не возвращает никакого значения и не увеличивает счет успешных назначений.
• Необязательное десятичное целое число, которое указывает максимальную ширину поля. Чтение символов из входного потока останавливается либо при достижении этого максимума, либо при обнаружении несоответствующего символа, в зависимости от того, что произойдет раньше. Большинство преобразований отбрасывают начальные пробельные символы, и эти отброшенные символы не учитываются в максимальной ширине поля. Преобразования, которые не отбрасывают начальные пробельные символы, документально подробно описаны.
• Необязательный символ модификатора типа. Этот символ игнорируется функцией Octave scanf, но распознается для обеспечения совместимости с языком C scanf.
• Символ, указывающий на применяемое преобразование.

Точные разрешенные параметры и их интерпретация различаются в зависимости от разных спецификаторов преобразования. См. описания отдельных преобразований для получения информации о конкретных разрешенных параметрах.