Adams Basic Package > Adams View > View Function Builder > Design-Time Functions > Functions: R - S > READ_T_O_SUBBLOCK_REAL

READ_T_O_SUBBLOCK_REAL

Searches for a real number attribute contained in the specified block and subblock. Returns the real number value of the selected attribute, or 0 if the attribute is not found or other errors occur.

Format

READ_T_O_SUBBLOCK_REAL (Block Name, SubBlock Name, Attribute)

Prerequisites

READ_T_O_OPEN_FILE (Filename)

Arguments

 
Block Name
Name of block in which to search
SubBlock Name
Name of subblock within the specified block in which to search
Attribute
Name of attribute within the specified subblock to retrieve the real number value.

Examples

[The following assumes this file has already been opened (“<acar_shared>/driver_controls.tbl/constant_radius_cornering.dcf”).] 
 
Function
READ_T_O_SUBBLOCK_REAL(“STEADY_STATE”, “MACHINE_CONTROL”, “RADIUS”)
Result
80.0
 
Function
READ_T_O_SUBBLOCK_REAL(“STEADY_STATE”, “MACHINE_CONTROL”, “TURN_DIRECTION”)
Result
0.0
This call will fail because “TURN_DIRECTION” is not a real number.
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.