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

READ_T_O_FIND_BLOCK

Searches the currently open TeimOrbit file for a named block, which can then be further processed. Returns 1 on success and 0 if any errors occur.

Format

READ_T_O_FIND_BLOCK (Block Name)

Prerequisites

READ_T_O_OPEN_FILE (Filename)

Arguments

 
Block Name
Name of block to find in TeimOrbit file. In the TO file, a block is a string separated by brackets, for example, [MDI_HEADER]. Not case sensitive.

Examples

[The following assumes this file has already been opened (“<acar_shared>/springs.tbl/mdi_0001.spr”)]
 
Function
READ_T_O_FIND_BLOCK (“SPRING_DATA”)
Result
1
 
Function
READ_T_O_FIND_BLOCK (“FREE_LENGTH”)
Result
0
This call will fail because the subblock “FREE_LENGTH” is not a block.
 
Important:  
Filenames are case sensitive and parameters are not case sensitive.