RowFieldOutputFile Statement

Added: build 1

Purpose

Provides instructions on how to parse an output file. Treats the file as a collection of rows and fields.

Syntax

RowFieldOutputFile <name>
{
   <statements>
   ...
}

Arguments

Name	Description
*name*	This is an identifier for the RowFieldOutputFile. The identifier is used by parse statements in the RunCommands section. A variable with this name is also automatically created if autoVars is set to true. Note that this name does not need to be the same as the file name specified in the fileToParse statement.

Applicable Statements

The following statements are valid within a RowFieldOutputFile section.

Notes:

Each RowFieldOutputFile must define a fileToParse.
The setDelimiters and setGroup statements only apply to variables and arrays defined after the associated statement. These statements may also be issued multiple times.
The markAsBeginning and markAsEnd statements are cumulative. That is, a markAsBeginning statement will start searching for the new beginning line starting with the previous beginning line. To start the search from the beginning of the file, first use the clearMarks statement.

Example

If you need to parse an output file named "out.dat" that has the following structure...

var1 = 5
var2 = 6
var3 = 7

...then the following RowFieldOutputFile could be used to read the file.

RowFieldOutputFile outFile
{
   fileToParse: out.data

   setDelimiters " ="

   #         name  type     row  field
   variable: var1  integer  1    2
   variable: var2  integer  2    2
   variable: var3  integer  3    2
}