Each IDLTask is defined by a set of parameters. Each has constraints on data type, values, etc. The IDLParameterLong64 is used when an IDLTask has a parameter defined as type of LONG64.
Syntax
Result = IDLParameterLong64( [, Properties=value])
Properties
Properties can be set as keywords to the function during creation, or retrieved using the "." notation after creation. The NAME property is required on initialization. The VALUE property is the only property that can be updated after creation.
CHOICE_LIST, DEFAULT, DESCRIPTION, DIRECTION, DISPLAY_NAME, INCLUSIVE_MAX, INCLUSIVE_MIN, MAX, MIN, NAME, REQUIRED, TEST_EXACT, TEST_OVERFLOW, TYPE, VALUE
Methods
Dehydrate
Hydrate
Validate
Return Value
Returns a reference to a newly-created object.
Properties
CHOICE_LIST
A 1D array that lists the possible values for the parameter. The default is !NULL. The values of this property must adhere to the TYPE property. In the task template this is defined with the "choice_list" key.
DEFAULT
The default value of the parameter. The default is !NULL. The values of this property must adhere to the TYPE property. In the task template this is defined with the "default" key.
DESCRIPTION
A string describing the purpose of the parameter with respect to the task. In the task template this is defined with the "description" key.
DIRECTION
A string describing if the parameter acts as "INPUT" or "OUTPUT". In the task template this is defined with the "direction" key. The default is "INPUT".
DISPLAY_NAME
A string for the display name of the parameter that could be used to build a user interface. It can contain spaces and special characters. In the task template this is defined with the "display_name" key. If not set, the value will default to the NAME property's value.
INCLUSIVE_MAX
A boolean value that indicates whether a parameter can equal MAX or not. The default is 1, which allows the value to equal MAX. In the task template this is defined with the "inclusive_max" key.
INCLUSIVE_MIN
A boolean value that indicates whether a parameter can equal MIN or not. The default is 1, which allows the value to equal MIN. In the task template this is defined with the "inclusive_min" key.
MAX
The maximum allowed value of the parameter. In the task template this is defined with the "max" key.
MIN
The minimum allowed value of the parameter. In the task template this is defined with the "min" key.
NAME
The name of the parameter which is required on initialization. The parameter’s value can be set and retrieved from the IDLTask using "." dot notation using this name. The name can also be used in the IDLTask::Parameter method to retrieve the parameter object. NAME must be a valid IDL variable name. In the task template this is defined with the "name" key. Use DISPLAY_NAME for a better user interface label.
REQUIRED
A boolean value that indicates whether the parameter is required or not. The default is 0, which allows the parameter to be optional. In the task template this is defined with the "required" key.
TEST_EXACT
A boolean value that indicates whether floating point values that are not exact integers are accepted or not. The default is 0, which allows truncation of floating point value to the parameter's type. In the task template this is defined with the "test_exact" key.
TEST_OVERFLOW
A boolean value that indicates whether out of range values will generate an error or wrap around the integer range. The default is 1, for out of range values to generate an error. In the task template this is defined with the "test_overflow" key.
TYPE
In the task template when "type" key is defined as LONG64, the IDLParameterLong64 is created and populated with the key/value pairs defined in the template. The TYPE property returned is LONG64.
VALUE
The current value of the parameter. The parameter's VALUE can be set at any time through IDLTask using "." dot notation using the NAME of the parameter, or directly on the parameter object.
IDLParameterLong64::Dehydrate
The Dehydrate function method transforms the current parameter instance into a Hash containing keys to describe each of its properties. Any property that must conform to the TYPE property will be itself dehydrated by the IDLDehydrate function to ensure they are reduced to primitive form. The return value can be passed into the Hydrate function to clone the parameter instance, or it can be serialized for storage or transmission.
Syntax
Result = IDLParameterLong64.Dehydrate([ERROR=error])
Return Value
A Hash comprised of IDL primitive values that describes this parameter and all its properties.
Keywords
ERROR
Set this keyword to a named variable that will contain any error message issued during execution. If no error occurs, the ERROR variable will be set to an empty string ('').
When this keyword is not set and an error occurs, the function returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine.
IDLParameterLong64::Hydrate
The Hydrate static function method takes in a Hash of IDL primitive values and builds a new instance of this parameter class using all the dehydrated properties. It expects all property values to be properly dehydrated. This allows you to dehydrate a parameter and store the primitives, then restore it in a later IDL session.
Syntax
Result = IDLParameterLong64.Hydrate( dehydratedForm [, ERROR=error])
Return Value
The result is a reference to a new instance of this parameter class.
Arguments
dehydratedForm
The Hash of IDL primitive values describing all of this parameter's properties in dehydrated form, to be transformed into a new instance of this parameter class.
Keywords
ERROR
Set this keyword to a named variable that will contain any error message issued during execution. If no error occurs, the ERROR variable will be set to an empty string ('').
When this keyword is not set and an error occurs, the function returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine.
IDLParameterLong64::Validate
This Validate function method returns a Boolean value that indicates whether the Value passed to it is valid for the parameter. If the Value is invalid, then 0 is returned and the ERROR keyword will be populated with information on why the Value is invalid. This method allows the user to test the Value before setting the parameter’s Value and generating an error that must be handled by the user routine.
Syntax
Result = IDLParameterLong64.Validate( value [, ERROR=error])
Return Value
The result is a Boolean value indicating if the Value is valid for the parameter.
Arguments
Value
The value to test for validity. On successful return this argument will be typecast to the parameter's TYPE.
Keywords
ERROR
Set this keyword to a named variable that will contain any error message issued during execution. If no error occurs, the ERROR variable will be set to an empty string ('').
When this keyword is not set and an error occurs, the function returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine.
Version History