summaryrefslogtreecommitdiffstats
path: root/funtools/fitsy/doc/cardins.html
blob: 26c9acc40df79245d508ce257b78b41737c1816c (plain)
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
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<TITLE> cardins
</TITLE>
<p>
<!-- pnuts --> <a href="cardfind.html">[Previous]</a> <a href="fitsy.html">[Up]</a> <a href="../mmtilib.html">[Top]</a>
<META NAME="generator" CONTENT="txt2html v1.3">
</HEAD>
<BODY>


<A NAME="section-1.1.1"><H3>NAME</H3></A>

<P>
 ft_cardins,ft_cardapp,ft_carddel -Fitsy FITS card insert and delete routines.

<A NAME="section-1.1.2"><H3>SYNOPSIS</H3></A>

 

<PRE>
FITSCard ft_cardins(FITSHead fits, FITSCard card, FITSCard here);
FITSCard ft_cardapp(FITSHead fits, FITSCard card);
FITSCard ft_carddel(FITSHead fits, FITSCard card);


<P>
</PRE>
<A NAME="section-1.1.3"><H3>PARAMETERS</H3></A>

<UL>
<P>
  <LI> <B>FITSHead fits</B> - FITS header.
  <LI> <B>FITSCard card</B> - FITS card to insert, append or
      delete.
  <LI> <B>FITSCard here</B> - Insert <B>card</B> after <B>here</B>

</UL>
<A NAME="section-1.1.4"><H3>DESCRIPTION</H3></A>


<A NAME="section-1.1.4.1"><H4>ft_cardins</H4></A>

<P>
 Insert a <B>card</B> into a FITS header after <B>here.</B>
 
<P>
 If <B>here</B> is NULL <B>card</B> is inserted before the END card.
 
<P>
 Returns <B>card</B>;

<A NAME="section-1.1.4.2"><H4>ft_cardapp</H4></A>

<P>
 Append a card to the end of the FITS header.
 
<P>
 Retuns <B>card.</B>

<A NAME="section-1.1.4.3"><H4>ft_carddel</H4></A>

<P>
 Delete a card from a FITS header.
 
<P>
 Returns <B>card</B> which now points the the card after
 the one deleted

<A NAME="section-1.1.5"><H3>EXAMPLES</H3></A>


<PRE>
                FITSCard        here;
                FITSBuff        card;

        <B>ft_cardkey</B>(&amp;card, "Keyword", 0);
        <B>ft_cardseti</B>(&amp;card, 4, NULL);

        /* Insert a new card "Keyword" after the 4th card.
         */
        here = <B>ft_cardins</B>(fits, &amp;card, <B>ft_cardnth</B>(4));

        /* Append the same card to the header
         */
        card = <B>ft_cardapp</B>(fits, &amp;card);

        /* Delete the first card.
         */
        <B>ft_carddel</B>(fits, here);

<P>
</PRE>

<p>
<!-- pnuts --> <a href="cardfind.html">[Previous]</a> <a href="fitsy.html">[Up]</a> <a href="../mmtilib.html">[Top]</a>
</BODY>
</HTML>