H18430 s 00070/00000/00000 d D 1.1 02/05/02 15:35:04 root 2 1 cC cF1 cK52198 cO-rw-rw-r-- e s 00000/00000/00000 d D 1.0 02/05/02 15:35:04 root 1 0 c BitKeeper file /Mastodon/Core/Build/ncurses/Ada95/html/curs_instr.3x.html cBor@egypt.pell.portland.or.us|ChangeSet|20020502223039|07086|e73225ae258b78f8 cHegypt.pell.portland.or.us cK28460 cPAda95/html/curs_instr.3x.html cR246744d13d79a4dc cV4 cX0x821 cZ-07:00 e u U f e 0 f x 0x821 t T I 2
instr, innstr, winstr, winnstr, mvinstr, mvinnstr, mvwin- str, mvwinnstr - get a string of characters from a curses window
#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);
These routines return a string of characters in str, extracted starting at the current cursor position in the named window. Attributes are stripped from the charac- ters. The four functions with n as the last argument return a leading substring at most n characters long (exclusive of the trailing NUL).
All of the functions return ERR upon failure, or the num- ber of characters actually read into the string.
Note that all routines except winnstr may be macros.
The XSI Curses error conditions EILSEQ and EILOVERFLOW associated with extended-level conformance are not yet detected (this implementation does not yet support XPG4 multi-byte characters). SVr4 does not document whether a length limit includes or excludes the trailing NUL. The ncurses library extends the XSI description by allow- ing a negative value for n. In this case, the functions return the string ending at the right margin.
curses(3X).E 2 I 1 E 1