MirOS Manual: 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)

NAME

     instr, innstr, winstr, winnstr, mvinstr, mvinnstr, mvwinstr,
     mvwinnstr - get a string of characters from a curses window

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);

DESCRIPTION

     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).

RETURN VALUE

     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.

NOTES

     Note that all routines except winnstr may be macros.

PORTABILITY

     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.

SEE ALSO

     curses(3).

MirOS BSD #10-current  Printed 03.04.2017                       1

Generated on 2017-04-03 16:26:17 by $MirOS: src/scripts/roff2htm,v 1.88 2017/01/29 00:51:06 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–2017 The MirOS Project, Germany.
This product includes material provided by mirabilos.

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