mbslen Subroutine

Purpose

Determines the number of characters (code points) in a multibyte character string.

Note: The mbslen subroutine is specific to the manufacturer. It is not defined in the POSIX, ANSI, or X/Open standards. Use of this subroutine may affect portability.

Library

Standard C Library (libc.a)

Syntax

#include <stdlib.h>

size_t mbslen( MbString)
char *mbs;

Description

The mbslen subroutine determines the number of characters (code points) in a multibyte character string. The LC_CTYPE category affects the behavior of the mbslen subroutine.

Parameters

Item Description
MbString Points to a multibyte character string.

Return Values

The mbslen subroutine returns the number of multibyte characters in a multibyte character string. It returns 0 if the MbString parameter points to a null character or if a character cannot be formed from the string pointed to by this parameter.