NAME

Cif_Free - Frees all memory associated with a compiler information file (CIF) structure

SYNOPSIS

#define CIF_VERSION 2
#include <cif.h>
 int Cif_Free (cif_structure)
struct Cif_generic ∗cif_structure;

IMPLEMENTATION

All Sun SPARC systems

DESCRIPTION

The Cif_Free routine releases all memory that is associated with a particular structure.  It can be used only with structures retrieved from a file that has a memory management mode of CIF_MEM_INDIV or with structures created by the Cif_Duplicate(3) routine.  You can set the memory management mode for a CIF by using the Cif_Memmode(3) routine. 

The Cif_Free routine accepts the following argument:

cif_structure Pointer to a generic structure. 

CIF_VERSION defines the library version.  The default is 1.  The newest version is 2 and should be used with this routine. 

See the Cif(3) man page for a discussion about CIF information, format, and versions. 

RETURN VALUES

A positive return value indicates successful completion.  A negative return value indicates that an error occurred. 

EXAMPLES

The following example, when used in a program, frees the memory associated with the structure to which ∗rptr points: struct Cif_generic ∗rptr;      .       .       .  (void) Cif_free (rptr);      .       .       . 

SEE ALSO

Cif(3) for general information about CIFs
Cif_Cifconv(3), Cif_Close(3), Cif_Duplicate(3), Cif_Errstring(3), Cif_Getpos(3), Cif_Getrecord(3), Cif_Memmode(3), Cif_Msginsert(3), Cif_Open(3), Cif_Release(3), Cif_Setpos(3) for information about general CIF library routines
Cif_Getfiledir(3), Cif_Getunitdir(3), Cif_Recgroup(3) for information about binary format specific CIF library routines

cifconv(1) for information about ASCII to binary format conversion in the

Compiler information file CIF Compiler information Compiler listings

SunOS 3.0.1  —  Last change: