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.

RETURN 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 @@
 

NOTES

        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.
 
 
 

PORTABILITY

-       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.
 
 
 

SEE ALSO

-       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).