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

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

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

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

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

% flags width type conversion

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

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

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