<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<!--Converted with LaTeX2HTML 96.1-c (Feb 29, 1996) by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds -->
<HTML>
<HEAD>
<TITLE>8.7 Input</TITLE>
<META NAME="description" CONTENT="8.7 Input">
<META NAME="keywords" CONTENT="lpg">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<LINK REL=STYLESHEET HREF="lpg.css">
</HEAD>
<BODY LANG="EN">
<A NAME="tex2html1699" HREF="node107.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="/icons//next_motif.gif"></A> <A NAME="tex2html1697" HREF="node85.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="/icons//up_motif.gif"></A> <A NAME="tex2html1691" HREF="node105.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="/icons//previous_motif.gif"></A> <A NAME="tex2html1701" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="/icons//contents_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html1700" HREF="node107.html">8.7.1 Formated Input</A>
<B>Up:</B> <A NAME="tex2html1698" HREF="node85.html">8 Character Cell Graphics</A>
<B> Previous:</B> <A NAME="tex2html1692" HREF="node105.html">8.6.5 Background Character</A>
<BR> <P>
<H1><A NAME="SECTION00970000000000000000">8.7 Input</A></H1>
<P>
<UL><LI> <TT>int getch()</TT> <A NAME="fun_getch"> </A><BR>
<TT>int wgetch(win)</TT> <A NAME="fun_wgetch"> </A><BR>
<TT>int mvgetch(y, x)</TT> <A NAME="fun_mvgetch"> </A><BR>
<TT>int mvwgetch(win, y, x)</TT> <A NAME="fun_mvwgetch"> </A><BR>
<B>getch()</B> will read input from the
terminal in a manner depending on whether delay mode is set or
not. If delay is on, <B>getch()</B> will wait until a key is
pressed, otherwise it will return the key in the input buffer
or ERR if this buffer is empty. <B>mvgetch(...)</B> and
<B>mvwgetch(...)</B>
will move the cursor to position <TT>y,x</TT>
first. The <TT>w</TT> functions read input from the terminal
related to the window <TT>win</TT>, <B>getch()</B> and
<B>mvgetch(...)</B>
from the terminal related to .
<P>
With <B>keypad(...)</B> enabled, <B>getch()</B> will return a code defined in
.h as KEY_* macros when a function key is pressed. When
ESCAPE is pressed (which can be the beginning of a function key)
ncurses will start a one second timer. If the remainder of
the keystroke is not finished in this second, the key is returned.
Otherwise, the function key value is returned.
(If necessary, use <B>notimeout()</B> to disable the second
timer).<LI> <TT>int ungetch(ch)</TT> <A NAME="fun_ungetch"> </A><BR>
Will put the character <TT>ch</TT> back to the input buffer.<LI> <TT>int getstr(str)</TT> <A NAME="fun_getstr"> </A><BR>
<TT>int wgetstr(win, str)</TT> <A NAME="fun_wgetstr"> </A><BR>
<TT>int mvgetstr(y, x, str)</TT> <A NAME="fun_mvgetstr"> </A><BR>
<TT>int mvwgetstr(win, y, x, str)</TT> <A NAME="fun_mvwgetstr"> </A><BR>
<TT>int wgetnstr(win, str, n)</TT> <A NAME="fun_wgetnstr"> </A><BR>
These functions will do a series of calls to <B>getch()</B>
until a newline is
received. The characters are placed in <TT>str</TT> (so don't forget to
allocate memory for your character pointer before calling
<B>getstr(...)</B>). If echo is enabled the string is echoed (use
<B>noecho()</B> to disable echo) and the user's kill and delete
characters will be interpreted.<LI> <TT>chtype inch()</TT> <A NAME="fun_inch"> </A><BR>
<TT>chtype winch(win)</TT> <A NAME="fun_winch"> </A><BR>
<TT>chtype mvinch(y, x)</TT> <A NAME="fun_mvinch"> </A><BR>
<TT>chtype mvwinch(win, y, x)</TT> <A NAME="fun_mvwinch"> </A><BR>
These functions return a character from the screen or window. Because
the type of the return value is <TT>chtype</TT> attribute information
is included. This information can be extracted from the character
using the A_* constants (see table <A HREF="node115.html#tab_attr">8.4</A> on page <A HREF="node115.html#tab_attr"><IMG ALIGN=BOTTOM ALT="gif" SRC="/icons//cross_ref_motif.gif"></A>).<LI> <TT>int instr(str)</TT> <A NAME="fun_instr"> </A><BR>
<TT>int innstr(str, n)</TT> <A NAME="fun_innstr"> </A><BR>
<TT>int winstr(win, str)</TT> <A NAME="fun_winstr"> </A><BR>
<TT>int winnstr(win, str, n)</TT> <A NAME="fun_winnstr"> </A><BR>
<TT>int mvinstr(y, x, str)</TT> <A NAME="fun_mvinstr"> </A><BR>
<TT>int mvinnstr(y, x, str, n)</TT> <A NAME="fun_mvinnstr"> </A><BR>
<TT>int mvwinstr(win, y, x, str)</TT> <A NAME="fun_mvwinstr"> </A><BR>
<TT>int mvwinnstr(win, y, x, str, n)</TT> <A NAME="fun_mvwinnstr"> </A><BR>
Return a character string from the screen or a window.
(<B>Note:</B> not implemented yet.)<LI> <TT>int inchstr(chstr)</TT> <A NAME="fun_inchstr"> </A><BR>
<TT>int inchnstr(chstr, n)</TT> <A NAME="fun_inchnstr"> </A><BR>
<TT>int winchstr(win, chstr)</TT> <A NAME="fun_winchstr"> </A><BR>
<TT>int winchnstr(win, chstr, n)</TT> <A NAME="fun_winchnstr"> </A><BR>
<TT>int mvinchstr(y, x, chstr)</TT> <A NAME="fun_mvinchstr"> </A><BR>
<TT>int mvinchnstr(y, x, chstr, n)</TT> <A NAME="fun_mvinchnstr"> </A><BR>
<TT>int mvwinchstr(win, y, x, chstr)</TT> <A NAME="fun_mvwinchstr"> </A><BR>
<TT>int mvwinchnstr(win, y, x, chstr, n)</TT> <A NAME="fun_mvwinchnstr"> </A><BR>
Return a chtype string from the screen or window. In the string,
attribute information is included for every character.
(<B>Note:</B> not implemented yet, lib_inchstr not included in the ncurses lib.)
</UL><BR> <HR>
<UL>
<LI> <A NAME="tex2html1702" HREF="node107.html#SECTION00971000000000000000">8.7.1 Formated Input</A>
</UL>
<HR><A NAME="tex2html1699" HREF="node107.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="/icons//next_motif.gif"></A> <A NAME="tex2html1697" HREF="node85.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="/icons//up_motif.gif"></A> <A NAME="tex2html1691" HREF="node105.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="/icons//previous_motif.gif"></A> <A NAME="tex2html1701" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="/icons//contents_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html1700" HREF="node107.html">8.7.1 Formated Input</A>
<B>Up:</B> <A NAME="tex2html1698" HREF="node85.html">8 Character Cell Graphics</A>
<B> Previous:</B> <A NAME="tex2html1692" HREF="node105.html">8.6.5 Background Character</A>
<P><ADDRESS>
<I>Converted on: <BR>
Fri Mar 29 14:43:04 EST 1996</I>
</ADDRESS>
</BODY>
</HTML>
