NAME Cif_Release - Frees memory that is associated with a CIF SYNOPSIS #define CIF_VERSION 2 #include <cif.h> int Cif_Release (cifd, freemode) int freemode; IMPLEMENTATION All Sun SPARC systems DESCRIPTION The Cif_Release routine releases all memory that is currently associated with the specified CIF. The CIF is identified by the descriptor cifd. The descriptor is assigned by the Cif_Open(3) routine and must be used for all subsequent references to the CIF, including references made by Cif_Release. The Cif_Release routine can be used only with CIFs that have a memory management mode of CIF_MEM_MANAGED. You can set the memory management mode for a CIF by using the Cif_Memmode(3) routine. The Cif_Release routine accepts the following arguments: cifd Specifies the CIF to use. freemode Indicates what should be done with the memory that is associated with the specified file. The following actions may be taken: CIF_MEM_KEEP Retains space that is associated with the CIF for use with structures from other CIFs. CIF_MEM_FREE Releases space that is associated with the CIF by using free(). CIF_VERSION defines the library version. The default is 1. The newest version is 2 and should be used with this rou- tine. See the Cif(3) man page for a discussion about CIF informa- tion, 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, releases the structures, but it retains all of the space that is associ- ated with the CIF identified by the descriptor mycif. int mycif; . . . (void) Cif_Release (mycif, CIF_MEM_KEEP); . . . SEE ALSO Cif(3) for general information about CIFs Cif_Close(3), Cif_Duplicate(3), Cif_Errstring(3), Cif_Free(3), Cif_Getpos(3), Cif_Getrecord(3), Cif_Memmode(3), Cif_Msginsert(3), Cif_Open(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 rou- tines cifconv(1) for information about ASCII to binary format conversion in the Compiler information file CIF Compiler information Compiler listings
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |