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
----------------------------------------------------------------------------------