mbsinit()

Determine the status of the conversion object used for restartable mb*() functions

Synopsis:

#include <wchar.h>

int mbsinit( const mbstate_t * ps );

Arguments:

ps: A pointer to the conversion object that you want to test.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The following functions use an object of type mbstate_t so that they can be restarted:

c16rtomb(), c32rtomb()
mbrlen()
mbrtowc()
mbsrtowcs()
mbstowcs()
wcsrtombs()
wcrtomb()

The mbsinit() function determines whether or not the mbstate_t object pointed to by ps describes an initial conversion state.

Note: If the object doesn't describe an initial conversion state, it isn't safe for you to use it in one of the above functions, other than the one you've already used it in.

Returns:

A nonzero value if ps is NULL or *ps describes an initial conversion state; otherwise zero.

Classification:

ANSI, POSIX 1003.1

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes