NhlDestroy

The Fortran name of this function is NhlFDestroy.

This function is used to destroy an HLU object.

C synopsis

#include <ncarg/hlu/hlu.h>

NhlErrorTypes NhlDestroy(
		int		obj_id
		)

Fortran synopsis

      subroutine NhlFDestroy(obj_id, ierr)
      integer obj_id, ierr

Arguments

obj_id: Identifies the HLU object to destroy. Returned from the NhlCreate function.
ierr (Fortran only): Error code.

Description

This function is used to free all the memory associated with the HLU object specified by the obj_id argument. It is important to note that the NhlDestroy function is a recursive function that destroys all the children objects of the object being destroyed. Therefore, if you call NhlDestroy on a Workstation class object that has children, those children objects will also be destroyed.

Return values

The NhlDestroy C function returns a value of type NhlErrorTypes, and the NhlFDestroy Fortran subroutine returns the error in ierr. The following table indicates what the return error values mean:

Value	|			Meaning
--------+-------------------------------------------------
NOERROR	|	Object was destroyed with no errors.
--------+-------------------------------------------------
INFO	|	Object was destroyed and there was some
	|	recoverable error.
--------+-------------------------------------------------
WARNING	|	Object was destroyed and there was some
	|	unrecoverable error.
--------+-------------------------------------------------
FATAL	|	Unable to destroy object. Invalid obj_id.

NOTE: Since this is a recursive function, these error codes may actually be for a child of the specified object.

Copyright

Reference Manual Control Panel

NG4 Home, Index, Examples, Glossary, Feedback, Ref Contents, Ref WhereAmI?

$Revision: 1.10 $ $Date: 1995/07/26 23:27:35 $