ETI forms

Freeing programmer-defined field types

This function frees any space allocated for a field type created with new_fieldtype or link_fieldtype. Its argument is a field type pointer previously obtained from one of these functions.

SYNOPSIS

   int free_fieldtype (fieldtype)
   FIELDTYPE  fieldtype;

You may want to free the field type TYPE_HEX from the previous example once fields of that type have been processed. To do so, you write

/* create field type TYPE_HEX */ create fields of this type free fields of this type */

free_fieldtype(TYPE_HEX); /* free programmer-defined type */

If successful, function free_fieldtype returns E_OK. If an error occurs, it returns one of the following:

E_SYSTEM_ERROR -: system error
E_BAD_ARGUMENT -: NULL field type
E_CONNECTED -: type is connected to one or more fields

Once a field type is freed, you must not use it again. If you do, the effect is undefined.