Skip to the navigation links
Last modified: December 2009

URL: http://cxc-newtest.cfa.harvard.edu/ciao4.2/stackio_stk_append.html
AHELP for CIAO 4.2

stk_append

Context: stackio

Synopsis

Add an item (or items) to a stack.

Syntax

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

Last modified: December 2009