Determines the display width of wide characters.
#include <string.h>
int wcwidth ( WC)
wchar_t WC;
The wcwidth subroutine determines the number of display columns to be occupied by the wide character specified by the WC parameter. The LC_CTYPE subroutine affects the behavior of the wcwidth subroutine.
| WC | Specifies a wide character. |
The wcwidth subroutine returns the number of display columns to be occupied by the WC parameter. If the WC parameter is a wide character null, a value of 0 is returned. If the WC parameter points to an unusable wide character code, -1 is returned.
To find the display column width of a wide character, use the following:
#include <string.h> #include <locale.h> #include <stdlib.h>
main()
{
wchar_t wc;
int retval;
(void)setlocale(LC_ALL, "");
/* Let wc be the wide character whose
** display width is to be found.
*/
retval= wcwidth( wc );
if(retval == -1){
/*
** Error handling. Invalid wide character in wc.
*/
}
}
This subroutine is part of Base Operating System (BOS) Runtime.
The wcswidth (wcswidth Subroutine) subroutine.
National Language Support Overview for Programming, Subroutines Overview, Understanding Wide Character Display Column Width Subroutines in AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.