*** UNIX MANUAL PAGE BROWSER ***

curs_instr(3) Library Functions Manual curs_instr(3) NAME curs_instr, instr, innstr, winstr, winnstr, mvinstr, mvinnstr, mvwin- str, mvwinnstr - Get a string of characters from a Curses window LIBRARY Curses Library (libcurses.a, libcurses.so) SYNOPSIS #include <curses.h> int instr(char *str); int innstr(char *str, int n); int winstr(WINDOW *win, char *str); int winnstr(WINDOW *win, char *str, int n); int mvinstr(int y, int x, char *str); int mvinnstr(int y, int x, char *str, int n); int mvwinstr(WINDOW *win, int y, int x, char *str); int mvwinnstr(WINDOW *win, int y, int x, char *str, int n); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: instr, innstr, winstr, winnstr, mvinstr, mvinnstr, mvwinstr, mvwinnstr: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. DESCRIPTION These routines return the string of characters in str, starting at the current cursor position in the named window and ending at the right margin of the window. Attributes are stripped from the characters. The four functions with n as the last argument return a string that is at most n characters long. NOTES The header file curses.h automatically includes the header file stdio.h. Note that all routines except winnstr may be macros. RETURN VALUES All routines return ERR upon failure. Upon successful completion, the *instr routines return OK, and the *innstr routines return the number of characters read into the string. RELATED INFORMATION Functions: curses(3) Others: standards(5) delim off curs_instr(3)