1curs_instr(3CURSES)        Curses Library Functions        curs_instr(3CURSES)
2
3
4

NAME

6       curs_instr,  instr,  innstr, winstr, winnstr, mvinstr, mvinnstr, mvwin‐
7       str, mvwinnstr - get a string of characters from a curses window
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int instr(char *str);
14
15
16       int innstr(char *str, int n);
17
18
19       int winstr(WINDOW *win, char *str);
20
21
22       int winnstr(WINDOW *win, char *str, int n);
23
24
25       int mvinstr(int y, int x, char *str);
26
27
28       int mvinnstr(int y, int x, char *str, int n);
29
30
31       int mvwinstr(WINDOW *win, int y, int x, char *str);
32
33
34       int mvwinnstr(WINDOW *win, int y, int x, char *str, int n);
35
36

DESCRIPTION

38       These routines return a string of characters in str,  starting  at  the
39       current  cursor  position  in  the named window and ending at the right
40       margin of the window. Attributes are stripped from the characters.  The
41       four  functions with n as the last argument return the string at most n
42       characters long.
43

RETURN VALUES

45       All routines return the integer ERR upon failure and an  integer  value
46       other than ERR upon successful completion.
47

ATTRIBUTES

49       See attributes(5) for descriptions of the following attributes:
50
51
52
53
54       ┌─────────────────────────────┬─────────────────────────────┐
55       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
56       ├─────────────────────────────┼─────────────────────────────┤
57       │MT-Level                     │Unsafe                       │
58       └─────────────────────────────┴─────────────────────────────┘
59

SEE ALSO

61       curses(3CURSES), attributes(5)
62

NOTES

64       The header <curses.h> automatically includes the headers  <stdio.h> and
65       <unctrl.h>.
66
67
68       Note that all routines except winnstr() may be macros.
69
70
71
72SunOS 5.11                        31 Dec 1996              curs_instr(3CURSES)