WCWIDTH(3C) Standard C Library Functions WCWIDTH(3C)

NAME

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

SYNOPSIS

#include <wchar.h>

int wcwidth(wchar_t wc);

#include <wchar.h>
#include <xlocale.h>

int wcwidth_l(wchar_t wc, locale_t loc);

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.

The function wcwidth_l() behaves identically to wcwidth(), except
instead of operating in the current locale, it operates in the locale
specified by loc.

RETURN VALUES

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

ERRORS

No errors are defined.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|CSI | Enabled |
+--------------------+-----------------+
|Interface Stability | See below. |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

The wcwidth() function is Standard. The wcwidth_l() function is
Uncommitted.

SEE ALSO

newlocale(3C), setlocale(3C), uselocale(3C), wcswidth(3C),
attributes(7), standards(7)

June 25, 2014 WCWIDTH(3C)