NAME

wcwidth - number of column positions of a wide-character code

 SYNOPSIS

#include <wchar.h>

int wcwidth(wchar_t wc);

 DESCRIPTION

The wcwidth() function determines the number of column positions required for the wide character wc. The value of wc must be a character representable as a wchar_t, and must be a wide-character code corresponding to a valid character in the current locale.

 RETURN VALUE

The wcwidth() function either returns 0 (if wc is a null wide-character code), or returns the number of column positions to be occupied by the wide-character code wc, or returns -1 (if wc does not correspond to a printing wide-character code).

 ERRORS

No errors are defined.

 EXAMPLES

None.

 APPLICATION USAGE

This function was removed from the final ISO C Amendment 1, and the return value for a non-printable wide character is not specified.

 FUTURE DIRECTIONS

None.

 SEE ALSO

wcswidth(), <wchar.h>.

DERIVATION

Derived from MSE working draft.