next up previous contents
Next: miget_label_value Up: LABEL FUNCTIONS (4) Previous: midefine_label   Contents

miget_label_name

NAME

miget_label_name - convert a label type to a text string

SYNOPSIS

#include <minc2.h>

int miget_label_name ( mihandle_t       volume, 
                       int              value, 
                       char             **name );

DESCRIPTION

For a labelled volume, this function retrieves the text name
associated with a given integer value.

The name pointer returned must be freed by calling mifree_name().

RETURN VALUE

MI_NOERROR on success, MI_ERROR on failure.



Robert VINCENT 2005-03-09