NAME    [Toc]    [Back]

       curs_ins_wch,  ins_wch,  wins_wch, mvins_wch, mvwins_wch -
       Insert a complex character and rendition before the  character
 under the cursor in a Curses window

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards 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    [Toc]    [Back]

       These  functions  insert  the complex character wch, along
       with its rendition, 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 rightmost 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  insertcharacter
  feature.  Perform special-character processing

NOTES    [Toc]    [Back]

       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    [Toc]    [Back]

       All  these functions return OK upon successful completion.
       Otherwise, they return ERR.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_add_wch(3)

       Others: standards(5)



                                                  curs_ins_wch(3)