NAME

inswch, winswch, mvinswch, mvwinswch − Insert a wchar_t character before the character under the cursor in a window

LIBRARY

The curses library (libcurses.so, libcurses.a)

SYNOPSIS

#include <curses.h>

int inswch( chtype wch );

int winswch(
        WINDOW ∗win,
        chtype wch );

int mvinswch(
        int y,
        int x,
        chtype wch );

int mvwinswch(
        WINDOW ∗win,
        int y,
        int x,
        chtype wch );

PARAMETERS

wchSpecifies the wide character to be inserted. 

winSpecifies a curses window. If not specified, the window is the default window stdscr. 

y, xSpecifies the line (y) and column (x) coordinates of the target position on the window.  If coordinates are not specified, the target position is the current position of the logical cursor. 

DESCRIPTION

The inswch routine inserts the wchar_t character wch before the character under the current cursor position on the default window. 

The winswch routine inserts the wchar_t character wch before the character under the current cursor position on window win. 

The mvinswch routine inserts the wchar_t character wch at cursor position (y, x) on the default window. 

The mvwinswch routine inserts the wchar_t character wch at cursor position (y, x) on the window win. 

All the routines cause the following actions:

       •All characters from the cursor position to the right edge of the window are moved one character position to the right. 

       •The last character on the line is always lost, even if it is a blank. 

       •The cursor position does not change after the insert is completed. 

The inswch, mvinswch, and mvwinswch routines are macros. 

RETURN VALUES

The inswch, mvinswch, mvwinswch, and winswch functions return OK on success and ERR on error. 

RELATED INFORMATION

Functions: addwch(3), curses(3), curses_intro(3).