uncompress
uncompress
SOURCE
,
DESTINATION

The uncompress statement uncompresses a `.zip`, `.tar.gz` or `.tar.bz2` file into a file or an entire folder.

Parameters

This statement has two parameters:

source – file to uncompress.

destination – name (and optionally path) of uncompressed file or folder. If this parameter is omitted, the new file (or folder) will have the same name as the compressed file.

Description

This statement uncompresses an archive file (must be either a `.zip`, `.tar.gz` or `.tar.bz2` file). Depending on the contents of the archive, the result may be either a single file or an entire folder.

The simplest way to use this statement is to uncompress in the same folder. If the file Yellow Flower.png.zip is in the same folder as the current database, you can unzip it like this.

    uncompress "Yellow Flower.png.zip"

This will create a file named Yellow Flower.png in the same folder as the current database.

The second parameter allows you to give the uncompressed file a different name, like this:

    uncompress "Yellow Flower.png.zip","Golden Flower.png"

Use the archivecontents( function to save the file (or folder) using its original, uncompressed name (which is not necessarily the same as the current name of the archive). If the archive contains a folder the contents will be multiple lines, so the firstline( function is used to extract the primary name of the contents. In this example you don’t know for sure what the final file name will be – it depends on the original uncompressed file name.

    uncompress "Yellow Flower.png.zip",firstline(archivecontents("Yellow Flower.png.zip"))

In addition to specifying the output name, you can also specify the exact location where the uncompressed file (or folder) will be placed.

    uncompress "Yellow Flower.png.zip","~/Pictures/Golden Flower.png"

Here is a similar example, but for an entire folder.

    uncompress "Spring Flowers.zip","~/Pictures/Spring Flowers (2016)"

See Also

- archivecontents( -- lists the contents of a compressed archive in *.zip*, *.tar.gz* or *.tar.bz2* format.
- compress -- compresses a file or an entire folder.
- zipcompress -- compresses a file or an entire folder into a zip file (using ditto shell tool).
- zipuncompress -- uncompresses a file or an entire folder from a zip file (using ditto shell tool).

History

Version | Status | Notes
10.0 | New | New in this version.