[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 1

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

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.

Related Information

The mblen (mblen Subroutine) subroutine, mbstowcs (mbstowcs Subroutine) subroutine, mbtowc (mbtowc Subroutine) subroutine.

Subroutines, Example Programs, and Libraries in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.

National Language Support Overview and Multibyte Code and Wide Character Code Conversion Subroutines in AIX 5L Version 5.2 National Language Support Guide and Reference.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]