Determines if a wide character corresponds to a multibyte character and returns its multibyte character representation.

#include <wchar.h>

int wctob(wint_t wc);

Parameters

wc

The value to translate.

Remarks

The wctob function converts a wide character contained in wchar to the corresponding multibyte character passed by the return int value, if the multibyte character is exactly one byte long.

If wctob was unsuccessful and no corresponding multibyte character was found, the function sets errno to EILSEQ and returns -1.

Return Values

If wctob successfully converts a wide character, it returns its multibyte character representation, only if the multibyte character is exactly one byte long. If wctob encounters a wide character it cannot convert to a multibyte character or the multibyte character is not exactly one byte long, it returns a –1.

Requirements