|AHELP for CIAO 4.2||
Display the contents of a stack.
stk_disp( Stack_Type stack )
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:
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.
See the bugs page for the stackio library on the CIAO website for an up-to-date listing of known bugs.