type(binary)
. If
Data is an already open stream, the caller is responsible for
closing it (but see option close_parent(true)
) and must not
close the stream until after archive_close/1
is called. Mode is either
read
or write
. Details are controlled by Options.
Typically, the option close_parent(true)
is used to also
close the Data 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
(defaultfalse
), Data stream is closed when archive_close/1 is called on Archive. If Data is a file name, the default istrue
. - 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 areall
,bzip2
,compress
,gzip
,grzip
,lrzip
,lzip
,lzma
,lzop
,none
,rpm
,uu
andxz
. The valueall
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 thatall
does not includeraw
andmtree
. To open both archive and non-archive files, bothformat(all)
andformat(raw)
and/orformat(mtree)
must be specified. Supported values are:all
,7zip
,ar
,cab
,cpio
,empty
,gnutar
,iso9660
,lha
,mtree
,rar
,raw
,tar
,xar
andzip
. The valueall
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.