path: root/man/ru/mpu_scanf.3

.TH MPU_SCANF 3 "Сентябрь 2026" "libmpuio" "Руководство программиста LIBMPUIO"
.SH ИМЯ
mpu_scanf, mpu_fscanf, mpu_sscanf, mpu_vscanf, mpu_vfscanf, mpu_vsscanf,
mpu_scanf_unlocked, mpu_fscanf_unlocked, mpu_vscanf_unlocked,
mpu_vfscanf_unlocked \- форматированный ввод UCS-2, включая числа libmpu
.SH ОБЗОР
.nf
#include <libmpuio.h>

int       mpu_scanf( const __mpu_char16_t *format, ... );
int       mpu_fscanf( mpu_FILE *stream,
                      const __mpu_char16_t *format, ... );
int       mpu_sscanf( const __mpu_char16_t *string,
                      const __mpu_char16_t *format, ... );
int       mpu_vscanf( const __mpu_char16_t *format, va_list args );
int       mpu_vfscanf( mpu_FILE *stream,
                       const __mpu_char16_t *format, va_list args );
int       mpu_vsscanf( const __mpu_char16_t *string,
                       const __mpu_char16_t *format, va_list args );
int       mpu_scanf_unlocked( const __mpu_char16_t *format, ... );
int       mpu_fscanf_unlocked( mpu_FILE *stream,
                               const __mpu_char16_t *format, ... );
int       mpu_vscanf_unlocked( const __mpu_char16_t *format, va_list args );
int       mpu_vfscanf_unlocked( mpu_FILE *stream,
                                const __mpu_char16_t *format, va_list args );
.fi
.SH ОПИСАНИЕ
Семейство
.BR mpu_scanf ()
читает форматированный текст, используя 16-битные строки формата и назначения
.B __mpu_char16_t
(UCS-2).
.PP
Для потока реального файла внешний UTF-8 декодируется в UCS-2 до интерпретации
форматированного ввода.  Для строкового ввода исходная строка уже находится в
UCS-2.  Сырой байтовый ввод через
.BR mpu_fread (3)
в этом преобразовании не участвует.
.PP
Функции соответствуют обычному семейству scanf stdio:
.BR mpu_scanf ()
читает из
.BR mpu_stdin ,
.BR mpu_fscanf ()
\- из указанного потока, а
.BR mpu_sscanf ()
\- из NUL-терминированной строки UCS-2.  V-функции принимают
.B va_list
вместо вариадических аргументов.
.PP
Unlocked-формы не захватывают mutex потока.  Они предназначены для
использования, когда вызывающая сторона владеет блокировкой потока через
.BR mpu_flockfile (3),
либо внешняя синхронизация гарантирована другим способом.
.SH ФОРМАТ
Строка формата содержит обычные символы UCS-2, пробельные символы и
спецификации преобразования.
.PP
Обычный непробельный символ должен точно совпасть со следующим входным
символом.  Пробельный символ в формате поглощает ноль или больше пробельных
символов входа.
.PP
Преобразование начинается с
.B %
и имеет общий вид
.PP
.nf
%[*][width][length]conversion
.fi
.PP
Для объектов libmpu обычный модификатор длины заменяется историческим
модификатором размера
.B z<bits>
или
.BR Z<bits> .
Обе формы эквивалентны:
.PP
.nf
%[*][width]z<bits>conversion
%[*][width]Z<bits>conversion
.fi
.PP
Литерал знака процента задаётся как
.BR %% .
.SH ПОДАВЛЕНИЕ ПРИСВАИВАНИЯ
Звёздочка сразу после
.B %
подавляет присваивание.  Входные данные потребляются как обычно, но аргумент-
указатель не извлекается, а преобразование не увеличивает возвращаемое значение.
.PP
Например,
.PP
.nf
%*d %d
.fi
.PP
пропускает первое десятичное целое и сохраняет второе.
.SH ШИРИНА ПОЛЯ
Десятичная ширина поля ограничивает максимальное число входных символов,
потребляемых этим преобразованием.  Это максимум, а не минимум.
.PP
Например,
.PP
.nf
%3d
.fi
.PP
читает не более трёх символов, принадлежащих десятичному целому.
.PP
Реализация проверяет накопление ширины поля на целочисленное переполнение.
Переполнение ширины устанавливает
.B errno
в
.B EOVERFLOW
и не допускается к внутреннему wrap-around.
.SH СЕМАНТИКА ДИАПАЗОНА ОБЫЧНЫХ ЦЕЛЫХ
Обычные целочисленные токены преобразуются через
.BR strtoimax (3)
или
.BR strtoumax (3)
до сохранения в выбранный тип назначения scanf.
Весь токен, принятый scanner LIBMPUIO, должен также полностью потребляться
нативной функцией преобразования; расхождение scanner/parser отвергается вместо
молчаливого принятия хвостового суффикса.
.PP
Для совместимости с поведением scanf в стиле glibc преобразование в тип
назначения, более узкий чем
.B intmax_t
или
.BR uintmax_t ,
использует нативное сужающее преобразование C.  Поэтому на поддерживаемых
GNU/Linux-системах с дополнительным кодом значения вроде 128, читаемого через
.BR %hhd ,
и 256, читаемого через
.BR %hhu ,
дают тот же результат с wrap-around, что и glibc scanf, и сами по себе не
обязаны устанавливать
.BR errno .
.PP
Если сам входной токен выходит за диапазон, принимаемый
.B strtoimax
или
.BR strtoumax ,
нативный parser устанавливает
.B errno
в
.B ERANGE,
после чего его насыщенный результат сохраняется с использованием выбранного
модификатора длины.  LIBMPUIO сохраняет это поведение.  Программам, которым
нужен переносимый ввод целых произвольного диапазона, следует использовать
MPU-целочисленные преобразования
.B z/Z<bits>
вместо зависимости от нативного сужения за пределами диапазона типа назначения C.
.SH МОДИФИКАТОРЫ ДЛИНЫ
Для обычных целочисленных преобразований и
.B %n
поддерживаются следующие модификаторы длины:
.TP
.B hh
Указатель на
.B signed char
или
.B unsigned char
в зависимости от преобразования.
.TP
.B h
Указатель на
.B short
или
.BR unsigned short .
.TP
.B l
Указатель на
.B long
или
.BR unsigned long .
Для вещественных преобразований
.B %lf
сохраняет в
.BR double\ * .
.TP
.B ll
Указатель на
.B long long
или
.BR unsigned long long .
.TP
.B j
Указатель на
.B intmax_t
или
.BR uintmax_t .
.TP
.B t
Указатель на
.B ptrdiff_t
или соответствующий беззнаковый целочисленный тип.
.TP
.B L
Для обычного вещественного преобразования сохранять в
.BR long\ double\ * .
.PP
Стандартный модификатор длины C
.B z
намеренно не реализован.  В LIBMPUIO и
.B z,
и
.B Z
вводят описанный ниже модификатор размера LibMPU.
.SH ПРЕОБРАЗОВАНИЕ СИМВОЛА
.TP
.B %c
Читает один символ UCS-2 в
.BR __mpu_char16_t\ * .
В отличие от большинства преобразований,
.B %c
не пропускает начальные пробелы.  Ширина поля больше единицы читает ровно это
число символов UCS-2.  Завершающий NUL не добавляется.
.SH ПРЕОБРАЗОВАНИЕ СТРОКИ
.TP
.B %s
Читает последовательность непробельных символов UCS-2 в
.BR __mpu_char16_t\ * .
Начальные пробелы входа пропускаются.  Добавляется завершающий NUL UCS-2.
Вызывающая сторона должна предоставить достаточно памяти для выбранной ширины
поля плюс терминатор либо для всего входного токена, если ширина не указана.
.TP
.B %a
Расширение LIBMPUIO: сопоставляет последовательность непробельных входных
символов и сохраняет их через
.BR __mpu_char8_t\ *
как NUL-терминированную многобайтовую строку, закодированную согласно активной
локали
.BR LC_CTYPE .
Для файловых и консольных потоков внешний многобайтовый ввод декодируется
LIBMPUIO до применения преобразования scanf.
Ширина поля ограничивает число входных символов, а не число байтов в результирующей
многобайтовой строке.  Поэтому буфер назначения должен иметь достаточно места
для преобразованной строки и завершающего NUL.  Символ, который нельзя
представить в активной локали, приводит к ошибке преобразования
.BR EILSEQ .
Модификаторы длины и MPU-модификатор
.B z/Z<bits>
к этому преобразованию не применяются.
.SH ПРЕОБРАЗОВАНИЕ SCANSET
.TP
.B %[
Читает непустую последовательность символов UCS-2, выбранных scanset, и
добавляет завершающий NUL.
.PP
Поддерживаются, в частности, формы:
.PP
.nf
%[abc]
%[a-z]
%[^0-9]
%[]a-z]
.fi
.PP
Начальный
.B ^
инвертирует набор.  Диапазоны распознаются.  Закрывающую скобку
.B ]
можно включить в набор, поместив её первым символом.  Как и для
.BR %c ,
начальные пробелы автоматически не пропускаются.
.SH ЗНАКОВЫЕ ЦЕЛОЧИСЛЕННЫЕ ПРЕОБРАЗОВАНИЯ
.TP
.B %d
Читает знаковое десятичное целое.
.TP
.B %i
Читает знаковое целое с основанием, определяемым из входа в соответствии с
обычной нотацией целых C.
.PP
Тип назначения выбирается модификатором длины.  Без модификатора назначения
имеет тип
.BR int\ * .
.SH БЕЗЗНАКОВЫЕ ЦЕЛОЧИСЛЕННЫЕ ПРЕОБРАЗОВАНИЯ
.TP
.B %u
Читает беззнаковое десятичное целое.
.TP
.B %o
Читает беззнаковое восьмеричное целое.
.TP
.B %x, %X
Читает беззнаковое шестнадцатеричное целое.  Шестнадцатеричные буквенные цифры
могут следовать непосредственно после необязательного префикса
.B 0x
или
.BR 0X .
.TP
.B %b, %B
Расширение libmpuio: читает беззнаковое двоичное целое.  Допускается
необязательный префикс
.B 0b
или
.BR 0B .
.PP
Текущий scanner также распознаёт совместимые преобразования
.BR %D ,
.BR %O
и
.BR %U .
.PP
Тип назначения выбирается модификатором длины.  Без модификатора это
.BR unsigned\ int\ * .
.SH ПРЕОБРАЗОВАНИЕ УКАЗАТЕЛЯ
.TP
.B %p
Читает шестнадцатеричное представление указателя и сохраняет результат через
.BR void\ ** .
.SH ОБЫЧНЫЕ ВЕЩЕСТВЕННЫЕ ПРЕОБРАЗОВАНИЯ
.TP
.B %e, %E, %f, %F, %g, %G
Читают обычное значение с плавающей точкой.  Лексический вход преобразуется
через
.BR strtold (3)
после преобразования токена UCS-2 в многобайтовую кодировку активной локали.
.PP
Без модификатора длины назначение имеет тип
.BR float\ * .
С
.B l
\-
.BR double\ * ,
а с
.B L
\-
.BR long\ double\ * .
.PP
Для
.B %e/%E/%f/%F/%g/%G
scanner принимает знаковые десятичные значения, формы с десятичной экспонентой
и поддерживаемые специальные значения, например infinity и NaN.  Обычный
вещественный ввод также принимает C-формы NaN
.BR nan()
и
.BR nan(payload) ,
где payload содержит ASCII-буквы, цифры или символ подчёркивания.  Регистр
написания не учитывается; допускается необязательный начальный знак.
.PP
Обычный вещественный ввод следует активному символу десятичного разделителя
.BR LC_NUMERIC .
Scanner получает строку десятичного разделителя локали из
.BR localeconv (3),
преобразует её в строгий UCS-2 для распознавания токена, а завершённый числовой
токен преобразует обратно в многобайтовую кодировку активной локали до вызова
.BR strtold (3).
Это относится к вводу
.BR %e/%E/%f/%F/%g/%G .
.PP
Следовательно, обычный форматированный вывод и обычный форматированный ввод
используют одно и то же соглашение о десятичном разделителе локали.  В локали C
разделителем остаётся
.BR . ;
например, в локали с запятой в качестве десятичного разделителя обычный ввод
принимает формы вроде
.BR 12,5 .
.PP
Это правило локали относится только к обычным вещественным преобразованиям C.
MPU-преобразования вещественных/комплексных чисел
.B z<bits>
и
.B Z<bits>
продолжают использовать числовую грамматику LIBMPU и не переинтерпретируются
обычным tokenizer локали libc.
.SH ПРЕОБРАЗОВАНИЕ СЧЁТЧИКА
.TP
.B %n
Сохраняет число символов UCS-2, потреблённых к этому моменту.  Оно не потребляет
вход и не увеличивает число успешных присваиваний, возвращаемое функцией.
.PP
Обычные модификаторы длины
.BR hh , h , l , ll , j
и
.B t
выбирают целочисленный тип назначения для
.BR %n .
.SH МОДИФИКАТОР РАЗМЕРА LIBMPU
Модификатор размера LibMPU для чисел произвольной точности имеет вид:
.PP
.nf
z<bits>
Z<bits>
.fi
.PP
Строчная и прописная формы эквивалентны.  LIBMPUIO намеренно не реализует
стандартный модификатор длины C
.B z
для
.BR size_t .
Поэтому, например,
.B %zu
означает преобразование беззнакового целого LibMPU с размером по умолчанию, а не
преобразование
.BR size_t .
.PP
Если после
.B z
или
.BR Z
нет десятичных цифр, предполагается 128 бит.  Десятичное поле
.I bits
должно обозначать один из поддерживаемых размеров MPU:
.PP
.nf
8, 16, 32, 64, 128, 256, 512, 1024,
2048, 4096, 8192, 16384, 32768, 65536
.fi
.PP
Фактическая грамматика компилируется по значению
.B MPU_REAL_IO_LIMIT
из
.BR <libmpu.h> .
Существуют только размеры, не превышающие это значение.  Если LibMPU настроена с
.B MPU_REAL_IO_LIMIT=16384,
то
.B z32768/Z32768
и
.B z65536/Z65536
являются недопустимыми модификаторами формата; они отвергаются до выполнения
преобразования.
.PP
Допустимый размер не зависит от класса следующего преобразования.  После разбора
модификатора целочисленные преобразования работают с целыми объектами libmpu,
вещественные \- с вещественными объектами libmpu, а
.B j/J
\- с комплексными объектами libmpu.  Для целочисленных преобразований допустимы
размеры начиная с 8 бит; для вещественных и комплексных требуется не менее 32
бит.
.PP
.B MPU_MATH_FN_LIMIT
ограничивает только трансцендентные/математические операции и не определяет
грамматику форматированного ввода.
.SH МОДЕЛЬ ТИПОВ НАЗНАЧЕНИЯ
Обычные и MPU-преобразования ввода также имеют отдельные контракты назначения.
Для обычных преобразований преобразование и стандартный модификатор длины
выбирают указатель на соответствующий тип назначения C, например
.B int *
для
.B %d
или
.B double *
для
.BR %lf .
.PP
Для MPU-преобразования
.B z<bits>
или
.B Z<bits>
выбирает одновременно MPU-интерпретацию и точный размер хранилища.  Аргумент
назначения указывает на объект MPU этого размера.  При array typedef libmpu
передача имени массива естественно предоставляет указатель на первый байт его
хранилища:
.PP
.nf
mpu_int128_t   x;
mpu_real128_t  r;

mpu_sscanf( text, MPU_UCS2("%z128u"), x );
mpu_sscanf( text, MPU_UCS2("%z128g"), r );
.fi
.PP
Указатель назначения не содержит метаданных размера времени выполнения, поэтому
scanner не может определить битовую ширину MPU по указателю.  Явный модификатор
размера необходим для описания того, как интерпретировать указанное хранилище.
Обычные назначения C должны использовать обычные преобразования C, а не MPU-
преобразование только как способ переинтерпретации представления объекта.

.SH ЦЕЛОЧИСЛЕННЫЕ ПРЕОБРАЗОВАНИЯ LIBMPU
Следующие преобразования принимают указатель на целый объект libmpu, размер
хранилища которого соответствует запрошенному
.BR z/Z<bits> :
.TP
.B %z<bits>d, %Z<bits>d, %z<bits>i, %Z<bits>i
Читать знаковое целое произвольной точности.
.TP
.B %z<bits>u, %Z<bits>u
Читать беззнаковое десятичное целое произвольной точности.
.TP
.B %z<bits>o, %Z<bits>o
Читать беззнаковое восьмеричное целое произвольной точности.
.TP
.B %z<bits>x, %Z<bits>x, %z<bits>X, %Z<bits>X
Читать беззнаковое шестнадцатеричное целое произвольной точности.
.TP
.B %z<bits>b, %Z<bits>b, %z<bits>B, %Z<bits>B
Читать беззнаковое двоичное целое произвольной точности.
.PP
Префиксы основания нормализуются до преобразования libmpu.  Поэтому scanner
может передавать каноническое представление, ожидаемое
.BR iatoi ()
и
.BR iatoui (),
не требуя от вызывающей стороны самостоятельно обрабатывать префиксы.
.PP
Примеры:
.PP
.nf
mpu_int128_t  x;
mpu_sscanf( text, fmt_Z128x, x );
.fi
.SH ВЕЩЕСТВЕННЫЕ ПРЕОБРАЗОВАНИЯ LIBMPU
Исторические вещественные преобразования:
.TP
.B %z<bits>r, %Z<bits>r, %z<bits>R, %Z<bits>R
Читать вещественное значение libmpu произвольной точности.
.TP
.B %z<bits>e/%Z<bits>e, %z<bits>E/%Z<bits>E, %z<bits>f/%Z<bits>f, %z<bits>F/%Z<bits>F, %z<bits>g/%Z<bits>g, %z<bits>G/%Z<bits>G
Читать вещественное значение libmpu произвольной точности с соответствующим
именем преобразования форматированного ввода.
.PP
Все эти преобразования сохраняют результат в вещественный объект libmpu
выбранного размера.  В частности, и
.B %Z128R,
и
.B %Z128E
ожидают назначение
.BR mpu_real128_t .
Они используют один и тот же путь преобразования вещественного числа и оба
принимают полную вещественную форму, формируемую форматами вещественного вывода.
Преобразование выполняется через
.BR ascii_to_real ()
из libmpu.
.PP
Для совместимости с историческим языком форматов CODE.LIB вещественный вывод
через
.B %r/%R
использует разделитель экспоненты
.BR e/E .
Поэтому значение, выведенное через
.BR %Z128R ,
можно прочитать обратно как через
.BR %Z128R ,
так и через
.BR %Z128E .
.PP
Соответствие типов назначения:
.PP
.nf
%Z128R  -> mpu_real128_t
%Z128E  -> mpu_real128_t
%Z128J  -> mpu_complex128_t
.fi
.SH КОМПЛЕКСНЫЕ ПРЕОБРАЗОВАНИЯ LIBMPU
.TP
.B %z<bits>j, %Z<bits>j, %z<bits>J, %Z<bits>J
Читать комплексное значение libmpu в исторической нотации действительной/
мнимой части.  Назначение является комплексным объектом libmpu выбранного
размера; например,
.B %Z128J
ожидает
.BR mpu_complex128_t .
.PP
Например, следующая нативная форма выводится комплексным форматом верхнего
регистра:
.PP
.nf
1.250000R+0000-2.500000J+0000
.fi
.PP
Scanner отделяет действительную и мнимую компоненты, преобразует каждую через
.BR ascii_to_real ()
и объединяет их через
.BR c_gen_complex () .
Класс возврата
.BR ascii_to_real ()
является определяющим: r/R обозначает действительную компоненту, j/J \- мнимую.
Любая компонента может отсутствовать и тогда инициализируется точным нулём.
Между двумя компонентами и после начального знака допускаются пробелы.  Если
возможная вторая компонента не является мнимой, пробное чтение и все
промежуточные пробелы возвращаются во вход, чтобы последующие данные оставались
доступными следующему преобразованию.
.PP
Специальные формы LIBMPU inf, NaN и ind принимаются вместе с их суффиксными
формами _e/_r/_j.  Scanner определяет только лексическую границу; числовую
интерпретацию выполняет LIBMPU.
.PP
Токен, не содержащий десятичных цифр, считается числовым только при наличии
явной десятичной точки.  Поэтому `.`, `+.e`, `-.r` и `.j` принимаются, а
отдельные `e`, `r` и `j` (включая варианты со знаком или суффиксом экспоненты)
не являются числовыми токенами.  Это лексическое ограничение предотвращает
смешение обычного буквенного ввода с числовыми константами, несмотря на то что
.BR ascii_to_real ()
напрямую принимает исторические формы из одной буквы.
.PP
Для принятых форм с точкой без цифр scanner добавляет явную нулевую мантиссу и
передаёт канонический токен в
.BR ascii_to_real () .
Эта функция LibMPU остаётся определяющей для числового значения и класса
компоненты e/r/j.  Обычные конечные значения и синтаксис специальных значений
передаются без изменений и не интерпретируются этой совместимой нормализацией.
.PP
Строчное имя
.B j
конфликтует со стандартным целочисленным модификатором длины
.BR j .
Если после него следует обычное целочисленное преобразование,
.B j
трактуется как стандартный модификатор длины
.BR intmax_t/uintmax_t .
В MPU-преобразовании, особенно после
.BR z/Z<bits> ,
это символ комплексного преобразования.
.SH ПРЕОБРАЗОВАНИЕ СЧЁТЧИКА LIBMPU
.TP
.B %z<bits>n, %Z<bits>n
Сохраняет число символов UCS-2, потреблённых к этому моменту, в целый объект
libmpu выбранного размера.  Оно не потребляет вход и не увеличивает число
присваиваний.
.SH ОТКАТ ЧИСЛОВОГО ТОКЕНА
Для десятичного вещественного ввода маркер экспоненты и необязательный знак
возвращаются назад, если после них нет цифры экспоненты.  Поэтому вход вроде
.B 12e+X
может сопоставить 12, оставив e+X для последующего ввода.  То же правило
соблюдается, когда ширина поля заканчивается посередине экспоненты.
.PP
Незавершённый payload NaN является ошибкой сопоставления; токен откатывается,
а не молча принимается частично.
.PP
libmpuio сохраняет символы, не являющиеся частью успешно принятого числового
токена.  Это включает суффиксные символы после целого и незавершённые
конструкции основания или экспоненты.
.PP
Например, при сканировании целого из входа, концептуально эквивалентного
.PP
.nf
123abc
.fi
.PP
буквы остаются доступными следующему преобразованию.  Аналогично, незавершённые
префиксы
.B 0x
или
.B 0b
и незавершённые вещественные экспоненты откатываются, а не молча теряются.
.SH UTF-8 И UCS-2
Весь форматированный текст внутри libmpuio находится в UCS-2.  Реальные файлы и
консольные потоки используют UTF-8 снаружи.  Корректные скалярные значения UTF-8
выше U+FFFF не представимы строгим UCS-2 и потому приводят к
.BR EILSEQ .
Пары суррогатов UTF-16 не синтезируются.
.PP
Назначения
.BR %c ,
.BR %s
и
.B %[
поэтому используют хранилище
.BR __mpu_char16_t ,
а не платформенный тип
.BR wchar_t .
Преобразование LIBMPUIO
.B %a
является явным интерфейсом многобайтовой строки текущей локали и сохраняет через
.BR __mpu_char8_t\ * .
.SH ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успехе функции возвращают число присвоенных входных элементов.
Преобразование, подавленное через
.BR * ,
не учитывается.  Преобразование
.B %n
также не учитывается.
.PP
Если ошибка ввода возникает до первого успешного присваивания, возвращается
.BR mpu_EOF .
Ошибка сопоставления до любого присваивания возвращает ноль.  Если последующее
преобразование завершается ошибкой после одного или нескольких присваиваний,
возвращается число завершённых присваиваний.
.SH ОШИБКИ
Ошибки нижележащего потока и decoder UTF-8 отражаются в состоянии ошибки потока
и
.BR errno .
Некорректный или непредставимый UTF-8 может устанавливать
.BR EILSEQ .
Ширина формата или размер MPU в битах, десятичное накопление которых переполняет
внутреннее целочисленное представление, могут устанавливать
.BR EOVERFLOW .
.PP
Недопустимые потоки или недопустимые внутренние аргументы могут устанавливать
.BR EINVAL .
.SH ПОТОКОБЕЗОПАСНОСТЬ
Обычные потоковые функции блокируют объект
.B mpu_FILE
на время сканирования.  Формы
.B *_unlocked
не захватывают mutex.
.PP
Типичная последовательность явной блокировки:
.PP
.nf
mpu_flockfile( fp );
r = mpu_fscanf_unlocked( fp, format, &value );
mpu_funlockfile( fp );
.fi
.SH ПРИМЕРЫ
Прочитать обычное десятичное целое и слово UCS-2:
.PP
.nf
__mpu_char16_t  format[] = MPU_UCS2("%d %s");
__mpu_char16_t  word[64];
int             value;

if( mpu_sscanf(text, format, &value, word) == 2 ) {
  /* здесь доступны value и word. */
}
.fi
.PP
Прочитать многобайтовое слово текущей локали:
.PP
.nf
__mpu_char8_t  word8[64];

if( mpu_sscanf(text, MPU_UCS2("%a"), word8) == 1 ) {
  /* word8 содержит многобайтовую строку текущей локали. */
}
.fi
.PP
Прочитать 128-битное целое libmpu:
.PP
.nf
mpu_int128_t    value;
__mpu_char16_t  format[] = MPU_UCS2("%Z128x");

if( mpu_fscanf(fp, format, value) == 1 ) {
  /* value содержит шестнадцатеричное целое. */
}
.fi
.PP
Прочитать одно и то же 128-битное вещественное значение через преобразование R
или E:
.PP
.nf
mpu_real128_t r1, r2;

mpu_sscanf( MPU_UCS2( "1.23456789E+10" ),
            MPU_UCS2( "%Z128R" ),
            r1 );

mpu_sscanf( MPU_UCS2( "1.23456789E+10" ),
            MPU_UCS2( "%Z128E" ),
            r2 );

mpu_printf( MPU_UCS2( "R: %Z128R\n" ), r1 );
mpu_printf( MPU_UCS2( "E: %Z128R\n" ), r2 );
.fi
.PP
Оба присваивания выше записывают в объекты
.BR mpu_real128_t .
Комплексное назначение используется только с нативным комплексным
преобразованием
.BR j/J .
.PP
Прочитать 128-битное вещественное и комплексное значение:
.PP
.nf
mpu_real128_t     r;
mpu_complex128_t  c;
__mpu_char16_t    format[] = MPU_UCS2( "%Z128E %Z128J" );

if( mpu_fscanf( fp, format, r, c ) == 2 )
{
  /* r и c были преобразованы libmpu. */
}
.fi
.SH ПРИМЕЧАНИЯ
Язык форматов LIBMPUIO намеренно сохраняет исторический синтаксис размера
чисел LibMPU.  Поэтому строчная
.B z
зарезервирована для LibMPU вместе с прописной
.BR Z ;
она не является модификатором длины C для
.BR size_t .
.SH СМ. ТАКЖЕ
.BR libmpuio (3),
.BR mpu_printf (3),
.BR mpu_fopen (3),
.BR mpu_fread (3),
.BR mpu_flockfile (3),
.BR strtold (3)
.SH БЛОКИРУЕМЫЙ И UNLOCKED-ФОРМАТИРОВАННЫЙ ВВОД
.BR mpu_fscanf_unlocked (),
.BR mpu_vfscanf_unlocked (),
.BR mpu_scanf_unlocked ()
и
.BR mpu_vscanf_unlocked ()
используют ровно тот же scanner, что и обычные потоковые формы, но не выполняют
неявную блокировку потока.  Токенизация, rollback, число присваиваний, семантика
нативного диапазона, MPU-преобразования z/Z<bits>, EOF/ошибка сопоставления и
ошибки не изменяются.
.PP
Семейство sscanf сканирует память UCS-2, принадлежащую вызывающей стороне, а не
поток mpu_FILE, и потому не имеет stream-unlocked варианта.