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

NAME

6       curs_alecompat,   movenextch,   wmovenextch,  moveprevch,  wmoveprevch,
7       adjcurspos, wadjcurspos - these  functions  are  added  to  ALE  curses
8       library for moving the cursor by character.
9

SYNOPSIS

11       cc [ flag ... ] file ... -lcurses [ library .. ]
12       #include <curses.h>
13
14       int movenextch(void);
15
16
17       int wmovenextch(WINDOW *win);
18
19
20       int moveprevch(void);
21
22
23       int wmoveprevch(WINDOW *win);
24
25
26       int adjcurspos(void);
27
28
29       int wadjcurspos(WINDOW *win);
30
31

DESCRIPTION

33       movenextch() and wmovenextch() move the cursor to the next character to
34       the right. If the next character is a multicolumn character, the cursor
35       is   positioned  on the first (left-most) column of that character. The
36       new cursor position will be on the next character, even if  the  cursor
37       was  originally  positioned  on  the left-most  column of a multicolumn
38       character.  Note that the simple  cursor   increment   (++x)  does  not
39       guarantee movement to the next character,  if the cursor was originally
40       positioned on a multicolumn character. getyx(3CURSES) can  be  used  to
41       find the new position.
42
43
44       moveprevc()   and   wmoveprevch()   routines   are   the   opposite  of
45       movenextch() and  wmovenextch(), moving the  cursor  to  the  left-most
46       column of the previous character.
47
48
49       adjcurspos()  and wadjcurspos() move the cursor to the first(left-most)
50       column of the multicolumn character that the cursor is presently on. If
51       the  cursor  is  already on  the first column, or if the cursor is on a
52       single-column  character,  these routines will have no effect.
53

RETURN VALUE

55       All routines return the integer ERR upon failure and an  integer  value
56       other than ERR upon successful completion.
57

ATTRIBUTES

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

SEE ALSO

71       curses(3CURSES), getyx(3CURSES), attributes(5)
72

NOTES

74       The  header  file  <curses.h>  automatically  includes the header files
75       <stdio.h> , <unctrl.h> and <widec.h>.
76
77
78       Note that  movenextch(), moveprevch(), and adjcurspos() may be macros.
79
80
81
82SunOS 5.11                        31 Dec 1996          curs_alecompat(3CURSES)