Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


FILE_UNZIP

FILE_UNZIP

The FILE_UNZIP procedure uncompresses ZIP files. The uncompression of individual files within the ZIP file is done using the ZLIB_UNCOMPRESS routine.

This routine is written in the IDL language. Its source code can be found in the file file_unzip.pro in the lib subdirectory of the IDL distribution.

Note: Because of IDL's file I/O limitations, the resulting files and directories will not have any of the original file owner information, permissions (file modes) or time stamps. Instead, the files and directories will have the current file owner and default permissions, and will have a time stamp equal to the current system time.

Examples


Here, we ZIP up the resource/fonts subdirectory within the IDL installation, and then UNZIP the file into our current working directory:

dir = FILEPATH('', SUBDIR=['resource','fonts'])
FILE_ZIP, dir, 'idlresources.zip'
FILE_UNZIP, 'idlresources.zip', /VERBOSE

IDL prints:

% fonts\
% fonts\hersh1.chr, 44667 bytes
...
% fonts\tt\ttfont.map, 305 bytes
% Total 61 files, 963401 bytes
% Time elapsed: 0.070999861 seconds.

Syntax


FILE_UNZIP, File [, DirectoryOut] [, FILES=variable] [, /LIST] [, /VERBOSE]

Arguments


File

Set this argument to a scalar string giving the file to unzip.

DirectoryOut

Set this optional argument to a scalar string giving the output directory. This directory will be created if it doesn't currently exist. If DirectoryOut is not provided then FILE_UNZIP will unzip into File's current directory.

Keywords


FILES

Set this keyword to a named variable. On return, this variable will contain a string array of all of the files that were unzipped.

LIST

Set this keyword to perform all of the FILE_UNZIP actions without actually unzipping the file. The list of files can be retrieved using the FILES keyword, while the VERBOSE keyword will output the list of directories and files within the ZIP file.

VERBOSE

Set this keyword to output additional information while the routine is executing.

Version History


8.2.3

Introduced

See Also


FILE_GZIP, FILE_GUNZIP, FILE_TAR, FILE_UNTAR, FILE_ZIP, ZLIB_COMPRESS, ZLIB_UNCOMPRESS



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us