curs_scroll(3curses)                            curs_scroll(3curses)


       NAME
             curs_scroll: scroll, srcl, wscrl - scroll a curses window

       SYNOPSIS
             cc [flag . . .] file -lcurses [library . . .]
             #include <curses.h>
             int scroll(WINDOW *win);
             int scrl(int n);
             int wscrl(WINDOW *win, int n);

       DESCRIPTION
             With the scroll routine, the window is scrolled up one line.
             This involves moving the lines in the window data structure.
             As an optimization, if the scrolling region of the window is
             the entire screen, the physical screen is scrolled at the same
             time.

             With the scrl and wscrl routines, for positive n scroll the
             window up n lines (line i+n becomes i); otherwise scroll the
             window down n lines.  This involves moving the lines in the
             window character image structure.  The current cursor position
             is not changed.

             For these functions to work, scrolling must be enabled via
             scrollok.

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

       REFERENCES
             curses(3curses), curs_outopts(3curses)

       NOTICES
             The header file curses.h automatically includes the header
             files stdio.h and unctrl.h.

             Note that scrl and scroll may be macros.










                           Copyright 1994 Novell, Inc.               Page 1