curs_inchstr(3ocurses)


curs_inchstr: inchstr, inchnstr, winchstr, winchnstr, mvinchstr, mvinchnstr, mvwinchstr, mvwinchnstr -- get a string of characters (and attributes) from a curses window

Synopsis

cc [flag . . .] file -locurses [library . . .]

#include <ocurses.h>

int inchstr(chtype *chstr); int inchnstr(chtype *chstr, int n); int winchstr(WINDOW *win, chtype *chstr); int winchnstr(WINDOW *win, chtype *chstr, int n); int mvinchstr(int y, int x, chtype *chstr); int mvinchnstr(int y, int x, chtype *chstr, int n); int mvwinchstr(WINDOW *win, int y, int x, chtype *chstr); int mvwinchnstr(WINDOW *win, int y, int x, chtype *chstr, int n);

Description

These routines return a string of type chtype, starting at the current cursor position in the named window and ending at the right margin of the window. The four functions with n as the last argument, return the string at most n characters long. Constants defined in ocurses.h can be used with the & (logical AND) operator to extract the character or the attribute alone from any position in the chstr [see curs_inch(3ocurses)].

Return values

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

References

curses(3ocurses), curs_inch(3ocurses)

Notices

The header file ocurses.h automatically includes the header files stdio.h and unctrl.h.

Note that all routines except winchnstr may be macros.


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004