NAME Cif_Getrecord - Gets the next record in a compiler informa- tion file (CIF) SYNOPSIS #define CIF_VERSION 2 #include <cif.h> int Cif_Getrecord (cifd, cif_record) int cifd; struct Cif_generic **cif_record; IMPLEMENTATION All Sun SPARC systems DESCRIPTION The Cif_Getrecord routine retrieves the next record from the CIF 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_Getrecord. The Cif_Getrecord routine accepts the following arguments: cifd CIF descriptor assigned by the Cif_Open(3) rou- tine. cif_record Specifies the address of a pointer to the generic structure type. The memory needed to contain the structure returned by Cif_Getrecord and associated information is acquired accord- ing to the memory management mode selected for the file. To set the memory management mode, use the Cif_Memmode(3) rou- tine. 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 is the number of the record type that is returned. A negative return value indicates an error condition. Cif_Getrecord also returns a pointer to the generic structure by using the cif_record argument. EXAMPLES The following example, when used in a program, retrieves the next record in the CIF that is identified by the descriptor mycif. The descriptor is assigned by the Cif_Open routine. int mycif, rtype; struct Cif_generic *rptr; . . . rtype = Cif_Getrecord (mycif, &rptr); . . . 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_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
Закладки на сайте Проследить за страницей |
Created 1996-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |