Updated: 2022/Sep/29
Please read Privacy Policy. It's for your privacy.
CURSES_INCH(3) Library Functions Manual CURSES_INCH(3) NAME curses_inch, inch, winch, inchnstr, mvinchnstr, winchnstr, mvwinchnstr, inchstr, mvinchstr, winchstr, mvwinchstr, innstr, winnstr, mvinnstr, mvwinnstr, instr, winstr, mvinstr, mvwinstr - curses read screen contents routines LIBRARY Curses Library (libcurses, -lcurses) SYNOPSIS #include <curses.h> 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); DESCRIPTION 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. RETURN VALUES If the calls innstr(), mvinnstr(), mvwinnstr(), and winnstr() succeed then they will return the number of characters actually read. Functions returning pointers will return NULL if an error is detected. The functions that return an int will return one of the following values: OK The function completed successfully. ERR An error occurred in the function. SEE ALSO curses_addch(3), curses_addstr(3), curses_attributes(3), curses_insch(3) STANDARDS The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification. NOTES The inchnstr() 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. HISTORY The Curses package appeared in 4.0BSD. NetBSD 10.99 October 25, 2018 NetBSD 10.99