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-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |