1MBSINIT(P)                 POSIX Programmer's Manual                MBSINIT(P)
2
3
4

NAME

6       mbsinit - determine conversion object status
7

SYNOPSIS

9       #include <wchar.h>
10
11       int mbsinit(const mbstate_t *ps);
12
13

DESCRIPTION

15       If  ps  is  not  a null pointer, the mbsinit() function shall determine
16       whether the object pointed to by ps  describes  an  initial  conversion
17       state.
18

RETURN VALUE

20       The  mbsinit()  function shall return non-zero if ps is a null pointer,
21       or if the pointed-to object describes an initial conversion state; oth‐
22       erwise, it shall return zero.
23
24       If  an mbstate_t object is altered by any of the functions described as
25       "restartable", and is then used with a different character sequence, or
26       in  the  other conversion direction, or with a different LC_CTYPE cate‐
27       gory setting than on earlier function calls, the behavior is undefined.
28

ERRORS

30       No errors are defined.
31
32       The following sections are informative.
33

EXAMPLES

35       None.
36

APPLICATION USAGE

38       The mbstate_t object is used to describe the current  conversion  state
39       from  a  particular character sequence to a wide-character sequence (or
40       vice versa) under the rules of a particular  setting  of  the  LC_CTYPE
41       category of the current locale.
42
43       The  initial  conversion  state corresponds, for a conversion in either
44       direction, to the beginning of a new character sequence in the  initial
45       shift  state.  A  zero  valued  mbstate_t object is at least one way to
46       describe an initial conversion state. A zero  valued  mbstate_t  object
47       can be used to initiate conversion involving any character sequence, in
48       any LC_CTYPE category setting.
49

RATIONALE

51       None.
52

FUTURE DIRECTIONS

54       None.
55

SEE ALSO

57       mbrlen() , mbrtowc() , wcrtomb() , mbsrtowcs() , wcsrtombs() , the Base
58       Definitions volume of IEEE Std 1003.1-2001, <wchar.h>
59

61       Portions  of  this text are reprinted and reproduced in electronic form
62       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
63       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
64       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
65       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
66       event of any discrepancy between this version and the original IEEE and
67       The  Open Group Standard, the original IEEE and The Open Group Standard
68       is the referee document. The original Standard can be  obtained  online
69       at http://www.opengroup.org/unix/online.html .
70
71
72
73IEEE/The Open Group                  2003                           MBSINIT(P)
Impressum