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
|
/**************************************************************
comfun.h (C-Munipack project)
Private common types, definitions, helper functions, ...
Copyright (C) 2003 David Motl, dmotl@volny.cz
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
**************************************************************/
#ifndef COMFUN_H
#define COMFUN_H
#include "cmpack_common.h"
#include "cmpack_table.h"
#include "cmpack_ccdfile.h"
/* ************* Common constats *******************/
/* Maximum length of the line in text files */
#define MAXLINE 1024
/* Maximum number of apertures */
#define MAXAP 12
/* Pi number */
/* PI number */
#ifndef M_PI
#define M_PI 3.14159265358979323846
#endif
/* Number of decimal places: */
#define MAG_PRECISION 5 /**< Magnitudes */
#define JD_PRECISION 7 /**< Julian date */
#define POS_PRECISION 2 /**< Object positions */
#define EXP_PRECISION 2 /**< Exposure duration */
#define TEMP_PRECISION 2 /**< Temperature */
#define AMASS_PRECISION 4 /**< Airmass coefficients */
#define ALT_PRECISION 2 /**< Altitude */
#define INVALID_MAG 99.99999 /**< Invalid magnitude value */
#define INVALID_ERR 9.99999 /**< Invalid error value */
#define INVALID_TEMP 999.99 /**< Invalid temperature */
#define INVALID_ALT -99.99 /**< Invalid altitude */
/****************** Common macros ******************/
#define fsig(x) ((x)>=0?(+1):(-1))
#define fabs(x) ((x)>=0?(x):-(x))
#define fmax(x,y) (((x)>(y))?(x):(y))
#define fmin(x,y) (((x)<(y))?(x):(y))
/**************** Common functions *****************/
/**
\brief Get range for specified output data format
\param[in] bitpix output data format
\param[out] minvalue minimal value
\param[out] maxvalue maximal value
\return nonzero on success, zero on failure
*/
int pixrange(CmpackBitpix bitpix, double *minvalue, double *maxvalue);
/**
\brief Print output data format
\param[in] bitpix output data format
\return allocated string
*/
const char *pixformat(int bitpix);
/**
\brief Returns true if the string contains whitespaces on
its start or end.
*/
int needs_trim(const char *str);
/**
\brief Trim all leading and trailing whitespace characters from a string
\details The result of the operation is stored to a newly
allocated buffer.
*/
char *trim(const char *str);
/**
\brief Trim all trailing whitespace characters from a string
\details The operation is done in situ, the function returns
the same pointer as the parameter.
*/
char *rtrim(char *str);
/**
\brief Trim all leading whitespace characters from a string
\details The result of the operation is stored to a newly
allocated buffer.
*/
char *ltrim(const char *str);
/**
\brief Find a string in memory buffer.
\details This is similar to strstr, but the haystack need
not to be null-terminated
*/
const char *memstr(const char *haystack, char *needle, size_t haystack_size);
/**
\brief encode string that it can be safely written to XML file
*/
char *xml_encode_string(const char *str);
/**
\brief copy string to buffer with truncation
*/
int strcpy_truncate(char *buf, int bufsize, const char *str);
#endif
|
