mbtowc
- Updated2023-02-21
- 1 minute(s) read
mbtowc
int mbtowc (wchar_t *wideCharCode, const char multibyteChar[], size_t byteLimit);
Purpose
Determines the number of bytes that are contained in the specified multibyte character and the code that corresponds to that multibyte character.
Parameters
| Input | ||
| Name | Type | Description |
| multibyteChar | const char [] | Contains a pointer to the multibyte character that is examined. The function determines the wide character code of this multibyte character. |
| byteLimit | size_t | Specifies the maximum number of bytes that are examined in the multibyte character. |
| Output | ||
| Name | Type | Description |
| wideCharCode | wchar_t | Contains the wide character code value that corresponds to the specified multibyte character. |
Return Value
| Name | Type | Description |
| numberOfBytes | int | Contains the number of bytes in the multibyte character. If multibyteChar is a null pointer, the function returns zero if multibyte characters are not state-dependent; otherwise, a nonzero value is returned. The function returns -1 if byteLimit bytes do not form a valid multibyte character. The function returns zero if multibyteChar points to the null character. |
Additional Information
Library: ANSI C Library
Include file: ansi_c.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later