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.
