X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_insch.3x.html;h=238b418b8e851ddf4eb93b79b5349b7560416708;hp=ed909f3149025a95534ac32dc9a54bd3472b3c61;hb=HEAD;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/curs_insch.3x.html b/doc/html/man/curs_insch.3x.html index ed909f31..5f60c67c 100644 --- a/doc/html/man/curs_insch.3x.html +++ b/doc/html/man/curs_insch.3x.html @@ -1,7 +1,7 @@ - - + -curs_insch 3x - - + + +curs_insch 3x 2024-04-20 ncurses 6.5 Library calls + + -

curs_insch 3x

-
+

curs_insch 3x 2024-04-20 ncurses 6.5 Library calls

-
-curs_insch(3x)                                           curs_insch(3x)
+curs_insch(3x)                   Library calls                  curs_insch(3x)
 
 
 
 
-
-

NAME

-       insch,  winsch,  mvinsch,  mvwinsch  -  insert a character
-       before cursor in a curses window
+

NAME

+       insch,  winsch,  mvinsch,  mvwinsch  -  insert  a curses character in a
+       window
 
 
-
-

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
-       int insch(chtype ch);
-       int winsch(WINDOW *win, chtype ch);
-       int mvinsch(int y, int x, chtype ch);
-       int mvwinsch(WINDOW *win, int y, int x, chtype ch);
+       int insch(chtype ch);
+       int winsch(WINDOW *win, chtype ch);
+       int mvinsch(int y, int x, chtype ch);
+       int mvwinsch(WINDOW *win, int y, int x, chtype ch);
 
 
-
-

DESCRIPTION

-       These routines insert the character ch before the  charac-
-       ter  under the cursor.  All characters to the right of the
-       cursor are moved one space to the right, with  the  possi-
-       bility  of the rightmost character on the line being lost.
-       The insertion operation does not change the  cursor  posi-
-       tion.
+

DESCRIPTION

+       These functions insert the curses character ch at  the  cursor  in  the
+       specified  window  win  (or  stdscr).   The character previously at the
+       cursor and any to its right move one cell to the right;  the  rightmost
+       character on the line is discarded.  The cursor does not advance.
 
 
-
-

RETURN VALUE

-       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
-       noted in the preceding routine descriptions.
+

RETURN VALUE

+       These functions return OK on success and ERR on failure.
 
+       Functions taking a WINDOW pointer argument fail if the pointer is NULL.
 
-
-

NOTES

-       These routines do not necessarily imply use of a  hardware
-       insert character feature.
+       Functions  prefixed with "mv" first perform cursor movement and fail if
+       the position (y, x) is outside the window boundaries.
 
-       Note that insch, mvinsch, and mvwinsch may be macros.
 
+

NOTES

+       insch, mvinsch, and mvwinsch may be implemented as macros.
 
-
-

PORTABILITY

-       These  functions are described in the XSI Curses standard,
-       Issue 4.
+       A terminal's insert_character  (ich1)  capability  is  not  necessarily
+       employed.
 
 
-
-

SEE ALSO

-       curses(3x).
+

PORTABILITY

+       X/Open Curses, Issue 4 describes these functions.
+
+       SVr4  curses  describes  a  successful return value only as "an integer
+       value other than ERR".
+
+
+

SEE ALSO

+       curs_ins_wch(3x) describes comparable functions in  the  wide-character
+       curses configuration.
+
+       curses(3x), terminfo(5)
 
 
 
-                                                         curs_insch(3x)
+ncurses 6.5                       2024-04-20                    curs_insch(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +