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

fdiml(3) - positive difference (Library - Linux man page)...
These functions return the positive difference, max(x-y,0), between their arguments. RETURN VALUE On success, these functions return the positive difference. If

rresvport_af(3) routines for returning a stream to a remote
The rcmd() function is used by the superuser to execute a command on a remote machine using an authentication scheme based on privileged port numbers. The rresv

git-fsck(1) - Verifies the connectivity and validity of the
Verifies the connectivity and validity of the objects in the database. OPTIONS &lt;object&gt; An object to treat as the head of an unreachability trace. If no objects

XtGetGC(3) - obtain and destroy a sharable GC (Man Page)....
The XtGetGC function returns a sharable, read-only GC. The parameters to this function are the same as those for XCreateGC except that a widget is passed instea

testparm(1) - check an smb (Commands - Linux manual page)...
This tool is part of the samba(7) suite. testparm is a very simple test program to check an smbd(8) configuration file for internal correctness. If this program

rpc(3) - library routines for remote procedure calls........
These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the s

is_idcok(3ncurses) - curses window properties (Man Page)....
This implementation provides functions which return properties set in the WINDOW structure, allowing it to be opaque if the symbol NCURSES_OPAQUE is defined: is

splashy-config.xml(5) - a user-mode, POSIX and LSB compliant
/etc/splashy/config.xml sets splashys behaviour during boot, shutdown inter-runlevel and error. It is an XML file where all values are enclosed in tags A tag is

dir(1) - list directory contents (Commands - Linux man page)
dir.1 - List information about the FILEs (the current directory by default). Sort entries alphabetically if none of -cftuvSUX nor --sort is specified. Mandatory

gnutls_certificate_type_set_priority(3) - API function......
Sets the priority on the certificate types supported by gnutls. Priority is higher for elements specified before others. After specifying the types you want, yo

gvfs-rm(1) Delete files (Commands - Linux manual page)......
gvfs-rm deletes each given file. The files can be specified as paths or as URIs with a scheme that is understood by gvfs. Note that not all URI schemes may allo

XkbForceBell(3) - Overrides user preference settings for aud
XkbForceBell.3 - The core X protocol allows only applications to explicitly sound the system bell with a given duration, pitch, and volume. Xkb extends this cap

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