std:: vwscanf, std:: vfwscanf, std:: vswscanf

Н/ДСоответствует символу или последовательности символов

• . Если используется спецификатор ширины, соответствует ровно width широких символов (аргумент должен быть указателем на массив достаточного размера).
• В отличие от %s и %[, не добавляет нулевой символ в конец массива.

Соответствует последовательности непробельных символов (строка).

• Если используется спецификатор ширины, соответствует до width символов или до первого пробельного символа, в зависимости от того, что встретится раньше.
• Всегда сохраняет нулевой символ в дополнение к соответствующим символам (поэтому массив аргумента должен иметь место по крайней мере для width+1 символов).

Соответствует непустой последовательности символов из набора символов.

• Если первый символ набора — ^, то соответствуют все символы, не входящие в набор.
• Если набор начинается с ] или ^], то символ ] также включается в набор.
• Реализация определяет, может ли символ - в не начальной позиции в наборе сканирования указывать диапазон, как в [0-9].
• Если используется спецификатор ширины, соответствует только до width.
• Всегда сохраняет нулевой символ в дополнение к соответствующим символам (поэтому массив аргумента должен иметь место по крайней мере для width+1 символов).

Соответствует десятичному целому числу.

• Формат числа такой же, как ожидается std::wcstol со значением 10 для аргумента base.

Соответствует беззнаковому двоичному целому числу.

• Формат числа такой же, как ожидается std::wcstoul со значением 2 для аргумента base.

Соответствует целому числу.

• Формат числа такой же, как ожидается std::wcstol со значением 0 для аргумента base (основание определяется по первым разобранным символам).

Соответствует беззнаковому десятичному целому числу.

• Формат числа такой же, как ожидается std::wcstoul со значением 10 для аргумента base.

Соответствует беззнаковому восьмеричному целому числу.

• Формат числа такой же, как ожидается std::wcstoul со значением 8 для аргумента base.

Соответствует беззнаковому шестнадцатеричному целому числу.

• Формат числа такой же, как ожидается std::wcstoul со значением 16 для аргумента base.

Возвращает количество прочитанных на данный момент символов.

• Входные данные не потребляются. Не увеличивает счётчик присваиваний.
• Если для спецификатора определён оператор подавления присваивания, поведение не определено.

Соответствует числу с плавающей запятой.

• Формат числа такой же, как ожидается std::wcstof.

Соответствует определяемой реализацией последовательности символов, представляющей указатель.

• printfФункции семейства %p должны порождать такую же последовательность с использованием спецификатора формата

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

За исключением спецификатора %, элемент ввода (или для %n количество входных символов) сначала преобразуется в тип, соответствующий спецификатору преобразования. Если присваивание не было подавлено с помощью *, результат преобразования записывается в объект, на который указывает следующий аргумент, который ещё не был записан. Если этот объект не имеет подходящего типа или результат преобразования не может быть представлен в объекте, поведение не определено.

Все спецификаторы преобразования, кроме [, c и n, потребляют и отбрасывают все ведущие пробельные символы (определяется как при вызове std::iswspace) перед попыткой разбора ввода. Эти потреблённые символы не учитываются в указанной максимальной ширине поля.

Если спецификатор длины l не используется, спецификаторы преобразования c, s и [ выполняют преобразование широкого символа в многобайтовый, как при вызове std::wcrtomb с объектом std::mbstate_t, инициализированным нулём перед преобразованием первого символа.

Спецификаторы преобразования s и [ всегда сохраняют нулевой терминатор в дополнение к соответствующим символам. Размер целевого массива должен быть как минимум на единицу больше указанной ширины поля. Использование %s или %[ без указания размера целевого массива так же небезопасно, как std::gets.

Правильные спецификации преобразования для целочисленных типов фиксированной ширины (std::int8_t и т.д.) определены в заголовке <cinttypes> (хотя SCNdMAX, SCNuMAX и т.д. являются синонимами %jd, %ju и т.д.).

Существует точка следования после действия каждого спецификатора преобразования; это позволяет сохранять несколько полей в одну и ту же переменную-приёмник.

При разборе неполного значения с плавающей запятой, которое заканчивается на экспоненту без цифр, например, при разборе "100er" со спецификатором преобразования %f, последовательность "100e" (самый длинный префикс возможно допустимого числа с плавающей запятой) потребляется, что приводит к ошибке сопоставления (потреблённая последовательность не может быть преобразована в число с плавающей запятой), при этом "r" остаётся. Некоторые существующие реализации не следуют этому правилу и откатываются, потребляя только "100", оставляя "er", например, glibc bug 1765.

Если спецификация преобразования недопустима, поведение не определено.