1curs_inswch(3CURSES)       Curses Library Functions       curs_inswch(3CURSES)
2
3
4

NAME

6       curs_inswch,  inswch,  winswch,  mvinswch, mvwinswch - insert a wchar_t
7       character before the character under the cursor in a curses window
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library .. ]
11       #include <curses.h>
12
13       int inswch(chtype wch);
14
15
16       int winswch(WINDOW *win, chtype wch);
17
18
19       int mvinswch(int y, int x, chtype wch);
20
21
22       int mvwinswch(WINDOW *win, int y, int x, chtype wch);
23
24

DESCRIPTION

26       These routines insert the character  wch, holding a  wchar_t character,
27       before  the  character under the cursor. All characters to the right of
28       the cursor are moved one space to the right, with  the  possibility  of
29       the  rightmost  character  on  the line being lost. The cursor position
30       does not change (after moving to y, x, if specified).  (This  does  not
31       imply use of the hardware insert character feature.)
32

RETURN VALUE

34       All  routines  return the integer ERR upon failure and an integer value
35       other than ERR upon successful completion.
36

ATTRIBUTES

38       See attributes(5) for descriptions of the following attributes:
39
40
41
42
43       ┌─────────────────────────────┬─────────────────────────────┐
44       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
45       ├─────────────────────────────┼─────────────────────────────┤
46       │MT-Level                     │Unsafe                       │
47       └─────────────────────────────┴─────────────────────────────┘
48

SEE ALSO

50       curses(3CURSES), attributes(5)
51

NOTES

53       The header file <curses.h>  automatically  includes  the  header  files
54       <stdio.h>, <unctrl.h> and <widec.h>.
55
56
57       Note that  inswch(), mvinswch(), and  mvwinswch() may be macros.
58
59
60       None of these routines can use the color attribute in chtype.
61
62
63
64SunOS 5.11                        31 Dec 1996             curs_inswch(3CURSES)