Deletes the current element from the stack.
Integer_Type stk_delete_current( Stack_Type stack )
The stk_delete_current() routine deletes the current item in the stack.
The remaining items are shifted back and the stack pointer remains at the same
position, unless the current item was also last item in the
stack. In this case, the pointer is moved back one. If
successful, this routine returns 0, and non-zero indicates failure.
chips> stk_disp( stk )
------
Stack position: 2
Stack size: 3
Stack allocated: 100
Stack entries:
1 :a.dat:
2 :b.dat:
3 :c.dat:
------
chips> () = stk_delete_current( stk )
chips> stk_disp( stk )
------
Stack position: 2
Stack size: 2
Stack allocated: 100
Stack entries:
1 :a.dat:
2 :c.dat:
------
- modules
-
stackio
- stackio
-
stk_append,
stk_build,
stk_change_current,
stk_change_num,
stk_close,
stk_count,
stk_current,
stk_delete_num,
stk_disp,
stk_expand_n,
stk_read_next,
stk_read_num,
stk_rewind,
stk_set_current
|