curs_insstr(3)curs_insstr(3)NAME
curs_insstr, insstr, insnstr, winsstr, winsnstr, mvinsstr, mvinsnstr,
mvwinsstr, mvwinsnstr - Insert a string before the character under the
cursor in a Curses window
SYNOPSIS
#include <curses.h>
int insstr(
const char *str ); int insnstr(
const char *str,
int n ); int winsstr(
WINDOW *win,
const char *str ); int winsnstr(
WINDOW *win,
const char *str,
int n ); int mvinsstr(
int y,
int x,
const char *str ); int mvinsnstr(
int y,
int x,
const char *str,
int n ); int mvwinsstr(
WINDOW *win,
int y,
int x,
const char *str ); int mvwinsnstr(
WINDOW *win,
int y,
int x,
const char *str,
int n );
LIBRARY
Curses Library (libcurses)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
insstr, insnstr, winsstr, winsnstr, mvinsstr, mvinsnstr, mvwinsstr,
mvwinsnstr: XCURSES4.2
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
DESCRIPTION
These routines insert a 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 moved to the right, with the possibility
of the rightmost characters on the line being lost. The cursor position
does not change (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 charac‐
ters. If n<=0, then the routines insert the entire string.
If a character in str is a tab, newline, carriage return, or backspace,
the routines move the cursor appropriately within the window. A newline
also causes clrtoeol before moving. Tabs are considered to be at every
eighth column. If a character in str is another control character, it
is drawn in the ^X notation. Calling winch after adding a control char‐
acter (and moving to it, if necessary) does not return the control
character, but instead returns the representation of the control char‐
acter.
NOTES
The header file <curses.h> automatically includes the header file
<stdio.h>.
Note that all but winsnstr may be macros.
RETURN VALUES
All routines return the integer ERR upon failure and OK upon successful
completion.
SEE ALSO
Functions: curses(3), curs_clear(3), curs_inch(3)
Others: standards(5)curs_insstr(3)