CURS_ALECOMPAT(3CURSES) Curses Library Functions CURS_ALECOMPAT(3CURSES)


NAME


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

SYNOPSIS


cc [ flag ... ] file ... -lcurses [ library .. ]
#include <curses.h>

int movenextch(void);


int wmovenextch(WINDOW *win);


int moveprevch(void);


int wmoveprevch(WINDOW *win);


int adjcurspos(void);


int wadjcurspos(WINDOW *win);


DESCRIPTION


movenextch() and wmovenextch() move the cursor to the next character to
the right. If the next character is a multicolumn character, the cursor
is positioned on the first (left-most) column of that character. The new
cursor position will be on the next character, even if the cursor was
originally positioned on the left-most column of a multicolumn
character. Note that the simple cursor increment (++x) does not
guarantee movement to the next character, if the cursor was originally
positioned on a multicolumn character. getyx(3CURSES) can be used to find
the new position.


moveprevc() and wmoveprevch() routines are the opposite of movenextch()
and wmovenextch(), moving the cursor to the left-most column of the
previous character.


adjcurspos() and wadjcurspos() move the cursor to the first(left-most)
column of the multicolumn character that the cursor is presently on. If
the cursor is already on the first column, or if the cursor is on a
single-column character, these routines will have no effect.

RETURN VALUE


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

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO


curses(3CURSES), getyx(3CURSES), attributes(7)

NOTES


The header file <curses.h> automatically includes the header files
<stdio.h> , <unctrl.h> and <widec.h>.


Note that movenextch(), moveprevch(), and adjcurspos() may be macros.


illumos December 31, 1996 CURS_ALECOMPAT(3CURSES)