function
<cwchar>
mbsinit
int mbsinit (const mbstate_t* ps);
Check if initial conversion state
Checks whether ps points to a mbstate_t object that describes an initial conversion state.
A zero-valued mbstate_t object always describes an initial conversion state, although other values may also represent such state (depending on the particular library implementation). This function returns non-zero for any mbstate_t object representing an initial state, or if ps is a null pointer.
Calling this function never changes the state identified by ps.
The state pointed by ps can be set to the initial state by calling:
1
memset (ps,0,sizeof(*ps)); // ps points now to a zero-valued object
Parameters
- ps
- Pointer to an mbstate_t object.
Return Value
A non-zero value if ps points to a mbstate_t object that describes an initial conversion state, or if ps is a null pointer.
Otherwise, a zero value is returned.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/* mbsinit example */
#include <wchar.h>
#include <string.h>
#include <stdio.h>
int main()
{
char buffer[80];
mbstate_t mbst;
const wchar_t wcs [] = L"mbsinit example";
const wchar_t * p;
p = wcs;
if ( !mbsinit(&mbst) )
memset (&mbst,0,sizeof(mbst)); /* set to initial state */
wcsrtombs ( buffer, &p, 80, &mbst);
printf (buffer);
return 0;
}
Output:
See also
- wcrtomb
- Convert wide character to multibyte sequence (function)
- mbrtowc
- Convert multibyte sequence to wide character (function)
- wcsrtombs
- Convert wide-character string to multibyte string (function)
- mbsrtowcs
- Convert multibyte string to wide-character string (function)