wcswidth(3C) Standard C Library Functions wcswidth(3C)NAMEwcswidth - number of column positions of a wide-character string
SYNOPSIS
#include <wchar.h>
int wcswidth(const wchar_t *pwcs, size_t n);
DESCRIPTION
The wcswidth() function determines the number of column positions
required for n wide-character codes (or fewer than n wide-character
codes if a null wide-character code is encountered before n wide-char‐
acter codes are exhausted) in the string pointed to by pwcs.
RETURN VALUES
The wcswidth() function either returns 0 (if pwcs points to a null
wide-character code), or returns the number of column positions to be
occupied by the wide-character string pointed to by pwcs, or returns −1
(if any of the first n wide-character codes in the wide-character
string pointed to by pwcs is not a printing wide-character code).
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│CSI │Enabled │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Standard │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe with exceptions │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsetlocale(3C), wcwidth(3C), attributes(5), standards(5)SunOS 5.10 14 Aug 2002 wcswidth(3C)