man7.org > Linux > man-pages

Linux/UNIX system programming training

curs_ins_wch(3x) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | PORTABILITY | HISTORY | SEE ALSO | COLOPHON 

curs_ins_wch(3X)              Library calls              curs_ins_wch(3X)

NAME         top

       ins_wch, wins_wch, mvins_wch, mvwins_wch - insert a curses complex
       character in a window

SYNOPSIS         top

       #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         top

       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         top

       These functions return OK on success and ERR on failure.

       In ncurses, they return ERR if

       •   the curses screen has not been initialized, or

       •   (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         top

       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         top

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

HISTORY         top

       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         top

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

       curses(3X), terminfo(5)

COLOPHON         top

       This page is part of the ncurses (new curses) project.
       Information about the project can be found at 
       ⟨https://invisible-island.net/ncurses/ncurses.html⟩.  If you have a
       bug report for this manual page, send it to bug-ncurses@gnu.org.
       This page was obtained from the tarball ncurses-6.6.tar.gz fetched
       from ⟨https://ftp.gnu.org/gnu/ncurses/⟩ on 2026-01-16.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

ncurses @NCURSES_MAJOR@.@NCU... 2025-10-20               curs_ins_wch(3X)

HTML rendering created 2026-01-16 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI