C mblen() function

C mblen() function - Get number of bytes in a character

Syntax mblen() function

int mblen(const char *str, size_t n)

The mblen() function is used to get the length in bytes of the multibyte character pointed to by string. n represents the maximum number of bytes examined.

Parameters mblen() function

Return value from mblen()

If string is NULL, the mblen() function returns:

• A non-zero value indicates that the active locale supports mixed-byte strings.The function initializes the state variable.
• Zero otherwise.

If string is not NULL, mblen() returns:

• A non-zero value indicates that the active locale supports mixed-byte strings. The function initializes the state variable.
• Zero otherwise.

Example: mblen() function

The following example shows the usage of mblen() function.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    int      i;
    char    *mbstr = (char *)malloc( sizeof( char ) );

    i = mblen( mbstr, MB_CUR_MAX );
    printf( "Length in bytes of multibyte character %x: %u\n", *mbstr, i );

    mbstr = NULL;
    i = mblen( mbstr, MB_CUR_MAX );
    printf( "Length in bytes of NULL multibyte character %x: %u\n", mbstr, i );
}

Output:

Length in bytes of multibyte character ffffff80: 1
Length in bytes of NULL multibyte character 0: 0

C Programming Code Editor:

Previous C Programming: C ldiv()
Next C Programming: C mbstowcs()