curs_inswstr, inswstr, insnwstr, winswstr, winsnwstr,
mvinswstr, mvinsnwstr, mvwinswstr, mvwinsnwstr - Insert a
wchar_t string before the character under the cursor in a
wchar_t *wstr ); int insnwstr(
int n ); int winswstr(
wchar_t *wstr ); int winsnwstr(
int n ); int mvinswstr(
wchar_t *wstr ); int mvinsnwstr(
int n ); int mvwinswstr(
wchar_t *wstr ); int mvwinsnwstr(
int n );
Curses Library (libcurses)
These routines insert a wchar_t character string (as many
wchar_t characters as will fit on the line) before the
character under the cursor. All characters to the right of
the cursor are moved to the right, with the possibility of
the rightmost characters on the line being lost. The routines
do not change the cursor position after moving to y,
x, if specified. (This does not imply use of the hardware
insert character feature.)
The four routines with n as the last argument insert at
most n wchar_t characters. If n<=0, then the routines
insert the entire string.
If a character in wstr is a tab, newline, carriage return,
or backspace, the cursor is moved appropriately within the
window. A newline also results in clrtoeol before moving.
Tabs are considered to be at every eighth column. If a
character in wstr is another control character, it is
drawn in the ^X notation. Calling winch after adding a
control character (and moving to it, if necessary) does
not return the control character, but instead returns the
representation of the control character.
The header file <curses.h> automatically includes the
header file <stdio.h>.
Note that all but winsnwstr may be macros.
The routines described on this reference page are among
the MNLS Curses functions that are not included in the
X/Open Curses CAE specification. MNLS routines are supported
only for backward compatibility reasons. Use the
*ins_wstr and *ins_nwstr functions in new applications
All routines return the integer ERR upon failure and an
integer value other than ERR upon successful completion.
Functions: curses(3), curs_clear(3), curs_ins_wstr(3),
[ Back ]