mblen Subroutine

Purpose

Determines the length in bytes of a multibyte character.

Library

Standard C Library (libc.a)

Syntax

#include <stdlib.h>

int mblen( MbString, Number) const char *MbString; size_t Number;

Description

The mblen subroutine determines the length, in bytes, of a multibyte character.

Parameters

Item	Description
Mbstring	Points to a multibyte character string.
Number	Specifies the maximum number of bytes to consider.

Return Values

The mblen subroutine returns 0 if the MbString parameter points to a null character. It returns -1 if a character cannot be formed from the number of bytes specified by the Number parameter. If MbString is a null pointer, 0 is returned.