ins_wch(3curses)

ins_wch -- insert a complex character and rendition into a window

Synopsis

cc [options] file -lcurses

#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 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 behavior is unspecified.

Return value

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

Errors

No errors are defined.

Usage

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

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

add_wch(3curses), curses(4)