NAME

wcswidth — number of column positions in 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 the first n characters of pwcs, or until a null wide character (L'\0') is encountered.

RETURN VALUES

The wcswidth() function returns 0 if pwcs is an empty string (L""), -1 if a non-printing wide character is encountered, otherwise it returns the number of column positions occupied.

SEE ALSO

iswprint(3), strlen(3), wcslen(3), wcwidth(3)

STANDARDS

The wcswidth() function conforms to IEEE Std 1003.1-2001 (“POSIX.1”).

HISTORY

The wcswidth() function was ported from NetBSD and first appeared in OpenBSD 3.8.