X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=Ada95%2Fhtml%2Fcurs_getch.3x.html;fp=Ada95%2Fhtml%2Fcurs_getch.3x.html;h=52d2397659c526d4e386eb04c27325be30f0d03b;hb=661078ddbde3ce0f3b06e95642fbb9b5fef7dca1;hp=a89c96e75748eba614d96a4fd928dfcac0b1d841;hpb=3a9b6a3bf0269231bef7de74757a910dedd04e0c;p=ncurses.git diff --git a/Ada95/html/curs_getch.3x.html b/Ada95/html/curs_getch.3x.html index a89c96e7..52d23976 100644 --- a/Ada95/html/curs_getch.3x.html +++ b/Ada95/html/curs_getch.3x.html @@ -92,42 +92,43 @@ KEY_CLOSE/Close key KEY_COMMAND/Cmd (command) key KEY_COPY/Copy key KEY_CREATE/Create key KEY_END/End key KEY_EXIT/Exit key KEY_FIND/Find key KEY_HELP/Help key - KEY_MARK/Mark key KEY_MESSAGE/Message key KEY_MOVE/Move - key KEY_NEXT/Next object key KEY_OPEN/Open key - KEY_OPTIONS/Options key KEY_PREVIOUS/Previous object key - KEY_REDO/Redo key KEY_REFERENCE/Ref(erence) key - KEY_REFRESH/Refresh key KEY_REPLACE/Replace key - KEY_RESTART/Restart key KEY_RESUME/Resume key + KEY_MARK/Mark key KEY_MESSAGE/Message key KEY_MOUSE/Mouse + event read KEY_MOVE/Move key KEY_NEXT/Next object key + KEY_OPEN/Open key KEY_OPTIONS/Options key KEY_PREVI- + OUS/Previous object key KEY_REDO/Redo key KEY_REFER- + ENCE/Ref(erence) key KEY_REFRESH/Refresh key + KEY_REPLACE/Replace key KEY_RESIZE/Screen resized + KEY_RESTART/Restart key KEY_RESUME/Resume key KEY_SAVE/Save key KEY_SBEG/Shifted beginning key KEY_SCAN- - CEL/Shifted cancel key KEY_SCOMMAND/Shifted command key - KEY_SCOPY/Shifted copy key KEY_SCREATE/Shifted create key - KEY_SDC/Shifted delete char key KEY_SDL/Shifted delete - line key KEY_SELECT/Select key KEY_SEND/Shifted end key + CEL/Shifted cancel key KEY_SCOMMAND/Shifted command key + KEY_SCOPY/Shifted copy key KEY_SCREATE/Shifted create key + KEY_SDC/Shifted delete char key KEY_SDL/Shifted delete + line key KEY_SELECT/Select key KEY_SEND/Shifted end key KEY_SEOL/Shifted clear line key KEY_SEXIT/Shifted exit key KEY_SFIND/Shifted find key KEY_SHELP/Shifted help key - KEY_SHOME/Shifted home key KEY_SIC/Shifted input key + KEY_SHOME/Shifted home key KEY_SIC/Shifted input key KEY_SLEFT/Shifted left arrow key KEY_SMESSAGE/Shifted mes- sage key KEY_SMOVE/Shifted move key KEY_SNEXT/Shifted next - key KEY_SOPTIONS/Shifted options key KEY_SPREVIOUS/Shifted - KEY_SRIGHT/Shifted right arrow KEY_SRSUME/Shifted resume - key KEY_SSAVE/Shifted save key KEY_SSUSPEND/Shifted sus- - pend key KEY_SUNDO/Shifted undo key KEY_SUSPEND/Suspend + redo key KEY_SREPLACE/Shifted replace key + KEY_SRIGHT/Shifted right arrow KEY_SRSUME/Shifted resume + key KEY_SSAVE/Shifted save key KEY_SSUSPEND/Shifted sus- + pend key KEY_SUNDO/Shifted undo key KEY_SUSPEND/Suspend key KEY_UNDO/Undo key Keypad is arranged like this: - center allbox tab(/) ; c c c . A1/up/A3 left/B2/right + center allbox tab(/) ; c c c . A1/up/A3 left/B2/right C1/down/C3 The has_key routine takes a key value from the above list, - and returns TRUE or FALSE according as the current termi- + and returns TRUE or FALSE according as the current termi- nal type recognizes a key with that value.
- All routines return the integer ERR upon failure and an + All routines return the integer ERR upon failure and an integer value other than ERR (OK in the case of ungetch()) upon successful completion. @@ -135,64 +136,63 @@
Use of the escape key by a programmer for a single charac- - ter function is discouraged, as it will cause a delay of + ter function is discouraged, as it will cause a delay of up to one second while the keypad code looks for a follow- ing function-key sequence. - When using getch, wgetch, mvgetch, or mvwgetch, nocbreak + When using getch, wgetch, mvgetch, or mvwgetch, nocbreak mode (nocbreak) and echo mode (echo) should not be used at - the same time. Depending on the state of the tty driver - when each character is typed, the program may produce + the same time. Depending on the state of the tty driver + when each character is typed, the program may produce undesirable results. Note that getch, mvgetch, and mvwgetch may be macros. Historically, the set of keypad macros was largely defined - by the extremely function-key-rich keyboard of the AT&T - 7300, aka 3B1, aka Safari 4. Modern personal computers - usually have only a small subset of these. IBM PC-style - consoles typically support little more than KEY_UP, - KEY_DOWN, KEY_LEFT, KEY_RIGHT, KEY_HOME, KEY_END, + by the extremely function-key-rich keyboard of the AT&T + 7300, aka 3B1, aka Safari 4. Modern personal computers + usually have only a small subset of these. IBM PC-style + consoles typically support little more than KEY_UP, + KEY_DOWN, KEY_LEFT, KEY_RIGHT, KEY_HOME, KEY_END, KEY_NPAGE, KEY_PPAGE, and function keys 1 through 12. The Ins key is usually mapped to KEY_IC.
- The *get* functions are described in the XSI Curses stan- - dard, Issue 4. They read single-byte characters only. - The standard specifies that they return ERR on failure, + The *get* functions are described in the XSI Curses stan- + dard, Issue 4. They read single-byte characters only. + The standard specifies that they return ERR on failure, but specifies no error conditions. - The echo behavior of these functions on input of KEY_ or - backspace characters was not specified in the SVr4 docu- - mentation. This description is adopted from the XSI - dled signals is unspecified in the SVr4 and XSI Curses - documentation. Under historical curses implementations, - it varied depending on whether the operating system's - implementation of handled signal receipt interrupts a - read(2) call in progress or not, and also (in some imple- - mentations) depending on whether an input timeout or non- + The echo behavior of these functions on input of KEY_ or + backspace characters was not specified in the SVr4 docu- + + The behavior of getch and friends in the presence of han- + dled signals is unspecified in the SVr4 and XSI Curses + documentation. Under historical curses implementations, + it varied depending on whether the operating system's + implementation of handled signal receipt interrupts a + read(2) call in progress or not, and also (in some imple- + mentations) depending on whether an input timeout or non- blocking mode hsd been set. Programmers concerned about portability should be prepared - for either of two cases: (a) signal receipt does not - interrupt getch; (b) signal receipt interrupts getch and - causes it to return ERR with errno set to EINTR. Under - the ncurses implementation, handled signals never inter- + for either of two cases: (a) signal receipt does not + interrupt getch; (b) signal receipt interrupts getch and + causes it to return ERR with errno set to EINTR. Under + the ncurses implementation, handled signals never inter- rupt getch. - The has_key function is unique to ncurses. We recommend - that any code using it be conditionalized on the NCURSES - feature macro. + The has_key function is unique to ncurses. We recommend + that any code using it be conditionalized on the + NCURSES_VERSION feature macro.
- curses(3X), curs_inopts(3X), curs_move(3X), - curs_refresh(3X). - - + curses(3X), curs_inopts(3X), curs_mouse(3X), + curs_move(3X), curs_refresh(3X). resizeterm(3X).