curs_in_wchstr(3) UNIX Programmer's Manual curs_in_wchstr(3)
in_wchstr, in_wchnstr, win_wchstr, win_wchnstr, mvin_wchstr,
mvin_wchnstr, mvwin_wchstr, mvwin_wchnstr - get an array of
complex characters and renditions from a curses window
#include <curses.h>
int in_wchstr(cchar_t *wchstr);
int in_wchnstr(cchar_t *wchstr, int n);
int win_wchstr(WINDOW *win, cchar_t *wchstr);
int win_wchnstr(WINDOW *win, cchar_t *wchstr, int n);
int mvin_wchstr(int y, int x, cchar_t *wchstr);
int mvin_wchnstr(int y, int x, cchar_t *wchstr, int n);
int mvwin_wchstr(WINDOW *win, int y, int x, cchar_t *wchstr);
int mvwin_wchnstr(WINDOW *win, int y, int x, cchar_t *wchstr, int n);
These functions return an array of complex characters in
wchstr, starting at the current cursor position in the named
window. Attributes (rendition) are stored with the charac-
ters.
The in_wchnstr, mvin_wchnstr, mvwin_wchnstr and win_wchnstr
fill the array with at most n cchar_t elements.
Note that all routines except win_wchnstr may be macros.
Reading a line that overflows the array pointed to by wchstr
with in_wchstr, mvin_wchstr, mvwin_wchstr or win_wchstr
causes undefined results. Therefore, the use of in_wchnstr,
mvin_wchnstr, mvwin_wchnstr, or win_wchnstr is recommended.
Upon successful completion, these functions return OK. Oth-
erwise, they return ERR.
The XSI Curses defines no error conditions. This implementa-
tion checks for null pointers, returning ERR in that case.
Functions: curses(3), curs_in_wch(3), curs_instr(3),
curs_inwstr(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.