X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_insch.3x.html;h=12edc6cd880ddf9cf9c15dd9c0ef4d03455d20b5;hp=5a1610b5f96ada6389e42fa0bf199e0bcce479ca;hb=HEAD;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/curs_insch.3x.html b/doc/html/man/curs_insch.3x.html index 5a1610b5..5f60c67c 100644 --- a/doc/html/man/curs_insch.3x.html +++ b/doc/html/man/curs_insch.3x.html @@ -1,80 +1,115 @@ + + + + + +curs_insch 3x 2024-04-20 ncurses 6.5 Library calls + + + +

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

-
-
-
-

NAME

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

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);
+curs_insch(3x)                   Library calls                  curs_insch(3x)
 
 
-
-

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.
 
 
-
-

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.
+

NAME

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

NOTES

-       These routines do not necessarily imply use of a  hardware
-       insert character feature.
+

SYNOPSIS

+       #include <curses.h>
 
-       Note that insch, mvinsch, and mvwinsch may be macros.
+       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);
 
 
-
-

PORTABILITY

-       These  functions are described in the XSI Curses standard,
-       Issue 4.
-
-
-
-

SEE ALSO

-       curses(3x).
+

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

+       These functions return OK on success and ERR on failure.
 
+       Functions taking a WINDOW pointer argument fail if the pointer is NULL.
 
+       Functions  prefixed with "mv" first perform cursor movement and fail if
+       the position (y, x) is outside the window boundaries.
 
 
+

NOTES

+       insch, mvinsch, and mvwinsch may be implemented as macros.
 
+       A terminal's insert_character  (ich1)  capability  is  not  necessarily
+       employed.
 
 
+

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)
 
 
 
+ncurses 6.5                       2024-04-20                    curs_insch(3x)
-
-
-Man(1) output converted with -man2html -
+
+ +