Forward to the next entry of the archive for which Name unifies
with the pathname of the entry. Fails silently if the end of
the archive is reached before success. Name is typically
specified if a single entry must be accessed and unbound
otherwise. The following example opens a Prolog stream to a
given archive entry. Note that Stream must be closed using
close/1 and the archive must be closed using archive_close/1
after the data has been used. See also setup_call_cleanup/3.
open_archive_entry(ArchiveFile, EntryName, Stream) :-
open(ArchiveFile, read, In, [type(binary)]),
archive_open(In, Archive, [close_parent(true)]),
archive_next_header(Archive, EntryName),
archive_open_entry(Archive, Stream).
- Errors
- -
permission_error(next_header, archive, Handle) if a
previously opened entry is not closed.