xref: /illumos-gate/usr/src/man/man3xcurses/mvcur.3xcurses (revision c10c16dec587a0662068f6e2991c29ed3a9db943)
te
Copyright (c) 1990, 1995 by Mortice Kern Systems Inc. All Rights Reserved Portions Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
mvcur 3XCURSES "5 Jun 2002" "SunOS 5.11" "X/Open Curses Library Functions"
NAME
mvcur - move the cursor
SYNOPSIS

cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \e
 -R  /usr/xpg4/lib  -lcurses  [ library... ]

c89 [ flag... ] file... -lcurses [ library... ]

#include <curses.h>

int mvcur(int oldrow, int oldcol, int newrow, int newcol);
PARAMETERS

oldrow

Is the row from which cursor is to be moved.

oldcol

Is the column from which cursor is to be moved.

newrow

Is the row to which cursor is to be moved.

newcol

Is the column to which cursor is to be moved.

DESCRIPTION

The mvcur() function is a low-level function used only outside of X/Open Curses when the program has to deal directly with the terminfo database to handle certain terminal capabilities. The use of appropriate X/Open Curses functions is recommended in all other situations, so that X/Open Curses can track the cursor.

The mvcur() function moves the cursor from the location specified by oldrow and oldcol to the location specified by newrow and newcol. A program using this function must keep track of the current cursor position.

RETURN VALUES

On success, the mvcur() function returns OK. Otherwise, it returns ERR.

ERRORS

None.

ATTRIBUTES

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

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityStandard
MT-LevelUnsafe
SEE ALSO

libcurses(3XCURSES), attributes(5), standards(5)