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

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

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

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

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

% flags width type conversion

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

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

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