X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_ins_wch.3x.html;h=5ab6a01189f8fdeb90d2c9991bd56b9c2153396f;hp=e4c734b7fe0f4fc4e903b5d26d08323a5616022a;hb=HEAD;hpb=ed646e3f683083e787c6ba773364401dc9fa9d40 diff --git a/doc/html/man/curs_ins_wch.3x.html b/doc/html/man/curs_ins_wch.3x.html index e4c734b7..f0256e14 100644 --- a/doc/html/man/curs_ins_wch.3x.html +++ b/doc/html/man/curs_ins_wch.3x.html @@ -1,6 +1,7 @@ - - -curs_ins_wch 3x - - + +curs_ins_wch 3x 2024-04-20 ncurses 6.4 Library calls + + -

curs_ins_wch 3x

curs_ins_wch 3x 2024-04-20 ncurses 6.4 Library calls

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

NAME

-       ins_wch,  mvins_wch,  mvwins_wch, wins_wch - insert a complex character
-       and rendition into a window
+       ins_wch,  mvins_wch,  mvwins_wch,  wins_wch  -  insert a curses complex
+       character in a window

SYNOPSIS

-       #include <curses.h>
+       #include <curses.h>
 
        int ins_wch(const cchar_t *wch);
-       int wins_wch(WINDOW *win, const cchar_t *wch);
-       int mvins_wch(int y, int x, const cchar_t *wch);
-       int mvwins_wch(WINDOW *win, int y, int x, const cchar_t *wch);
+       int wins_wch(WINDOW *win, const cchar_t *wch);
+       int mvins_wch(int y, int x, const cchar_t *wch);
+       int mvwins_wch(WINDOW *win, int y, int x, const cchar_t *wch);

DESCRIPTION

-       These routines, insert the complex character wch with rendition  before
-       the  character  under  the  cursor.  All characters to the right of the
-       cursor are moved one space to the right, with the  possibility  of  the
-       rightmost  character  on  the line being lost.  The insertion operation
-       does not change the cursor position.
+       These functions insert the curses complex character wch 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

-       If successful, these functions return OK.  If not, they return ERR.
+       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

+       A  terminal's  insert_character  (ich1)  capability  is not necessarily
+       employed.
 
-       Functions with a "mv" prefix first  perform  a  cursor  movement  using
-       wmove, and return an error if the position is outside the window, or if
-       the window pointer is null.
+       ins_wch, mvins_wch, and mvwins_wch may be implemented as macros.
 
 
-

ERRORS

-       No errors are defined.
+

PORTABILITY

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

HISTORY

+       SVr4  (1989)  implemented  these  functions  under  the  names  inswch,
+       winswch, mvinswch, and mvwinswch.