Synopsis

Add an item (or items) to a stack.

Integer_Type stk_append( Stack_Type stack, String_Type stackstring )
Integer_Type stk_append( Stack_Type stack, String_Type stackstring,
Integer_Type prepend )

Description

Append the item (or items) indicated in the argument stackstring to the end of the stack. The string may be a simple string, or a stack file (indicated by a prefix @ sign). In the latter case, each line in the stack file is appended to the stack. The prepend flag serves the same purpose as in the stk_build() function, which is to prepend the full path name given in the stack file to each element in the file. If successful, this routine returns 0, and non-zero indicates failure.

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_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_read_num, stk_rewind, stk_set_current