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
|
/*
* 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.
*/
#ifndef UT_SYSTEM_MAP_H_INCLUDED
#define UT_SYSTEM_MAP_H_INCLUDED
#include "udunits2.h"
typedef struct SystemMap SystemMap;
#ifdef __cplusplus
extern "C" {
#endif
/*
* Returns a new instance of a system-map.
*
* Arguments:
* compare Function for comparing keys.
* Returns:
* NULL Operating-system failure. See "errno".
* else Pointer to the new map.
*/
SystemMap*
smNew();
/*
* Returns the address of the pointer to which a unit-system maps.
*
* Arguments:
* map Pointer to the system-map.
* system Pointer to the unit-system.
* Returns:
* NULL There is no pointer associated with "system".
* else Address of the pointer to which "system" maps.
*/
void**
smFind(
const SystemMap* const map,
const void* const system);
/*
* Returns the address of the pointer to which a unit-system maps -- creating a
* new entry if necessary. If a new entry is created, then the pointer whose
* address is returned will be NULL.
*
* Arguments:
* map Pointer to the system-map.
* system Pointer to the unit-system.
* Returns:
* NULL Operating system failure. See "errno".
* else Address of the pointer to which "system" maps.
*/
void**
smSearch(
SystemMap* const map,
const void* system);
/*
* Removes the system-map entry that corresponds to a unit-system.
*
* Arguments:
* map Pointer to the map.
* system Pointer to the unit-system.
*/
void
smRemove(
SystemMap* const map,
const void* const system);
/*
* Frees a system-map. This function should be called when a system-map is no
* longer needed.
*
* Arguments:
* map Pointer to the system-map to be freed or NULL. Use of "map"
* upon return results in undefined behavior.
*/
void
smFree(
SystemMap* const map);
#ifdef __cplusplus
}
#endif
#endif
|