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

READ_T_O_NEXT_BLOCK

Moves to the next block in the currently open TeimOrbit file. Returns a string with the block type, or a null string if there is no next block in the file.

Format

READ_T_O_NEXT_BLOCK ()

Prerequisites

READ_T_O_OPEN_FILE (Filename)

Arguments

None

Examples

[The following assumes this file has already been opened (“<acar_shared>/driver_controls.tbl/constant_radius_cornering.dcf”), and the previous read was in the “EXPERIMENT” block] 
 
Function
READ_T_O_NEXT_BLOCK()
Result
“STEADY_STATE”
If the function was issued again, a null string would be returned, since “STEADY_STATE” is the last block in the file:
 
Function
READ_T_O_NEXT_BLOCK()
Result
“”
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.