HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

ins_wch(3X) ins_wch(3X)

(ENHANCED CURSES)

NAME

ins_wch, mvins_wch, mvwins_wch, wins_wch — insert a complex character and rendition into a window

SYNOPSIS

#include <curses.h>

int ins_wch(const cchar_t *wch);

int wins_wch(WINDOW *win, const cchar_t *wch);

int mvins_wch(int y, int x, const cchar_t *wch);

int mvwins_wch(WINDOW *win, int y, int x, const cchar_t *wch);

DESCRIPTION

These functions insert the complex character wch with its rendition in the current or speciﬁed window at

the current or speciﬁed cursor position.

These functions do not perform wrapping. These functions do not advance the cursor position. These

functions perform special-character processing, with the exception that if a newline is inserted into the

last line of a window and scrolling is not enabled, the behaviour is unspeciﬁed.

RETURN VALUE

Upon successful completion, these functions return OK. Otherwise, they return ERR.

ERRORS

No errors are deﬁned.

APPLICATION USAGE

For non-spacing characters,

add_wch() can be used to add the non-spacing characters to a spacing com-

plex character already in the window.