Name

---

  MGH_OBJ_FILTER

Purpose

---

  Given a list of object references, this function returns a list filtered by class
  type.

Category

---

  Objects.

Calling Sequence

---

  Result = MGH_OBJ_FILTER(Objects, COUNT=count, ISA=isa)

Inputs

---

  Objects: The input list of objects.

Keyword Parameters

---

  COUNT: Set this keyword to a named variable that will contain the number
              of objects returned.
  ISA: This keyword specifies a class name or list of class names used for filtering. An
              object is passed by the filter if it matches one or more of the classes (using the OBJ_ISA function).

Outputs

---

  The function returns the filtered list.
###########################################################################
  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, Jul 2000:
      Written.