idlastro / FITS Binary Table Extensions I/O: FXPARPOS

[Source code]

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.
If neither BEFORE or AFTER 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