[det]archive_open(+Data,
+Mode, -Archive, +Options)Open the archive in Data and unify Archive with a
handle to the opened archive. Data is either a file or a
stream that contains a valid archive. Mode is either read
or write
. Details are controlled by Options.
Typically, the option close_parent(true)
is used to close
an entry stream if the archive is closed using
archive_close/1. For other
options when reading, the defaults are typically fine - for writing, a
valid format and optional filters must be specified. The option format(raw)
must be used to process compressed streams that do not contain explicit
entries (e.g., gzip'ed data) unambibuously. The raw
format
creates a pseudo archive holding a single member named data
.
- close_parent(+Boolean)
- If this option is
true
(default false
), Data
stream is closed if archive_close/1
is called on Archive.
- compression(+Compression)
- Synomym for
filter(Compression)
. Deprecated.
- filter(+Filter)
- Support the indicated filter. This option may be used multiple times to
support multiple filters. In read mode, If no filter options are
provided,
all
is assumed. In write mode, none is assumed.
Supported values are all
, bzip2
, compress
, gzip
,
grzip
, lrzip
, lzip
, lzma
, lzop
, none
, rpm
, uu
and xz
. The value all
is default for read, none
for write.
- format(+Format)
- Support the indicated format. This option may be used multiple times to
support multiple formats in read mode. In write mode, you must supply a
single format. If no format options are provided,
all
is
assumed for read mode. Note that
all
does not include raw
and mtree
.
To open both archive and non-archive files, both format(all)
and
format(raw)
and/or format(mtree)
must be
specified. Supported values are: all
, 7zip
, ar
, cab
, cpio
, empty
, gnutar
,
iso9660
, lha
, mtree
, rar
, raw
, tar
, xar
and zip
. The value all
is default for read.
Note that the actually supported compression types and formats may
vary depending on the version and installation options of the underlying
libarchive library. This predicate raises a domain or permission error
if the (explicitly) requested format or filter is not supported.
- Errors
- -
domain_error(filter, Filter)
if the requested filter is
invalid (e.g., all
for writing).
- domain_error(format, Format)
if the requested format type
is not supported.
- permission_error(set, filter, Filter)
if the requested
filter is not supported.