Returns the selected element from a stack.
String_Type stk_read_num( Stack_Type stack, Integer_Type N )
Return the character string from a stack in position N. The first
item in the stack is assigned the number "1", and
sequentially thereafter. NULL is returned if any errors were
encountered or if the requested entry was outside the range
of the stack.
This function does not change the current position of the
stack - i.e. that used by routines like
stk_read_next(), stk_set_current(), and stk_rewind().
The following example shows you one way to loop through
all the elements in a stack.
See the ahelp page for stk_read_next() for another way to do this.
_for ( 1, stk_count(stk), 1 ) {
variable i = ();
variable elem = stk_read_num( stk, i );
vmessage( "Stack: %s", elem );
}
- 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_disp,
stk_expand_n,
stk_read_next,
stk_rewind,
stk_set_current
|
![[CIAO Logo]](../imgs/ciao_logo_navbar.gif){kind=logo}