octave: Paging Screen Output
14.1.1.1 Paging Screen Output
.............................
When running interactively, Octave normally sends any output intended
for your terminal that is more than one screen long to a paging program,
such as ‘less’ or ‘more’. This avoids the problem of having a large
volume of output stream by before you can read it. With ‘less’ (and
some versions of ‘more’) you can also scan forward and backward, and
search for specific items.
Normally, no output is displayed by the pager until just before
Octave is ready to print the top level prompt, or read from the standard
input (for example, by using the ‘fscanf’ or ‘scanf’ functions). This
means that there may be some delay before any output appears on your
screen if you have asked Octave to perform a significant amount of work
with a single command statement. The function ‘fflush’ may be used to
force output to be sent to the pager (or any other stream) immediately.
You can select the program to run as the pager using the ‘PAGER’
function, and you can turn paging off by using the function ‘more’.
-- : more
-- : more on
-- : more off
Turn output pagination on or off.
Without an argument, ‘more’ toggles the current state.
The current state can be determined via ‘page_screen_output’.
DONTPRINTYET See also: page_screen_output XREFpage_screen_output, *noteDONTPRINTYET DONTPRINTYET See also: page_screen_output XREFpage_screen_output,
page_output_immediately XREFpage_output_immediately, *notePAGER:
DONTPRINTYET DONTPRINTYET See also: page_screen_output XREFpage_screen_output,
page_output_immediately XREFpage_output_immediately, PAGER
XREFPAGER, PAGER_FLAGS XREFPAGER_FLAGS.
-- : VAL = PAGER ()
-- : OLD_VAL = PAGER (NEW_VAL)
-- : PAGER (NEW_VAL, "local")
Query or set the internal variable that specifies the program to
use to display terminal output on your system.
The default value is normally "less", "more", or "pg", depending on
what programs are installed on your system. Installation.
When called from inside a function with the "local" option, the
variable is changed locally for the function and any subroutines it
calls. The original variable value is restored when exiting the
function.
DONTPRINTYET See also: PAGER_FLAGS XREFPAGER_FLAGS, *noteDONTPRINTYET DONTPRINTYET See also: PAGER_FLAGS XREFPAGER_FLAGS,
page_output_immediately XREFpage_output_immediately, *notemore:
DONTPRINTYET DONTPRINTYET See also: PAGER_FLAGS XREFPAGER_FLAGS,
page_output_immediately XREFpage_output_immediately, more
XREFmore, page_screen_output XREFpage_screen_output.
-- : VAL = PAGER_FLAGS ()
-- : OLD_VAL = PAGER_FLAGS (NEW_VAL)
-- : PAGER_FLAGS (NEW_VAL, "local")
Query or set the internal variable that specifies the options to
pass to the pager.
When called from inside a function with the "local" option, the
variable is changed locally for the function and any subroutines it
calls. The original variable value is restored when exiting the
function.
DONTPRINTYET See also: PAGER XREFPAGER, more XREFmore, *noteDONTPRINTYET DONTPRINTYET See also: PAGER XREFPAGER, more XREFmore,
page_screen_output XREFpage_screen_output, *noteDONTPRINTYET DONTPRINTYET See also: PAGER XREFPAGER, more XREFmore,
page_screen_output XREFpage_screen_output,
page_output_immediately XREFpage_output_immediately.
-- : VAL = page_screen_output ()
-- : OLD_VAL = page_screen_output (NEW_VAL)
-- : page_screen_output (NEW_VAL, "local")
Query or set the internal variable that controls whether output
intended for the terminal window that is longer than one page is
sent through a pager.
This allows you to view one screenful at a time. Some pagers (such
as ‘less’—see Installation) are also capable of moving
backward on the output.
When called from inside a function with the "local" option, the
variable is changed locally for the function and any subroutines it
calls. The original variable value is restored when exiting the
function.
DONTPRINTYET See also: more XREFmore, *notepage_output_immediately:
DONTPRINTYET DONTPRINTYET See also: more XREFmore, page_output_immediately
XREFpage_output_immediately, PAGER XREFPAGER, *noteDONTPRINTYET DONTPRINTYET See also: more XREFmore, page_output_immediately
XREFpage_output_immediately, PAGER XREFPAGER,
PAGER_FLAGS XREFPAGER_FLAGS.
-- : VAL = page_output_immediately ()
-- : OLD_VAL = page_output_immediately (NEW_VAL)
-- : page_output_immediately (NEW_VAL, "local")
Query or set the internal variable that controls whether Octave
sends output to the pager as soon as it is available.
Otherwise, Octave buffers its output and waits until just before
the prompt is printed to flush it to the pager.
When called from inside a function with the "local" option, the
variable is changed locally for the function and any subroutines it
calls. The original variable value is restored when exiting the
function.
DONTPRINTYET See also: page_screen_output XREFpage_screen_output, *noteDONTPRINTYET DONTPRINTYET See also: page_screen_output XREFpage_screen_output,
more XREFmore, PAGER XREFPAGER, *notePAGER_FLAGS:
DONTPRINTYET DONTPRINTYET See also: page_screen_output XREFpage_screen_output,
more XREFmore, PAGER XREFPAGER, PAGER_FLAGS
XREFPAGER_FLAGS.
-- : fflush (FID)
Flush output to file descriptor FID.
‘fflush’ returns 0 on success and an OS dependent error value (−1
on Unix) on error.
Programming Note: Flushing is useful for ensuring that all pending
output makes it to the screen before some other event occurs. For
example, it is always a good idea to flush the standard output
stream before calling ‘input’.
See also: fopen XREFfopen, fclose XREFfclose.