Export

Listing of Formats »

Export["dest.ext",expr]

exports data to a file, converting it to the format corresponding to the file extension ext.

Export[dest,expr,"format"]

exports data in the specified format.

Export[dest,exprs,elements]

exports data by treating exprs as elements.

Export[dest,exprs,elements,options]

uses the specified options.

Details

  • Export handles a large number of formats, each typically with many different possible elements. The possible formats are given in the list $ExportFormats, and in the "Listing of All Formats".
  • By default, Export creates a file in the current directory given by Directory[].
  • In Export[dest,], dest can be any of the following:
  • "file" or File["file"]explicit file name
    "!prog"export data to a pipe
    CloudObject[]a cloud object
    LocalObject[]a local object
  • The following combinations of exprs and elements can be given:
  • exprelemexport expr as elem
    {expr1,expr2,}{{elem1,elem2,}}export expri as elemi
    {expr1,expr2,}{elem1,subelem1,}export expri as sublement subelemi of elem1
    rules"Rules"export elements and expressions rules
  • When specifying the format, the following elements specifications can be given:
  • {"format",elem}a single element
    {"format",{elem1,elem2,}}multiple elements
    {"format",elem1,sublelem1,}subelements of subelements of elem1
    {"format",rules}export elements and expressions rules
  • When exporting using the "Rules" element, rules can have the following forms:
  • elem->vala value for a single element
    {elem1->val1,elem2->val2,}values for several elements
    elem1->val1,elem2->val2,an association for several elements
    elem1->{elem11->val11,}values for subelements
  • Export takes an OverwriteTarget option for all formats. Possible settings include:
  • Falsedo not overwrite an existing file
    Trueoverwrite an existing file (default)
    "KeepBoth"keep the existing file, automatically choosing a name for the new file
  • Use Export[dest,,options] to provide format-specific options that control the behavior of the export.
  • Export[file,NotebookObject[],] when possible exports the content of the notebook referenced by the NotebookObject.
  • New formats can be manually registered in the Wolfram Language. See the tutorial for "Developing an Export Converter".

Examples

open all close all

Basic Examples  (4)

Export an image object:

In[1]:=
Click for copyable input
Out[1]=

Export a plot as a GIF:

In[1]:=
Click for copyable input
Out[1]=

Export a formula as a GIF:

In[1]:=
Click for copyable input
Out[1]=
In[2]:=
Click for copyable input
Out[2]=

Export a sound as a MIDI file:

In[1]:=
Click for copyable input
Out[1]=

Generalizations & Extensions  (2)

Introduced in 1999
(4.0)
|
Updated in 2019
(12.0)