WCSWIDTH(3) | Library Functions Manual | WCSWIDTH(3)

# 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.

July 25, 2011 | Debian