X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_getch.3x.html;h=3af0cc77543de1c9e96a1c84bcba3f37adb18ba1;hp=d9b4b70328aa57b6c32fa131023f324fce7cc014;hb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86;hpb=e2d7d0028f4298dca2b0edaf2dc8ce30518d9218 diff --git a/doc/html/man/curs_getch.3x.html b/doc/html/man/curs_getch.3x.html index d9b4b703..3af0cc77 100644 --- a/doc/html/man/curs_getch.3x.html +++ b/doc/html/man/curs_getch.3x.html @@ -1,8 +1,7 @@ - +
+ +- curs_getch(3x) curs_getch(3x)-
+NAME
getch, wgetch, mvgetch, mvwgetch, ungetch, has_key - get (or push back) characters from curses terminal keyboard-SYNOPSIS
+SYNOPSIS
#include <curses.h> int getch(void); @@ -65,7 +65,7 @@-DESCRIPTION
+DESCRIPTION
The getch, wgetch, mvgetch and mvwgetch, routines read a character from the window. In no-delay mode, if no input is waiting, the value ERR is returned. In delay mode, the @@ -76,14 +76,24 @@ waits until a character is typed or the specified timeout has been reached. - Unless noecho has been set, then the character will also - be echoed into the designated window according to the fol- - lowing rules: if the character is the current erase char- - acter, left arrow, or backspace, the cursor is moved one - space to the left and that screen position is erased as if - delch had been called. If the character value is any oth- - er KEY_ define, the user is alerted with a beep call. - Otherwise the character is simply output to the screen. + If echo is enabled, and the window is not a pad, then the + character will also be echoed into the designated window + according to the following rules: + + o If the character is the current erase character, left + arrow, or backspace, the cursor is moved one space to + the left and that screen position is erased as if + delch had been called. + + o If the character value is any other KEY_ define, the + user is alerted with a beep call. + + o If the character is a carriage-return, and if nl is + enabled, it is translated to a line-feed after echo- + ing. + + o Otherwise the character is simply output to the + screen. If the window is not a pad, and it has been moved or modi- fied since the last call to wrefresh, wrefresh will be @@ -93,7 +103,7 @@ ken for that function key is returned instead of the raw characters. Possible function keys are defined in <curs- es.h> as macros with values outside the range of 8-bit - characters whose names begin with KEY_. Thus, a variable + characters whose names begin with KEY_. Thus, a variable intended to hold the return value of a function key must be of short size or larger. @@ -110,14 +120,16 @@ be returned by the next call to wgetch. There is just one input queue for all windows. - Function Keys + ++Function Keys
The following function keys, defined in <curses.h>, might be returned by getch if keypad has been enabled. Note that not all of these are necessarily supported on any particular terminal. - Name Key name + ------------------------------------------------- KEY_BREAK Break key KEY_DOWN The four arrow keys ... KEY_UP @@ -168,6 +180,7 @@ 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 @@ -178,7 +191,6 @@ 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 @@ -224,7 +236,7 @@ | C1 | down | C3 | +-----+------+-------+ The has_key routine takes a key value from the above list, - and returns TRUE or FALSE according to whether the current + and returns TRUE or FALSE according to whether the current terminal type recognizes a key with that value. Note that a few values do not correspond to a real key, e.g., KEY_RESIZE and KEY_MOUSE. See resizeterm(3x) for more de- @@ -233,7 +245,7 @@-RETURN VALUE
+RETURN VALUE
All routines return the integer ERR upon failure and an integer value other than ERR (OK in the case of ungetch()) upon successful completion. @@ -251,7 +263,7 @@-NOTES
+NOTES
Use of the escape key by a programmer for a single charac- ter function is discouraged, as it will cause a delay of up to one second while the keypad code looks for a follow- @@ -301,7 +313,7 @@-PORTABILITY
+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, @@ -317,7 +329,7 @@ documentation. Under historical curses implementations, it varied depending on whether the operating system's im- plementation of handled signal receipt interrupts a - read(2) call in progress or not, and also (in some imple- + read(2) call in progress or not, and also (in some imple- mentations) depending on whether an input timeout or non- blocking mode has been set. @@ -334,7 +346,7 @@-SEE ALSO
+SEE ALSO
curses(3x), curs_inopts(3x), curs_outopts(3x), curs_mouse(3x), curs_move(3x), curs_refresh(3x), re- sizeterm(3x). @@ -346,10 +358,20 @@ curs_getch(3x)-
- -Man(1) output converted with -man2html - +