/usr/share/doc/libstarlink-ast-doc/node163.html is in libstarlink-ast-doc 8.6.2+dfsg-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Adding Individual Cards to a FitsChan</TITLE>
<META NAME="description" CONTENT="Adding Individual Cards to a FitsChan">
<META NAME="keywords" CONTENT="sun211">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="sun211.css">
<LINK REL="next" HREF="node164.html">
<LINK REL="previous" HREF="node162.html">
<LINK REL="up" HREF="node155.html">
<LINK REL="next" HREF="node164.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html2142"
HREF="node164.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html2140"
HREF="node155.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html2134"
HREF="node162.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2143"
HREF="node164.html">Adding Concatenated Cards to</A>
<B> Up:</B> <A NAME="tex2html2141"
HREF="node155.html">Storing AST Objects in</A>
<B> Previous:</B> <A NAME="tex2html2135"
HREF="node162.html">The Native FitsChan Output</A>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION000168000000000000000"></A><A NAME="ss:addingfitscards"></A>
<BR>
Adding Individual Cards to a FitsChan
</H2>
<P>
To insert individual cards into a FitsChanFitsChan, prior to reading them back
as Objects for example, you should use the astPutFitsastPutFits function. You
can insert a card in front of the current one as follows:
<P>
<SMALL CLASS="SMALL">
<BR>
<IMG
WIDTH="265" HEIGHT="14" ALIGN="BOTTOM" BORDER="0"
SRC="img261.png"
ALT="\begin{terminalv}
astPutFits( fitschan, card, 0 );
\end{terminalv}">
<BR>
</SMALL>
<P>
where the third argument of zero indicates that the current card
should not be overwritten. Note that facilities are not provided by
AST for formatting the card contents.
<P>
After inserting a card, the FitsChan's CardCard attribute points at the
original Card, or at the end-of-file if the FitsChan was originally
empty. Entering a sequence of cards is therefore straightforward. If
``cards'' is an array of pointers to strings containing FITS header
cards and ``ncards'' is the number of cards, then a loop such as the
following will insert the cards in sequence into a FitsChan:
<P>
<SMALL CLASS="SMALL">
<BR>
<IMG
WIDTH="699" HEIGHT="128" ALIGN="BOTTOM" BORDER="0"
SRC="img262.png"
ALT="\begin{terminalv}
...">
<BR>
</SMALL>
<P>
The string containing a card need not be null terminated if it is at
least 80 characters long (we have not allocated space for the strings
themselves in this brief example).
<P>
Note that astPutFits enforces the validity of a FitsChan by rejecting
any cards which do not adhere to the FITS standard. If any such cards
are detected, an error will result.
<P>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html2142"
HREF="node164.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next"
SRC="/usr/share/latex2html/icons/next.png"></A>
<A NAME="tex2html2140"
HREF="node155.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
SRC="/usr/share/latex2html/icons/up.png"></A>
<A NAME="tex2html2134"
HREF="node162.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
SRC="/usr/share/latex2html/icons/prev.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2143"
HREF="node164.html">Adding Concatenated Cards to</A>
<B> Up:</B> <A NAME="tex2html2141"
HREF="node155.html">Storing AST Objects in</A>
<B> Previous:</B> <A NAME="tex2html2135"
HREF="node162.html">The Native FitsChan Output</A></DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
|