X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addch.3x.html;h=74834b36d5ff0c214ef7e518f829954378650506;hp=c0af2f68e20bdb7db782cd268595c743b5d5b517;hb=eccca377f55c70b12e3e92621d94d1e1c1fcfb7d;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40 diff --git a/doc/html/man/curs_addch.3x.html b/doc/html/man/curs_addch.3x.html index c0af2f68..74834b36 100644 --- a/doc/html/man/curs_addch.3x.html +++ b/doc/html/man/curs_addch.3x.html @@ -1,7 +1,7 @@
- +X/Open Curses states that the ACS_ definitions are char constants. For the wide-character implementation (see curs_add_wch), there are analo- gous WACS_ definitions which are cchar_t constants. @@ -205,11 +207,46 @@ acters except by using UTF-8 (see the discussion of NCURSES_NO_UTF8_ACS in ncurses(3x)). - The TABSIZE variable is implemented in some versions of curses, but is + +
+ X/Open Curses assumes that the parameter passed to waddch contains a + single character. As discussed in curs_attr(3x), that character may + have been more than eight bits in an SVr3 or SVr4 implementation, but + in the X/Open Curses model, the details are not given. The important + distinction between SVr4 curses and X/Open Curses is that the non-char- + acter information (attributes and color) was separated from the charac- + ter information which is packed in a chtype to pass to waddch. + + In this implementation, chtype holds eight bits. But ncurses allows + multibyte characters to be passed in a succession of calls to waddch. + The other implementations do not do this; a call to waddch passes + exactly one character which may be rendered as one or more cells on the + screen depending on whether it is printable. + + Depending on the locale settings, ncurses will inspect the byte passed + in each call to waddch, and check if the latest call will continue a + multibyte sequence. When a character is complete, ncurses displays the + character and moves to the next position in the screen. + + If the calling application interrupts the succession of bytes in a + multibyte character by moving the current location (e.g., using wmove), + ncurses discards the partially built character, starting over again. + + For portability to other implementations, do not rely upon this behav- + ior: + + o check if a character can be represented as a single byte in the + current locale before attempting call waddch, and + + o call wadd_wch for characters which cannot be handled by waddch. + + +
+ The TABSIZE variable is implemented in some versions of curses, but is not part of X/Open curses. If ch is a carriage return, the cursor is moved to the beginning of the - current row of the window. This is true of other implementations, but + current row of the window. This is true of other implementations, but is not documented. @@ -217,7 +254,7 @@ curses(3x), curs_attr(3x), curs_clear(3x), curs_inch(3x), curs_out- opts(3x), curs_refresh(3x), curs_variables(3x), putc(3). - Comparable functions in the wide-character (ncursesw) library are + Comparable functions in the wide-character (ncursesw) library are described in curs_add_wch(3x). @@ -237,7 +274,13 @@