X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_insstr.3x.html;h=78d7743555c5fc2985b382f41836aff29e0c03d9;hp=2349cbc28668e8bd96c2e831449a38cb3a34befa;hb=55ccd2b959766810cf7db8d1c4462f338ce0afc8;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;ds=sidebyside diff --git a/doc/html/man/curs_insstr.3x.html b/doc/html/man/curs_insstr.3x.html index 2349cbc2..78d77435 100644 --- a/doc/html/man/curs_insstr.3x.html +++ b/doc/html/man/curs_insstr.3x.html @@ -1,27 +1,69 @@ + + + +curs_insstr 3x + + + +

curs_insstr 3x

 
+curs_insstr(3x)                                         curs_insstr(3x)
+
+
+

NAME

-       insstr,  insnstr,  winsstr, winsnstr, mvinsstr, mvinsnstr,
-       mvwinsstr, mvwinsnstr - insert string before cursor  in  a
-       curses window
+       insstr,  insnstr,  winsstr, winsnstr, mvinsstr, mvinsnstr,
+       mvwinsstr, mvwinsnstr - insert string before 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);
+       #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);

@@ -29,102 +71,52 @@ These routines insert a character string (as many charac- ters 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 char- + shifted right with the possibility of the rightmost char- acters on the line being lost. 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 sub- - string of 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 a character in - the ^-representation of the control character. + not change (after moving to y, x, if specified). The + functions with n as the last argument insert a leading + substring of at most n characters. If n<=0, then the + entire string is inserted. + + Special characters are handled as in addch.

RETURN VALUE

-       All  routines that return an integer return ERR upon fail-
+       All  routines that return an integer return ERR upon fail-
        ure and OK (SVr4 specifies only "an  integer  value  other
-       than  ERR")  upon  successful completion, unless otherwise
+       than  ERR")  upon  successful completion, unless otherwise
        noted in the preceding routine descriptions.
 
+       X/Open defines no error conditions.  In  this  implementa-
+       tion, if the window parameter is null or the str parameter
+       is null, an error is returned.
+

NOTES

-       Note that all but winsnstr may be macros.
+       Note that all but winsnstr may be macros.

PORTABILITY