curs_ins_wch(3)curs_ins_wch(3)NAME
curs_ins_wch, ins_wch, wins_wch, mvins_wch, mvwins_wch - Insert a com‐
plex character and rendition before the character under the cursor in a
Curses 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 );
LIBRARY
Curses Library (libcurses)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
ins_wch, wins_wch, mvins_wch, mvwins_wch: XCURSES4.2
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
DESCRIPTION
These functions insert the complex character wch, along with its rendi‐
tion, in the current or specified window at the current or specified
cursor position. These functions: Do not perform wrapping
In other words, all characters to the right of the cursor are
moved one space to the right, with the possibility of the right‐
most character on the line being lost. Do not change the cursor
position after moving to y, x, if specified
This does not imply use of the hardware insert-character fea‐
ture. Perform special-character processing
NOTES
The header file <curses.h> automatically includes the header file
<stdio.h>.
Applications can use add_wch to add nonspacing characters to a spacing-
complex character already in the window.
Note that ins_wch, mvins_wch, and mvwins_wch may be macros.
RETURN VALUES
All these functions return OK upon successful completion. Otherwise,
they return ERR.
SEE ALSO
Functions: curses(3), curs_add_wch(3)
Others: standards(5)curs_ins_wch(3)