Freeing Memory Allocated by PEXlib Functions


For and overview and related topics, see Introduction to PEXlib.

Some PEXlib functions allocate memory on behalf of the application. Memory allocation often occurs in the case of inquiry functions where the size of data to be returned is unknown.

Applications must use the XFree function to deallocate memory that has been allocated for them by PEXlib, unless PEXlib provides a specific function to free memory allocated for particular PEXlib objects. Where necessary, the specific function for deallocation is noted in the description of each function that allocates the memory. Memory allocated by PEXlib is considered to be `owned' by PEXlib; the application must not modify pointers to memory that the library returns nor attempt to free such memory except by the specified functions. The application can change data structure fields other than pointers to memory without consequences.

Functions for Freeing Memory Allocated by PEXlib
----------------------------------------------------------------------------------
Functions that Allocate Memory             Functions to Deallocate Memory
----------------------------------------------------------------------------------
 PEXCreateOCC                                         PEXFreeOCC
 PEXConvertDoubleFloat                           XFree
 PEXConvertSingleFloat                            XFree
 PEXDecodeOCs                                         PEXFreeOCData
 PEXEncodeOCs                                         XFree
 PEXEndPickAll                                         PEXFreePickPaths
 PEXEndPickOne                                        PEXFreePickPaths
 PEXEscapeWithReply                               XFree
 PEXFetchElements                                    XFree
 PEXGenerateMipmap                                PEXFreeMipmap
 PEXGenerateMipmapFromResources      PEXFreeMipmap
 PEXGetAncestors                                      PEXFreeStructurePaths
 PEXGetAncillaryBufferInfo                     PEXFreeAncillaryBufferInfo
 PEXGetDescendants                                  PEXFreeStructurePaths
 PEXGetDefinedIndices                             XFree
 PEXGetElementInfo                                 XFree
 PEXGetEnumTypeInfo                             PEXFreeEnumInfo
 PEXGetImpDepConstants                         XFree
 PEXGetLargeElementInfo                        XFree
 PEXGetNameSet                                       XFree
 PEXGetPickDevice                                   PEXFreePDAttributes
 PEXGetPickMeasure                                 PEXFreePMAttributes
 PEXGetPipelineContext5_2                     PEXFreePCAttributes5_2
 PEXGetPredefinedEntries                        PEXFreeTableEntries
 PEXGetRendererExtAttributes                 PEXFreeRendererExtAttributes
 PEXGetRendererAttributes                     PEXFreeRendererAttributes
 PEXGetSearchContext                              PEXFreeSCAttributes
 PEXGetStructuresInNetwork                    XFree
 PEXGetTableEntry                                   PEXFreeTableEntries
 PEXGetTableEntries                                 PEXFreeTableEntries
 PEXGetTableValues                                  PEXFreeTableValues
 PEXGetWorkstationAttributes                  PEXFreeWorkstationAttributes
 PEXGetWorkstationPostings                    XFree
 PEXGetZBuffer                                        XFree
 PEXListFontsWithInfo                              PEXFreeFontNames
                                                                     PEXFreeFontInfo
 PEXListFonts                                             PEXFreeFontNames
 PEXMapDCToWC                                     XFree
 PEXMapWCToDC                                     XFree
 PEXMatchRenderingTargets                     XFree
 PEXPickAll                                                PEXFreePickPaths
 PEXPickOne                                               PEXFreePickPaths
 PEXQueryEncodedTextExtents                  XFree
 PEXQueryFont                                           PEXFreeFontInfo
 PEXQueryTextExtents                               XFree
 PEXSearchNetwork                                   PEXFreeStructurePaths
----------------------------------------------------------------------------------