CALL AST_ADDMOCSTRING( THIS, CMODE, NEGATE, MAXORDER,
LEN, STRING, JSON, STATUS )
THIS = INTEGER (Given)
Pointer to the
Moc to be modified.
CMODE = INTEGER (Given)
Indicates how the supplied MOC
is to be combined with the existing Moc. Any of the following values may be supplied:
-
AST__AND: The modified Moc is the intersection of the original Moc and the sipplied
MOC.
-
AST__OR: The modified Moc is the union of the original Moc and the supplied MOC.
-
AST__XOR: The modified Moc is the exclusive disjunction of the original Moc and the supplied MOC.
NEGATE = LOGICAL (Given)
If .FALSE., the cells added to the existing Moc will be those
included in the supplied MOC. If .TRUE., the cells added to the existing Moc will be those
not included in the supplied MOC.
MAXORDER = INTEGER (Given)
The maximum
HEALPix order to use. If a negative value is supplied, the maximum order will be determined
by searching the supplied MOC (this will take extra time). In either case, if a value has
already been set for the
MaxOrder attribute in the Moc, then the attribute value is used in
preference to the value supplied for this parameter. Any HEALPix cells in the supplied
MOC that refer to an order greater than MAXORDER are ignored.
LEN = INTEGER
(Given)
The number of characters to read from the supplied string. If this is greater than the
length of the string, it is ignored and the whole string is read.
STRING = CHARACTER
∗ (
∗ )
(Given)
The array of characters holding the supplied MOC. It should be encoded using either the
string or JSON serialisation described in the MOC recommendation. The used serialisation is
determined from the first non-blank character, which should be either a curly brace (’
{’
- JSON
serialisation) or a digit (string serialisation).
JSON = LOGICAL (Returned)
A boolean flag
indicating if the supplied string was interpreted using the JSON (.TRUE.) or string (.FALSE.)
serialisation.
STATUS = INTEGER (Given and Returned)
The global status.