mbsinit(3C)															       mbsinit(3C)

NAME

       mbsinit() - determine conversion object status

SYNOPSIS

DESCRIPTION

       If ps is not a null pointer, the function determines whether the object pointed to by ps describes an initial conversion state.

APPLICATION USAGE

       The mbstate_t object is used to describe the current conversion state from a particular character sequence to a wide-character sequence (or
       vice versa) under the rules of a particular setting of the category of the current locale.

       The initial conversion state corresponds, for a conversion in either direction, to the beginning of a new character sequence in the initial
       shift  state.   A zero valued mbstate_t object is at least one way to describe an initial conversion state.  A zero valued mbstate_t object
       can be used to initiate conversion involving any character sequence.

       The prototype of this function is available to applications if they are:

	      a. conformant.

	      b. Compiled with macro with a value >=500.

	      c. Compiled with macro with a value >= 200112.

EXTERNAL INFLUENCES

   Environment Variables
       The behavior of this function is affected by the category of the current locale.

RETURN VALUE

       The function returns non-zero if ps is a null pointer, or if the pointed-to object describes an initial	conversion  state;  otherwise,	it
       returns zero.

       The  behavior  is  undefined  if an mbstate_t object is altered by any of the functions described as "restartable", and is then used with a
       different character sequence, or in the other conversion direction, or with a different category setting than on earlier function calls.

ERRORS

       No errors are defined.

AUTHOR

       was developed by HP and Mitsubishi Electric Corporation.

SEE ALSO

       mbrlen(3C), mbrtowc(3C), mbsrtowcs(3C), wcrtomb(3C), wcsrtombs(3C).

																       mbsinit(3C)