curs_in_wch(3X) Library calls curs_in_wch(3X)

in_wch, mvin_wch, mvwin_wch, win_wch - get a curses complex character from a window

#include <curses.h>
int in_wch(cchar_t *wch);
int win_wch(WINDOW *win, cchar_t *wch);
int mvin_wch(int y, int x, cchar_t *wch);
int mvwin_wch(WINDOW *win, int y, int x, cchar_t *wch);

These functions extract the complex character and rendition from the current position in the named window into the cchar_t object referenced by wch.

No errors are defined in X/Open Curses. This implementation checks for null pointers, returns ERR in that case. Also, the mv routines check for error moving the cursor, returning ERR in that case. Otherwise they return OK.

Functions prefixed with “mv” first perform cursor movement and fail if the position (y, x) is outside the window boundaries.

Note that all of these routines may be macros.

These functions are described in X/Open Curses, Issue 4.

curs_inch(3X) describes comparable functions of the ncurses library in its non-wide-character configuration.

curses(3X), curs_inwstr(3X)

2024-04-20 ncurses 6.5