[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, 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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The mblen subroutine, mbstowcs subroutine, mbtowc subroutine.

National Language Support Overview for Programming, Subroutines Overview, Understanding Multibyte Code and Wide Character Code Conversion Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]