X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getcchar.3x.html;h=1358430cbc2f9d5239c9446a8a71836db5b14416;hp=d6e961f4b93d00a978c768d26635211fcf087eca;hb=77afe78361875f531dc2bf8d73f2e781c8e76176;hpb=027ae42953e3186daed8f3882da73de48291b606 diff --git a/doc/html/man/curs_getcchar.3x.html b/doc/html/man/curs_getcchar.3x.html index d6e961f4..1358430c 100644 --- a/doc/html/man/curs_getcchar.3x.html +++ b/doc/html/man/curs_getcchar.3x.html @@ -1,7 +1,7 @@ @@ -106,26 +106,32 @@ - The wide-character string pointed to by wch. The string must be L'\0' terminated, contain at most one - character with strictly positive width, which must be - the first, and contain no characters of negative - width. + spacing character, which must be the first. + + Up to CCHARW_MAX-1 nonspacing characters may follow. + Additional nonspacing characters are ignored. + + The string may contain a single control character + instead. In that case, no nonspacing characters are + allowed.

NOTES

-       The opts argument is reserved for future use.   Currently,
+       The  opts argument is reserved for future use.  Currently,
        an application must provide a null pointer as opts.
 
-       The  wcval  argument may be a value generated by a call to
-       setcchar or by a function that has a cchar_t output  argu-
-       ment.   If  wcval  is  constructed by any other means, the
+       The wcval argument may be a value generated by a  call  to
+       setcchar  or by a function that has a cchar_t output argu-
+       ment.  If wcval is constructed by  any  other  means,  the
        effect is unspecified.
 
 
 

RETURN VALUES

        When wch is a null pointer, getcchar returns the number of
-       wide characters referenced by wcval.
+       wide characters referenced by wcval, including one  for  a
+       trailing null.
 
        When  wch  is not a null pointer, getcchar returns OK upon
        successful completion, and ERR otherwise.
@@ -136,8 +142,8 @@
 
 

SEE ALSO

-       Functions:   curses(3x),  wcwidth(3x),  curs_attr_get(3x),
-       can_change_color(3x).
+       Functions:   curs_attr(3x),   curs_color(3x),  curses(3x),
+       wcwidth(3).