wcswidth

Section: C Library Functions (3)
Updated: 2022-12-15
Index Return to Main Contents
 

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

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).
InterfaceAttributeValue
wcswidth() Thread safetyMT-Safe locale

 

STANDARDS

POSIX.1-2001, POSIX.1-2008.  

NOTES

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

SEE ALSO

iswprint(3), wcwidth(3)


 

Index

NAME
LIBRARY
SYNOPSIS
DESCRIPTION
RETURN VALUE
ATTRIBUTES
STANDARDS
NOTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 06:13:52 GMT, May 08, 2024