Add a scalar value to a KeyMap astMapPut0X
"
Data Type Codes"
section
below for the code appropriate to each supported data type). "
pointer to AstObject"
). If the supplied key is already in use in the KeyMap, the new value will replace the old value.
If the stored value is an AST Object pointer, the Object’
s reference count is incremented
by this call. Any subsequent changes made to the Object using the returned pointer will
be reflected in any any other active pointers for the Object, including any obtained
later using astMapget0A. The reference count for the Object will be decremented when
the KeyMap is destroyed, or the entry is removed or over-written with a different
pointer.
D: double
F: float
I: int
K: int64_t
C: "
const"
pointer to null terminated character string
A: Pointer to AstObject
P: Generic "
void "
pointer
S: short int
B: unsigned byte (i.e. unsigned char)
For example, astMapPut0D would be used to store a "
double"
value, while astMapPut0I
would be used to store an "
int"
, etc.
Note that KeyMaps containing generic "
void
"
pointers cannot be written out using astShow or astWrite. An error will be reported if
this is attempted.