Put a value into an element of a vector value in a KeyMap astMapPutElemX
"
Data Type Codes"
section below for the code appropriate to each supported data type).
The supplied value is converted from the data type indicated by
X
to the data type of the KeyMap entry before being stored (an error is reported if it is
not possible to convert the value to the required data type). "
elem"
index is
outside the range of the vector, the length of the vector will be increased by
one element and the supplied value will be stored at the end of the vector in
the new element. "
elem"
index is outside the range of the
vector, an error will be reported. The number of elements in each cell of a
column is specified when the column is created using astAddColumn. If the entry originally holds a scalar value, it will be treated like a vector entry of length 1.
If the specified key cannot be found in the given KeyMap, or is found but has an undefined value, a new vector entry with the given name, and data type implied by X, is created and the supplied value is stored in its first entry.
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. char)
For example, astMapPutElemD would be used to put a "
double"
value, while astMapPutElemI
would be used to put an "
int"
value, etc. For D or I, the supplied "
value"
parameter
should be a double or int. For C, the supplied "
value"
parameter should be a pointer
to a character string. For A, the supplied "
value"
parameter should be an AstObject
pointer.