mvinsch(3xcurses)

1insch(3XCURSES)         X/Open Curses Library Functions        insch(3XCURSES)
2
3
4

NAME

6       insch, winsch, mvinsch, mvwinsch - insert a character
7

SYNOPSIS

9       cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
10        -R  /usr/xpg4/lib  -lcurses  [ library... ]
11
12       c89 [ flag... ] file... -lcurses [ library... ]
13
14       #include <curses.h>
15
16       int insch(chtype ch);
17
18
19       int mvinsch(int y, int x, chtype ch);
20
21
22       int mvwinsch(WINDOW *win, int y, int x, chtype ch);
23
24
25       int winsch(WINDOW *win, chtype ch);
26
27

PARAMETERS

29       ch     Is the character to be inserted.
30
31
32       y      Is the y (row) coordinate of the position of the character.
33
34
35       x      Is the x (column) coordinate of the position of the character.
36
37
38       win    Is  a  pointer  to  the  window  in which the character is to be
39              inserted.
40
41

DESCRIPTION

43       These  functions insert the character and rendition from  ch  into  the
44       current or specified window at the current or specified position.
45
46
47       These  functions  do not perform wrapping and do not advance the cursor
48       position. These functions perform  special-character  processing,  with
49       the  exception  that  if  a newline is inserted into the last line of a
50       window and scrolling is not enabled, the behavior is unspecified.
51

RETURN VALUES

53       Upon successful completion, these functions return OK. Otherwise,  they
54       return ERR.
55

ERRORS

57       No errors are defined.
58

USAGE

60       These  functions  are  only guaranteed to operate reliably on character
61       sets in which each character fits into a single byte, whose  attributes
62       can be expressed using only constants with the A_ prefix.
63

ATTRIBUTES

65       See attributes(5) for descriptions of the following attributes:
66
67
68
69
70       ┌─────────────────────────────┬─────────────────────────────┐
71       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │Interface Stability          │Standard                     │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │MT-Level                     │Unsafe                       │
76       └─────────────────────────────┴─────────────────────────────┘
77