Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (i - m) mbsinit(3)
NAME
mbsinit - determine conversion object status
LIBRARY
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <wchar.h>
int mbsinit(const mbstate_t *ps);
PARAMETERS
ps Points to the mbstate_t object to be evaluated.
DESCRIPTION
If the ps parameter is not a null pointer, the mbsinit( ) function determines whether the pointed-to
mbstate_t opject describes an initial conversion state.
RETURN VALUES
The mbsinit( ) function returns a nonzero value if ps is a null pointer or if the the object ps points
to describes an initial conversion state. Otherwise the mbsinit( ) function returns 0 (zero).
The behavior is undefined if an mbstate_t object is altered by any of the functions described as
"restartable" and is then used in one of these ways:
• With a different character sequence.
• In the other conversion direction.
ERRORS
No errors are returned.
RELATED INFORMATION
Functions: wctob(3).
STANDARDS CONFORMANCE
The behavior of this function conforms to the ISO/IEC 9899:1999 standard.
527187-017 Hewlett-Packard Company 4−181