PCL and Customization > Broken, Obsolete, Modified and New Functions > System and Utility Functions (Chapter 4)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
System and Utility Functions (Chapter 4)
 
Issue:Inadequate function description.
Resolution:Modified function description.
Type:Modified.
 
Original Description Information:
sys_class_get
( class_name, varname )
Description:
 
 
Retrieve the contents of a variable from a specified class.
Input:
 
 
STRING
classname
Class name specified as a string.
STRING
varname
Variable name specified as a string.
Output:
 
 
LOGICAL
<Return Value>
True if hash table found; FALSE otherwise.
Error Conditions:
 
None.
 
 
New Description Information:
sys_class_get
( class_name, )
Description:
 
 
This function will return the value of a classwide variable from a class of PCL functions.
Input:
 
 
STRING
class_name[32]
This value specifies the name of the PCL function class from which the variable value will be retrieved.
STRING
variable_name[32]
This value specifies the name of the variable which will have its value retrieved.
Output:
 
 
DYNAMIC_ILRSW
<Return Value>
This function returns the value from the specified variable which is a member of the specified class.
Error Conditions:
 
None.
 
Remarks:
This function assumes that the caller already knows the data type of the variable whose contents will be returned.
Example:
None.
 
Issue:Argument list changed.
Resolution:Updated the function listing in the body of the document.
Type:Modified.
 
Original Description Information:
sys_eval
( string )
Description:
 
 
Compile and execute PCL expression contained in a string.
Input:
 
 
STRING
string
PCL expression contained in the string. The expression is evaluated under global context, therefore it can not make use of local variables.
Output:
 
 
STRING
tablename
Name of a system hash table.
ANY
<Return Value>
Result of the evaluation of the PCL expression. Datatype depends on the contents of the string expression.
 
New Description Information:
sys_eval
( pcl_expression )
Description:
 
 
This function will execute a PCL expression contained in a string.
Input:
 
 
STRING
pcl_expression
This value provides the PCL expression that will be evaluated. This expression is evaluated in a global context where it will be assumed that any variables in the PCL expression will have a global scope. This global context prevents the use of any local variables in the PCL expression.
Output:
 
 
DYNAMIC
<Return Value>
This function will return the results of the evaluated PCL expression. The type of the data returned will be defined by the evaluated PCL expression.
Error Conditions:
 
None.