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

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

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

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

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

% flags width type conversion

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

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

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