Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: July 2017
 
 

wscrl(3XCURSES)

Name

scrl, scroll, wscrl - scroll a window

Synopsis

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

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

#include <curses.h>

int scrl(int n);
int scroll(WINDOW *win);
int wscrl(WINDOW *win, int n);

Parameters

n

number and direction of lines to scroll

win

pointer to the window in which to scroll

Description

The scroll() function scrolls the window win up one line. The current cursor position is not changed.

The scrl() and wscrl() functions scroll the window stdscr or win up or down n lines, where n is a positive (scroll up) or negative (scroll down) integer.

The scrollok(3XCURSES) function must be enabled for these functions to work.

Return Values

On success, these functions return OK. Otherwise, they return ERR.

Errors

None.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Unsafe
Standard

See Also

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