std::mblen
| Определено в заголовочном файле <cstdlib>
|
||
int mblen( const char* s, std::size_t n ); |
||
Определяет размер в байтах многобайтового символа, на первый байт которого указывает s.
Если s является нулевым указателем, сбрасывает глобальное состояние преобразования и определяет, используются ли последовательности сдвига.
Это функция эквивалента вызову std::mbtowc((wchar_t*)0, s, n), за исключением того, что состояние преобразования std::mbtowc не изменяется.
Примечание
Каждый вызов mblen обновляет глобальное внутреннее состояние преобразования (в статическом объекте типа std::mbstate_t, известного только этой функции). Если многобайтовая кодировка использует состояния сдвига необходимо соблюдать осторожность, чтобы не допустить возврата или повторного сканирования. В любом случае несколько потоков не должны вызывать mblen без синхронизации: вместо этого можно использовать std::mbrlen.
Параметры
| s | — | указатель на многобайтовый символ |
| n | — | ограничение на количество байтов в s, которые могут быть проверены |
Возвращаемое значение
Если s не является нулевым указателем, возвращает количество байтов, содержащихся в многобайтовом символе, или -1, если первые байты, на которые указывает s, не формируют допустимый многобайтовый символ или 0, если s указывает на нулевой символ '\0'.
Если s является нулевым указателем, сбрасывает своё внутреннее состояние преобразования, чтобы установить начальное состояние сдвига, и возвращает 0, если текущая многобайтовая кодировка не зависит от состояния (не использует последовательности сдвига) или ненулевое значение, если текущая многобайтовая кодировка зависит от состояния (использует последовательности сдвига).
Пример
#include <clocale>
#include <cstdlib>
#include <iomanip>
#include <iostream>
#include <stdexcept>
#include <string_view>