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

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.

Implementation Specifics

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

Related Information

The mbsadvance (mbsadvance Subroutine) subroutine.

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


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