Name

---

  MGH_NEW

Purpose

---

  A procedure that calls function OBJ_NEW and optionally returns the
  object reference.

Calling Sequence

---

  MGH_NEW, Name, P1, P2, ...

Inputs

---

Name

---

    Class name for the new object
  Pn
    The arguments to be passed to the method given by Name. These
    arguments are the positional arguments documented for the called
    method, and are passed to the called method exactly as if it had
    been called directly. The number of positional arguments in this
    list must not exceed 10.

Keyword Parameters

---

  Keywords are passed to the called function, with the exception of
  the following:

Result

---

    Set this keyword to a named variable to return the object reference.
###########################################################################
  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-06:
    Written.
  Mark Hadfield, 2001-07:
    Modified for IDL 5.5: _EXTRA changed to _REF_EXTRA and
    _STRICT_EXTRA.
  Mark Hadfield, 2002-06:
    Reduced maximum number of parameters, Pn from 15 to 10. Even the
    latter value is ridiculously conservative.