- NAME
FXPARPOS()
- Purpose
Finds position to insert record into FITS header.
- Explanation
Finds the position to insert a record into a FITS header. Called from
FXADDPAR.
- Use
Result = FXPARPOS(KEYWRD, IEND [, BEFORE=BEFORE ] [, AFTER=AFTER ])
- Inputs
KEYWRD = Array of eight-character keywords in header.
IEND = Position of END keyword.
- Opt. Inputs
None.
- Outputs
Result of function is position to insert record.
- Opt. Outputs
None.
- Keywords
BEFORE = Keyword string name. The parameter will be placed before the
location of this keyword. For example, if BEFORE='HISTORY'
then the parameter will be placed before the first history
location. This applies only when adding a new keyword;
keywords already in the header are kept in the same position.
AFTER = Same as BEFORE, but the parameter will be placed after the
location of this keyword. This keyword takes precedence over
BEFORE.
AST = The parameter will be placed just after the last keyword
which is not a blank, COMMENT, or HISTORY record. Both the
BEFORE and AFTER keywords take precedence over LAST.
If none of the BEFORE, AFTER, or LAST keywords are passed, then IEND is
returned.
- Calls
None.
- Common
None.
- Restrictions
KEYWRD and IEND must be consistent with the relevant FITS header.
- Side effects
None.
- Category
Data Handling, I/O, FITS, Generic.
- Prev. Hist.
William Thompson, Jan 1992.
- Written
William Thompson, GSFC, January 1992.
- Modified
Version 1, William Thompson, GSFC, 12 April 1993.
Incorporated into CDS library.
- Version
Version 1, 12 April 1993.
Converted to IDL V5.0 W. Landsman September 1997
ersion 3, 15-Mar-2017, William Thompson, GSFC
Test for continue lines when using AFTER option.
ersion 4, 16-Mar-2017, William Thompson, GSFC, added LAST keyword
ersion 5, 30-Mar-2017, William Thompson, GSFC, fix bug if AFTER=''