Функция mblen

Прототип функции mblen:

int mblen( const char * ptrmb, size_t max );

Заголовочный файл

Описание

Функция возвращает длину строки, которая состоит из многобайтовых символов. Строка передается в функцию в качестве аргумента, через указатель ptrmb. Размер многобайтовых символов задается через параметр max.
mblen имеет свои собственные внутренние состояния, которые изменяются по мере необходимости при вызове этой функции.

Параметры:

• ptrmb Указатель на первый байт строки с многобайтовыми символами.

• max
  Максимальное количество байтов, для проверки длинны символа. Не более MB_CUR_MAX символов рассматривается в любом случае.

Возвращаемое значение

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

Если передаваемый аргумент через указатель ptrmb является нулевым указателем, то функция возвращает ненулевое значение, если кодировка многобайтовых символов является платформо-зависимой, и — ноль, в других случаях.