Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

mbsinit(3) Guardian Native C Library Calls Reference Manual
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.
4−90 Hewlett-Packard Company 527192-018