The result of a query.

A result object is read-only and is thread-safe to read or iterate over concurrently.

Functions

void

cass_result_free

( result )

Frees a result instance.

This method invalidates all values, rows, and iterators that were derived from this result.

Parameters:
Name Type Details
in result
cass_size_t

cass_result_row_count

( result )

Gets the number of rows for the specified result.

Parameters:
Name Type Details
in result
Returns:
Type Details
cass_size_t

The number of rows in the result.

cass_size_t

cass_result_column_count

( result )

Gets the number of columns per row for the specified result.

Parameters:
Name Type Details
in result
Returns:
Type Details
cass_size_t

The number of columns per row in the result.

CassString

cass_result_column_name

( result, index )

Gets the column name at index for the specified result.

Parameters:
Name Type Details
in result
in index
Returns:
Type Details
CassString

The column name at the specified index. Empty string is returned if the index is out of bounds.

CassValueType

cass_result_column_type

( result, index )

Gets the column type at index for the specified result.

Parameters:
Name Type Details
in result
in index
Returns:
Type Details
CassValueType

The column type at the specified index. CASS_VALUE_TYPE_UNKNOWN is returned if the index is out of bounds.

const CassRow *

cass_result_first_row

( result )

Gets the first row of the result.

Parameters:
Name Type Details
in result
Returns:
Type Details
const CassRow *

The first row of the result. NULL if there are no rows.

cass_bool_t

cass_result_has_more_pages

( result )

Returns true if there are more pages.

Parameters:
Name Type Details
in result
Returns:
Type Details
cass_bool_t

cass_true if there are more pages

CassIterator *

cass_iterator_from_result

( result )

Creates a new iterator for the specified result. This can be used to iterate over rows in the result.

Parameters:
Name Type Details
in result
Returns:
Type Details
CassIterator *

A new iterator that must be freed.

See Also: