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

Technical Reference: Base Operating System and Extensions, Volume 1


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


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.

Implementation Specifics

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

Related Information

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

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


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