Package nom.tam.fits.header.hierarch
Class StandardIHierarchKeyFormatter
java.lang.Object
nom.tam.fits.header.hierarch.StandardIHierarchKeyFormatter
- All Implemented Interfaces:
IHierarchKeyFormatter
HIERARCH keyword formatter based on the ESO convention. This formatter writes HIERARCH keywords that conform to the
ESO convention, but takes a more liberal approach by supporting the full range of ASCII characters allowed in FITS
headers, including the option to preserve case. (The ESO convention is upper-case only).
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Appends the formatted HIERARCH keyword to the Fits line buffer.int
Returns the extra spaces required when printing the key, relative to a space separated components following "HIERARCH " and the "= " prior to the value.final boolean
Checks if this formatter allows support for case-sensitive (mixed-case) hierarchical keywords.void
setCaseSensitive
(boolean value) Sets whether case-sensitive (mixed-case) HIERARCH keywords are supported.toHeaderString
(String key) Returns the string reppresentation of the specified HIERARCH keyword in the FITS headerMethods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface nom.tam.fits.header.hierarch.IHierarchKeyFormatter
getAssignStringForSpace, getMinAssignLength
-
Constructor Details
-
StandardIHierarchKeyFormatter
public StandardIHierarchKeyFormatter()
-
-
Method Details
-
toHeaderString
Description copied from interface:IHierarchKeyFormatter
Returns the string reppresentation of the specified HIERARCH keyword in the FITS header- Specified by:
toHeaderString
in interfaceIHierarchKeyFormatter
- Parameters:
key
- the HIERARCH keyword, in the dot separated convention of this library- Returns:
- how this key looks in the FITS header with this formatting convention.
-
append
Description copied from interface:IHierarchKeyFormatter
Appends the formatted HIERARCH keyword to the Fits line buffer. For example as a step towards builing up the header card for this keyword.- Specified by:
append
in interfaceIHierarchKeyFormatter
- Parameters:
key
- The HIERARCH keyword in out own internal representation (HIERARCH.
followed by the dot-sepatated hierarchical components).buffer
- The FITS line buffer to which we want the formatted HIERARCH-style keyword to be appended.
-
getExtraSpaceRequired
Description copied from interface:IHierarchKeyFormatter
Returns the extra spaces required when printing the key, relative to a space separated components following "HIERARCH " and the "= " prior to the value.- Specified by:
getExtraSpaceRequired
in interfaceIHierarchKeyFormatter
- Parameters:
key
- the HIERARCH-style header key.- Returns:
- the number of extra spaces relative to the most compact notation for the components.
-
setCaseSensitive
public void setCaseSensitive(boolean value) Description copied from interface:IHierarchKeyFormatter
Sets whether case-sensitive (mixed-case) HIERARCH keywords are supported.- Specified by:
setCaseSensitive
in interfaceIHierarchKeyFormatter
- Parameters:
value
- Iffalse
(default), then all HIERARCH keywords will be converted to upper-case. Otherwise, case will be preserved.- See Also:
-
isCaseSensitive
public final boolean isCaseSensitive()Description copied from interface:IHierarchKeyFormatter
Checks if this formatter allows support for case-sensitive (mixed-case) hierarchical keywords.- Specified by:
isCaseSensitive
in interfaceIHierarchKeyFormatter
- Returns:
- If
false
(default), then all HIERARCH keywords will be converted to upper-case. Otherwise, case will be preserved.
-