[ новости /+++ | форум | теги | ]

NAME
     Cif_Recgroup - Retrieves all the  records  of  a  particular
     type  that belong to a single unit from an open, sorted com-
     piler information file (CIF)

SYNOPSIS
     #define CIF_VERSION 2
     #include <cif.h>

     int Cif_Recgroup (cifd, udir, rtype, rptr)
     int cifd;
     struct Cif_unitdir *udir;
     int rtype;
     struct Cif_generic **rptr;

IMPLEMENTATION
     All Sun SPARC systems

DESCRIPTION
     The Cif_Recgroup routine retrieves the address of the  first
     record  of the type requested from the specified unit direc-
     tory of the specified CIF.  It returns the number of records
     returned in rptr.

     The Cif_Recgroup routine accepts the following arguments:

     cifd Specifies  the   CIF   descriptor   returned   by   the
          Cif_Open(3) routine.

     udir Contains the address  of  the  unit  directory  set  by
          Cif_Getunitdir(3) routine.

     rtype
          Specifies type requested.

     rptr Contains the address of the first record  set  by  this
          routine.  Note, when udir is null, rtype may be records
          not associated with a particular unit.

     CIF_VERSION defines the library version.  The default is  1.
     The  newest  version  is 2 and should be used with this rou-
     tine.

     CIFs are initially ASCII, but when passed through cifconv(1)
     or  when  the  Cif_Cifconv(3) routine is used, they are con-
     verted to sorted binary; then the Cif_Recgroup  routine  may
     be used.

     See the Cif(3) man page for a discussion about CIF  informa-
     tion, format, and versions.


RETURN VALUES
     The the Cif_Recgroup man page routine returns the number  of
     records in the record group.

     A negative value indicates an error  condition.   The  error
     condition can be identified with the following symbolic con-
     stants:

     Symbolic Constant   Description

     CIF_BADREQ          The requested function  cannot  be  per-
                         formed.

     CIF_NOMEM           A problem was encountered while  acquir-
                         ing memory.

     CIF_NOTOPEN         The CIF file descriptor is not  an  open
                         file.

     CIF_SYSERR          An error occurred while calling a system
                         routine.

EXAMPLES
     The following is an example of using the  Cif_Recgroup  rou-
     tine.  It uses the address of the unit directory obtained by
     using  the   Cif_Getunitdir   routine.    int   fd;   struct
     Cif_filedir  *filedir;  struct  Cif_unitdir *unitdir; struct
     Cif_usage *rec_usage; int nrecords;

     mycif   =   Cif_Cifconv   ("myprogram.T",   "r",   nrecords,
     CIF_VERSION, 1);

     Cif_Getfiledir(fd, &filedir);

     Cif_Getunitdir(fd, filedir->ut, *unitdir);

     nrecords=Cif_Recgroup(fd,   unitdir,   CIF_USAGE,    (struct
     Cif_generic **)&rec_usage);


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_Release(3),  Cif_Setpos(3) for information about general
     CIF library routines
     Cif_Getfiledir(3), Cif_Getunitdir(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

Партнёры:

Хостинг: