X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_ins_wch.3x.html;h=883121e82179ec5b6d71343f6dad63d6bfa7f168;hp=ed0ab4db3e4915646d9d851d01a284556cfa331f;hb=HEAD;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/curs_ins_wch.3x.html b/doc/html/man/curs_ins_wch.3x.html index ed0ab4db..f0256e14 100644 --- a/doc/html/man/curs_ins_wch.3x.html +++ b/doc/html/man/curs_ins_wch.3x.html @@ -1,7 +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 com-
-       plex character and rendition into a window
+

NAME

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

SYNOPSIS

-       #include <curses.h>
+

SYNOPSIS

+       #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 ren-
-       dition before the character under the cursor.  All charac-
-       ters 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.
+

DESCRIPTION

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

RETURN VALUE

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

ERRORS

-       No errors are defined.
+       Functions prefixed with "mv" first perform cursor movement and fail  if
+       the position (y, x) is outside the window boundaries.
 
 
-
-

SEE ALSO

-       curses(3x), curs_insch(3x).
+

NOTES

+       A  terminal's  insert_character  (ich1)  capability  is not necessarily
+       employed.
+
+       ins_wch, mvins_wch, and mvwins_wch may be implemented as macros.
+
+
+

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

SEE ALSO

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