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

NAME

6       curs_inswstr,  inswstr, insnwstr, winswstr, winsnwstr, mvinswstr, mvin‐
7       snwstr, mvwinswstr, mvwinsnwstr - insert wchar_t string before  charac‐
8       ter under the cursor in a curses window
9

SYNOPSIS

11       cc [ flag ... ] file ... -lcurses [ library .. ]
12       #include <curses.h>
13
14       int inswstr(wchar_t *wstr);
15
16
17       int insnwstr(wchar_t *wstr, int n);
18
19
20       int winswstr(WINDOW *win, wchar_t *wstr);
21
22
23       int winsnwstr(WINDOW *win, wchar_t *wstr, int n);
24
25
26       int mvinswstr(int y, int x, wchar_t *wstr);
27
28
29       int mvinsnwstr(int y, int x, wchar_t *wstr, int n);
30
31
32       int mvwinswstr(WINDOW *win, int y, int x, wchar_t *wstr);
33
34
35       int mvwinsnwstr(WINDOW *win, int y, int x, wchar_t *wstr, int n);
36
37

DESCRIPTION

39       These  routines  insert  a   wchar_t character string (as many  wchar_t
40       characters as will fit on the line) before the character under the cur‐
41       sor.  All characters to the right of the cursor are moved to the right,
42       with the possibility of the rightmost  characters  on  the  line  being
43       lost.  The  cursor  position  does not change (after moving to y, x, if
44       specified). (This does not imply use of the hardware  insert  character
45       feature.)  The four routines with n as the last argument insert at most
46       n wchar_t characters. If n<=0, then the entire string is inserted.
47
48
49       If a character  in   wstr  is  a  tab,  newline,  carriage  return,  or
50       backspace,  the cursor is moved appropriately within the window. A new‐
51       line also does a  clrtoeol(3CURSES) before moving. Tabs are  considered
52       to  be  at every eighth column. If a character in  wstr is another con‐
53       trol character, it is drawn in the ^X notation. Calling winwch(3CURSES)
54       after  adding a control character (and moving to it, if necessary) does
55       not return the control character, but instead returns  the  representa‐
56       tion of the control character.
57

RETURN VALUE

59       All  routines  return the integer ERR upon failure and an integer value
60       other than ERR upon successful completion.
61

ATTRIBUTES

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

SEE ALSO

75       clrtoeol(3CURSES), curses(3CURSES), winwch(3CURSES), attributes(5)
76

NOTES

78       The header file <curses.h>  automatically  includes  the  header  files
79       <stdio.h>, <unctrl.h> and <widec.h>.
80
81
82       Note that all but  winsnwstr() may be macros.
83
84
85
86SunOS 5.11                        31 Dec 1996            curs_inswstr(3CURSES)
Impressum