ins_wstr
NAMESYNOPSIS
DESCRIPTION
NOTES
RETURN VALUE
SEE ALSO
NAME
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
SYNOPSIS
#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);
DESCRIPTION
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.
NOTES
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.
RETURN VALUE
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.
SEE ALSO
ncurses(3NCURSES), insstr(3NCURSES), in_wch(3NCURSES), ins_wch(3NCURSES).
More Linux Commands
manpages/fdiml.3.html
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
manpages/rresvport_af.3.html
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
manpages/git-fsck.1.html
git-fsck(1) - Verifies the connectivity and validity of the
Verifies the connectivity and validity of the objects in the database. OPTIONS <object> An object to treat as the head of an unreachability trace. If no objects
manpages/XtGetGC.3.html
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
manpages/testparm.1.html
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
manpages/rpc.3.html
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
manpages/is_idcok.3ncurses.html
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
manpages/splashy-config.xml.5.html
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
manpages/dir.1.html
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
manpages/gnutls_certificate_type_set_priority.3.html
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
manpages/gvfs-rm.1.html
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
manpages/XkbForceBell.3.html
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
