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
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidAppends the formatted HIERARCH keyword to the Fits line buffer.intReturns the extra spaces required when printing the key, relative to a space separated components following "HIERARCH " and the "= " prior to the value.final booleanChecks if this formatter allows support for case-sensitive (mixed-case) hierarchical keywords.voidsetCaseSensitive(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, waitMethods inherited from interface nom.tam.fits.header.hierarch.IHierarchKeyFormatter
getAssignStringForSpace, getMinAssignLength
-
Constructor Details
-
StandardIHierarchKeyFormatter
public StandardIHierarchKeyFormatter()
-
-
Method Details
-
toHeaderString
Description copied from interface:IHierarchKeyFormatterReturns the string reppresentation of the specified HIERARCH keyword in the FITS header- Specified by:
toHeaderStringin 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:IHierarchKeyFormatterAppends 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:
appendin 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:IHierarchKeyFormatterReturns the extra spaces required when printing the key, relative to a space separated components following "HIERARCH " and the "= " prior to the value.- Specified by:
getExtraSpaceRequiredin 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:IHierarchKeyFormatterSets whether case-sensitive (mixed-case) HIERARCH keywords are supported.- Specified by:
setCaseSensitivein 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:IHierarchKeyFormatterChecks if this formatter allows support for case-sensitive (mixed-case) hierarchical keywords.- Specified by:
isCaseSensitivein interfaceIHierarchKeyFormatter- Returns:
- If
false(default), then all HIERARCH keywords will be converted to upper-case. Otherwise, case will be preserved.
-