Manual Pages for UNIX Operating System command usage for man win_wchstr

Miscellaneous Library Functions                curs_in_wchstr(3X)



NAME
     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

SYNOPSIS
     #include 

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

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

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

RETURN VALUES
     Upon successful completion, these functions return OK.  Oth-
     erwise, they return ERR.

PORTABILITY
     The XSI Curses defines no error conditions.  This  implemen-
     tation checks for null pointers, returning ERR in that case.

SEE ALSO
     Functions:   curses(3X),  curs_in_wch(3X),   curs_instr(3X),
     curs_inwstr(3X) curs_inchstr(3X)










SunOS 5.10                Last change:                          1