[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

mbstomb Subroutine

Purpose

Extracts a multibyte character from a multibyte character string.

Note: The mbstomb 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 <mbstr.h>
mbchar_t mbstomb (MbString)
const char *MbString;

Description

The mbstomb subroutine extracts the multibyte character pointed to by the MbString parameter from the multibyte character string. The LC_CTYPE category affects the behavior of the mbstomb subroutine.

Parameters

MbString Contains a multibyte character string.

Return Values

The mbstomb subroutine returns the code point of the multibyte character as a mbchar_t data type. If an unusable multibyte character is encountered, a value of 0 is returned.

Implementation Specifics

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

Related Information

The mbschr subroutine, mbspbrk subroutine, mbsrchr subroutine.

National Language Support Overview for Programming, Subroutines Overview in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]