function
<cwchar>
wctob
Convert wide character to single byte
Returns the single-byte representation of the wide character wc if (and only if) wc corresponds to a multibyte character with a length of a single byte in the initial state of a multibyte sequence.
Otherwise, it returns EOF.
Parameters
- wc
- The wint_t promotion of a wide character.
The value is internally converted to a wchar_t to be interpreted.
Return Value
If wc translates to a single-byte character in the initial shift state of a multibyte sequence, the function returns its representation as an unsigned char (promoted to a value of type int).
Otherwise, it returns EOF.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/* wctob example */
#include <wchar.h>
#include <stdio.h>
int main()
{
int i,num;
const wchar_t wcs [] = L"wctob example";
num=0;
for (i=0; i<wcslen(wcs); ++i)
if (wctob(wcs[i]) != EOF) ++num;
wprintf (L"wcs contains %d characters that translate to single-byte characters.",num);
return 0;
}
Output:
wcs contains 14 characters that translate to single-byte characters.
See also
- btowc
- Convert single byte character to wide character (function)
- wcrtomb
- Convert wide character to multibyte sequence (function)
- wcsrtombs
- Convert wide-character string to multibyte string (function)