wcswidth(3)		    Library Functions Manual		     wcswidth(3)

NAME
     wcswidth - determine columns needed for a fixed-size wide-character string

LIBRARY
     Standard C library (libc, -lc)

SYNOPSIS
     #define _XOPEN_SOURCE	       /* See feature_test_macros(7) */
     #include <wchar.h>

     int wcswidth(const wchar_t *s, size_t n);

DESCRIPTION
     The  wcswidth()  function returns the number of columns needed to represent
     the wide-character string pointed to by s, but at most n  wide  characters.
     If	 a  nonprintable wide character occurs among these characters, -1 is re-
     turned.

RETURN VALUE
     The wcswidth() function returns the number	 of  column  positions	for  the
     wide-character string s, truncated to at most length n.

ATTRIBUTES
     For  an  explanation  of the terms used in this section, see attributes(7).
     allbox; lbx lb lb l l l.  Interface Attribute Value T{ wcswidth()
     T}	  Thread safety	  MT-Safe locale

STANDARDS
     POSIX.1-2008.

HISTORY
     POSIX.1-2001.

NOTES
     The behavior of wcswidth() depends on the LC_CTYPE category of the	 current
     locale.

SEE ALSO
     iswprint(3), wcwidth(3)

Linux man-pages 6.18		   2026-02-08			     wcswidth(3)