-
Notifications
You must be signed in to change notification settings - Fork 0
/
vars.h
129 lines (113 loc) · 3.99 KB
/
vars.h
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
#ifndef CEXP_VARS_H
#define CEXP_VARS_H
#include "cexpsyms.h"
/* Interface to CEXP variables */
/* SLAC Software Notices, Set 4 OTT.002a, 2004 FEB 03
*
* Authorship
* ----------
* This software (CEXP - C-expression interpreter and runtime
* object loader/linker) was created by
*
* Till Straumann <[email protected]>, 2002-2008,
* Stanford Linear Accelerator Center, Stanford University.
*
* Acknowledgement of sponsorship
* ------------------------------
* This software was produced by
* the Stanford Linear Accelerator Center, Stanford University,
* under Contract DE-AC03-76SFO0515 with the Department of Energy.
*
* Government disclaimer of liability
* ----------------------------------
* Neither the United States nor the United States Department of Energy,
* nor any of their employees, makes any warranty, express or implied, or
* assumes any legal liability or responsibility for the accuracy,
* completeness, or usefulness of any data, apparatus, product, or process
* disclosed, or represents that its use would not infringe privately owned
* rights.
*
* Stanford disclaimer of liability
* --------------------------------
* Stanford University makes no representations or warranties, express or
* implied, nor assumes any liability for the use of this software.
*
* Stanford disclaimer of copyright
* --------------------------------
* Stanford University, owner of the copyright, hereby disclaims its
* copyright and all other rights in this software. Hence, anyone may
* freely use it for any purpose without restriction.
*
* Maintenance of notices
* ----------------------
* In the interest of clarity regarding the origin and status of this
* SLAC software, this and all the preceding Stanford University notices
* are to remain affixed to any copy or derivative of this software made
* or distributed by the recipient and are to be affixed to any copy of
* software made or distributed by the recipient that contains a copy or
* derivative of this software.
*
* SLAC Software Notices, Set 4 OTT.002a, 2004 FEB 03
*/
#ifdef __cplusplus
extern "C" {
#endif
/* initialize the facility: this routine must exactly be called ONCE */
void
cexpVarInitOnce(void);
/* destroy all variables */
void
cexpVarsFlush(void);
/* lookup a variable
* If the variable is not found, the return value
* is 0. If it is found, a pointer to its
* data area is returned.
* It is the users responsability to protect the
* data area from concurrent access by multiple
* threads. The internal locking only protects
* the variable management.
* If the 'creat' is nonzero the
* variable will be created if it doesn't exist
* already.
*/
CexpSym
cexpVarLookup(const char *name, int creat);
/* remove a variable
* RETURNS: nonzero if the variable was found & deleted
*
* NOTE: the comments about cexpVarLookup in a multithreaded
* environment. Variables exist in a global namespace,
* so multiple threads may use them. However, if they
* do so, they must make sure not to use pointers to
* 'CexpTypedVal's of deleted variables.
*/
void *
cexpVarDelete(char *name);
/* call a user routine for every variable in lexical
* order. The 'walk' aborts if the user routine returns
* a nonzero value returning that same value to the
* caller.
*
* NOTE: 1) in a multithreaded environment, the global
* variable table is locked while in
* cexpVarWalk(), i.e. nobody can access
* variables while this routine is active.
* 2) The walker MUST NOT add/delete variables.
*/
typedef void* (*CexpVarWalker)(const char *name, CexpSym a, void *usrArg);
void *
cexpVarWalk(CexpVarWalker walker, void *usrArg);
/* string table management
* There exists one global 'string table', where static
* strings are registered. There is no way of deleting
* strings, so it is safe to assume they live 'forever'
*/
/* lookup a string optionally adding it to the
* table.
*/
char *
cexpStrLookup(char *name, int creat);
#ifdef __cplusplus
}
#endif
#endif