ins_wstr, ins_nwstr, wins_wstr, wins_nwstr, mvins_wstr, mvins_nwstr, mvwins_wstr, mvwins_nwstr − insert a wide-character string into a curses window


#include <ncurses/curses.h>

int ins_wstr(const wchar_t *wstr);
int ins_nwstr(const wchar_t *
wstr, int n);
int wins_wstr(WINDOW *
win, const wchar_t *wstr);
int wins_nwstr(WINDOW *
win, const wchar_t *wstr, int n);
int mvins_wstr(int
y, int x, const wchar_t *wstr);
int mvins_nwstr(int
y, int x, const wchar_t *wstr, int n);
int mvwins_wstr(WINDOW *
win, int y, int x, const wchar_t *wstr);
int mvwins_nwstr(WINDOW *
win, int y, int x, const wchar_t *wstr, int n);


These routines insert a wchar_t character string (as many characters as will fit on the line) before the character under the cursor. All characters to the right of the cursor are shifted right, with the possibility of the rightmost characters on the line being lost. No wrapping is performed. The cursor position does not change (after moving to y, x, if specified). The four routines with n as the last argument insert a leading substring of at most n wchar_t characters. If n is less than 1, the entire string is inserted.

If a character in wstr is a tab, newline, carriage return or backspace, the cursor is moved appropriately within the window. A newline also does a 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 win_wch after adding a control character (and moving to it, if necessary) does not return the control character, but instead returns a character in the ^-representation of the control character.


Note that all but wins_nwstr may be macros.

If the first character in the string is a nonspacing character, these functions will fail. XSI does not define what will happen if a nonspacing character follows a control character.


Upon successful completion, these functions return OK. Otherwise, they return ERR.

Functions with a "mv" prefix first perform a cursor movement using wmove, and return an error if the position is outside the window, or if the window pointer is null.


ncurses(3NCURSES), insstr(3NCURSES), in_wch(3NCURSES), ins_wch(3NCURSES).

More Linux Commands

httxt2dbm2(1) Generate dbm files for use with RewriteMap....
httxt2dbm is used to generate dbm files from text input, for use in RewriteMap with the dbm map type. If the output file already exists, it will not be truncate

scalblnl(3) - multiply floating-point number by integral pow
These functions multiply their first argument x by FLT_RADIX (probably 2) to the power of exp, that is: x * FLT_RADIX ** exp The definition of FLT_RADIX can be

Tcl_FSRegister(3) - procedures to interact with any filesyst
There are several reasons for calling the Tcl_FS API functions (e.g. Tcl_FSAccess and Tcl_FSStat) rather than calling system level functions like access and sta

Tk_ResizeWindow(3) - change window configuration or attribut
These procedures are analogous to the X library procedures with similar names, such as XConfigureWindow. Each one of the above procedures calls the correspondin

fgetwc_unlocked(3) - nonlocking stdio functions (Man Page)
Each of these functions has the same behavior as its counterpart without the _unlocked suffix, except that they do not use locking (they do not set locks themse

deliver(8) - deliver mail to an IMAP mailbox (Man Page).....
Deliver reads a message from the standard input and delivers it to one or more IMAP mailboxes. Deliver reads its configuration options out of the imapd.conf(5)

gnutls_supplemental_get_name(3) - API function (Man Page)...
Convert a gnutls_supplemental_data_format_type_t value to a string. RETURNS a string that contains the name of the specified supplemental data format type, or N

vline_set(3ncurses) - create curses borders or lines using c
The border_set and wborder_set functions draw a border around the edges of the current or specified window. These functions do not change the cursor position, a

apply(n) - Apply an anonymous function - Linux manual page
The command apply applies the function func to the arguments arg1 arg2 ... and returns the result. The function func is a two element list {args body} or a thre

mitem_name(3menu) - get menu item name and description field
The function item_name returns the name part of the given item. The function item_description returns the description part of the given item. RETURN VALUE These

MIME::Decoder::BinHex(3pm) - decode a "binhex" stream.......
A MIME::Decoder subclass for a nonstandard encoding whereby data are binhex-encoded. Common non-standard MIME encodings for this: x-uu x-uuencode SEE ALSO MIME:

_nc_free_and_exit(3ncurses) - curses memory-leak checking...
These functions are used to simplify analysis of memory leaks in the ncurses library. They are normally not available; they must be configured into the library

We can't live, work or learn in freedom unless the software we use is free.