Extract - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


FileTools[Compressed]

  

Extract

  

uncompress a file and write it out to a new file

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

Extract(sourcefilename, destfilename, opts)

Parameters

sourcefilename

-

string, or string in string

destfilename

-

string

opts

-

options as specified below

Options

• 

overwrite : (optional) truefalse ; overwrite file if it exists on disk

• 

includepath : (optional) truefalse ; include directory structure on extract

Description

• 

Extract is an all-in-one command to open a file, uncompress it, and write the uncompressed data out to a new file.

• 

If sourcefilename is a zip archive and destfilename is a path, then all members of the zip archive will be extracted to the given path. To extract a single file from a zip archive, specify sourcefilename using the syntax "specificmember" in "filename.zip".

• 

If the option overwrite=true is given, then an error will not be raised if the file to be extracted already exists on disk. The default is false.

• 

If the option, includepath=true is given, then the subdirectory structure of the given zip file will be preserved in the extracted files.  If this option is set to false, then the subdirectory structure will be discarded during extraction.  It is undetermined which file will be written if there are multiple files with the same base name. The default is includepath=true.

Examples

Construct a file in zip format and extract from it.

zipfileFileTools:-TemporaryFileGZtest-,.zip

zipfile/tmp/mpldoc4/GZtest-yYoYxV9R.zip

(1)

FileTools:-Compressed:-WriteFile( "first" in zipfile, "one");

3

(2)

FileTools:-Compressed:-WriteFile( "second" in zipfile, Array(1..50, 0, datatype=integer[1]) );

50

(3)

FileTools:-Compressed:-Contentszipfile

first,second

(4)

Add directory structure to the zip file and extract it.

dirFileTools:-TemporaryFileztest-

dir/tmp/mpldoc4/ztest-bx70dpPu

(5)

FileTools:-MakeDirectorydir

FileTools:-Compressed:-Extractzipfile,dir

FileTools:-ListDirectorydir

second,first

(6)

FileTools:-Text:-ReadFilecatdir,/first

one

(7)

FileTools:-Binary:-ReadFilecatdir,/second

00000000000000000000000000000000000000000000000000

(8)

FileTools:-Removecatdir,/first

FileTools:-Removecatdir,/second

FileTools:-ListDirectorydir

(9)

FileTools:-Compressed:-Extract( "first" in zipfile, dir );

FileTools:-ListDirectorydir

first

(10)

FileTools:-Text:-ReadFilecatdir,/first

one

(11)

FileTools:-Removecatdir,/first

FileTools:-RemoveDirectorydir,forceremove

FileTools:-Removezipfile

Compatibility

• 

The FileTools:-Compressed:-Extract command was introduced in Maple 18.

• 

The  and  options were introduced in Maple 18.

• 

For more information on Maple 18 changes, see Updates in Maple 18.

See Also

FileTools:-Remove

FileTools[Compressed]

FileTools[Compressed][ReadFile]