*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> curs_insstr (3x)              
Title
Content
Arch
Section
 

Contents


curs_insstr(3X)						       curs_insstr(3X)


NAME    [Toc]    [Back]

     curs_insstr:  insstr, insnstr, winsstr, winsnstr, mvinsstr, mvinsnstr,
     mvwinsstr,	mvwinsnstr - insert string before character under the cursor
     in	a curses window

SYNOPSIS    [Toc]    [Back]

     #include <curses.h>

     int insstr(char *str);
     int insnstr(char *str, int	n);
     int winsstr(WINDOW	*win, char *str);
     int winsnstr(WINDOW *win, char *str, int n);
     int mvinsstr(int y, int x,	char *str);
     int mvinsnstr(int y, int x, char *str, int	n);
     int mvwinsstr(WINDOW *win,	int y, int x, char *str);
     int mvwinsnstr(WINDOW *win, int y,	int x, char *str, int n);

DESCRIPTION    [Toc]    [Back]

     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 characters.  If n<=0,	then
     the entire	string is inserted.

     If	a character in str 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	str 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.

RETURN VALUE    [Toc]    [Back]

     All routines return the integer ERR upon failure and an integer value
     other than	ERR upon successful completion.

NOTES    [Toc]    [Back]

     The header	file curses.h automatically includes the header	files stdio.h
     and unctrl.h.

     Note that all but winsnstr	may be macros.

SEE ALSO    [Toc]    [Back]

      
      
     curses(3X), curs_clear(3X), curs_inch(3X)


									PPPPaaaaggggeeee 1111
[ Back ]
 Similar pages
Name OS Title
curs_inswstr IRIX insert wchar_t string before character under the cursor in a curses window
mvwinsnstr Tru64 Insert a string before the character under the cursor in a Curses window
winsstr Tru64 Insert a string before the character under the cursor in a Curses window
winsnstr Tru64 Insert a string before the character under the cursor in a Curses window
mvinsstr Tru64 Insert a string before the character under the cursor in a Curses window
insstr Tru64 Insert a string before the character under the cursor in a Curses window
mvinsnstr Tru64 Insert a string before the character under the cursor in a Curses window
insnstr Tru64 Insert a string before the character under the cursor in a Curses window
curs_insstr Tru64 Insert a string before the character under the cursor in a Curses window
mvwinsstr Tru64 Insert a string before the character under the cursor in a Curses window
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service