Five DAL functions allow a second argument, which provides a place for a return argument. The argument is specified as the destination argument. The database functions that return a value and require specification of a destination are:
gtm_data
gtm_get
gtm_order
gtm_previous
gtm_query
Example:
mode = (short)GTMI_EXTGBL;DESC_MODE (k0[0],mode);DESC_CHAR (k0[1],"./mumps.gld");DESC_CHAR (k0[2],"CAT");DESC_CHAR (k0[3],"Garfield");DESC_ZERO (k0[4]); memset (k1, 0, sizeof(k1));k1[0].type = GTM_ARRAY_OF_CHARS; status = gtm_get (k0,k1);
This example corresponds to the M statement:
K1=$GET(^|",/mumps.gld"|CAT("Garfield")