-curs_addch(3x)curs_addch(3x)
+curs_addch(3x) Library calls curs_addch(3x)
@@ -74,12 +74,12 @@
o The cursor automatically wraps to the beginning of the next line.
- o At the bottom of the current scrolling region, and if scrollok is
- enabled, the scrolling region is scrolled up one line.
+ o At the bottom of the current scrolling region, and if scrollok(3x)
+ is enabled, the scrolling region is scrolled up one line.
- o If scrollok is not enabled, writing a character at the lower right
- margin succeeds. However, an error is returned because it is not
- possible to wrap to a new line
+ o If scrollok(3x) is not enabled, writing a character at the lower
+ right margin succeeds. However, an error is returned because it is
+ not possible to wrap to a new line
If ch is a tab, newline, carriage return or backspace, the cursor is
moved appropriately within the window:
@@ -97,9 +97,19 @@
may be altered by setting the TABSIZE variable.
If ch is any other nonprintable character, it is drawn in printable
- form, i.e., the ^X notation used by unctrl(3x). Calling winch after
- adding a nonprintable character does not return the character itself,
- but instead returns the printable representation of the character.
+ form, using the same convention as unctrl(3x):
+
+ o Control characters are displayed in the ^X notation.
+
+ o Values above 128 are either meta characters (if the screen has not
+ been initialized, or if meta(3x) has been called with a TRUE E
+ parameter), shown in the M-X notation, or are displayed as
+ themselves. In the latter case, the values may not be printable;
+ this follows the X/Open specification.
+
+ Calling winch after adding a nonprintable character does not return the
+ character itself, but instead returns the printable representation of
+ the character.
Video attributes can be combined with a character argument passed to
addch or related functions by logical-ORing them into the character.
@@ -178,9 +188,9 @@
If it is not possible to add a complete character, an error is
returned:
- o If scrollok is not enabled, writing a character at the lower right
- margin succeeds. However, an error is returned because it is not
- possible to wrap to a new line
+ o If scrollok(3x) is not enabled, writing a character at the lower
+ right margin succeeds. However, an error is returned because it is
+ not possible to wrap to a new line
o If an error is detected when converting a multibyte character to a
sequence of bytes, or if it is not possible to add all of the
@@ -198,9 +208,9 @@
- X/Open Curses states that the ACS_ definitions are char constants. For
+ X/Open Curses states that the ACS_ definitions are char constants. For
the wide-character implementation (see curs_add_wch), there are
- analogous WACS_ definitions which are cchar_t constants. Some
+ analogous WACS_ definitions which are cchar_t constants. Some
implementations are problematic:
o Some implementations define the ACS symbols to a constant (such as
@@ -210,8 +220,8 @@
NetBSD also uses an array, actually named _acs_char, with a #define
for compatibility.
- o HPUX curses equates some of the ACS_ symbols to the analogous WACS_
- symbols as if the ACS_ symbols were wide characters. The
+ o HPUX curses equates some of the ACS_ symbols to the analogous WACS_
+ symbols as if the ACS_ symbols were wide characters. The
misdefined symbols are the arrows and other symbols which are not
used for line-drawing.
@@ -221,7 +231,7 @@
implementations use i (lowercase).
None of the terminal descriptions on Unix platforms use uppercase-
- I, except for Solaris (i.e., screen's terminal description,
+ I, except for Solaris (i.e., screen's terminal description,
apparently based on the X/Open documentation around 1995). On the
other hand, the terminal description gs6300 (AT&T PC6300 with EMOTS
Terminal Emulator) uses lowercase-i.
@@ -233,7 +243,7 @@
second-hand list of their character descriptions has come to light.
The ACS-prefixed names for them were invented for ncurses(3x).
- The displayed values for the ACS_ and WACS_ constants depend on
+ The displayed values for the ACS_ and WACS_ constants depend on
o the library configuration, i.e., ncurses versus ncursesw, where the
latter is capable of displaying Unicode while the former is not,
@@ -298,7 +308,7 @@
- curs_addch(3x)
+ncurses 6.4 2023-07-01 curs_addch(3x)