A statement that has been prepared cluster-side (It has been pre-parsed and cached).

A prepared statement is read-only and it is thread-safe to concurrently bind new statements.

Functions

void

cass_prepared_free

( const CassPrepared * prepared )

Frees a prepared instance.

Parameters:
Name Type Details
in prepared const CassPrepared *
CassStatement *

cass_prepared_bind

( const CassPrepared * prepared )

Creates a bound statement from a pre-prepared statement.

Parameters:
Name Type Details
in prepared const CassPrepared *
Returns:
Type Details
CassStatement *

Returns a bound statement that must be freed.

See Also:
CassError

cass_prepared_parameter_name

( const CassPrepared * prepared, size_t index, const char ** name, size_t * name_length )

Gets the name of a parameter at the specified index.

Parameters:
Name Type Details
in prepared const CassPrepared *
in index size_t
out name const char **
out name_length size_t *
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

const CassDataType *

cass_prepared_parameter_data_type

( const CassPrepared * prepared, size_t index )

Gets the data type of a parameter at the specified index.

Parameters:
Name Type Details
in prepared const CassPrepared *
in index size_t
Returns:
Type Details
const CassDataType *

Returns a reference to the data type of the parameter. Do not free this reference as it is bound to the lifetime of the prepared.

const CassDataType *

cass_prepared_parameter_data_type_by_name

( const CassPrepared * prepared, const char * name )

Gets the data type of a parameter for the specified name.

Parameters:
Name Type Details
in prepared const CassPrepared *
in name const char *
Returns:
Type Details
const CassDataType *

Returns a reference to the data type of the parameter. Do not free this reference as it is bound to the lifetime of the prepared.

const CassDataType *

cass_prepared_parameter_data_type_by_name_n

( const CassPrepared * prepared, const char * name, size_t name_length )

Same as CassPrepared::cass_prepared_parameter_data_type_by_name, but with lengths for string parameters.

Parameters:
Name Type Details
in prepared const CassPrepared *
in name const char *
in name_length size_t
Returns:
Type Details
const CassDataType *

Returns a reference to the data type of the parameter. Do not free this reference as it is bound to the lifetime of the prepared.

See Also: