Name

---

  MGH_EXAMPLE_STRUCT

Purpose

---

  This example procedure compares two methods of building up an anonymous
  structure with a large number of tags.
  Option 0 calls the MGH_STRUCT_BUILD function, which has been designed for
  efficiency and robustness when the number of tags and/or the volume of data
  is large.
  Option 1 uses repeated calls to CREATE_STRUCT, which repeatedly increments
  the structure. For large problems this is inefficient (it has quadratic timing)
  because the structure has is copied on every call.
  A more realistic example of the application of MGH_STRUCT_BUILD can be seen in
  the Retrieve method of the MGHncFile class.
###########################################################################
  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, Nov 2000:
      Written.