Query Result Row

Query Result Row — Result row in a query result set containing a set of literals that are bound to variables.

Synopsis

typedef             rasqal_row;
rasqal_row *        rasqal_new_row_for_size             (rasqal_world *world,
                                                         int size);
void                rasqal_free_row                     (rasqal_row *row);
int                 rasqal_row_set_value_at             (rasqal_row *row,
                                                         int offset,
                                                         rasqal_literal *value);

Description

An ordered row of rasqal_literal values that are each bound to rasqal_variable defined in an associated rasqal_variables table inside a rasqal_query_results query result set.

Details

rasqal_row

typedef struct rasqal_row_s rasqal_row;

Rasqal Result Row class.


rasqal_new_row_for_size ()

rasqal_row *        rasqal_new_row_for_size             (rasqal_world *world,
                                                         int size);

Constructor - Create a new query result row of a given size

world :

rasqal_world

size :

width of row

Returns :

a new query result row or NULL on failure

rasqal_free_row ()

void                rasqal_free_row                     (rasqal_row *row);

Destructor - Free a query result row object.

row :

query result row

rasqal_row_set_value_at ()

int                 rasqal_row_set_value_at             (rasqal_row *row,
                                                         int offset,
                                                         rasqal_literal *value);

Set the value of a variable in a query result row

Any existing row value is freed and the literal value passed in is copied.

row :

query result row

offset :

offset into row (column number)

value :

literal value to set

Returns :

non-0 on failure