Share this page

# lr.next_row

Advances to the next row in the parameter data file.

## C#

    int lr.next_row( string dat_file );

## VB.NET

    Function lr.next_row( ByVal dat_file As String ) as Integer

String and Parameter Functions

## Arguments

Name | Comments
--- | ---
dat_file | The name of the parameter .dat file containing the values you want to retrieve.

The lr.next_row function sets the active row to be the next available row in the specified parameters file. If the current row is the last, lr_next_row sets the active row to the first row.

Use this function within an iteration, to advance to the next set of values. If you want the active row to advance at the beginning of each iteration, you do not need this function: In the parameter properties, you can specify to advance to the next row for each iteration.

This function is most useful with `Table` parameters. If you specify more than one parameter in a file, lr.next_row advances the values for all the parameters. This is the natural way to advance `Table` rows.

To advance only one parameter in a file, use lr.advance_param with Select next row set to sequential in the parameter properties.

Note that the dat file name is by default the name of a parameter, unless you specified a different name for the file when you defined the parameter. For example, the dat file for the IDs parameter, is IDs.dat.

## Return Values

This function always returns zero.

## Parameterization

You cannot use standard parameterization for any arguments in this function.

## Example

In the following example, the lr.next_row function advances to the next row in order to retrieve the next Stock Trader ID.

Copy code

    lr.message( "Connect to Stock Trader ID Number " + lr.eval_string("{ID}") );
    lr.next_row("ID.dat");
    lr.message( "Connect to Stock Trader ID Number " + lr.eval_string("{ID}") );
    return 0;
    }

Tips to improve your search results... VuGen Function Reference Version 26.1-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: