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 and Java languages | In version 26.1: 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. In version 26.3: 0: If API call was successful and the row is found. One of the Error Codes on call failure, or if the row is not found.
C# Language | No return value.

## C Language Example

Copy code

    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-26.3 Function Reference 26.1-26.3 All View Local Help Center View Online Help Center Version: