https://invisible-island.net/ncurses/man/


curs_ins_wch 3x 2025-03-08 ncurses 6.5 Library calls

curs_ins_wch(3x)                 Library calls                curs_ins_wch(3x)




NAME

       ins_wch,  wins_wch,  mvins_wch,  mvwins_wch  -  insert a curses complex
       character in 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

       wins_wch inserts  the  curses  complex  character  wch  at  the  cursor
       position in the window win.  The character previously at the cursor and
       any to its right move one cell to the  right;  the  formerly  rightmost
       character  on the line is discarded.  Unlike add_wch(3x), wins_wch does
       not advance the cursor.  ncurses(3x) describes  the  variants  of  this
       function.


RETURN VALUE

       These functions return OK on success and ERR on failure.

       In ncurses, they return ERR if

       o   the curses screen has not been initialized, or

       o   (for  functions  taking  a  WINDOW  pointer argument) win is a null
           pointer.

       Functions prefixed with "mv" first perform cursor movement and fail  if
       the position (y, x) is outside the window boundaries.


NOTES

       ins_wch, mvins_wch, and mvwins_wch may be implemented as macros.

       curses  does  not  necessarily  employ  the terminal's insert_character
       (ich1) capability to achieve insertion.


PORTABILITY

       X/Open Curses Issue 4 describes these functions.  It specifies no error
       conditions for them.


HISTORY

       X/Open  Curses Issue 4 (1995) initially specified these functions.  The
       System V Interface Definition Version 4 of the same  year  specified  a
       function  named  winswch  (and  the  usual variants).  This was a later
       addition to SVr4.x,  not  appearing  in  the  first  SVr4  (1989).   It
       differed  from  X/Open's  later wins_wch in that it took an argument of
       type chtype instead of cchar_t.


SEE ALSO

       curs_insch(3x) describes comparable functions in the non-wide-character
       curses configuration.

       curses(3x), terminfo(5)



ncurses 6.5                       2025-03-08                  curs_ins_wch(3x)