next up previous contents
Next: miget_volume_dimensions Up: DIMENSION FUNCTIONS (39) Previous: micreate_dimension   Contents

mifree_dimension_handle

NAME

mifree_dimension_handle - delete the dimension definition associated 
with the given handle

SYNOPSIS

#include <minc2.h>

int mifree_dimension_handle ( midimhandle_t       dim_ptr)

DESCRIPTION

Deletes the dimension definition (i.e., dimension handle and dimension itself)
only if the dimension is NOT associated with a volume.

RETURN VALUE

mifree_dimension_handle returns MI_NOERROR if it successfully deletes 
a dimension or MI_ERROR otherwise.



Robert VINCENT 2005-03-09