The IDL_Savefile::Contents function method returns a structure variable of type IDL_SAVEFILE_CONTENTS containing information about the associated SAVE file and its contents.
Result = Obj->[IDL_Savefile::]Contents()
Returns a structure variable of type IDL_SAVEFILE_CONTENTS containing information about the associated SAVE file and its contents. The structure contains the following fields:
|
Field
|
Type
|
Description
|
|---|---|---|
|
FILENAME
|
String
|
The file path to the open SAVE file.
|
|
DESCRIPTION
|
String
|
A user-supplied description string for the SAVE file, as specified using the DESCRIPTION keyword to the SAVE procedure. If the SAVE file lacks a user supplied description, this field contains a null string.
|
|
FILETYPE
|
String
|
A description of SAVE file type. For a standard SAVE file, this field will contain the string "Portable (XDR)". For a compressed SAVE file, this field will contain "Portable (XDR) compressed".
|
|
USER
|
String
|
The user name of the user who issued the SAVE command that created the SAVE file.
|
|
HOST
|
String
|
The name of the computer on which the SAVE file was created.
|
|
DATE
|
String
|
The date on which the SAVE file was created.
|
|
ARCH
|
String
|
The value of the !VERSION.ARCH system variable field of the IDL installation that created the SAVE file.
|
|
OS
|
String
|
The value of the !VERSION.OS system variable field of the IDL installation that created the SAVE file.
|
|
RELEASE
|
String
|
The value of the !VERSION.RELEASE system variable field of the IDL installation that created the SAVE file.
|
|
N_COMMON
|
Integer
|
The number of main-level common blocks contained in the SAVE file.
|
|
N_VAR
|
Integer
|
The number of variables contained in the SAVE file.
|
|
N_SYSVAR
|
Integer
|
The number of system variables contained in the SAVE file.
|
|
N_PROCEDURE
|
Integer
|
The number of procedures contained in the SAVE file.
|
|
N_FUNCTION
|
Integer
|
The number of functions contained in the SAVE file.
|
|
N_OBJECT_HEAPVAR
|
Integer
|
The number of object heap variables contained in the SAVE file.
|
|
N_POINTER_HEAPVAR
|
Integer
|
The number of pointer heap variables contained in the SAVE file.
|
|
N_STRUCTDEF
|
Integer
|
The number of named structure definitions contained in the SAVE file. Named structure definitions are saved when a variable that references them is saved.
|
None.
None.
See Example.
Introduced: 6.1