Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

leaveok(3)  —  Subroutines

NAME

leaveok − Enables a non-tracking cursor

SYNOPSIS

#include <curses.h>
 
int leaveok(win, bf)
    WINDOW ∗win;
    bool bf;

DESCRIPTION

This option allows the cursor to be left wherever the update happens to leave it.  Normally, the cursor is left at the current location (y, x) of the window being refreshed.  This routine is useful for applications where the cursor is not used, since it reduces the need for cursor motions.  If possible, the cursor is made invisible when this option is enabled. 

This option is initially disabled, and is not enabled until the value of bf is changed from FALSE to TRUE. 

RETURN VALUES

The leaveok function returns OK on success and ERR on error. 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026