About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/stackio_stk_delete_current.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 stk_delete_current Context: stackio

Synopsis

Deletes the current element from the stack.

Syntax

Integer_Type stk_delete_current( Stack_Type stack )

Description

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.

Example

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:
------

Bugs

See the bugs page for the stackio library on the CIAO website for an up-to-date listing of known bugs.

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.