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

c
curses_intro(3X) curses_intro(3X)
(X/Open CURSES)
Function Families Provided
Function Names Description swc Refer to
Add (Overwrite)
[mv][w]addch(3X) add a character Y Y Y addch(3X)
[mv][w]addch[n]str(3X) add a character string N N N addchstr(3X)
[mv][w]add[n]str(3X) add a string Y Y Y addnstr(3X)
[mv][w]add[n]wstr(3X) add a wide character string Y Y Y addnwstr(3X)
[mv][w]add_wch(3X) add a wide character and rendition Y Y Y add_wch(3X)
[mv][w]add_wch[n]str(3X) add an array of wide characters and renditions ? N N add_wchnstr(3X)
Change Renditions
[mv][w]chgat(3X) change renditions of characters in a window - N N chgat(3X)
Delete
[mv][w]delch(3X) delete a character - - N delch(3X)
Get (Input from Keyboard to Window)
[mv][w]getch(3X) get a character Y Y Y getch(3X)
[mv][w]get[n]str(3X) get a character string Y Y Y getnstr(3X)
[mv][w]get_wch(3X) get a wide character Y Y Y get_wch(3X)
[mv][w]get[n]_wstr(3X) get an array of wide characters and key codes Y Y Y get_wstr(3X)
Explicit Cursor Movement
[w]move(3X) move the cursor - - - move(3X)
Input (Read Back from Window)
[mv][w]inch(3X) input a character - - - inch(3X)
[mv][w]inch[n]str(3X) input an array of characters and attributes - - - inchnstr(3X)
[mv][w]in[n]str(3X) input a string - - - innstr(3X)
[mv][w]in[n]wstr(3X) input a string of wide characters - - - innwstr(3X)
[mv][w]in_wch(3X) input a wide character and rendition - - - in_wch(3X)
[mv][w]in_wch[n]str(3X) input an array of wide characters and renditions - - - inwchnstr(3X)
Insert
[mv][w]insch(3X) insert a character Y N N insch(3X)
[mv][w]ins[n]str(3X) insert a character string Y N N insnstr(3X)
[mv][w]ins_[n]wstr(3X) insert a wide-character string Y N N ins_nwstr(3X)
[mv][w]ins_wch(3X) insert a wide character Y N N ins_wch(3X)
Print and Scan
[mv][w]printw(3X) print formatted output - - - mvprintw(3X)
[mv][w]scanw(3X) 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.)
s Y means these functions perform special-character processing (see Special Characters in
curses_intro). N means they do not. ? means the results are unspecified when these functions
are applied to special characters.
w Y means these functions perform wrapping (see Truncation, Wrapping and Scrolling in
curses_intro). N means they do not.
c Y means these functions advance the cursor (see Truncation, Wrapping and Scrolling in
curses_intro). N means they do not.
- The attribute specified by this column does not apply to these functions.
Interfaces Implemented as Macros
The following interfaces with arguments must be implemented as macros. The relevance to the applica-
tion programmer is that the ‘&’ character cannot be used before the arguments.
Macros Man page Entry
COLOR_PAIR( ) can_change_color()
getbegyx(),getmaxyx (),getparyx (),getyx() getbegyx()
The header file reference manual pages list other macros, like COLOR_BLACK, that do not take argu-
ments.
HP-UX 11i Version 2: September 2004 − 13 − Hewlett-Packard Company Section 3−−179