*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> curs_getwch (3x)              


curs_getwch(3X)						       curs_getwch(3X)

NAME    [Toc]    [Back]

     curs_getwch: getwch, wgetwch, mvgetwch, mvwgetwch,	ungetwch - get (or
     push back)	wchar_t	characters from	curses terminal	keyboard

SYNOPSIS    [Toc]    [Back]

     #include <curses.h>

     int getwch(void);

     int wgetwch(WINDOW	*win);
     int mvgetwch(int y, int x);

     int mvwgetwch(WINDOW *win,	int y, int x);
     int ungetwch(int wch);

DESCRIPTION    [Toc]    [Back]

     The getwch, wgetwch, mvgetwch, and	mvwgetwch routines read	an EUC
     character from the	terminal associated with the window, transform it into
     a wchar_t character, and return a wchar_t character.  In no-delay mode,
     if	no input is waiting, the value ERR is returned.	 In delay mode,	the
     program waits until the system passes text	through	to the program.
     Depending on the setting of cbreak, this is after one character (cbreak
     mode), or after the first newline (nocbreak mode).	 In half-delay mode,
     the program waits until a character is typed or the specified timeout has
     been reached.  Unless noecho has been set,	the character will also	be
     echoed into the designated	window.

     If	the window is not a pad, and it	has been moved or modified since the
     last call to wrefresh, wrefresh will be called before another character
     is	read.

     If	keypad is TRUE,	and a function key is pressed, the token for that
     function key is returned instead of the raw characters.  Possible
     function keys are defined in <curses.h> with integers beginning with
     0401, whose names begin with KEY_.	 If a character	that could be the
     beginning of a function key (such as escape) is received, curses sets a
     timer.  If	the remainder of the sequence does not come in within the
     designated	time, the character is passed through; otherwise, the function
     key value is returned.  For this reason, many terminals experience	a
     delay between the time a user presses the escape key and the escape is
     returned to the program.

     The ungetwch routine places wch back onto the input queue to be returned
     by	the next call to wgetwch.

   Function Keys    [Toc]    [Back]
     The following function keys, defined in <curses.h>, might be returned by
     getwch if keypad has been enabled.	 Note that not all of these may	be
     supported on a particular terminal	if the terminal	does not transmit a
     unique code when the key is pressed or if the definition for the key is
     not present in the	terminfo database.

									Page 1

curs_getwch(3X)						       curs_getwch(3X)

     Name		  Key name

									Page 2

     KEY_BREAK		  Break	key
     KEY_DOWN		  The four arrow keys ...
     KEY_HOME		  Home key (upward+left	arrow)
     KEY_BACKSPACE	  Backspace
     KEY_F0		  Function keys; space for 64 keys is reserved.
     KEY_F(n)		  For 0	< n < 63
     KEY_DL		  Delete line
     KEY_IL		  Insert line
     KEY_DC		  Delete character
     KEY_IC		  Insert char or enter insert mode
     KEY_EIC		  Exit insert char mode
     KEY_CLEAR		  Clear	screen
     KEY_EOS		  Clear	to end of screen
     KEY_EOL		  Clear	to end of line
     KEY_SF		  Scroll 1 line	forward
     KEY_SR		  Scroll 1 line	backward (reverse)
     KEY_NPAGE		  Next page
     KEY_PPAGE		  Previous page
     KEY_STAB		  Set tab
     KEY_CTAB		  Clear	tab
     KEY_CATAB		  Clear	all tabs
     KEY_ENTER		  Enter	or send
     KEY_SRESET		  Soft (partial) reset
     KEY_RESET		  Reset	or hard	reset
     KEY_PRINT		  Print	or copy
     KEY_LL		  Home down or bottom (lower left).  Keypad is
			  arranged like	this:
			       A1    up	   A3
			      left   B2	  right
			       C1   down   C3
     KEY_A1		  Upper	left of	keypad
     KEY_A3		  Upper	right of keypad
     KEY_B2		  Center of keypad
     KEY_C1		  Lower	left of	keypad
     KEY_C3		  Lower	right of keypad
     KEY_BTAB		  Back tab key
     KEY_BEG		  Beg(inning) key
     KEY_CANCEL		  Cancel key
     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

									Page 3

     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_SAVE		  Save key
     KEY_SBEG		  Shifted beginning key
     KEY_SCANCEL	  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_SLEFT		  Shifted left arrow key
     KEY_SMESSAGE	  Shifted message key
     KEY_SMOVE		  Shifted move key
     KEY_SNEXT		  Shifted next key
     KEY_SOPTIONS	  Shifted options key
     KEY_SPREVIOUS	  Shifted prev key
     KEY_SPRINT		  Shifted print	key
     KEY_SREDO		  Shifted 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 suspend key
     KEY_SUNDO		  Shifted undo key
     KEY_SUSPEND	  Suspend key
     KEY_UNDO		  Undo key

RETURN VALUE    [Toc]    [Back]

     All routines return the integer ERR upon failure and an integer value
     other than	ERR upon successful completion.

									Page 4

     The header	file <curses.h>	automatically includes the header files
     <stdio.h> and <unctrl.h>.

     Use of the	escape key by a	programmer for a single	character function is

     When using	getwch,	wgetwch, mvgetwch, or mvwgetwch, nocbreak mode and
     echo mode 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
     undesirable results.

     Note that getwch, mvgetwch, and mvwgetwch may be macros.

SEE ALSO    [Toc]    [Back]

     curses(3X), curs_inopts(3X), curs_move(3X), curs_refresh(3X).

									PPPPaaaaggggeeee 5555
[ Back ]
 Similar pages
Name OS Title
curs_getch IRIX get (or push back) characters from curses terminal keyboard
ungetch Tru64 Get (or push back) characters from a Curses terminal keyboard
ungetch OpenBSD get (or push back) characters from curses terminal keyboard
mvwgetch OpenBSD get (or push back) characters from curses terminal keyboard
wgetch OpenBSD get (or push back) characters from curses terminal keyboard
mvwgetch Tru64 Get (or push back) characters from a Curses terminal keyboard
getch FreeBSD get (or push back) characters from curses terminal keyboard
has_key FreeBSD get (or push back) characters from curses terminal keyboard
curs_getch OpenBSD get (or push back) characters from curses terminal keyboard
mvgetch FreeBSD get (or push back) characters from curses terminal keyboard
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service