/usr/include/udunits.h is in libudunits2-dev 2.1.23-3.
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 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 | /*
* Copyright 2008, 2009 University Corporation for Atmospheric Research
*
* This file is part of the UDUNITS-2 package. See the file LICENSE
* in the top-level source-directory of the package for copying and
* redistribution conditions.
*/
/*
* Public header-file for the Unidata units(3) library.
*/
#ifndef UT_UNITS_H_INCLUDED
#define UT_UNITS_H_INCLUDED
#include "udunits2.h"
#define UT_NAMELEN 32 /* maximum length of a unit string
* (including all prefixes and EOS) */
/*
* Macro for declaring functions regardless of the availability of
* function prototypes. NB: will need double parens in actual use (e.g.
* "int func PROTO((int a, char *cp))").
*/
#ifndef PROTO
# if defined(__STDC__) || defined(__GNUC__) \
|| defined(__cplusplus) || defined(c_plusplus)
# define PROTO(a) a
# else
# define PROTO(a) ()
# endif
#endif
#define UT_EOF 1 /* end-of-file encountered */
#define UT_ENOFILE -1 /* no units-file */
#define UT_ESYNTAX -2 /* syntax error */
#define UT_EUNKNOWN -3 /* unknown specification */
#define UT_EIO -4 /* I/O error */
#define UT_EINVALID -5 /* invalid unit-structure */
#define UT_ENOINIT -6 /* package not initialized */
#define UT_ECONVERT -7 /* two units are not convertable */
#define UT_EALLOC -8 /* memory allocation failure */
#define UT_ENOROOM -9 /* insufficient room supplied */
#define UT_ENOTTIME -10 /* not a unit of time */
#define UT_DUP -11 /* duplicate unit */
#define UT_MAXNUM_BASE_QUANTITIES 10
typedef double UtOrigin; /* origin datatype */
typedef double UtFactor; /* conversion-factor datatype */
/*
* Unit-structure. Don't rely on or mess with the members!
*/
typedef struct utUnit {
ut_unit* unit2;
} utUnit;
#ifdef __cplusplus
extern "C" {
#endif
/*
* Initialize the units(3) package.
*/
extern int utInit PROTO((
const char *path
));
/*
* Indicate if the units(3) package has been initialized.
*/
extern int utIsInit PROTO((void));
/*
* Initialize a unit-structure.
*/
extern void utIni PROTO((
utUnit* const unit
));
/*
* Decode a formatted unit specification into a unit-structure.
*/
extern int utScan PROTO((
const char *spec,
utUnit *up
));
/*
* Convert a temporal value into a UTC Gregorian date and time.
*/
extern int utCalendar PROTO((
double value,
const utUnit *unit,
int *year,
int *month,
int *day,
int *hour,
int *minute,
float *second
));
/*
* Convert a date into a temporal value. The date is assumed to
* use the Gregorian calendar if on or after noon, October 15, 1582;
* otherwise, the date is assumed to use the Julian calendar.
*/
extern int utInvCalendar PROTO((
int year,
int month,
int day,
int hour,
int minute,
double second,
const utUnit *unit,
double *value
));
/*
* Indicate if a unit structure refers to a unit of time.
*/
extern int utIsTime PROTO((
const utUnit *up
));
/*
* Indicate if a unit structure has an origin.
*/
extern int utHasOrigin PROTO((
const utUnit *up
));
/*
* Clear a unit structure.
*/
extern utUnit* utClear PROTO((
utUnit *unit
));
/*
* Copy a unit-strcture.
*/
extern utUnit* utCopy PROTO((
const utUnit *source,
utUnit *dest
));
/*
* Multiply one unit-structure by another.
*/
extern utUnit* utMultiply PROTO((
const utUnit *term1,
const utUnit *term2,
utUnit *result
));
/*
* Divide one unit-structure by another.
*/
extern utUnit* utDivide PROTO((
const utUnit *numer,
const utUnit *denom,
utUnit *result
));
/*
* Form the reciprocal of a unit-structure.
*/
extern utUnit* utInvert PROTO((
const utUnit *source,
utUnit *dest
));
/*
* Raise a unit-structure to a power.
*/
extern utUnit* utRaise PROTO((
const utUnit *source,
int power,
utUnit *result
));
/*
* Shift the origin of a unit-structure by an arithmetic amount.
*/
extern utUnit* utShift PROTO((
const utUnit *source,
double amount,
utUnit *result
));
/*
* Scale a unit-structure.
*/
extern utUnit* utScale PROTO((
const utUnit *source,
double factor,
utUnit *result
));
/*
* Compute the conversion factor between two unit-structures.
*/
extern int utConvert PROTO((
const utUnit *from,
const utUnit *to,
double *slope,
double *intercept
));
/*
* Encode a unit-structure into a formatted unit-specification.
*/
extern int utPrint PROTO((
const utUnit *unit,
char **buf
));
/*
* Add a unit-structure to the units-table.
*/
extern int utAdd PROTO((
char *name,
int HasPlural,
const utUnit *unit
));
/*
* Return the unit-structure corresponding to a unit-specification.
*/
extern int utFind PROTO((
char *spec,
utUnit *up
));
/*
* Free the resources of a unit-structure.
*/
extern void utFree PROTO((
utUnit* const unit
));
/*
* Terminate use of this package.
*/
extern void utTerm PROTO((void));
#ifdef __cplusplus
}
#endif
#endif /* UT_UNITS_H_INCLUDED not defined */
|