1 .\" $Id: curs_instr.3x,v 1.7 1997/03/15 23:25:24 tom Exp $
4 \fBinstr\fR, \fBinnstr\fR, \fBwinstr\fR, \fBwinnstr\fR,
5 \fBmvinstr\fR, \fBmvinnstr\fR, \fBmvwinstr\fR, \fBmvwinnstr\fR - get a string
6 of characters from a \fBcurses\fR window
8 \fB#include <curses.h>\fR
10 \fBint instr(char *str);\fR
12 \fBint innstr(char *str, int n);\fR
14 \fBint winstr(WINDOW *win, char *str);\fR
16 \fBint winnstr(WINDOW *win, char *str, int n);\fR
18 \fBint mvinstr(int y, int x, char *str);\fR
20 \fBint mvinnstr(int y, int x, char *str, int n);\fR
22 \fBint mvwinstr(WINDOW *win, int y, int x, char *str);\fR
24 \fBint mvwinnstr(WINDOW *win, int y, int x, char *str, int n);\fR
27 These routines return a string of characters in \fIstr\fR, extracted starting
28 at the current cursor position in the named window.
29 Attributes are stripped from the characters. The four
30 functions with \fIn\fR as the last argument return a leading substring at most
31 \fIn\fR characters long (exclusive of the trailing NUL).
33 All of the functions return \fBERR\fR upon failure,
34 or the number of characters actually read into the string.
36 Note that all routines except \fBwinnstr\fR may be macros.
39 error conditions \fBEILSEQ\fR and \fBEILOVERFLOW\fR associated with
40 extended-level conformance are not yet detected (this implementation does not
41 yet support XPG4 multi-byte characters).
43 document whether a length limit includes or excludes the trailing NUL.
45 The ncurses library extends the XSI description by allowing a negative
47 In this case, the functions return the string ending at the right margin.
51 .\"# The following sets edit modes for GNU EMACS