AST_GETMOCSTRING

Get the JSON or string-encoded representation of a Moc

Description:

This function stores the JSON or string-encoded representation of the supplied Moc in the supplied string buffer.

Invocation

CALL AST_GETMOCSTRING( THIS, JSON, MXSIZE, STRING, SIZE, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Moc.
JSON = LOGICAL (Given)
If .TRUE., the Moc is encoded using JSON serialisation. Otherwise it is encoded using string-serialisation.
MXSIZE = INTEGER (Given)
The length of the supplied string buffer in bytes. An error will be reported if this value is smaller than the number required to describe the Moc. However, if zero is supplied, the buffer will be ignored - no string will be returned but the required size of the buffer will still be returned in SIZE.
STRING( ∗ ) = BYTE (Returned)
The area of memory in which to return the JSON or string-encoded representation of the Moc. This area is assumed to contain at least MXSIZE bytes. Only used if MXSIZE is greater than zero.
SIZE = INTEGER∗8 (Returned)
Returned holding the number of bytes needed to store the complete JSON or string-encoded representation of the Moc.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright (C) 2021 East Asian Observatory