Deprecated. Use lrvtc_rotate_row. Retrieves the first row and moves the values to the bottom.

C Language

vtc_rotate_row ( PVCI2 pvci, char **outValues,  unsigned char sendflag );

C# Language

bool vts_multi.rotate_row ( int pvci,  string [] outValues, string sendflag );

Java Language

int Vtc.rotate_row ( int pvci, OutArrOfStrParameter outcolumns, OutArrOfStrParameter outvalues, int sendFlag );

Query Functions


name Comments
pvci The server connection handle.
outValues Pointer to a string to store retrieved values.
sendflag Specify how the values are added back to bottom. One of:
  • VTSEND_SAME_ROW - Send all the data to the same row.
  • VTSEND_STACKED - The data is sent to available fields at the bottom of each column.
  • VTSEND_STACKED_UNIQUE - If the value of the first field already exists elsewhere in the column, the top field is retrieved and then discarded. Otherwise, data is sent to an available field at the bottom of the column.

vtc_rotate_row retrieves the data in the first row and stores them in parameters with the same name as the columns. The data is removed from the first row and moved to the bottom of the columns as specified by the unsigned char sendflag.

If there is no data in a cell, the output is NULL.

Return Values

Returns zero on success or one of the Error Codes.


All string input arguments can be passed using standard parameterization.

C Language Example

   vtc_rotate_row( pvci, &outColumns, &outValues, VTSEND_STACKED_UNIQUE);
    for(index=0; outColumns[index]; ++index){
        lr_log_message("%s : %s", outColumns[index], outValues[index]);    

C# Language Example

.Net Multiple Connection Example

Java Language Example

Java Multi-Connection Example