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;
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
Item | Description |
---|---|
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.