Share this page

# lrvtc_search_row

Searches for a row containing specific values in specific columns.

If more than one row meets the condition, the data from only one random row is returned.

## C Language

    VTCERR2 lrvtc_search_row ( char* columns, char* values, char* delimiter )

## C# Language

    void vts.search_row ( string columns, string values, string delimiter )

## Java Language

    int Lrvtc.search_row ( string columns, string values, string delimiter )

Query Functions

## Arguments

Name | Comments
--- | ---
columns | The names of the columns to search. The column names are separated by the delimiter.
values | The values of the columns to search. The values are separated by the delimiter.
delimiter | The character that separates the column names and values in the lists. If a string, rather than a single character, is passed in delimiter, the string as a whole is the delimiter.

## Return Values

Protocol | Return Value
--- | ---
C Language | 0: If API call was successful but row not found. 1: If API call was successful and row found. On call failure, one of the Error Codes.
C# Language | No return value.
Java Language | 0: If API call was successful but row not found. 1: If API call was successful and row found. On call failure, one of the Error Codes.

## C Language Example

    int rc;
    ...
    rc = lrvtc_search_row("Column1;Column3", "val1;val3", ";");
    if(rc == 1)
            lr_output_message("a row found");
    #The found row data will be saved in parameters named by Column names.

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