curs_instr(3) UNIX Programmer's Manual curs_instr(3)
instr, innstr, winstr, winnstr, mvinstr, mvinnstr, mvwinstr,
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 characters.
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 number
of characters actually read into the string.
X/Open defines no error conditions. In this implementation,
if the window parameter is null or the str parameter is
null, a zero is returned.
Note that all routines except winnstr may be macros.
SVr4 does not document whether a length limit includes or
excludes the trailing NUL.
The ncurses library extends the XSI description by allowing
a negative value for n. In this case, the functions return
the string ending at the right margin.
curses(3).
MirOS BSD #10-current Printed 19.2.2012 1
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.