This is documentation for Mathematica 8, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)

TAR (.tar, .tgz, .tb2, .tbz2)

MIME types: and application/x-tar
TAR archive file format.
Combines collections of files in a single archive.
Popular on Unix systems.
Often used in combination with compression utilities.
The extensions .tgz, .tb2, .tbz2 are supported for GZIP or BZIP2-compressed TAR files.
TAR is an acronym derived from Tape Archive.
Stores files sequentially and without using compression, while preserving file system information and directory structures.
Does not support encryption or compression.
Part of the POSIX.1-1998 and POSIX.1-2001 standards.
  • Import and Export can work with general TAR archives as well as with specific application formats consisting of multiple related files.
  • When importing from a TAR archive that constitutes a supported multifile Import format, the converter for this format will be used.
  • Import gives full path specifications for all files in a general TAR file.
  • Export exports expr to a file and saves it as a TAR archive, inferring the file format from the file extension of .
  • Export exports multiple expressions to a TAR archive.
  • Import returns an expression of the form .
  • Import extracts from the archive and imports it.
  • Import imports the specified element from a TAR file.
  • Import imports multiple elements.
  • Since Mathematica can automatically recognize all common file-compression and archive formats, it is never necessary to specify as a format in the second argument of Import.
  • Export creates a TAR archive by treating expr as specifying element elem.
  • Export treats each as specifying the corresponding .
  • Export exports expr with the specified option elements taken to have the specified values.
  • Export uses rules to specify the elements to be exported.
  • See the reference pages for full general information on Import and Export.
"Elements"list of elements and options available in this file
"Rules"full list of rules for each element and option
"Options"list of rules for options, properties, and settings
  • The following can be used to select or specify individual files:
"FileNames"list of filenames representing the contents of a TAR archive
"filename"a single file
"filename","format" a single file, taken to be in the specified format
"filename","format",elemelement elem from the specified file
  • Import by default uses the element for the TAR format.
  • Import["file.tar", All] imports an entire TAR archive.
  • File names can include relative or absolute directory specifications and the abbreviated string patterns supported by StringMatchQ.
  • Import["file.tar", "dir/*.jpg"] imports all JPEG files from subdirectory dir.
  • Export creates an archive containing a GIF and a text file.
  • Export["file", {expr1, expr2}, {"TAR", {{"file1", "GIF"}, {"file2", "Text"}}}] is equivalent to the above.
Create a TAR file that contains a PNG file and a text file:
Show the names of the files in the generated TAR:
Extract and import the PNG file:
Show the Import elements available in the PNG file:
Import all text files, using a file pattern specification:
Create a TAR file that contains a PNG file and a text file:
In[1]:=
Click for copyable input
Out[1]=
Show the names of the files in the generated TAR:
In[2]:=
Click for copyable input
Out[2]=
Extract and import the PNG file:
In[3]:=
Click for copyable input
Out[3]=
Show the Import elements available in the PNG file:
In[4]:=
Click for copyable input
Out[4]=
Import all text files, using a file pattern specification:
In[5]:=
Click for copyable input
Out[5]=