A error result of a request

Functions

void

cass_error_result_free

( const CassErrorResult * error_result )

Frees an error result instance.

Parameters:
Name Type Details
in error_result const CassErrorResult *
CassError

cass_error_result_code

( const CassErrorResult * error_result )

Gets error code for the error result. This error code will always have an server error source.

Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
CassError

The server error code

CassConsistency

cass_error_result_consistency

( const CassErrorResult * error_result )

Gets consistency that triggered the error result of the following types:

  • CASS_ERROR_SERVER_READ_TIMEOUT
  • CASS_ERROR_SERVER_WRITE_TIMEOUT
  • CASS_ERROR_SERVER_READ_FAILURE
  • CASS_ERROR_SERVER_WRITE_FAILURE
  • CASS_ERROR_SERVER_UNAVAILABLE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
CassConsistency

The consistency that triggered the error for a read timeout, write timeout or an unavailable error result. Undefined for other error result types.

cass_int32_t

cass_error_result_responses_received

( const CassErrorResult * error_result )

Gets the actual number of received responses, received acknowledgments or alive nodes for following error result types, respectively:

  • CASS_ERROR_SERVER_READ_TIMEOUT
  • CASS_ERROR_SERVER_WRITE_TIMEOUT
  • CASS_ERROR_SERVER_READ_FAILURE
  • CASS_ERROR_SERVER_WRITE_FAILURE
  • CASS_ERROR_SERVER_UNAVAILABLE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
cass_int32_t

The actual received responses for a read timeout, actual received acknowledgments for a write timeout or actual alive nodes for a unavailable error. Undefined for other error result types.

cass_int32_t

cass_error_result_responses_required

( const CassErrorResult * error_result )

Gets required responses, required acknowledgments or required alive nodes needed to successfully complete the request for following error result types, respectively:

  • CASS_ERROR_SERVER_READ_TIMEOUT
  • CASS_ERROR_SERVER_WRITE_TIMEOUT
  • CASS_ERROR_SERVER_READ_FAILURE
  • CASS_ERROR_SERVER_WRITE_FAILURE
  • CASS_ERROR_SERVER_UNAVAILABLE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
cass_int32_t

The required responses for a read time, required acknowledgments for a write timeout or required alive nodes for an unavailable error result. Undefined for other error result types.

cass_int32_t

cass_error_result_num_failures

( const CassErrorResult * error_result )

Gets the number of nodes that experienced failures for the following error types:

  • CASS_ERROR_SERVER_READ_FAILURE
  • CASS_ERROR_SERVER_WRITE_FAILURE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
cass_int32_t

The number of nodes that failed during a read or write request.

cass_bool_t

cass_error_result_data_present

( const CassErrorResult * error_result )

Determines whether the actual data was present in the responses from the replicas for the following error result types:

  • CASS_ERROR_SERVER_READ_TIMEOUT
  • CASS_ERROR_SERVER_READ_FAILURE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
cass_bool_t

cass_true if the data was present in the received responses when the read timeout occurred. Undefined for other error result types.

CassWriteType

cass_error_result_write_type

( const CassErrorResult * error_result )

Gets the write type of a request for the following error result types:

  • CASS_ERROR_SERVER_WRITE_TIMEOUT
  • CASS_ERROR_SERVER_WRITE_FAILURE
Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
CassWriteType

The type of the write that timed out. Undefined for other error result types.

CassError

cass_error_result_keyspace

( const CassErrorResult * error_result, const char ** keyspace, size_t * keyspace_length )

Gets the affected keyspace for the following error result types:

  • CASS_ERROR_SERVER_ALREADY_EXISTS
  • CASS_ERROR_SERVER_FUNCTION_FAILURE
Parameters:
Name Type Details
in error_result const CassErrorResult *
out keyspace const char **
out keyspace_length size_t *
Returns:
Type Details
CassError

CASS_OK if successful, otherwise error occurred

CassError

cass_error_result_table

( const CassErrorResult * error_result, const char ** table, size_t * table_length )

Gets the affected table for the already exists error (CASS_ERROR_SERVER_ALREADY_EXISTS) result type.

Parameters:
Name Type Details
in error_result const CassErrorResult *
out table const char **
out table_length size_t *
Returns:
Type Details
CassError

CASS_OK if successful, otherwise error occurred

CassError

cass_error_result_function

( const CassErrorResult * error_result, const char ** function, size_t * function_length )

Gets the affected function for the function failure error (CASS_ERROR_SERVER_FUNCTION_FAILURE) result type.

Requires Apache Cassandra: 2.2+

Parameters:
Name Type Details
in error_result const CassErrorResult *
out function const char **
out function_length size_t *
Returns:
Type Details
CassError

CASS_OK if successful, otherwise error occurred

size_t

cass_error_num_arg_types

( const CassErrorResult * error_result )

Gets the number of argument types for the function failure error (CASS_ERROR_SERVER_FUNCTION_FAILURE) result type.

Requires Apache Cassandra: 2.2+

Parameters:
Name Type Details
in error_result const CassErrorResult *
Returns:
Type Details
size_t

The number of arguments for the affected function.

CassError

cass_error_result_arg_type

( const CassErrorResult * error_result, size_t index, const char ** arg_type, size_t * arg_type_length )

Gets the argument type at the specified index for the function failure error (CASS_ERROR_SERVER_FUNCTION_FAILURE) result type.

Requires Apache Cassandra: 2.2+

Parameters:
Name Type Details
in error_result const CassErrorResult *
in index size_t
out arg_type const char **
out arg_type_length size_t *
Returns:
Type Details
CassError

CASS_OK if successful, otherwise error occurred