chtype
inch(
void
)
chtype
winch(
WINDOW *win
)
int
inchnstr(
chtype *chars
, int n
)
int
mvinchnstr(
int y
, int x
, chtype *chstr
, int n
)
int
winchnstr(
WINDOW *win
, chtype *chars
, int n
)
int
mvwinchnstr(
WINDOW *win
, int y
, int x
, chtype *chstr
, int n
)
int
inchstr(
chtype *chars
)
int
mvinchstr(
int y
, int x
, chtype *chstr
)
int
winchstr(
WINDOW *win
, chtype *chars
)
int
mvwinchstr
WINDOW *win
int y
int x
chtype *chstr
int
innstr(
char *str
, int n
)
int
winnstr(
WINDOW *win
, char *str
, int n
)
int
mvinnstr(
int y
, int x
, char *str
, int n
)
int
mvwinnstr(
WINDOW *win
, int y
, int x
, char *str
, int n
)
int
instr(
char *str
)
int
winstr(
WINDOW *win
, char *str
)
int
mvinstr(
int y
, int x
, char *str
)
int
mvwinstr(
WINDOW *win
, int y
, int x
, char *str
)
stdscr
or of the specified window.
The
inch()
function returns the character that is displayed on
stdscr
at the current cursor position.
The
winch()
function is the same as the
inch(
)
function, excepting that the character is read from window specified by
win
.
The
inchnstr()
function fills an array of
chtype
with characters read from
stdscr
,
the characters are read starting from the current cursor position and
continuing until either n - 1 characters are read or the right hand
side of the screen is reached.
The resulting character array will be
NULL
terminated.
The
winchnstr()
function is the same as
inchnstr(
)
excepting that the characters are read from the window specified by
win
.
The
inchstr()
and
winchstr(
)
functions are the same as the
inchnstr(
)
and
winchnstr(
)
functions, respectively, excepting that they do not limit the number
of characters read.
The characters returned are those from the current starting position to
the right hand side of the screen.
The use of
inchstr(
)
and
winchstr(
)
is not recommended as the character buffer can be overflowed.
The
innstr()
function
is similar to the
inchstr(
)
function, excepting that the array of characters returned is stripped of all
the curses attributes making it a plain character string.
The
mvinchstr(),
mvinchnstr(
),
mvwinchstr(
),
and
mvwinchnstr(
)
functions are the same as the
inchstr(
),
inchnstr(
),
winchstr(
),
and
winchstr(
)
functions, respectively, except that
wmove(
)
is called to move the cursor to the position specified by
y
,
x
before the output is printed on the window.
Likewise, the
mvinstr(),
mvinnstr(
),
mvwinstr(
),
and
mvwinnstr(
)
functions are the same as the
instr(
),
innstr(
),
winstr(
),
and
winstr(
)
functions, respectively, except that
wmove(
)
is called to move the cursor to the position specified by
y
,
x
before the output is printed on the window.
The
winnstr()
function is the same as the
innstr(
)
function, excepting that characters are read from the window specified by
win
.
The
instr()
and
winstr(
)
functions
are the same as the
innstr(
)
and
winnstr(
)
functions, respectively, excepting that there are no limits placed on the
size of the returned string, which may cause buffer overflows.
For this reason, the use of
instr(
)
and
winstr(
)
is not recommended.
NULL
if an error is detected.
The functions that return an int will return one of the following
values:
OK
ERR
)
and
innstr(
)
function read at most n - 1 characters from the screen so as to leave
room for
NULL
termination.
The X/Open specification is unclear as to whether or not this is the correct
behaviour.