# lr.advance_param

Advances to the next available parameter value.

    int lr.advance_param( String parameter );

String and Parameter Functions | Java Syntax

## Arguments

Name | Comments
--- | ---
param | The name of the parameter in quotes (no brackets).

The lr.advance_param function causes the script to use the next available value of the parameter. If you are running multiple iterations, you can specify in the parameter properties to advance automatically to the next value for each iteration. Use this function within an iteration to advance to the next value.

The effect on other parameters in the same data file depends on the settings in the Vuser parameter list dialog.

This function is not recorded—you insert it manually into your script.

## Return Values

This function returns 0 on success and -1 on failure.

## Parameterization

Parameterization is not applicable to this function.

## Example

In the following example, Stock is a parameter defined in the Parameter list. The lr.advance_param function advances to the next value in the parameter file.

lr.output_message("Track Stock: " + lr.eval_string("<STOCK>")); for(int i=0; i<3; i++) { int j = lr.advance_param("STOCK"); lr.output_message("Track Stock: " + lr.eval_string("<STOCK>")); }

    The Stock.dat file has the following values:
        STOCK
        MERQ
        IBM
        MSFT

    Output:
        Track Stock: MERQ
        Track Stock: IBM
        Track Stock: MSFT