These functions read the contents of
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.