HPlogo HP-UX Reference > I

ins_wch(3X)

ENHANCED CURSES
HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

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

SEE ALSO

add_wch(3X), <curses.h>.

CHANGE HISTORY

First released in X/Open Curses, Issue 4.