The IDL_Savefile object provides complete query and restore capabilities for IDL SAVE files. IDL SAVE files are binary format files created with the SAVE procedure; they can contain data or IDL routines. Using IDL_Savefile, you can retrieve information about the user, machine, and system that created the SAVE file, as well as the number and size of the various items contained in the file (variables, common blocks, routines, etc.). You can also selectively restore individual items from the SAVE file.

Use IDL_Savefile instead of the RESTORE procedure when you need to obtain detailed information on the items contained within a SAVE file without first restoring it, or when you wish to restore only selected items. Use RESTORE when you want to restore everything from the SAVE file using a simple interface.




See IDL_Savefile::Init.


Objects of this class have no properties of their own.


This class has the following methods:

In addition, this class inherits the methods of its superclasses (if any).


Use the IDL_Savefile object to query the contents of a SAVE file containing data and selectively restore variables.

Typically, IDL_Savefile::Contents is the first method called on a savefile object; the information retrieved indicates the number of different types of items contained in the file (variables, routines, etc.). Next, a call to IDL_Savefile::Names is used to obtain the names of items of a specific type. IDL_Savefile::Size can be used to determine the size of variables in the file, and IDL_Savefile::Restore can be used to restore items for use within the current IDL session.

; Select a SAVE file to restore. The file contains volume data.
savefile = FILEPATH('cduskcD1400.sav', $
   SUBDIRECTORY=['examples', 'data'])
; Create a savefile object.
sObj = OBJ_NEW('IDL_Savefile', savefile)
; Query the contents of the SAVE file to determine the number of
; regular variables contained therein.
sContents = sObj->Contents()
PRINT, sContents.N_VAR
; IDL Prints:
; 3
; Retrieve the names of the variables in the SAVE file.
sNames = sObj->Names()
PRINT, sNames
; IDL Prints:
; Determine the size of the DENSITY variable.
sDensitySize = sObj->Size('density')
PRINT, sDensitySize
; IDL Prints:
; 3          30          30          15           1       13500
; Restore the DENSITY variable.
sObj->Restore, 'density'
; Display the volume data.
IVOLUME, density

Version History



See Also