MirBSD manpage: curs_instr(3), innstr(3), instr(3), mvinnstr(3), mvinstr(3), mvwinnstr(3), mvwinstr(3), winnstr(3), winstr(3)

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.



MirBSD #10-current     Printed 2022-12-23                       1

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung