CIF_FILENAME(3)

NAME

Cif_Filename - Returns a pointer to the actual file name of an opened CIF

SYNOPSIS

#define CIF_VERSION 2
#include <cif.h>
char ∗Cif_Filename (cifd)
int cifd;

IMPLEMENTATION

All Sun SPARC systems

DESCRIPTION

The Cif_Filename routine returns the address of the actual name of the file that is the object of the cifd argument.

The Cif_Filename routine accepts the following argument:

cifd Identifies the CIF.

The cifd descriptor is assigned by the Cif_Open(3) routine or the Cif_Cifconv(3) routine and must be used for all subsequent references to the CIF. For a CIF opened with Cif_Open(3), the returned value is the first argument of Cif_Open. For a CIF opened with Cif_Cifconv(3), the return value is the binary version of the file (see Cif_Cifconv).

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

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

EXAMPLES

The following example returns the actual file name of the CIF converted and opened by the Cif_Cifconv routine (myprogram.TT).
int records[] = { CIF_CIFHDR, CIF_ENTRY, CIF_UNIT, CIF_ENDUNIT, 0 };
int mycif;
char ∗fname;      .      .      .
mycif = Cif_Cifconv ("myprogram.T", "r", records, CIF_VERSION, 1);      .      .      .
fname = Cif_Filename (mycif);      .      .      .

Museum