Technical Reference: Base Operating System and Extensions, Volume 1

mbsinvalid Subroutine

Purpose

Validates characters of multibyte character strings.

Note

The mbsinvalid 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>

char *mbsinvalid ( S) const char *S;

Description

The mbsinvalid subroutine examines the string pointed to by the S parameter to determine the validity of characters. The LC_CTYPE category affects the behavior of the mbsinvalid subroutine.

Parameters

S	Contains a multibyte character string.

Return Values

The mbsinvalid subroutine returns a pointer to the byte following the last valid multibyte character in the S parameter. If all characters in the S parameter are valid multibyte characters, a null pointer is returned. If the S parameter is a null pointer, the behavior of the mbsinvalid subroutine is unspecified.

Related Information

The mbsadvance Subroutine.

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

National Language Support Overview in AIX 5L Version 5.2 National Language Support Guide and Reference