X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getcchar.3x.html;h=c2f8ad01a7bf557c8071724ad25044c648bbb1ed;hp=73597971cc9650d294451fa788635da29a8324e2;hb=bca50d0d8592defee6c584fdedd25f4b1a31345b;hpb=3eda6f30a84d53844d2ebceadb457e2e7e9cfbf3 diff --git a/doc/html/man/curs_getcchar.3x.html b/doc/html/man/curs_getcchar.3x.html index 73597971..c2f8ad01 100644 --- a/doc/html/man/curs_getcchar.3x.html +++ b/doc/html/man/curs_getcchar.3x.html @@ -26,13 +26,13 @@ * sale, use or other dealings in this Software without prior written * * authorization. * **************************************************************************** - * @Id: curs_getcchar.3x,v 1.18 2017/03/31 10:50:54 tom Exp @ + * @Id: curs_getcchar.3x,v 1.19 2017/11/18 23:47:37 tom Exp @ -->
- +-curs_getcchar(3x) curs_getcchar(3x) +curs_getcchar(3x) curs_getcchar(3x)
- 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 + getcchar, setcchar - Get a wide character string and rendition from a + cchar_t or set a cchar_t from a wide-character string
@@ -72,96 +71,84 @@
- 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: + 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: o Extracts information from a cchar_t value wcval - o Stores the character attributes in the location - pointed to by attrs + o Stores the character attributes in the location pointed to by attrs - o Stores the color-pair in the location pointed to by - color_pair + o Stores the color-pair in the location pointed to by color_pair - o Stores the wide-character string, characters refer- - enced by wcval, into the array pointed to by wch. + o Stores the wide-character string, characters referenced by wcval, + into the array pointed to by wch. - When wch is a null pointer, the getcchar function does the - following: + When wch is a null pointer, the getcchar function does the following: - o Obtains the number of wide characters pointed to by - wcval + o Obtains the number of wide characters pointed to by wcval - o Does not change the data referenced by attrs or - color_pair + o Does not change the data referenced by attrs or color_pair
- The setcchar function initializes the location pointed to - by wcval by using: + The setcchar function initializes the location pointed to by wcval by + using: o The character attributes in attrs o The color pair in color_pair - 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. + 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. + 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. + The string may contain a single control character instead. In that + case, no nonspacing characters are allowed.
- X/Open Curses documents the opts argument as reserved for - future use, saying that it must be null. This implementa- - tion uses that parameter in ABI 6 for the functions which - have a color-pair parameter to support extended color - pairs: + 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: - o For functions which modify the color, e.g., setc- - char, 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. + 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. - o For functions which retrieve the color, e.g., getc- - char, 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 standard - pointer to short parameter. + 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.
- 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. + 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.
- When wch is a null pointer, getcchar returns the number of - wide characters referenced by wcval, including one for a - trailing null. + 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. + When wch is not a null pointer, getcchar returns OK upon successful + completion, and ERR otherwise. - Upon successful completion, setcchar returns OK. Other- - wise, it returns ERR. + Upon successful completion, setcchar returns OK. Otherwise, it returns + ERR.
- Functions: curs_attr(3x), curs_color(3x), curses(3x), - wcwidth(3). + Functions: curs_attr(3x), curs_color(3x), curses(3x), wcwidth(3). - curs_getcchar(3x) + curs_getcchar(3x)