Technical Reference: Base Operating System and Extensions, Volume 2

move or wmove Subroutine

Purpose

Window location cursor functions.

Library

Curses Library (libcurses.a)

Syntax

int ( x);

int wmove (WINDOW *win,
int y,
int x);

Description

The move and wmove subroutines move the logical cursor associated with the current or specified window to (y, x) relative to the window's origin. This subroutine does not move the cursor of the terminal until the next refresh (refresh or wrefresh Subroutine) operation.

Parameters

y
x
*win

Return Values

Upon successful completion, these subroutines return OK. Otherwise, they return ERR.

Examples

To move the logical cursor in the stdscr to the coordinates y = 5, x = 10, use:
```
move(5, 10);
```
To move the logical cursor in the user-defined window my_window to the coordinates y = 5, x = 10, use:
```
WINDOW *my_window;
wmove(my_window, 5, 10);
```

Related Information

The getch (getch, mvgetch, mvwgetch, or wgetch Subroutine) and refresh (refresh or wrefresh Subroutine) subroutines.

Controlling the Cursor with Curses, Curses Overview for Programming, List of Curses Subroutines in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs.