CLOSE ARCHIVE FILE(3P) — SUNPHIGS LIBRARY

NAME

CLOSE ARCHIVE FILE - close named archive file

SYNOPSIS

C Syntax

void
pclosearfile ( archive_id )
Pintarchive_id;archive identifier

FORTRAN Syntax

SUBROUTINE pclarf ( AFID )
INTEGERAFIDarchive file identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, AROP)

DESCRIPTION

Purpose

Use CLOSE ARCHIVE FILE to close an archive file.

C Input Parameter

archive_id
An integer identifying the archive file to be closed.

FORTRAN Input Parameter

AFIDAn integer identifying the archive file to be closed. The physical file associated with this identifier will be closed when this function returns, even if it was open when passed to OPEN ARCHIVE.

Execution

If the archive associated with the specified archive file identifier has changed since it was opened, it is written to the file and the file is closed. If no changes were made, the file will be closed without being rewritten.

The archive file identifier is disassociated with the file it referred to and removed from the set of open archive files maintained in the PHIGS state list. The PHIGS archive state is changed to archive closed (ARCL) if no other archive files are open.

SunPHIGS archives are supported in a private, binary format.

ERRORS

007Ignoring function, function requires state (PHOP, ∗, ∗, AROP)

404Ignoring function, the specified archive file is not open

Museum