mvwgetwch man page on OSF1

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
OSF1 logo
[printable version]

curs_getwch(3)							curs_getwch(3)

NAME
       curs_getwch,  getwch,  wgetwch, mvgetwch, mvwgetwch, ungetwch - Get (or
       push back) wchar_t characters from a Curses terminal keyboard

SYNOPSIS
       #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(
	       wchar_t wch );

LIBRARY
       Curses Library (libcurses)

DESCRIPTION
       The getwch, wgetwch, mvgetwch, and mvwgetwch routines read an EUC char‐
       acter  from  the	 terminal associated with the Curses window, transform
       the character into a wchar_t character, and return the wchar_t  charac‐
       ter.  In no-delay mode, if no input is waiting, the routines return the
       value ERR. In delay mode, the program waits  until  the	system	passes
       text  through  to  the program. In cbreak mode, the program waits until
       after one character. In nocbreak mode, the program  waits  until	 after
       the first newline. In half-delay mode, the program waits until the user
       types a character or until the  specified  timeout  has	been  reached.
       Unless  noecho has been set, Curses echos the character into the desig‐
       nated window.

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

       If keypad is TRUE and the user presses a	 function  key,	 the  routines
       return  the  token for that function instead of the raw characters. The
       <curses.h> file defines possible function keys by using integers begin‐
       ning with 0401 and names beginning 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 routines pass the character  to	 the  applica‐
       tion;  otherwise,  they return the function key value. 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
       The following function keys, defined in <curses.h>, might  be  returned
       by  the	getwch	routines if keypad has been enabled. Note a particular
       terminal may not support all of these function keys.  In	 other	words,
       the  routines  do  not  return  the key values 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.

       ────────────────────────────────────────────────────────────────────────────
       Name		    Key name
       ────────────────────────────────────────────────────────────────────────────
       KEY_BREAK	    Break key

			    The four arrow keys
       KEY_DOWN
       KEY_UP
       KEY_LEFT
       KEY_RIGHT

       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 one line forward
       KEY_SR		    Scroll one line backward (in 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).  The	 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
       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 character 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 previous key
       KEY_SPRINT	    Shifted print key
       KEY_SREDO	    Shifted redo key
       KEY_SREPLACE	    Shifted replace key
       KEY_SRIGHT	    Shifted right-arrow key
       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
       ────────────────────────────────────────────────────────────────────────────

NOTES
       The header file	<curses.h>  automatically  includes  the  header  file
       <stdio.h>.

       Programmers  should  not use the escape key as a single character func‐
       tion.

       When using getwch, wgetwch, mvgetwch, or mvwgetwch, applications should
       not  use nocbreak mode and echo mode 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.

       The routines described on this reference page are among the MNLS Curses
       functions that are not included in the X/Open Curses CAE specification.
       MNLS  routines  are  supported only for backward compatibility reasons.
       Use the *get_wch functions in new applications (see curs_get_wch(3)).

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

SEE ALSO
       Functions: curses(3), curs_inopts(3), curs_move(3), curs_refresh(3)

								curs_getwch(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OSF1

List of man pages available for OSF1

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net