read_scf(3) Staden Package read_scf(3)NAME
read_scf, fread_scf, read_scf_header - Read SCF files
SYNOPSIS
#include <scf.h>
Scf *read_scf(
char *fn);
Scf *fread_scf(
FILE *fp);
int read_scf_header(
FILE *fp,
Header *h);
DESCRIPTION
These functions read SCF format trace files. All the functions accept‐
ing a FILE * as an argument assume that the file pointer is at the cor‐
rect offset within the file.
read_scf() reads an entire SCF file into the Scf structure (see the
scf(4) manual page for the details of this structure). The data is read
from the specified file name.
fread_scf() reads an entire SCF file into the Scf structure (see the
scf(4) manual page for the details of this structure). The data is read
from the specified file pointer, which is neither closed or rewound
after the operation.
read_scf_header() reads the Header structure from the specified file
pointer.
RETURN VALUES
On successful completion, the read_scf() and fread_scf() functions
return a pointer to a Scf structure. Othewise these functions return a
null pointer.
On successful completion, the read_scf_header() function returns 0.
Otherwise the function returns -1.
SEE ALSOscf(4), write_scf(3)read_scf(3)
