X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getcchar.3x.html;h=34d4aae0e6dbd5f1b3aa72bb4fb8f6bf435b23d1;hp=1358430cbc2f9d5239c9446a8a71836db5b14416;hb=06078d3fa68db669ed37178c01873546b4b28745;hpb=77afe78361875f531dc2bf8d73f2e781c8e76176 diff --git a/doc/html/man/curs_getcchar.3x.html b/doc/html/man/curs_getcchar.3x.html index 1358430c..34d4aae0 100644 --- a/doc/html/man/curs_getcchar.3x.html +++ b/doc/html/man/curs_getcchar.3x.html @@ -1,7 +1,6 @@ - + + + curs_getcchar 3x -

curs_getcchar 3x

-
+

curs_getcchar 3x

-
-curs_getcchar(3x)                                     curs_getcchar(3x)
+curs_getcchar(3x)                                            curs_getcchar(3x)
 
 
 
 
-
-

NAME

-       getcchar,  setcchar - Get a wide character string and ren-
-       dition from a cchar_t or set a cchar_t from a wide-charac-
-       ter string
+

NAME

+       getcchar,  setcchar  - Get a wide character string and rendition from a
+       cchar_t or set a cchar_t from a wide-character string
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
        int getcchar(
@@ -71,88 +68,103 @@
                void *opts );
 
 
-
-

DESCRIPTION

-       The  getcchar  function  gets  a wide-character string and
-       rendition from a cchar_t argument.  When wch is not a null
-       pointer, the getcchar function does the following:
+

DESCRIPTION

 
-       -    Extracts information from a cchar_t value wcval
+

getcchar

+       The getcchar function gets a wide-character string and rendition from a
+       cchar_t  argument.   When wch is not a null pointer, the getcchar func-
+       tion does the following:
 
-       -    Stores  the  character  attributes  in  the  location
-            pointed to by attrs
+       o   Extracts information from a cchar_t value wcval
 
-       -    Stores the color-pair in the location pointed  to  by
-            color_pair
+       o   Stores the character attributes in the location pointed to by attrs
 
-       -    Stores  the  wide-character string, characters refer-
-            enced by wcval, into the array pointed to by wch.
+       o   Stores the color-pair in the location pointed to by color_pair
 
-       When wch is a null pointer, the getcchar function does the
-       following:
+       o   Stores the wide-character string, characters referenced  by  wcval,
+           into the array pointed to by wch.
 
-       -    Obtains  the  number of wide characters pointed to by
-            wcval
+       When wch is a null pointer, the getcchar function does the following:
 
-       -    Does not change  the  data  referenced  by  attrs  or
-            color_pair
+       o   Obtains the number of wide characters pointed to by wcval
 
-       The  setcchar function initializes the location pointed to
-       by wcval by using:
+       o   Does not change the data referenced by attrs or color_pair
 
-       -    The character attributes in attrs
 
-       -    The color pair in color_pair
+

setcchar

+       The  setcchar  function initializes the location pointed to by wcval by
+       using:
 
-       -    The wide-character string pointed  to  by  wch.   The
-            string  must be L'\0' terminated, contain at most one
-            spacing character, which must be the first.
+       o   The character attributes in attrs
 
-            Up to CCHARW_MAX-1 nonspacing characters may  follow.
-            Additional nonspacing characters are ignored.
+       o   The color pair in color_pair
 
-            The  string  may  contain  a single control character
-            instead.  In that case, no nonspacing characters  are
-            allowed.
+       o   The wide-character string pointed to by wch.  The  string  must  be
+           L'\0' terminated, contain at most one spacing character, which must
+           be the first.
 
+           Up to CCHARW_MAX-1 nonspacing characters  may  follow.   Additional
+           nonspacing characters are ignored.
 
-
-

NOTES

-       The  opts argument is reserved for future use.  Currently,
-       an application must provide a null pointer as opts.
+           The string may contain a single control character instead.  In that
+           case, no nonspacing characters are allowed.
 
-       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.
 
+

EXTENSIONS

+       X/Open Curses documents the opts argument as reserved for  future  use,
+       saying  that  it must be null.  This implementation uses that parameter
+       in ABI 6 for the functions which have a color-pair parameter to support
+       extended color pairs:
 
-
-

RETURN VALUES

-       When wch is a null pointer, getcchar returns the number of
-       wide characters referenced by wcval, including one  for  a
-       trailing null.
+       o   For   functions  which modify the color, e.g., setcchar, if opts is
+           set it is treated as a pointer to int, and used to  set  the  color
+           pair instead of the short pair parameter.
 
-       When  wch  is not a null pointer, getcchar returns OK upon
-       successful completion, and ERR otherwise.
+       o   For  functions which retrieve the color, e.g., getcchar, if opts is
+           set it is treated as a pointer to int, and  used  to  retrieve  the
+           color pair as an int value, in addition retrieving it via the stan-
+           dard pointer to short parameter.
 
-       Upon successful completion, setcchar returns  OK.   Other-
-       wise, it returns ERR.
 
+

NOTES

+       The wcval argument may be a value generated by a call to setcchar or by
+       a function that has a cchar_t output argument.  If wcval is constructed
+       by any other means, the effect is unspecified.
 
-
-

SEE ALSO

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

RETURN VALUE

+       When wch is a null pointer, getcchar returns the number of wide charac-
+       ters 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.
+
+       Upon successful completion, setcchar returns OK.  Otherwise, it returns
+       ERR.
+
+
+

SEE ALSO

+       Functions: curs_attr(3x), curs_color(3x), curses(3x), wcwidth(3).
 
 
 
-                                                      curs_getcchar(3x)
+                                                             curs_getcchar(3x)
 
-
-
-Man(1) output converted with -man2html -
+