format : bzip2, zip, or gzip ; specify the input format explicitly

ReadFile is an all-in-one command to open a file, read and decompress its data, and close the file.

If the given file is in zip format, and an in-zip name is not specified (using "subfile" in "zipfile"), then the first member of the zip archive is read.

If the second parameter, outputtype, is string then the contents of the file are returned as a string.

If the outputtype is not specified and the in-zip file name ends in ".m", then the contents of the zip file will be parsed as if they were in Maple's internal object format.

If the outputtype is not specified and the in-zip file name ends in ".mpl", then the contents of the zip file will be parsed as if they were a single Maple-syntax text command.

If outputtype is Array, then m and n are integers specifying the dimensions of the Array. The dimensions are optional, and one or more can be set. The hwdatatype indicates one of the integer[], float[], or complex[] datatype variations accepted by the 'datatype' option of the Array command.

If outputtype is set to bytes or does not match any of the above criteria then an Array of datatype integer[1] is returned.

$\mathrm{file}≔\mathrm{FileTools}\left[\mathrm{TemporaryFilename}\right]\left(\mathrm{FileTools}\left[\mathrm{JoinPath}\right]\left(\left[\mathrm{FileTools}\left[\mathrm{TemporaryDirectory}\right]\left(\right)\,''GZtest-''\right]\right)\right)$

$\mathrm{file}≔''/tmp/mpldoc2/GZtest-yYoYxV9R''$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{WriteFile}\right]\left(\mathrm{file}\,''This\; is\; a\; test''\right)$

$14$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{ReadFile}\right]\left(\mathrm{file}\,\mathrm{string}\right)$

$''This\; is\; a\; test''$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{WriteFile}\right]\left(\mathrm{file}\,\mathrm{Array}\left(1..50\,0\,\mathrm{datatype}=\mathrm{integer}\left[1\right]\right)\right)$

$50$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{ReadFile}\right]\left(\mathrm{file}\right)$

$\left[\begin{array}{cccccccccccccccccccccccccccccccccccccccccccccccccc}0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\end{array}\right]$

$\mathrm{FileTools}\left[\mathrm{Remove}\right]\left(\mathrm{file}\right)$

$\mathrm{zipfile}≔\mathrm{FileTools}\left[\mathrm{TemporaryFilename}\right]\left(\mathrm{cat}\left(\mathrm{FileTools}\left[\mathrm{TemporaryDirectory}\right]\left(\right)\,\mathrm{kernelopts}\left(\mathrm{dirsep}\right)\,''GZtest-''\right)\,''.zip''\right)$

$\mathrm{zipfile}≔''/tmp/mpldoc2/GZtest-bx70dpPu.zip''$

FileTools[Compressed][WriteFile]("first" in zipfile, "one");

$3$

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

$50$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{Contents}\right]\left(\mathrm{zipfile}\right)$

$\left[''first''\,''second''\right]$

$\mathrm{FileTools}\left[\mathrm{Compressed}\right]\left[\mathrm{ReadFile}\right]\left(\mathrm{zipfile}\,\mathrm{string}\right)$

$''one''$

FileTools[Compressed][ReadFile]("second" in zipfile);

$\left[\begin{array}{cccccccccccccccccccccccccccccccccccccccccccccccccc}0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0& 0\end{array}\right]$

$\mathrm{FileTools}\left[\mathrm{Remove}\right]\left(\mathrm{zipfile}\right)$

The FileTools[Compressed][ReadFile] command was introduced in Maple 16.

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