Synopsis

Display the contents of a stack.

stk_disp( Stack_Type stack )

Description

This is a utility routine that displays the contents of the stack - including ther current position - to the screen (i.e. stdout).

The stackio module is not available by default; to use it in a S-Lang program, it must be loaded using the S-Lang require() function:

  require("stackio");

Example

slsh> require("stackio");
slsh> stk = stk_build( "@stack.lis" );
slsh> stk_disp( stk );
------
Stack position: 0
Stack size: 3
Stack allocated: 100
Stack entries:
1 :a.dat:
2 :b.dat:
3 :c.dat:
------
slsh> stk_read_next( stk );
a.dat
slsh> stk_disp( stk ) ;
------
Stack position: 1
Stack size: 3
Stack allocated: 100
Stack entries:
1 :a.dat:
2 :b.dat:
3 :c.dat:
------

In this example we used stk_disp() to display the stack after it has been created - so its position is 0 - and after calling stk_read_next() - when the position had been increased by 1.

Bugs

See the bugs page for the stackio library on the CIAO website for an up-to-date listing of known bugs.

See Also

modules

stackio

stackio

stk_append, stk_build, stk_change_current, stk_change_num, stk_close, stk_count, stk_current, stk_delete_current, stk_delete_num, stk_expand_n, stk_read_next, stk_read_num, stk_rewind, stk_set_current