Name

---

  MGH_STRUCT_BUILD

Purpose

---

  This function builds an anonymous structure, given a list of tag names
  and a list of pointers to data values.

Calling Sequence

---

  result = MGH_STRUCT_BUILD(tags, values, POINTER=pointer)

Positional Parameters

---

  tags (input, string array)
    List of tag names
  values (input, pointer array)
    A list of values wrapped in pointers. Must have the same number
    of elements as the tags array.

Keyword Parameters

---

  POINTER (input, switch)
    Determines whether the output structure includes the data values
    or pointers to them.

Procedure

---

  A command to create the structure is constructed and processed by
  EXECUTE. To avoid "Program code area full" failures a limit is
  placed on the number of tags created at one time; if this limit is
  exceeded the structure is built up in a series of steps.
###########################################################################
  This software is provided subject to the following conditions:
  1. NIWA makes no representations or warranties regarding the
    accuracy of the software, the use to which the software may
    be put or the results to be obtained from the use of the
    software. Accordingly NIWA accepts no liability for any loss
    or damage (whether direct of indirect) incurred by any person
    through the use of or reliance on the software.
  2. NIWA is to be acknowledged as the original author of the
    software where the software is used or presented in any form.
###########################################################################

Modification History

---

  Mark Hadfield, 2000-11:
    Written.
  Mark Hadfield, 2005-09:
    Added POINTER keyword.