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(cchar_t *const wch);

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

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

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

DESCRIPTION

These functions insert the complex character wch with its rendition in the current or specified window at the current or specified 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 unspecified.

RETURN VALUE

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

ERRORS

No errors are defined.

APPLICATION USAGE

For non-spacing characters, add_wch() can be used to add the non-spacing characters to a spacing complex character already in the window.

CHANGE HISTORY

First released in X/Open Curses, Issue 4.

Hewlett-Packard Company — HP-UX Release 10.20: July 1996

Museum