HP-UX Reference (11i v2 07/12) - 3 Library Functions A-M (vol 6)

c
curses_intro(3X) curses_intro(3X)
(X/Open CURSES)
• A function with the basic name is often provided for historical compatibility and operates only on
single-byte characters. A function with the same name plus the
w infix operates on wide (multibyte)
characters. A function with the same name plus the
_w infix operates on complex characters and
their renditions.
• When a function with the basic name operates on a single character, there is sometimes a function
with the same name plus the
n infix that operates on multiple characters. An
n argument specifies
the number of characters to process. The respective manpage specifies the outcome if the value of
n is
inappropriate.
Function Families Provided
Function Names Description s w c Refer to
Add (Overwrite)
[mv][w]addch() add a character Y Y Y addch(3X)
[mv][w]addch[n]str() add a character string N N N addchstr(3X)
[mv][w]add[n]str() add a string Y Y Y addnstr(3X)
add a wide-character string[mv][w]add[n]wstr() YYYaddnwstr(3X)
add a wide character and
rendition
[mv][w]add_wch() YYYadd_wch(3X)
add an array of wide charac-
ters and renditions
[mv][w]add_wch[n]str() ?NNadd_wchnstr(3X)
Change Renditions
change renditions of charac-
ters in a window
[mv][w]chgat() -NNchgat(3X)
Delete
[mv][w]delch() delete a character - - N delch(3X)
Get (Input from Keyboard
to Window)
[mv][w]getch() get a character Y Y Y getch(3X)
[mv][w]get[n]str() get a character string Y Y Y getnstr(3X)
[mv][w]get_wch() get a wide character Y Y Y get_wch(3X)
get an array of wide charac-
ters and key codes
[mv][w]get[n]_wstr() YYYget_wstr(3X)
Explicit Cursor Movement
[w]move() move the cursor - - - move(3X)
Input (Read Back from
Window)
[mv][w]inch() input a character - - - inch(3X)
input an array of characters
and attributes
[mv][w]inch[n]str() ---inchnstr(3X)
[mv][w]in[n]str() input a string - - - innstr(3X)
input a string of wide charac-
ters
[mv][w]in[n]wstr() ---innwstr(3X)
input a wide character and
rendition
[mv][w]in_wch() ---in_wch(3X)
input an array of wide char-
acters and renditions
[mv][w]in_wch[n]str() ---in_wchnstr(3X)
Insert
[mv][w]insch() insert a character Y N N insch(3X)
[mv][w]ins[n]str() insert a character string Y N N insnstr(3X)
insert a wide-character string[mv][w]ins_[n]wstr() YNNins_nwstr(3X)
[mv][w]ins_wch() insert a wide character Y N N ins_wch(3X)
Print and Scan
[mv][w]printw() print formatted output - - - mvprintw(3X)
[mv][w]scanw() convert formatted output - - - mvscanw(3X)
Legend
The following notation indicates the effect when characters are moved to the screen. (For the Get func-
tions, this applies only when echoing is enabled.)
266 Hewlett-Packard Company − 12 − HP-UX 11i Version 2: December 2007 Update