IDL_Savefile::Contents
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.
Syntax
Result = Obj->[IDL_Savefile::]Contents()
Return Value
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 an empty 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. |
Arguments
None.
Keywords
None.
Example
See Example.
Version History
|
6.1 |
Introduced |