wcslib (8.2.2)
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.8"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>WCSLIB: fitshdr.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr id="projectrow">
<td id="projectalign">
<div id="projectname">WCSLIB<span id="projectnumber"> 8.2.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.8 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search/",'.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */
$(document).ready(function() { init_codefold(0); });
/* @license-end */
</script>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<div id="MSearchResults">
<div class="SRPage">
<div id="SRIndex">
<div id="SRResults"></div>
<div class="SRStatus" id="Loading">Loading...</div>
<div class="SRStatus" id="Searching">Searching...</div>
<div class="SRStatus" id="NoMatches">No Matches</div>
</div>
</div>
</div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_af99bb3c152a306abd27951285ad1127.html">C</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle"><div class="title">fitshdr.h</div></div>
</div><!--header-->
<div class="contents">
<a href="fitshdr_8h.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno"> 1</span><span class="comment">/*============================================================================</span></div>
<div class="line"><a id="l00002" name="l00002"></a><span class="lineno"> 2</span><span class="comment"> WCSLIB 8.2 - an implementation of the FITS WCS standard.</span></div>
<div class="line"><a id="l00003" name="l00003"></a><span class="lineno"> 3</span><span class="comment"> Copyright (C) 1995-2023, Mark Calabretta</span></div>
<div class="line"><a id="l00004" name="l00004"></a><span class="lineno"> 4</span><span class="comment"></span> </div>
<div class="line"><a id="l00005" name="l00005"></a><span class="lineno"> 5</span><span class="comment"> This file is part of WCSLIB.</span></div>
<div class="line"><a id="l00006" name="l00006"></a><span class="lineno"> 6</span><span class="comment"></span> </div>
<div class="line"><a id="l00007" name="l00007"></a><span class="lineno"> 7</span><span class="comment"> WCSLIB is free software: you can redistribute it and/or modify it under the</span></div>
<div class="line"><a id="l00008" name="l00008"></a><span class="lineno"> 8</span><span class="comment"> terms of the GNU Lesser General Public License as published by the Free</span></div>
<div class="line"><a id="l00009" name="l00009"></a><span class="lineno"> 9</span><span class="comment"> Software Foundation, either version 3 of the License, or (at your option)</span></div>
<div class="line"><a id="l00010" name="l00010"></a><span class="lineno"> 10</span><span class="comment"> any later version.</span></div>
<div class="line"><a id="l00011" name="l00011"></a><span class="lineno"> 11</span><span class="comment"></span> </div>
<div class="line"><a id="l00012" name="l00012"></a><span class="lineno"> 12</span><span class="comment"> WCSLIB is distributed in the hope that it will be useful, but WITHOUT ANY</span></div>
<div class="line"><a id="l00013" name="l00013"></a><span class="lineno"> 13</span><span class="comment"> WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS</span></div>
<div class="line"><a id="l00014" name="l00014"></a><span class="lineno"> 14</span><span class="comment"> FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for</span></div>
<div class="line"><a id="l00015" name="l00015"></a><span class="lineno"> 15</span><span class="comment"> more details.</span></div>
<div class="line"><a id="l00016" name="l00016"></a><span class="lineno"> 16</span><span class="comment"></span> </div>
<div class="line"><a id="l00017" name="l00017"></a><span class="lineno"> 17</span><span class="comment"> You should have received a copy of the GNU Lesser General Public License</span></div>
<div class="line"><a id="l00018" name="l00018"></a><span class="lineno"> 18</span><span class="comment"> along with WCSLIB. If not, see http://www.gnu.org/licenses.</span></div>
<div class="line"><a id="l00019" name="l00019"></a><span class="lineno"> 19</span><span class="comment"></span> </div>
<div class="line"><a id="l00020" name="l00020"></a><span class="lineno"> 20</span><span class="comment"> Author: Mark Calabretta, Australia Telescope National Facility, CSIRO.</span></div>
<div class="line"><a id="l00021" name="l00021"></a><span class="lineno"> 21</span><span class="comment"> http://www.atnf.csiro.au/people/Mark.Calabretta</span></div>
<div class="line"><a id="l00022" name="l00022"></a><span class="lineno"> 22</span><span class="comment"> $Id: fitshdr.h,v 8.2.1.1 2023/11/16 10:05:57 mcalabre Exp mcalabre $</span></div>
<div class="line"><a id="l00023" name="l00023"></a><span class="lineno"> 23</span><span class="comment">*=============================================================================</span></div>
<div class="line"><a id="l00024" name="l00024"></a><span class="lineno"> 24</span><span class="comment">*</span></div>
<div class="line"><a id="l00025" name="l00025"></a><span class="lineno"> 25</span><span class="comment">* WCSLIB 8.2 - C routines that implement the FITS World Coordinate System</span></div>
<div class="line"><a id="l00026" name="l00026"></a><span class="lineno"> 26</span><span class="comment">* (WCS) standard. Refer to the README file provided with WCSLIB for an</span></div>
<div class="line"><a id="l00027" name="l00027"></a><span class="lineno"> 27</span><span class="comment">* overview of the library.</span></div>
<div class="line"><a id="l00028" name="l00028"></a><span class="lineno"> 28</span><span class="comment">*</span></div>
<div class="line"><a id="l00029" name="l00029"></a><span class="lineno"> 29</span><span class="comment">*</span></div>
<div class="line"><a id="l00030" name="l00030"></a><span class="lineno"> 30</span><span class="comment">* Summary of the fitshdr routines</span></div>
<div class="line"><a id="l00031" name="l00031"></a><span class="lineno"> 31</span><span class="comment">* -------------------------------</span></div>
<div class="line"><a id="l00032" name="l00032"></a><span class="lineno"> 32</span><span class="comment">* The Flexible Image Transport System (FITS), is a data format widely used in</span></div>
<div class="line"><a id="l00033" name="l00033"></a><span class="lineno"> 33</span><span class="comment">* astronomy for data interchange and archive. It is described in</span></div>
<div class="line"><a id="l00034" name="l00034"></a><span class="lineno"> 34</span><span class="comment">*</span></div>
<div class="line"><a id="l00035" name="l00035"></a><span class="lineno"> 35</span><span class="comment">= "Definition of the Flexible Image Transport System (FITS), version 3.0",</span></div>
<div class="line"><a id="l00036" name="l00036"></a><span class="lineno"> 36</span><span class="comment">= Pence, W.D., Chiappetti, L., Page, C.G., Shaw, R.A., & Stobie, E. 2010,</span></div>
<div class="line"><a id="l00037" name="l00037"></a><span class="lineno"> 37</span><span class="comment">= A&A, 524, A42 - http://dx.doi.org/10.1051/0004-6361/201015362</span></div>
<div class="line"><a id="l00038" name="l00038"></a><span class="lineno"> 38</span><span class="comment">*</span></div>
<div class="line"><a id="l00039" name="l00039"></a><span class="lineno"> 39</span><span class="comment">* See also http://fits.gsfc.nasa.gov</span></div>
<div class="line"><a id="l00040" name="l00040"></a><span class="lineno"> 40</span><span class="comment">*</span></div>
<div class="line"><a id="l00041" name="l00041"></a><span class="lineno"> 41</span><span class="comment">* fitshdr() is a generic FITS header parser provided to handle keyrecords that</span></div>
<div class="line"><a id="l00042" name="l00042"></a><span class="lineno"> 42</span><span class="comment">* are ignored by the WCS header parsers, wcspih() and wcsbth(). Typically the</span></div>
<div class="line"><a id="l00043" name="l00043"></a><span class="lineno"> 43</span><span class="comment">* latter may be set to remove WCS keyrecords from a header leaving fitshdr()</span></div>
<div class="line"><a id="l00044" name="l00044"></a><span class="lineno"> 44</span><span class="comment">* to handle the remainder.</span></div>
<div class="line"><a id="l00045" name="l00045"></a><span class="lineno"> 45</span><span class="comment">*</span></div>
<div class="line"><a id="l00046" name="l00046"></a><span class="lineno"> 46</span><span class="comment">*</span></div>
<div class="line"><a id="l00047" name="l00047"></a><span class="lineno"> 47</span><span class="comment">* fitshdr() - FITS header parser routine</span></div>
<div class="line"><a id="l00048" name="l00048"></a><span class="lineno"> 48</span><span class="comment">* --------------------------------------</span></div>
<div class="line"><a id="l00049" name="l00049"></a><span class="lineno"> 49</span><span class="comment">* fitshdr() parses a character array containing a FITS header, extracting</span></div>
<div class="line"><a id="l00050" name="l00050"></a><span class="lineno"> 50</span><span class="comment">* all keywords and their values into an array of fitskey structs.</span></div>
<div class="line"><a id="l00051" name="l00051"></a><span class="lineno"> 51</span><span class="comment">*</span></div>
<div class="line"><a id="l00052" name="l00052"></a><span class="lineno"> 52</span><span class="comment">* Given:</span></div>
<div class="line"><a id="l00053" name="l00053"></a><span class="lineno"> 53</span><span class="comment">* header const char []</span></div>
<div class="line"><a id="l00054" name="l00054"></a><span class="lineno"> 54</span><span class="comment">* Character array containing the (entire) FITS header,</span></div>
<div class="line"><a id="l00055" name="l00055"></a><span class="lineno"> 55</span><span class="comment">* for example, as might be obtained conveniently via the</span></div>
<div class="line"><a id="l00056" name="l00056"></a><span class="lineno"> 56</span><span class="comment">* CFITSIO routine fits_hdr2str().</span></div>
<div class="line"><a id="l00057" name="l00057"></a><span class="lineno"> 57</span><span class="comment">*</span></div>
<div class="line"><a id="l00058" name="l00058"></a><span class="lineno"> 58</span><span class="comment">* Each header "keyrecord" (formerly "card image")</span></div>
<div class="line"><a id="l00059" name="l00059"></a><span class="lineno"> 59</span><span class="comment">* consists of exactly 80 7-bit ASCII printing characters</span></div>
<div class="line"><a id="l00060" name="l00060"></a><span class="lineno"> 60</span><span class="comment">* in the range 0x20 to 0x7e (which excludes NUL, BS,</span></div>
<div class="line"><a id="l00061" name="l00061"></a><span class="lineno"> 61</span><span class="comment">* TAB, LF, FF and CR) especially noting that the</span></div>
<div class="line"><a id="l00062" name="l00062"></a><span class="lineno"> 62</span><span class="comment">* keyrecords are NOT null-terminated.</span></div>
<div class="line"><a id="l00063" name="l00063"></a><span class="lineno"> 63</span><span class="comment">*</span></div>
<div class="line"><a id="l00064" name="l00064"></a><span class="lineno"> 64</span><span class="comment">* nkeyrec int Number of keyrecords in header[].</span></div>
<div class="line"><a id="l00065" name="l00065"></a><span class="lineno"> 65</span><span class="comment">*</span></div>
<div class="line"><a id="l00066" name="l00066"></a><span class="lineno"> 66</span><span class="comment">* nkeyids int Number of entries in keyids[].</span></div>
<div class="line"><a id="l00067" name="l00067"></a><span class="lineno"> 67</span><span class="comment">*</span></div>
<div class="line"><a id="l00068" name="l00068"></a><span class="lineno"> 68</span><span class="comment">* Given and returned:</span></div>
<div class="line"><a id="l00069" name="l00069"></a><span class="lineno"> 69</span><span class="comment">* keyids struct fitskeyid []</span></div>
<div class="line"><a id="l00070" name="l00070"></a><span class="lineno"> 70</span><span class="comment">* While all keywords are extracted from the header,</span></div>
<div class="line"><a id="l00071" name="l00071"></a><span class="lineno"> 71</span><span class="comment">* keyids[] provides a convienient way of indexing them.</span></div>
<div class="line"><a id="l00072" name="l00072"></a><span class="lineno"> 72</span><span class="comment">* The fitskeyid struct contains three members;</span></div>
<div class="line"><a id="l00073" name="l00073"></a><span class="lineno"> 73</span><span class="comment">* fitskeyid::name must be set by the user while</span></div>
<div class="line"><a id="l00074" name="l00074"></a><span class="lineno"> 74</span><span class="comment">* fitskeyid::count and fitskeyid::idx are returned by</span></div>
<div class="line"><a id="l00075" name="l00075"></a><span class="lineno"> 75</span><span class="comment">* fitshdr(). All matched keywords will have their</span></div>
<div class="line"><a id="l00076" name="l00076"></a><span class="lineno"> 76</span><span class="comment">* fitskey::keyno member negated.</span></div>
<div class="line"><a id="l00077" name="l00077"></a><span class="lineno"> 77</span><span class="comment">*</span></div>
<div class="line"><a id="l00078" name="l00078"></a><span class="lineno"> 78</span><span class="comment">* Returned:</span></div>
<div class="line"><a id="l00079" name="l00079"></a><span class="lineno"> 79</span><span class="comment">* nreject int* Number of header keyrecords rejected for syntax</span></div>
<div class="line"><a id="l00080" name="l00080"></a><span class="lineno"> 80</span><span class="comment">* errors.</span></div>
<div class="line"><a id="l00081" name="l00081"></a><span class="lineno"> 81</span><span class="comment">*</span></div>
<div class="line"><a id="l00082" name="l00082"></a><span class="lineno"> 82</span><span class="comment">* keys struct fitskey**</span></div>
<div class="line"><a id="l00083" name="l00083"></a><span class="lineno"> 83</span><span class="comment">* Pointer to an array of nkeyrec fitskey structs</span></div>
<div class="line"><a id="l00084" name="l00084"></a><span class="lineno"> 84</span><span class="comment">* containing all keywords and keyvalues extracted from</span></div>
<div class="line"><a id="l00085" name="l00085"></a><span class="lineno"> 85</span><span class="comment">* the header.</span></div>
<div class="line"><a id="l00086" name="l00086"></a><span class="lineno"> 86</span><span class="comment">*</span></div>
<div class="line"><a id="l00087" name="l00087"></a><span class="lineno"> 87</span><span class="comment">* Memory for the array is allocated by fitshdr() and</span></div>
<div class="line"><a id="l00088" name="l00088"></a><span class="lineno"> 88</span><span class="comment">* this must be freed by the user. See wcsdealloc().</span></div>
<div class="line"><a id="l00089" name="l00089"></a><span class="lineno"> 89</span><span class="comment">*</span></div>
<div class="line"><a id="l00090" name="l00090"></a><span class="lineno"> 90</span><span class="comment">* Function return value:</span></div>
<div class="line"><a id="l00091" name="l00091"></a><span class="lineno"> 91</span><span class="comment">* int Status return value:</span></div>
<div class="line"><a id="l00092" name="l00092"></a><span class="lineno"> 92</span><span class="comment">* 0: Success.</span></div>
<div class="line"><a id="l00093" name="l00093"></a><span class="lineno"> 93</span><span class="comment">* 1: Null fitskey pointer passed.</span></div>
<div class="line"><a id="l00094" name="l00094"></a><span class="lineno"> 94</span><span class="comment">* 2: Memory allocation failed.</span></div>
<div class="line"><a id="l00095" name="l00095"></a><span class="lineno"> 95</span><span class="comment">* 3: Fatal error returned by Flex parser.</span></div>
<div class="line"><a id="l00096" name="l00096"></a><span class="lineno"> 96</span><span class="comment">* 4: Unrecognised data type.</span></div>
<div class="line"><a id="l00097" name="l00097"></a><span class="lineno"> 97</span><span class="comment">*</span></div>
<div class="line"><a id="l00098" name="l00098"></a><span class="lineno"> 98</span><span class="comment">* Notes:</span></div>
<div class="line"><a id="l00099" name="l00099"></a><span class="lineno"> 99</span><span class="comment">* 1: Keyword parsing is done in accordance with the syntax defined by</span></div>
<div class="line"><a id="l00100" name="l00100"></a><span class="lineno"> 100</span><span class="comment">* NOST 100-2.0, noting the following points in particular:</span></div>
<div class="line"><a id="l00101" name="l00101"></a><span class="lineno"> 101</span><span class="comment">*</span></div>
<div class="line"><a id="l00102" name="l00102"></a><span class="lineno"> 102</span><span class="comment">* a: Sect. 5.1.2.1 specifies that keywords be left-justified in columns</span></div>
<div class="line"><a id="l00103" name="l00103"></a><span class="lineno"> 103</span><span class="comment">* 1-8, blank-filled with no embedded spaces, composed only of the</span></div>
<div class="line"><a id="l00104" name="l00104"></a><span class="lineno"> 104</span><span class="comment">* ASCII characters ABCDEFGHJKLMNOPQRSTUVWXYZ0123456789-_</span></div>
<div class="line"><a id="l00105" name="l00105"></a><span class="lineno"> 105</span><span class="comment">*</span></div>
<div class="line"><a id="l00106" name="l00106"></a><span class="lineno"> 106</span><span class="comment">* fitshdr() accepts any characters in columns 1-8 but flags keywords</span></div>
<div class="line"><a id="l00107" name="l00107"></a><span class="lineno"> 107</span><span class="comment">* that do not conform to standard syntax.</span></div>
<div class="line"><a id="l00108" name="l00108"></a><span class="lineno"> 108</span><span class="comment">*</span></div>
<div class="line"><a id="l00109" name="l00109"></a><span class="lineno"> 109</span><span class="comment">* b: Sect. 5.1.2.2 defines the "value indicator" as the characters "= "</span></div>
<div class="line"><a id="l00110" name="l00110"></a><span class="lineno"> 110</span><span class="comment">* occurring in columns 9 and 10. If these are absent then the</span></div>
<div class="line"><a id="l00111" name="l00111"></a><span class="lineno"> 111</span><span class="comment">* keyword has no value and columns 9-80 may contain any ASCII text</span></div>
<div class="line"><a id="l00112" name="l00112"></a><span class="lineno"> 112</span><span class="comment">* (but see note 2 for CONTINUE keyrecords). This is copied to the</span></div>
<div class="line"><a id="l00113" name="l00113"></a><span class="lineno"> 113</span><span class="comment">* comment member of the fitskey struct.</span></div>
<div class="line"><a id="l00114" name="l00114"></a><span class="lineno"> 114</span><span class="comment">*</span></div>
<div class="line"><a id="l00115" name="l00115"></a><span class="lineno"> 115</span><span class="comment">* c: Sect. 5.1.2.3 states that a keyword may have a null (undefined)</span></div>
<div class="line"><a id="l00116" name="l00116"></a><span class="lineno"> 116</span><span class="comment">* value if the value/comment field, columns 11-80, consists entirely</span></div>
<div class="line"><a id="l00117" name="l00117"></a><span class="lineno"> 117</span><span class="comment">* of spaces, possibly followed by a comment.</span></div>
<div class="line"><a id="l00118" name="l00118"></a><span class="lineno"> 118</span><span class="comment">*</span></div>
<div class="line"><a id="l00119" name="l00119"></a><span class="lineno"> 119</span><span class="comment">* d: Sect. 5.1.1 states that trailing blanks in a string keyvalue are</span></div>
<div class="line"><a id="l00120" name="l00120"></a><span class="lineno"> 120</span><span class="comment">* not significant and the parser always removes them. A string</span></div>
<div class="line"><a id="l00121" name="l00121"></a><span class="lineno"> 121</span><span class="comment">* containing nothing but blanks will be replaced with a single</span></div>
<div class="line"><a id="l00122" name="l00122"></a><span class="lineno"> 122</span><span class="comment">* blank.</span></div>
<div class="line"><a id="l00123" name="l00123"></a><span class="lineno"> 123</span><span class="comment">*</span></div>
<div class="line"><a id="l00124" name="l00124"></a><span class="lineno"> 124</span><span class="comment">* Sect. 5.2.1 also states that a quote character (') in a string</span></div>
<div class="line"><a id="l00125" name="l00125"></a><span class="lineno"> 125</span><span class="comment">* value is to be represented by two successive quote characters and</span></div>
<div class="line"><a id="l00126" name="l00126"></a><span class="lineno"> 126</span><span class="comment">* the parser removes the repeated quote.</span></div>
<div class="line"><a id="l00127" name="l00127"></a><span class="lineno"> 127</span><span class="comment">*</span></div>
<div class="line"><a id="l00128" name="l00128"></a><span class="lineno"> 128</span><span class="comment">* e: The parser recognizes free-format character (NOST 100-2.0,</span></div>
<div class="line"><a id="l00129" name="l00129"></a><span class="lineno"> 129</span><span class="comment">* Sect. 5.2.1), integer (Sect. 5.2.3), and floating-point values</span></div>
<div class="line"><a id="l00130" name="l00130"></a><span class="lineno"> 130</span><span class="comment">* (Sect. 5.2.4) for all keywords.</span></div>
<div class="line"><a id="l00131" name="l00131"></a><span class="lineno"> 131</span><span class="comment">*</span></div>
<div class="line"><a id="l00132" name="l00132"></a><span class="lineno"> 132</span><span class="comment">* f: Sect. 5.2.3 offers no comment on the size of an integer keyvalue</span></div>
<div class="line"><a id="l00133" name="l00133"></a><span class="lineno"> 133</span><span class="comment">* except indirectly in limiting it to 70 digits. The parser will</span></div>
<div class="line"><a id="l00134" name="l00134"></a><span class="lineno"> 134</span><span class="comment">* translate an integer keyvalue to a 32-bit signed integer if it</span></div>
<div class="line"><a id="l00135" name="l00135"></a><span class="lineno"> 135</span><span class="comment">* lies in the range -2147483648 to +2147483647, otherwise it</span></div>
<div class="line"><a id="l00136" name="l00136"></a><span class="lineno"> 136</span><span class="comment">* interprets it as a 64-bit signed integer if possible, or else a</span></div>
<div class="line"><a id="l00137" name="l00137"></a><span class="lineno"> 137</span><span class="comment">* "very long" integer (see fitskey::type).</span></div>
<div class="line"><a id="l00138" name="l00138"></a><span class="lineno"> 138</span><span class="comment">*</span></div>
<div class="line"><a id="l00139" name="l00139"></a><span class="lineno"> 139</span><span class="comment">* g: END not followed by 77 blanks is not considered to be a legitimate</span></div>
<div class="line"><a id="l00140" name="l00140"></a><span class="lineno"> 140</span><span class="comment">* end keyrecord.</span></div>
<div class="line"><a id="l00141" name="l00141"></a><span class="lineno"> 141</span><span class="comment">*</span></div>
<div class="line"><a id="l00142" name="l00142"></a><span class="lineno"> 142</span><span class="comment">* 2: The parser supports a generalization of the OGIP Long String Keyvalue</span></div>
<div class="line"><a id="l00143" name="l00143"></a><span class="lineno"> 143</span><span class="comment">* Convention (v1.0) whereby strings may be continued onto successive</span></div>
<div class="line"><a id="l00144" name="l00144"></a><span class="lineno"> 144</span><span class="comment">* header keyrecords. A keyrecord contains a segment of a continued</span></div>
<div class="line"><a id="l00145" name="l00145"></a><span class="lineno"> 145</span><span class="comment">* string if and only if</span></div>
<div class="line"><a id="l00146" name="l00146"></a><span class="lineno"> 146</span><span class="comment">*</span></div>
<div class="line"><a id="l00147" name="l00147"></a><span class="lineno"> 147</span><span class="comment">* a: it contains the pseudo-keyword CONTINUE,</span></div>
<div class="line"><a id="l00148" name="l00148"></a><span class="lineno"> 148</span><span class="comment">*</span></div>
<div class="line"><a id="l00149" name="l00149"></a><span class="lineno"> 149</span><span class="comment">* b: columns 9 and 10 are both blank,</span></div>
<div class="line"><a id="l00150" name="l00150"></a><span class="lineno"> 150</span><span class="comment">*</span></div>
<div class="line"><a id="l00151" name="l00151"></a><span class="lineno"> 151</span><span class="comment">* c: columns 11 to 80 contain what would be considered a valid string</span></div>
<div class="line"><a id="l00152" name="l00152"></a><span class="lineno"> 152</span><span class="comment">* keyvalue, including optional keycomment, if column 9 had contained</span></div>
<div class="line"><a id="l00153" name="l00153"></a><span class="lineno"> 153</span><span class="comment">* '=',</span></div>
<div class="line"><a id="l00154" name="l00154"></a><span class="lineno"> 154</span><span class="comment">*</span></div>
<div class="line"><a id="l00155" name="l00155"></a><span class="lineno"> 155</span><span class="comment">* d: the previous keyrecord contained either a valid string keyvalue or</span></div>
<div class="line"><a id="l00156" name="l00156"></a><span class="lineno"> 156</span><span class="comment">* a valid CONTINUE keyrecord.</span></div>
<div class="line"><a id="l00157" name="l00157"></a><span class="lineno"> 157</span><span class="comment">*</span></div>
<div class="line"><a id="l00158" name="l00158"></a><span class="lineno"> 158</span><span class="comment">* If any of these conditions is violated, the keyrecord is considered in</span></div>
<div class="line"><a id="l00159" name="l00159"></a><span class="lineno"> 159</span><span class="comment">* isolation.</span></div>
<div class="line"><a id="l00160" name="l00160"></a><span class="lineno"> 160</span><span class="comment">*</span></div>
<div class="line"><a id="l00161" name="l00161"></a><span class="lineno"> 161</span><span class="comment">* Syntax errors in keycomments in a continued string are treated more</span></div>
<div class="line"><a id="l00162" name="l00162"></a><span class="lineno"> 162</span><span class="comment">* permissively than usual; the '/' delimiter may be omitted provided that</span></div>
<div class="line"><a id="l00163" name="l00163"></a><span class="lineno"> 163</span><span class="comment">* parsing of the string keyvalue is not compromised. However, the</span></div>
<div class="line"><a id="l00164" name="l00164"></a><span class="lineno"> 164</span><span class="comment">* FITSHDR_COMMENT status bit will be set for the keyrecord (see</span></div>
<div class="line"><a id="l00165" name="l00165"></a><span class="lineno"> 165</span><span class="comment">* fitskey::status).</span></div>
<div class="line"><a id="l00166" name="l00166"></a><span class="lineno"> 166</span><span class="comment">*</span></div>
<div class="line"><a id="l00167" name="l00167"></a><span class="lineno"> 167</span><span class="comment">* As for normal strings, trailing blanks in a continued string are not</span></div>
<div class="line"><a id="l00168" name="l00168"></a><span class="lineno"> 168</span><span class="comment">* significant.</span></div>
<div class="line"><a id="l00169" name="l00169"></a><span class="lineno"> 169</span><span class="comment">*</span></div>
<div class="line"><a id="l00170" name="l00170"></a><span class="lineno"> 170</span><span class="comment">* In the OGIP convention "the '&' character is used as the last non-blank</span></div>
<div class="line"><a id="l00171" name="l00171"></a><span class="lineno"> 171</span><span class="comment">* character of the string to indicate that the string is (probably)</span></div>
<div class="line"><a id="l00172" name="l00172"></a><span class="lineno"> 172</span><span class="comment">* continued on the following keyword". This additional syntax is not</span></div>
<div class="line"><a id="l00173" name="l00173"></a><span class="lineno"> 173</span><span class="comment">* required by fitshdr(), but if '&' does occur as the last non-blank</span></div>
<div class="line"><a id="l00174" name="l00174"></a><span class="lineno"> 174</span><span class="comment">* character of a continued string keyvalue then it will be removed, along</span></div>
<div class="line"><a id="l00175" name="l00175"></a><span class="lineno"> 175</span><span class="comment">* with any trailing blanks. However, blanks that occur before the '&'</span></div>
<div class="line"><a id="l00176" name="l00176"></a><span class="lineno"> 176</span><span class="comment">* will be preserved.</span></div>
<div class="line"><a id="l00177" name="l00177"></a><span class="lineno"> 177</span><span class="comment">*</span></div>
<div class="line"><a id="l00178" name="l00178"></a><span class="lineno"> 178</span><span class="comment">*</span></div>
<div class="line"><a id="l00179" name="l00179"></a><span class="lineno"> 179</span><span class="comment">* fitskeyid struct - Keyword indexing</span></div>
<div class="line"><a id="l00180" name="l00180"></a><span class="lineno"> 180</span><span class="comment">* -----------------------------------</span></div>
<div class="line"><a id="l00181" name="l00181"></a><span class="lineno"> 181</span><span class="comment">* fitshdr() uses the fitskeyid struct to return indexing information for</span></div>
<div class="line"><a id="l00182" name="l00182"></a><span class="lineno"> 182</span><span class="comment">* specified keywords. The struct contains three members, the first of which,</span></div>
<div class="line"><a id="l00183" name="l00183"></a><span class="lineno"> 183</span><span class="comment">* fitskeyid::name, must be set by the user with the remainder returned by</span></div>
<div class="line"><a id="l00184" name="l00184"></a><span class="lineno"> 184</span><span class="comment">* fitshdr().</span></div>
<div class="line"><a id="l00185" name="l00185"></a><span class="lineno"> 185</span><span class="comment">*</span></div>
<div class="line"><a id="l00186" name="l00186"></a><span class="lineno"> 186</span><span class="comment">* char name[12]:</span></div>
<div class="line"><a id="l00187" name="l00187"></a><span class="lineno"> 187</span><span class="comment">* (Given) Name of the required keyword. This is to be set by the user;</span></div>
<div class="line"><a id="l00188" name="l00188"></a><span class="lineno"> 188</span><span class="comment">* the '.' character may be used for wildcarding. Trailing blanks will be</span></div>
<div class="line"><a id="l00189" name="l00189"></a><span class="lineno"> 189</span><span class="comment">* replaced with nulls.</span></div>
<div class="line"><a id="l00190" name="l00190"></a><span class="lineno"> 190</span><span class="comment">*</span></div>
<div class="line"><a id="l00191" name="l00191"></a><span class="lineno"> 191</span><span class="comment">* int count:</span></div>
<div class="line"><a id="l00192" name="l00192"></a><span class="lineno"> 192</span><span class="comment">* (Returned) The number of matches found for the keyword.</span></div>
<div class="line"><a id="l00193" name="l00193"></a><span class="lineno"> 193</span><span class="comment">*</span></div>
<div class="line"><a id="l00194" name="l00194"></a><span class="lineno"> 194</span><span class="comment">* int idx[2]:</span></div>
<div class="line"><a id="l00195" name="l00195"></a><span class="lineno"> 195</span><span class="comment">* (Returned) Indices into keys[], the array of fitskey structs returned by</span></div>
<div class="line"><a id="l00196" name="l00196"></a><span class="lineno"> 196</span><span class="comment">* fitshdr(). Note that these are 0-relative array indices, not keyrecord</span></div>
<div class="line"><a id="l00197" name="l00197"></a><span class="lineno"> 197</span><span class="comment">* numbers.</span></div>
<div class="line"><a id="l00198" name="l00198"></a><span class="lineno"> 198</span><span class="comment">*</span></div>
<div class="line"><a id="l00199" name="l00199"></a><span class="lineno"> 199</span><span class="comment">* If the keyword is found in the header the first index will be set to the</span></div>
<div class="line"><a id="l00200" name="l00200"></a><span class="lineno"> 200</span><span class="comment">* array index of its first occurrence, otherwise it will be set to -1.</span></div>
<div class="line"><a id="l00201" name="l00201"></a><span class="lineno"> 201</span><span class="comment">*</span></div>
<div class="line"><a id="l00202" name="l00202"></a><span class="lineno"> 202</span><span class="comment">* If multiples of the keyword are found, the second index will be set to</span></div>
<div class="line"><a id="l00203" name="l00203"></a><span class="lineno"> 203</span><span class="comment">* the array index of its last occurrence, otherwise it will be set to -1.</span></div>
<div class="line"><a id="l00204" name="l00204"></a><span class="lineno"> 204</span><span class="comment">*</span></div>
<div class="line"><a id="l00205" name="l00205"></a><span class="lineno"> 205</span><span class="comment">*</span></div>
<div class="line"><a id="l00206" name="l00206"></a><span class="lineno"> 206</span><span class="comment">* fitskey struct - Keyword/value information</span></div>
<div class="line"><a id="l00207" name="l00207"></a><span class="lineno"> 207</span><span class="comment">* ------------------------------------------</span></div>
<div class="line"><a id="l00208" name="l00208"></a><span class="lineno"> 208</span><span class="comment">* fitshdr() returns an array of fitskey structs, each of which contains the</span></div>
<div class="line"><a id="l00209" name="l00209"></a><span class="lineno"> 209</span><span class="comment">* result of parsing one FITS header keyrecord. All members of the fitskey</span></div>
<div class="line"><a id="l00210" name="l00210"></a><span class="lineno"> 210</span><span class="comment">* struct are returned by fitshdr(), none are given by the user.</span></div>
<div class="line"><a id="l00211" name="l00211"></a><span class="lineno"> 211</span><span class="comment">*</span></div>
<div class="line"><a id="l00212" name="l00212"></a><span class="lineno"> 212</span><span class="comment">* int keyno</span></div>
<div class="line"><a id="l00213" name="l00213"></a><span class="lineno"> 213</span><span class="comment">* (Returned) Keyrecord number (1-relative) in the array passed as input to</span></div>
<div class="line"><a id="l00214" name="l00214"></a><span class="lineno"> 214</span><span class="comment">* fitshdr(). This will be negated if the keyword matched any specified in</span></div>
<div class="line"><a id="l00215" name="l00215"></a><span class="lineno"> 215</span><span class="comment">* the keyids[] index.</span></div>
<div class="line"><a id="l00216" name="l00216"></a><span class="lineno"> 216</span><span class="comment">*</span></div>
<div class="line"><a id="l00217" name="l00217"></a><span class="lineno"> 217</span><span class="comment">* int keyid</span></div>
<div class="line"><a id="l00218" name="l00218"></a><span class="lineno"> 218</span><span class="comment">* (Returned) Index into the first entry in keyids[] with which the</span></div>
<div class="line"><a id="l00219" name="l00219"></a><span class="lineno"> 219</span><span class="comment">* keyrecord matches, else -1.</span></div>
<div class="line"><a id="l00220" name="l00220"></a><span class="lineno"> 220</span><span class="comment">*</span></div>
<div class="line"><a id="l00221" name="l00221"></a><span class="lineno"> 221</span><span class="comment">* int status</span></div>
<div class="line"><a id="l00222" name="l00222"></a><span class="lineno"> 222</span><span class="comment">* (Returned) Status flag bit-vector for the header keyrecord employing the</span></div>
<div class="line"><a id="l00223" name="l00223"></a><span class="lineno"> 223</span><span class="comment">* following bit masks defined as preprocessor macros:</span></div>
<div class="line"><a id="l00224" name="l00224"></a><span class="lineno"> 224</span><span class="comment">*</span></div>
<div class="line"><a id="l00225" name="l00225"></a><span class="lineno"> 225</span><span class="comment">* - FITSHDR_KEYWORD: Illegal keyword syntax.</span></div>
<div class="line"><a id="l00226" name="l00226"></a><span class="lineno"> 226</span><span class="comment">* - FITSHDR_KEYVALUE: Illegal keyvalue syntax.</span></div>
<div class="line"><a id="l00227" name="l00227"></a><span class="lineno"> 227</span><span class="comment">* - FITSHDR_COMMENT: Illegal keycomment syntax.</span></div>
<div class="line"><a id="l00228" name="l00228"></a><span class="lineno"> 228</span><span class="comment">* - FITSHDR_KEYREC: Illegal keyrecord, e.g. an END keyrecord with</span></div>
<div class="line"><a id="l00229" name="l00229"></a><span class="lineno"> 229</span><span class="comment">* trailing text.</span></div>
<div class="line"><a id="l00230" name="l00230"></a><span class="lineno"> 230</span><span class="comment">* - FITSHDR_TRAILER: Keyrecord following a valid END keyrecord.</span></div>
<div class="line"><a id="l00231" name="l00231"></a><span class="lineno"> 231</span><span class="comment">*</span></div>
<div class="line"><a id="l00232" name="l00232"></a><span class="lineno"> 232</span><span class="comment">* The header keyrecord is syntactically correct if no bits are set.</span></div>
<div class="line"><a id="l00233" name="l00233"></a><span class="lineno"> 233</span><span class="comment">*</span></div>
<div class="line"><a id="l00234" name="l00234"></a><span class="lineno"> 234</span><span class="comment">* char keyword[12]</span></div>
<div class="line"><a id="l00235" name="l00235"></a><span class="lineno"> 235</span><span class="comment">* (Returned) Keyword name, null-filled for keywords of less than eight</span></div>
<div class="line"><a id="l00236" name="l00236"></a><span class="lineno"> 236</span><span class="comment">* characters (trailing blanks replaced by nulls).</span></div>
<div class="line"><a id="l00237" name="l00237"></a><span class="lineno"> 237</span><span class="comment">*</span></div>
<div class="line"><a id="l00238" name="l00238"></a><span class="lineno"> 238</span><span class="comment">* Use</span></div>
<div class="line"><a id="l00239" name="l00239"></a><span class="lineno"> 239</span><span class="comment">*</span></div>
<div class="line"><a id="l00240" name="l00240"></a><span class="lineno"> 240</span><span class="comment">= sprintf(dst, "%.8s", keyword)</span></div>
<div class="line"><a id="l00241" name="l00241"></a><span class="lineno"> 241</span><span class="comment">*</span></div>
<div class="line"><a id="l00242" name="l00242"></a><span class="lineno"> 242</span><span class="comment">* to copy it to a character array with null-termination, or</span></div>
<div class="line"><a id="l00243" name="l00243"></a><span class="lineno"> 243</span><span class="comment">*</span></div>
<div class="line"><a id="l00244" name="l00244"></a><span class="lineno"> 244</span><span class="comment">= sprintf(dst, "%8.8s", keyword)</span></div>
<div class="line"><a id="l00245" name="l00245"></a><span class="lineno"> 245</span><span class="comment">*</span></div>
<div class="line"><a id="l00246" name="l00246"></a><span class="lineno"> 246</span><span class="comment">* to blank-fill to eight characters followed by null-termination.</span></div>
<div class="line"><a id="l00247" name="l00247"></a><span class="lineno"> 247</span><span class="comment">*</span></div>
<div class="line"><a id="l00248" name="l00248"></a><span class="lineno"> 248</span><span class="comment">* int type</span></div>
<div class="line"><a id="l00249" name="l00249"></a><span class="lineno"> 249</span><span class="comment">* (Returned) Keyvalue data type:</span></div>
<div class="line"><a id="l00250" name="l00250"></a><span class="lineno"> 250</span><span class="comment">* - 0: No keyvalue (both the value and type are undefined).</span></div>
<div class="line"><a id="l00251" name="l00251"></a><span class="lineno"> 251</span><span class="comment">* - 1: Logical, represented as int.</span></div>
<div class="line"><a id="l00252" name="l00252"></a><span class="lineno"> 252</span><span class="comment">* - 2: 32-bit signed integer.</span></div>
<div class="line"><a id="l00253" name="l00253"></a><span class="lineno"> 253</span><span class="comment">* - 3: 64-bit signed integer (see below).</span></div>
<div class="line"><a id="l00254" name="l00254"></a><span class="lineno"> 254</span><span class="comment">* - 4: Very long integer (see below).</span></div>
<div class="line"><a id="l00255" name="l00255"></a><span class="lineno"> 255</span><span class="comment">* - 5: Floating point (stored as double).</span></div>
<div class="line"><a id="l00256" name="l00256"></a><span class="lineno"> 256</span><span class="comment">* - 6: Integer complex (stored as double[2]).</span></div>
<div class="line"><a id="l00257" name="l00257"></a><span class="lineno"> 257</span><span class="comment">* - 7: Floating point complex (stored as double[2]).</span></div>
<div class="line"><a id="l00258" name="l00258"></a><span class="lineno"> 258</span><span class="comment">* - 8: String.</span></div>
<div class="line"><a id="l00259" name="l00259"></a><span class="lineno"> 259</span><span class="comment">* - 8+10*n: Continued string (described below and in fitshdr() note 2).</span></div>
<div class="line"><a id="l00260" name="l00260"></a><span class="lineno"> 260</span><span class="comment">*</span></div>
<div class="line"><a id="l00261" name="l00261"></a><span class="lineno"> 261</span><span class="comment">* A negative type indicates that a syntax error was encountered when</span></div>
<div class="line"><a id="l00262" name="l00262"></a><span class="lineno"> 262</span><span class="comment">* attempting to parse a keyvalue of the particular type.</span></div>
<div class="line"><a id="l00263" name="l00263"></a><span class="lineno"> 263</span><span class="comment">*</span></div>
<div class="line"><a id="l00264" name="l00264"></a><span class="lineno"> 264</span><span class="comment">* Comments on particular data types:</span></div>
<div class="line"><a id="l00265" name="l00265"></a><span class="lineno"> 265</span><span class="comment">* - 64-bit signed integers lie in the range</span></div>
<div class="line"><a id="l00266" name="l00266"></a><span class="lineno"> 266</span><span class="comment">*</span></div>
<div class="line"><a id="l00267" name="l00267"></a><span class="lineno"> 267</span><span class="comment">= (-9223372036854775808 <= int64 < -2147483648) ||</span></div>
<div class="line"><a id="l00268" name="l00268"></a><span class="lineno"> 268</span><span class="comment">= (+2147483647 < int64 <= +9223372036854775807)</span></div>
<div class="line"><a id="l00269" name="l00269"></a><span class="lineno"> 269</span><span class="comment">*</span></div>
<div class="line"><a id="l00270" name="l00270"></a><span class="lineno"> 270</span><span class="comment">* A native 64-bit data type may be defined via preprocessor macro</span></div>
<div class="line"><a id="l00271" name="l00271"></a><span class="lineno"> 271</span><span class="comment">* WCSLIB_INT64 defined in wcsconfig.h, e.g. as 'long long int'; this</span></div>
<div class="line"><a id="l00272" name="l00272"></a><span class="lineno"> 272</span><span class="comment">* will be typedef'd to 'int64' here. If WCSLIB_INT64 is not set, then</span></div>
<div class="line"><a id="l00273" name="l00273"></a><span class="lineno"> 273</span><span class="comment">* int64 is typedef'd to int[3] instead and fitskey::keyvalue is to be</span></div>
<div class="line"><a id="l00274" name="l00274"></a><span class="lineno"> 274</span><span class="comment">* computed as</span></div>
<div class="line"><a id="l00275" name="l00275"></a><span class="lineno"> 275</span><span class="comment">*</span></div>
<div class="line"><a id="l00276" name="l00276"></a><span class="lineno"> 276</span><span class="comment">= ((keyvalue.k[2]) * 1000000000 +</span></div>
<div class="line"><a id="l00277" name="l00277"></a><span class="lineno"> 277</span><span class="comment">= keyvalue.k[1]) * 1000000000 +</span></div>
<div class="line"><a id="l00278" name="l00278"></a><span class="lineno"> 278</span><span class="comment">= keyvalue.k[0]</span></div>
<div class="line"><a id="l00279" name="l00279"></a><span class="lineno"> 279</span><span class="comment">*</span></div>
<div class="line"><a id="l00280" name="l00280"></a><span class="lineno"> 280</span><span class="comment">* and may reported via</span></div>
<div class="line"><a id="l00281" name="l00281"></a><span class="lineno"> 281</span><span class="comment">*</span></div>
<div class="line"><a id="l00282" name="l00282"></a><span class="lineno"> 282</span><span class="comment">= if (keyvalue.k[2]) {</span></div>
<div class="line"><a id="l00283" name="l00283"></a><span class="lineno"> 283</span><span class="comment">= printf("%d%09d%09d", keyvalue.k[2], abs(keyvalue.k[1]),</span></div>
<div class="line"><a id="l00284" name="l00284"></a><span class="lineno"> 284</span><span class="comment">= abs(keyvalue.k[0]));</span></div>
<div class="line"><a id="l00285" name="l00285"></a><span class="lineno"> 285</span><span class="comment">= } else {</span></div>
<div class="line"><a id="l00286" name="l00286"></a><span class="lineno"> 286</span><span class="comment">= printf("%d%09d", keyvalue.k[1], abs(keyvalue.k[0]));</span></div>
<div class="line"><a id="l00287" name="l00287"></a><span class="lineno"> 287</span><span class="comment">= }</span></div>
<div class="line"><a id="l00288" name="l00288"></a><span class="lineno"> 288</span><span class="comment">*</span></div>
<div class="line"><a id="l00289" name="l00289"></a><span class="lineno"> 289</span><span class="comment">* where keyvalue.k[0] and keyvalue.k[1] range from -999999999 to</span></div>
<div class="line"><a id="l00290" name="l00290"></a><span class="lineno"> 290</span><span class="comment">* +999999999.</span></div>
<div class="line"><a id="l00291" name="l00291"></a><span class="lineno"> 291</span><span class="comment">*</span></div>
<div class="line"><a id="l00292" name="l00292"></a><span class="lineno"> 292</span><span class="comment">* - Very long integers, up to 70 decimal digits in length, are encoded</span></div>
<div class="line"><a id="l00293" name="l00293"></a><span class="lineno"> 293</span><span class="comment">* in keyvalue.l as an array of int[8], each of which stores 9 decimal</span></div>
<div class="line"><a id="l00294" name="l00294"></a><span class="lineno"> 294</span><span class="comment">* digits. fitskey::keyvalue is to be computed as</span></div>
<div class="line"><a id="l00295" name="l00295"></a><span class="lineno"> 295</span><span class="comment">*</span></div>
<div class="line"><a id="l00296" name="l00296"></a><span class="lineno"> 296</span><span class="comment">= (((((((keyvalue.l[7]) * 1000000000 +</span></div>
<div class="line"><a id="l00297" name="l00297"></a><span class="lineno"> 297</span><span class="comment">= keyvalue.l[6]) * 1000000000 +</span></div>
<div class="line"><a id="l00298" name="l00298"></a><span class="lineno"> 298</span><span class="comment">= keyvalue.l[5]) * 1000000000 +</span></div>
<div class="line"><a id="l00299" name="l00299"></a><span class="lineno"> 299</span><span class="comment">= keyvalue.l[4]) * 1000000000 +</span></div>
<div class="line"><a id="l00300" name="l00300"></a><span class="lineno"> 300</span><span class="comment">= keyvalue.l[3]) * 1000000000 +</span></div>
<div class="line"><a id="l00301" name="l00301"></a><span class="lineno"> 301</span><span class="comment">= keyvalue.l[2]) * 1000000000 +</span></div>
<div class="line"><a id="l00302" name="l00302"></a><span class="lineno"> 302</span><span class="comment">= keyvalue.l[1]) * 1000000000 +</span></div>
<div class="line"><a id="l00303" name="l00303"></a><span class="lineno"> 303</span><span class="comment">= keyvalue.l[0]</span></div>
<div class="line"><a id="l00304" name="l00304"></a><span class="lineno"> 304</span><span class="comment">*</span></div>
<div class="line"><a id="l00305" name="l00305"></a><span class="lineno"> 305</span><span class="comment">* - Continued strings are not reconstructed, they remain split over</span></div>
<div class="line"><a id="l00306" name="l00306"></a><span class="lineno"> 306</span><span class="comment">* successive fitskey structs in the keys[] array returned by</span></div>
<div class="line"><a id="l00307" name="l00307"></a><span class="lineno"> 307</span><span class="comment">* fitshdr(). fitskey::keyvalue data type, 8 + 10n, indicates the</span></div>
<div class="line"><a id="l00308" name="l00308"></a><span class="lineno"> 308</span><span class="comment">* segment number, n, in the continuation.</span></div>
<div class="line"><a id="l00309" name="l00309"></a><span class="lineno"> 309</span><span class="comment">*</span></div>
<div class="line"><a id="l00310" name="l00310"></a><span class="lineno"> 310</span><span class="comment">* int padding</span></div>
<div class="line"><a id="l00311" name="l00311"></a><span class="lineno"> 311</span><span class="comment">* (An unused variable inserted for alignment purposes only.)</span></div>
<div class="line"><a id="l00312" name="l00312"></a><span class="lineno"> 312</span><span class="comment">*</span></div>
<div class="line"><a id="l00313" name="l00313"></a><span class="lineno"> 313</span><span class="comment">* union keyvalue</span></div>
<div class="line"><a id="l00314" name="l00314"></a><span class="lineno"> 314</span><span class="comment">* (Returned) A union comprised of</span></div>
<div class="line"><a id="l00315" name="l00315"></a><span class="lineno"> 315</span><span class="comment">*</span></div>
<div class="line"><a id="l00316" name="l00316"></a><span class="lineno"> 316</span><span class="comment">* - fitskey::i,</span></div>
<div class="line"><a id="l00317" name="l00317"></a><span class="lineno"> 317</span><span class="comment">* - fitskey::k,</span></div>
<div class="line"><a id="l00318" name="l00318"></a><span class="lineno"> 318</span><span class="comment">* - fitskey::l,</span></div>
<div class="line"><a id="l00319" name="l00319"></a><span class="lineno"> 319</span><span class="comment">* - fitskey::f,</span></div>
<div class="line"><a id="l00320" name="l00320"></a><span class="lineno"> 320</span><span class="comment">* - fitskey::c,</span></div>
<div class="line"><a id="l00321" name="l00321"></a><span class="lineno"> 321</span><span class="comment">* - fitskey::s,</span></div>
<div class="line"><a id="l00322" name="l00322"></a><span class="lineno"> 322</span><span class="comment">*</span></div>
<div class="line"><a id="l00323" name="l00323"></a><span class="lineno"> 323</span><span class="comment">* used by the fitskey struct to contain the value associated with a</span></div>
<div class="line"><a id="l00324" name="l00324"></a><span class="lineno"> 324</span><span class="comment">* keyword.</span></div>
<div class="line"><a id="l00325" name="l00325"></a><span class="lineno"> 325</span><span class="comment">*</span></div>
<div class="line"><a id="l00326" name="l00326"></a><span class="lineno"> 326</span><span class="comment">* int i</span></div>
<div class="line"><a id="l00327" name="l00327"></a><span class="lineno"> 327</span><span class="comment">* (Returned) Logical (fitskey::type == 1) and 32-bit signed integer</span></div>
<div class="line"><a id="l00328" name="l00328"></a><span class="lineno"> 328</span><span class="comment">* (fitskey::type == 2) data types in the fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00329" name="l00329"></a><span class="lineno"> 329</span><span class="comment">*</span></div>
<div class="line"><a id="l00330" name="l00330"></a><span class="lineno"> 330</span><span class="comment">* int64 k</span></div>
<div class="line"><a id="l00331" name="l00331"></a><span class="lineno"> 331</span><span class="comment">* (Returned) 64-bit signed integer (fitskey::type == 3) data type in the</span></div>
<div class="line"><a id="l00332" name="l00332"></a><span class="lineno"> 332</span><span class="comment">* fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00333" name="l00333"></a><span class="lineno"> 333</span><span class="comment">*</span></div>
<div class="line"><a id="l00334" name="l00334"></a><span class="lineno"> 334</span><span class="comment">* int l[8]</span></div>
<div class="line"><a id="l00335" name="l00335"></a><span class="lineno"> 335</span><span class="comment">* (Returned) Very long integer (fitskey::type == 4) data type in the</span></div>
<div class="line"><a id="l00336" name="l00336"></a><span class="lineno"> 336</span><span class="comment">* fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00337" name="l00337"></a><span class="lineno"> 337</span><span class="comment">*</span></div>
<div class="line"><a id="l00338" name="l00338"></a><span class="lineno"> 338</span><span class="comment">* double f</span></div>
<div class="line"><a id="l00339" name="l00339"></a><span class="lineno"> 339</span><span class="comment">* (Returned) Floating point (fitskey::type == 5) data type in the</span></div>
<div class="line"><a id="l00340" name="l00340"></a><span class="lineno"> 340</span><span class="comment">* fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00341" name="l00341"></a><span class="lineno"> 341</span><span class="comment">*</span></div>
<div class="line"><a id="l00342" name="l00342"></a><span class="lineno"> 342</span><span class="comment">* double c[2]</span></div>
<div class="line"><a id="l00343" name="l00343"></a><span class="lineno"> 343</span><span class="comment">* (Returned) Integer and floating point complex (fitskey::type == 6 || 7)</span></div>
<div class="line"><a id="l00344" name="l00344"></a><span class="lineno"> 344</span><span class="comment">* data types in the fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00345" name="l00345"></a><span class="lineno"> 345</span><span class="comment">*</span></div>
<div class="line"><a id="l00346" name="l00346"></a><span class="lineno"> 346</span><span class="comment">* char s[72]</span></div>
<div class="line"><a id="l00347" name="l00347"></a><span class="lineno"> 347</span><span class="comment">* (Returned) Null-terminated string (fitskey::type == 8) data type in the</span></div>
<div class="line"><a id="l00348" name="l00348"></a><span class="lineno"> 348</span><span class="comment">* fitskey::keyvalue union.</span></div>
<div class="line"><a id="l00349" name="l00349"></a><span class="lineno"> 349</span><span class="comment">*</span></div>
<div class="line"><a id="l00350" name="l00350"></a><span class="lineno"> 350</span><span class="comment">* int ulen</span></div>
<div class="line"><a id="l00351" name="l00351"></a><span class="lineno"> 351</span><span class="comment">* (Returned) Where a keycomment contains a units string in the standard</span></div>
<div class="line"><a id="l00352" name="l00352"></a><span class="lineno"> 352</span><span class="comment">* form, e.g. [m/s], the ulen member indicates its length, inclusive of</span></div>
<div class="line"><a id="l00353" name="l00353"></a><span class="lineno"> 353</span><span class="comment">* square brackets. Otherwise ulen is zero.</span></div>
<div class="line"><a id="l00354" name="l00354"></a><span class="lineno"> 354</span><span class="comment">*</span></div>
<div class="line"><a id="l00355" name="l00355"></a><span class="lineno"> 355</span><span class="comment">* char comment[84]</span></div>
<div class="line"><a id="l00356" name="l00356"></a><span class="lineno"> 356</span><span class="comment">* (Returned) Keycomment, i.e. comment associated with the keyword or, for</span></div>
<div class="line"><a id="l00357" name="l00357"></a><span class="lineno"> 357</span><span class="comment">* keyrecords rejected because of syntax errors, the compete keyrecord</span></div>
<div class="line"><a id="l00358" name="l00358"></a><span class="lineno"> 358</span><span class="comment">* itself with null-termination.</span></div>
<div class="line"><a id="l00359" name="l00359"></a><span class="lineno"> 359</span><span class="comment">*</span></div>
<div class="line"><a id="l00360" name="l00360"></a><span class="lineno"> 360</span><span class="comment">* Comments are null-terminated with trailing spaces removed. Leading</span></div>
<div class="line"><a id="l00361" name="l00361"></a><span class="lineno"> 361</span><span class="comment">* spaces are also removed from keycomments (i.e. those immediately</span></div>
<div class="line"><a id="l00362" name="l00362"></a><span class="lineno"> 362</span><span class="comment">* following the '/' character), but not from COMMENT or HISTORY keyrecords</span></div>
<div class="line"><a id="l00363" name="l00363"></a><span class="lineno"> 363</span><span class="comment">* or keyrecords without a value indicator ("= " in columns 9-80).</span></div>
<div class="line"><a id="l00364" name="l00364"></a><span class="lineno"> 364</span><span class="comment">*</span></div>
<div class="line"><a id="l00365" name="l00365"></a><span class="lineno"> 365</span><span class="comment">*</span></div>
<div class="line"><a id="l00366" name="l00366"></a><span class="lineno"> 366</span><span class="comment">* Global variable: const char *fitshdr_errmsg[] - Status return messages</span></div>
<div class="line"><a id="l00367" name="l00367"></a><span class="lineno"> 367</span><span class="comment">* ----------------------------------------------------------------------</span></div>
<div class="line"><a id="l00368" name="l00368"></a><span class="lineno"> 368</span><span class="comment">* Error messages to match the status value returned from each function.</span></div>
<div class="line"><a id="l00369" name="l00369"></a><span class="lineno"> 369</span><span class="comment">*</span></div>
<div class="line"><a id="l00370" name="l00370"></a><span class="lineno"> 370</span><span class="comment">*===========================================================================*/</span></div>
<div class="line"><a id="l00371" name="l00371"></a><span class="lineno"> 371</span> </div>
<div class="line"><a id="l00372" name="l00372"></a><span class="lineno"> 372</span><span class="preprocessor">#ifndef WCSLIB_FITSHDR</span></div>
<div class="line"><a id="l00373" name="l00373"></a><span class="lineno"> 373</span><span class="preprocessor">#define WCSLIB_FITSHDR</span></div>
<div class="line"><a id="l00374" name="l00374"></a><span class="lineno"> 374</span> </div>
<div class="line"><a id="l00375" name="l00375"></a><span class="lineno"> 375</span><span class="preprocessor">#include "wcsconfig.h"</span></div>
<div class="line"><a id="l00376" name="l00376"></a><span class="lineno"> 376</span> </div>
<div class="line"><a id="l00377" name="l00377"></a><span class="lineno"> 377</span><span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a id="l00378" name="l00378"></a><span class="lineno"> 378</span><span class="keyword">extern</span> <span class="stringliteral">"C"</span> {</div>
<div class="line"><a id="l00379" name="l00379"></a><span class="lineno"> 379</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00380" name="l00380"></a><span class="lineno"> 380</span> </div>
<div class="line"><a id="l00381" name="l00381"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a42bdf2e2f36d1dee9e06732c75a8ff89"> 381</a></span><span class="preprocessor">#define FITSHDR_KEYWORD 0x01</span></div>
<div class="line"><a id="l00382" name="l00382"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a5077485c3de4b7bca55698eb66110a76"> 382</a></span><span class="preprocessor">#define FITSHDR_KEYVALUE 0x02</span></div>
<div class="line"><a id="l00383" name="l00383"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a6400ad537ecfd565fb39a574831edf41"> 383</a></span><span class="preprocessor">#define FITSHDR_COMMENT 0x04</span></div>
<div class="line"><a id="l00384" name="l00384"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a9361fbafbbbba777da623fc3b9e96d2e"> 384</a></span><span class="preprocessor">#define FITSHDR_KEYREC 0x08</span></div>
<div class="line"><a id="l00385" name="l00385"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a705c7c2c9700367e0e8b82d5033e6fa3"> 385</a></span><span class="preprocessor">#define FITSHDR_CARD 0x08 </span><span class="comment">// Alias for backwards compatibility.</span></div>
<div class="line"><a id="l00386" name="l00386"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a8393f26f643097bb78326a85b4e2e7a4"> 386</a></span><span class="preprocessor">#define FITSHDR_TRAILER 0x10</span></div>
<div class="line"><a id="l00387" name="l00387"></a><span class="lineno"> 387</span> </div>
<div class="line"><a id="l00388" name="l00388"></a><span class="lineno"> 388</span> </div>
<div class="line"><a id="l00389" name="l00389"></a><span class="lineno"> 389</span><span class="keyword">extern</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code hl_variable" href="fitshdr_8h.html#ad966ed3fefd26c9546ec078171e3940b">fitshdr_errmsg</a>[];</div>
<div class="line"><a id="l00390" name="l00390"></a><span class="lineno"> 390</span> </div>
<div class="foldopen" id="foldopen00391" data-start="{" data-end="};">
<div class="line"><a id="l00391" name="l00391"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412"> 391</a></span><span class="keyword">enum</span> <a class="code hl_enumeration" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412">fitshdr_errmsg_enum</a> {</div>
<div class="line"><a id="l00392" name="l00392"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a8f88dbd41c3e1e65e4953e5fc6f2cb51"> 392</a></span> <a class="code hl_enumvalue" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a8f88dbd41c3e1e65e4953e5fc6f2cb51">FITSHDRERR_SUCCESS</a> = 0, <span class="comment">// Success.</span></div>
<div class="line"><a id="l00393" name="l00393"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a63a6fb5e1687601e9b4f2788260bbf46"> 393</a></span> <a class="code hl_enumvalue" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a63a6fb5e1687601e9b4f2788260bbf46">FITSHDRERR_NULL_POINTER</a> = 1, <span class="comment">// Null fitskey pointer passed.</span></div>
<div class="line"><a id="l00394" name="l00394"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412ab423fa4f6030c2480b8ed78088318bbe"> 394</a></span> <a class="code hl_enumvalue" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412ab423fa4f6030c2480b8ed78088318bbe">FITSHDRERR_MEMORY</a> = 2, <span class="comment">// Memory allocation failed.</span></div>
<div class="line"><a id="l00395" name="l00395"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a303803fdbecabde6bc9bb607cb284242"> 395</a></span> <a class="code hl_enumvalue" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a303803fdbecabde6bc9bb607cb284242">FITSHDRERR_FLEX_PARSER</a> = 3, <span class="comment">// Fatal error returned by Flex parser.</span></div>
<div class="line"><a id="l00396" name="l00396"></a><span class="lineno"> 396</span> <a class="code hl_enumvalue" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a9904089dd772386251e46f4a1f118b0f">FITSHDRERR_DATA_TYPE</a> = 4 <span class="comment">// Unrecognised data type.</span></div>
<div class="line"><a id="l00397" name="l00397"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a9904089dd772386251e46f4a1f118b0f"> 397</a></span>};</div>
</div>
<div class="line"><a id="l00398" name="l00398"></a><span class="lineno"> 398</span> </div>
<div class="line"><a id="l00399" name="l00399"></a><span class="lineno"> 399</span><span class="preprocessor">#ifdef WCSLIB_INT64</span></div>
<div class="line"><a id="l00400" name="l00400"></a><span class="lineno"> 400</span> <span class="keyword">typedef</span> WCSLIB_INT64 <a class="code hl_typedef" href="fitshdr_8h.html#a88ab82d73e5c2607f0a40af8917fffe1">int64</a>;</div>
<div class="line"><a id="l00401" name="l00401"></a><span class="lineno"> 401</span><span class="preprocessor">#else</span></div>
<div class="line"><a id="l00402" name="l00402"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a88ab82d73e5c2607f0a40af8917fffe1"> 402</a></span> <span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code hl_typedef" href="fitshdr_8h.html#a88ab82d73e5c2607f0a40af8917fffe1">int64</a>[3];</div>
<div class="line"><a id="l00403" name="l00403"></a><span class="lineno"> 403</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00404" name="l00404"></a><span class="lineno"> 404</span> </div>
<div class="line"><a id="l00405" name="l00405"></a><span class="lineno"> 405</span> </div>
<div class="line"><a id="l00406" name="l00406"></a><span class="lineno"> 406</span><span class="comment">// Struct used for indexing the keywords.</span></div>
<div class="foldopen" id="foldopen00407" data-start="{" data-end="};">
<div class="line"><a id="l00407" name="l00407"></a><span class="lineno"><a class="line" href="structfitskeyid.html"> 407</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structfitskeyid.html">fitskeyid</a> {</div>
<div class="line"><a id="l00408" name="l00408"></a><span class="lineno"><a class="line" href="structfitskeyid.html#a9c19a56e7a92c1728bebd92e5370b9c7"> 408</a></span> <span class="keywordtype">char</span> <a class="code hl_variable" href="structfitskeyid.html#a9c19a56e7a92c1728bebd92e5370b9c7">name</a>[12]; <span class="comment">// Keyword name, null-terminated.</span></div>
<div class="line"><a id="l00409" name="l00409"></a><span class="lineno"><a class="line" href="structfitskeyid.html#ab20aa3220d9994d02a1791e35dc91a56"> 409</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskeyid.html#ab20aa3220d9994d02a1791e35dc91a56">count</a>; <span class="comment">// Number of occurrences of keyword.</span></div>
<div class="line"><a id="l00410" name="l00410"></a><span class="lineno"><a class="line" href="structfitskeyid.html#a8c8c5a6be67ef57333e80e71f320b62e"> 410</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskeyid.html#a8c8c5a6be67ef57333e80e71f320b62e">idx</a>[2]; <span class="comment">// Indices into fitskey array.</span></div>
<div class="line"><a id="l00411" name="l00411"></a><span class="lineno"> 411</span>};</div>
</div>
<div class="line"><a id="l00412" name="l00412"></a><span class="lineno"> 412</span> </div>
<div class="line"><a id="l00413" name="l00413"></a><span class="lineno"> 413</span><span class="comment">// Size of the fitskeyid struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l00414" name="l00414"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#a23868c17c44dc94add97438092d3058c"> 414</a></span><span class="preprocessor">#define KEYIDLEN (sizeof(struct fitskeyid)/sizeof(int))</span></div>
<div class="line"><a id="l00415" name="l00415"></a><span class="lineno"> 415</span> </div>
<div class="line"><a id="l00416" name="l00416"></a><span class="lineno"> 416</span> </div>
<div class="line"><a id="l00417" name="l00417"></a><span class="lineno"> 417</span><span class="comment">// Struct used for storing FITS keywords.</span></div>
<div class="foldopen" id="foldopen00418" data-start="{" data-end="};">
<div class="line"><a id="l00418" name="l00418"></a><span class="lineno"><a class="line" href="structfitskey.html"> 418</a></span><span class="keyword">struct </span><a class="code hl_struct" href="structfitskey.html">fitskey</a> {</div>
<div class="line"><a id="l00419" name="l00419"></a><span class="lineno"><a class="line" href="structfitskey.html#a43de42050c7e0232c9f7c5a28bfede4b"> 419</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#a43de42050c7e0232c9f7c5a28bfede4b">keyno</a>; <span class="comment">// Header keyrecord sequence number (1-rel).</span></div>
<div class="line"><a id="l00420" name="l00420"></a><span class="lineno"><a class="line" href="structfitskey.html#af5bd77eb6d318c562bfe650f6784eb5f"> 420</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#af5bd77eb6d318c562bfe650f6784eb5f">keyid</a>; <span class="comment">// Index into fitskeyid[].</span></div>
<div class="line"><a id="l00421" name="l00421"></a><span class="lineno"><a class="line" href="structfitskey.html#a935a63ff3aa2c0403ed8eee1a94662e7"> 421</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#a935a63ff3aa2c0403ed8eee1a94662e7">status</a>; <span class="comment">// Header keyrecord status bit flags.</span></div>
<div class="line"><a id="l00422" name="l00422"></a><span class="lineno"><a class="line" href="structfitskey.html#a48b4ff24100b6ada4fd184d5c3d55eec"> 422</a></span> <span class="keywordtype">char</span> <a class="code hl_variable" href="structfitskey.html#a48b4ff24100b6ada4fd184d5c3d55eec">keyword</a>[12]; <span class="comment">// Keyword name, null-filled.</span></div>
<div class="line"><a id="l00423" name="l00423"></a><span class="lineno"><a class="line" href="structfitskey.html#adbc83643fe92fd44408a6d62dbaf87b1"> 423</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#adbc83643fe92fd44408a6d62dbaf87b1">type</a>; <span class="comment">// Keyvalue type (see above).</span></div>
<div class="line"><a id="l00424" name="l00424"></a><span class="lineno"><a class="line" href="structfitskey.html#a42413fd1f1f3117a4bc4c0599c2c3889"> 424</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#a42413fd1f1f3117a4bc4c0599c2c3889">padding</a>; <span class="comment">// (Dummy inserted for alignment purposes.)</span></div>
<div class="line"><a id="l00425" name="l00425"></a><span class="lineno"> 425</span> <span class="keyword">union </span>{</div>
<div class="line"><a id="l00426" name="l00426"></a><span class="lineno"><a class="line" href="structfitskey.html#a88e62afbb23808ae484b8734bb1685b9"> 426</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#a88e62afbb23808ae484b8734bb1685b9">i</a>; <span class="comment">// 32-bit integer and logical values.</span></div>
<div class="line"><a id="l00427" name="l00427"></a><span class="lineno"><a class="line" href="structfitskey.html#af1a8fb88bc5d4ba60f9f12d0885c360e"> 427</a></span> <a class="code hl_typedef" href="fitshdr_8h.html#a88ab82d73e5c2607f0a40af8917fffe1">int64</a> <a class="code hl_variable" href="structfitskey.html#af1a8fb88bc5d4ba60f9f12d0885c360e">k</a>; <span class="comment">// 64-bit integer values.</span></div>
<div class="line"><a id="l00428" name="l00428"></a><span class="lineno"><a class="line" href="structfitskey.html#a68ab074cc13a9e0be1583ee93aa0db6b"> 428</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#a68ab074cc13a9e0be1583ee93aa0db6b">l</a>[8]; <span class="comment">// Very long signed integer values.</span></div>
<div class="line"><a id="l00429" name="l00429"></a><span class="lineno"><a class="line" href="structfitskey.html#ae6f81da89b09d92db5258191a1a9354b"> 429</a></span> <span class="keywordtype">double</span> <a class="code hl_variable" href="structfitskey.html#ae6f81da89b09d92db5258191a1a9354b">f</a>; <span class="comment">// Floating point values.</span></div>
<div class="line"><a id="l00430" name="l00430"></a><span class="lineno"><a class="line" href="structfitskey.html#a413484cd565be07b4adc75ed53c4ace7"> 430</a></span> <span class="keywordtype">double</span> <a class="code hl_variable" href="structfitskey.html#a413484cd565be07b4adc75ed53c4ace7">c</a>[2]; <span class="comment">// Complex values.</span></div>
<div class="line"><a id="l00431" name="l00431"></a><span class="lineno"><a class="line" href="structfitskey.html#aaa0b63820fb73086d2f55ea9687d8126"> 431</a></span> <span class="keywordtype">char</span> <a class="code hl_variable" href="structfitskey.html#aaa0b63820fb73086d2f55ea9687d8126">s</a>[72]; <span class="comment">// String values, null-terminated.</span></div>
<div class="line"><a id="l00432" name="l00432"></a><span class="lineno"><a class="line" href="structfitskey.html#aa914a7430a2746de8ceb641321842784"> 432</a></span> } <a class="code hl_variable" href="structfitskey.html#aa914a7430a2746de8ceb641321842784">keyvalue</a>; <span class="comment">// Keyvalue.</span></div>
<div class="line"><a id="l00433" name="l00433"></a><span class="lineno"><a class="line" href="structfitskey.html#ad50ff3c9166c43e1fe0542b18a216ee1"> 433</a></span> <span class="keywordtype">int</span> <a class="code hl_variable" href="structfitskey.html#ad50ff3c9166c43e1fe0542b18a216ee1">ulen</a>; <span class="comment">// Length of units string.</span></div>
<div class="line"><a id="l00434" name="l00434"></a><span class="lineno"><a class="line" href="structfitskey.html#a4fe936ed7df47a073c049f4fe1528ba2"> 434</a></span> <span class="keywordtype">char</span> <a class="code hl_variable" href="structfitskey.html#a4fe936ed7df47a073c049f4fe1528ba2">comment</a>[84]; <span class="comment">// Comment (or keyrecord), null-terminated.</span></div>
<div class="line"><a id="l00435" name="l00435"></a><span class="lineno"> 435</span>};</div>
</div>
<div class="line"><a id="l00436" name="l00436"></a><span class="lineno"> 436</span> </div>
<div class="line"><a id="l00437" name="l00437"></a><span class="lineno"> 437</span><span class="comment">// Size of the fitskey struct in int units, used by the Fortran wrappers.</span></div>
<div class="line"><a id="l00438" name="l00438"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#ae6ae55940dfdf1155736df656d83a7cd"> 438</a></span><span class="preprocessor">#define KEYLEN (sizeof(struct fitskey)/sizeof(int))</span></div>
<div class="line"><a id="l00439" name="l00439"></a><span class="lineno"> 439</span> </div>
<div class="line"><a id="l00440" name="l00440"></a><span class="lineno"> 440</span> </div>
<div class="line"><a id="l00441" name="l00441"></a><span class="lineno"><a class="line" href="fitshdr_8h.html#aebb4607327b6db35b468517328f67878"> 441</a></span><span class="keywordtype">int</span> <a class="code hl_function" href="fitshdr_8h.html#aebb4607327b6db35b468517328f67878">fitshdr</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> header[], <span class="keywordtype">int</span> nkeyrec, <span class="keywordtype">int</span> nkeyids,</div>
<div class="line"><a id="l00442" name="l00442"></a><span class="lineno"> 442</span> <span class="keyword">struct</span> <a class="code hl_struct" href="structfitskeyid.html">fitskeyid</a> keyids[], <span class="keywordtype">int</span> *nreject, <span class="keyword">struct</span> <a class="code hl_struct" href="structfitskey.html">fitskey</a> **keys);</div>
<div class="line"><a id="l00443" name="l00443"></a><span class="lineno"> 443</span> </div>
<div class="line"><a id="l00444" name="l00444"></a><span class="lineno"> 444</span> </div>
<div class="line"><a id="l00445" name="l00445"></a><span class="lineno"> 445</span><span class="preprocessor">#ifdef __cplusplus</span></div>
<div class="line"><a id="l00446" name="l00446"></a><span class="lineno"> 446</span>}</div>
<div class="line"><a id="l00447" name="l00447"></a><span class="lineno"> 447</span><span class="preprocessor">#endif</span></div>
<div class="line"><a id="l00448" name="l00448"></a><span class="lineno"> 448</span> </div>
<div class="line"><a id="l00449" name="l00449"></a><span class="lineno"> 449</span><span class="preprocessor">#endif </span><span class="comment">// WCSLIB_FITSHDR</span></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412">fitshdr_errmsg_enum</a></div><div class="ttdeci">fitshdr_errmsg_enum</div><div class="ttdef"><b>Definition</b> fitshdr.h:391</div></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412a303803fdbecabde6bc9bb607cb284242"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a303803fdbecabde6bc9bb607cb284242">FITSHDRERR_FLEX_PARSER</a></div><div class="ttdeci">@ FITSHDRERR_FLEX_PARSER</div><div class="ttdef"><b>Definition</b> fitshdr.h:395</div></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412a63a6fb5e1687601e9b4f2788260bbf46"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a63a6fb5e1687601e9b4f2788260bbf46">FITSHDRERR_NULL_POINTER</a></div><div class="ttdeci">@ FITSHDRERR_NULL_POINTER</div><div class="ttdef"><b>Definition</b> fitshdr.h:393</div></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412a8f88dbd41c3e1e65e4953e5fc6f2cb51"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a8f88dbd41c3e1e65e4953e5fc6f2cb51">FITSHDRERR_SUCCESS</a></div><div class="ttdeci">@ FITSHDRERR_SUCCESS</div><div class="ttdef"><b>Definition</b> fitshdr.h:392</div></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412a9904089dd772386251e46f4a1f118b0f"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412a9904089dd772386251e46f4a1f118b0f">FITSHDRERR_DATA_TYPE</a></div><div class="ttdeci">@ FITSHDRERR_DATA_TYPE</div><div class="ttdef"><b>Definition</b> fitshdr.h:396</div></div>
<div class="ttc" id="afitshdr_8h_html_a4d7dfa6de37191eb897faa60ce216412ab423fa4f6030c2480b8ed78088318bbe"><div class="ttname"><a href="fitshdr_8h.html#a4d7dfa6de37191eb897faa60ce216412ab423fa4f6030c2480b8ed78088318bbe">FITSHDRERR_MEMORY</a></div><div class="ttdeci">@ FITSHDRERR_MEMORY</div><div class="ttdef"><b>Definition</b> fitshdr.h:394</div></div>
<div class="ttc" id="afitshdr_8h_html_a88ab82d73e5c2607f0a40af8917fffe1"><div class="ttname"><a href="fitshdr_8h.html#a88ab82d73e5c2607f0a40af8917fffe1">int64</a></div><div class="ttdeci">int int64[3]</div><div class="ttdoc">64-bit signed integer data type.</div><div class="ttdef"><b>Definition</b> fitshdr.h:402</div></div>
<div class="ttc" id="afitshdr_8h_html_ad966ed3fefd26c9546ec078171e3940b"><div class="ttname"><a href="fitshdr_8h.html#ad966ed3fefd26c9546ec078171e3940b">fitshdr_errmsg</a></div><div class="ttdeci">const char * fitshdr_errmsg[]</div><div class="ttdoc">Status return messages.</div></div>
<div class="ttc" id="afitshdr_8h_html_aebb4607327b6db35b468517328f67878"><div class="ttname"><a href="fitshdr_8h.html#aebb4607327b6db35b468517328f67878">fitshdr</a></div><div class="ttdeci">int fitshdr(const char header[], int nkeyrec, int nkeyids, struct fitskeyid keyids[], int *nreject, struct fitskey **keys)</div><div class="ttdoc">FITS header parser routine.</div></div>
<div class="ttc" id="astructfitskey_html"><div class="ttname"><a href="structfitskey.html">fitskey</a></div><div class="ttdoc">Keyword/value information.</div><div class="ttdef"><b>Definition</b> fitshdr.h:418</div></div>
<div class="ttc" id="astructfitskey_html_a413484cd565be07b4adc75ed53c4ace7"><div class="ttname"><a href="structfitskey.html#a413484cd565be07b4adc75ed53c4ace7">fitskey::c</a></div><div class="ttdeci">double c[2]</div><div class="ttdef"><b>Definition</b> fitshdr.h:430</div></div>
<div class="ttc" id="astructfitskey_html_a42413fd1f1f3117a4bc4c0599c2c3889"><div class="ttname"><a href="structfitskey.html#a42413fd1f1f3117a4bc4c0599c2c3889">fitskey::padding</a></div><div class="ttdeci">int padding</div><div class="ttdef"><b>Definition</b> fitshdr.h:424</div></div>
<div class="ttc" id="astructfitskey_html_a43de42050c7e0232c9f7c5a28bfede4b"><div class="ttname"><a href="structfitskey.html#a43de42050c7e0232c9f7c5a28bfede4b">fitskey::keyno</a></div><div class="ttdeci">int keyno</div><div class="ttdef"><b>Definition</b> fitshdr.h:419</div></div>
<div class="ttc" id="astructfitskey_html_a48b4ff24100b6ada4fd184d5c3d55eec"><div class="ttname"><a href="structfitskey.html#a48b4ff24100b6ada4fd184d5c3d55eec">fitskey::keyword</a></div><div class="ttdeci">char keyword[12]</div><div class="ttdef"><b>Definition</b> fitshdr.h:422</div></div>
<div class="ttc" id="astructfitskey_html_a4fe936ed7df47a073c049f4fe1528ba2"><div class="ttname"><a href="structfitskey.html#a4fe936ed7df47a073c049f4fe1528ba2">fitskey::comment</a></div><div class="ttdeci">char comment[84]</div><div class="ttdef"><b>Definition</b> fitshdr.h:434</div></div>
<div class="ttc" id="astructfitskey_html_a68ab074cc13a9e0be1583ee93aa0db6b"><div class="ttname"><a href="structfitskey.html#a68ab074cc13a9e0be1583ee93aa0db6b">fitskey::l</a></div><div class="ttdeci">int l[8]</div><div class="ttdef"><b>Definition</b> fitshdr.h:428</div></div>
<div class="ttc" id="astructfitskey_html_a88e62afbb23808ae484b8734bb1685b9"><div class="ttname"><a href="structfitskey.html#a88e62afbb23808ae484b8734bb1685b9">fitskey::i</a></div><div class="ttdeci">int i</div><div class="ttdef"><b>Definition</b> fitshdr.h:426</div></div>
<div class="ttc" id="astructfitskey_html_a935a63ff3aa2c0403ed8eee1a94662e7"><div class="ttname"><a href="structfitskey.html#a935a63ff3aa2c0403ed8eee1a94662e7">fitskey::status</a></div><div class="ttdeci">int status</div><div class="ttdef"><b>Definition</b> fitshdr.h:421</div></div>
<div class="ttc" id="astructfitskey_html_aa914a7430a2746de8ceb641321842784"><div class="ttname"><a href="structfitskey.html#aa914a7430a2746de8ceb641321842784">fitskey::keyvalue</a></div><div class="ttdeci">union fitskey::@1 keyvalue</div></div>
<div class="ttc" id="astructfitskey_html_aaa0b63820fb73086d2f55ea9687d8126"><div class="ttname"><a href="structfitskey.html#aaa0b63820fb73086d2f55ea9687d8126">fitskey::s</a></div><div class="ttdeci">char s[72]</div><div class="ttdef"><b>Definition</b> fitshdr.h:431</div></div>
<div class="ttc" id="astructfitskey_html_ad50ff3c9166c43e1fe0542b18a216ee1"><div class="ttname"><a href="structfitskey.html#ad50ff3c9166c43e1fe0542b18a216ee1">fitskey::ulen</a></div><div class="ttdeci">int ulen</div><div class="ttdef"><b>Definition</b> fitshdr.h:433</div></div>
<div class="ttc" id="astructfitskey_html_adbc83643fe92fd44408a6d62dbaf87b1"><div class="ttname"><a href="structfitskey.html#adbc83643fe92fd44408a6d62dbaf87b1">fitskey::type</a></div><div class="ttdeci">int type</div><div class="ttdef"><b>Definition</b> fitshdr.h:423</div></div>
<div class="ttc" id="astructfitskey_html_ae6f81da89b09d92db5258191a1a9354b"><div class="ttname"><a href="structfitskey.html#ae6f81da89b09d92db5258191a1a9354b">fitskey::f</a></div><div class="ttdeci">double f</div><div class="ttdef"><b>Definition</b> fitshdr.h:429</div></div>
<div class="ttc" id="astructfitskey_html_af1a8fb88bc5d4ba60f9f12d0885c360e"><div class="ttname"><a href="structfitskey.html#af1a8fb88bc5d4ba60f9f12d0885c360e">fitskey::k</a></div><div class="ttdeci">int64 k</div><div class="ttdef"><b>Definition</b> fitshdr.h:427</div></div>
<div class="ttc" id="astructfitskey_html_af5bd77eb6d318c562bfe650f6784eb5f"><div class="ttname"><a href="structfitskey.html#af5bd77eb6d318c562bfe650f6784eb5f">fitskey::keyid</a></div><div class="ttdeci">int keyid</div><div class="ttdef"><b>Definition</b> fitshdr.h:420</div></div>
<div class="ttc" id="astructfitskeyid_html"><div class="ttname"><a href="structfitskeyid.html">fitskeyid</a></div><div class="ttdoc">Keyword indexing.</div><div class="ttdef"><b>Definition</b> fitshdr.h:407</div></div>
<div class="ttc" id="astructfitskeyid_html_a8c8c5a6be67ef57333e80e71f320b62e"><div class="ttname"><a href="structfitskeyid.html#a8c8c5a6be67ef57333e80e71f320b62e">fitskeyid::idx</a></div><div class="ttdeci">int idx[2]</div><div class="ttdef"><b>Definition</b> fitshdr.h:410</div></div>
<div class="ttc" id="astructfitskeyid_html_a9c19a56e7a92c1728bebd92e5370b9c7"><div class="ttname"><a href="structfitskeyid.html#a9c19a56e7a92c1728bebd92e5370b9c7">fitskeyid::name</a></div><div class="ttdeci">char name[12]</div><div class="ttdef"><b>Definition</b> fitshdr.h:408</div></div>
<div class="ttc" id="astructfitskeyid_html_ab20aa3220d9994d02a1791e35dc91a56"><div class="ttname"><a href="structfitskeyid.html#ab20aa3220d9994d02a1791e35dc91a56">fitskeyid::count</a></div><div class="ttdeci">int count</div><div class="ttdef"><b>Definition</b> fitshdr.h:409</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Nov 29 2023 19:09:57 for WCSLIB by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.8
</small></address>
</body>
</html>
Browse
Usage
Versions