*** UNIX MANUAL PAGE BROWSER ***

curs_ins_wch(3) Library Functions Manual 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 LIBRARY Curses Library (libcurses.a, libcurses.so) 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); STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: ins_wch, wins_wch, mvins_wch, mvwins_wch: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry 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. RELATED INFORMATION Functions: curses(3) curs_add_wch(3) Others: standards(5) delim off curs_ins_wch(3)