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

READ_T_O_SUBBLOCK_STRING

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

Format

READ_T_O_SUBBLOCK_STRING (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 string 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_STRING (“STEADY_STATE”, “STEERING”, “METHOD”)
Result
“MACHINE”
 
Function
READ_T_O_SUBBLOCK_STRING (“STEADY_STATE”, “GEAR”, “CONTROL_VALUE”)
Result
“”
This call will fail because “CONTROL_VALUE” is not a string.
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.