Menu

CassCollection

struct CassCollection

A collection of values.

Public Functions

CassCollection *cass_collection_new(CassCollectionType type, size_t item_count)

Creates a new collection.

Return

Returns a collection that must be freed.

See

cass_collection_free()

Parameters
  • type:

  • item_count: The approximate number of items in the collection.

CassCollection *cass_collection_new_from_data_type(const CassDataType *data_type, size_t item_count)

Creates a new collection from an existing data type.

Return

Returns a collection that must be freed.

See

cass_collection_free();

Parameters
  • data_type:

  • item_count: The approximate number of items in the collection.

void cass_collection_free(CassCollection *collection)

Frees a collection instance.

Parameters
  • collection:

CassError cass_collection_append_int8(CassCollection *collection, cass_int8_t value)

Appends a “tinyint” to the collection.

Requires Apache Cassandra: 2.2+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_int16(CassCollection *collection, cass_int16_t value)

Appends an “smallint” to the collection.

Requires Apache Cassandra: 2.2+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_int32(CassCollection *collection, cass_int32_t value)

Appends an “int” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_uint32(CassCollection *collection, cass_uint32_t value)

Appends a “date” to the collection.

Requires Apache Cassandra: 2.2+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_int64(CassCollection *collection, cass_int64_t value)

Appends a “bigint”, “counter”, “timestamp” or “time” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_float(CassCollection *collection, cass_float_t value)

Appends a “float” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_double(CassCollection *collection, cass_double_t value)

Appends a “double” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_bool(CassCollection *collection, cass_bool_t value)

Appends a “boolean” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_string(CassCollection *collection, const char *value)

Appends an “ascii”, “text” or “varchar” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value: The value is copied into the collection object; the memory pointed to by this parameter can be freed after this call.

CassError cass_collection_append_string_n(CassCollection *collection, const char *value, size_t value_length)

Same as cass_collection_append_string(), but with lengths for string parameters.

Return

same as cass_collection_append_string()

See

cass_collection_append_string();

Parameters
  • collection:

  • value:

  • value_length:

CassError cass_collection_append_bytes(CassCollection *collection, const cass_byte_t *value, size_t value_size)

Appends a “blob”, “varint” or “custom” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value: The value is copied into the collection object; the memory pointed to by this parameter can be freed after this call.

  • value_size:

CassError cass_collection_append_custom(CassCollection *collection, const char *class_name, const cass_byte_t *value, size_t value_size)

Appends a “custom” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • class_name:

  • value: The value is copied into the collection object; the memory pointed to by this parameter can be freed after this call.

  • value_size:

CassError cass_collection_append_custom_n(CassCollection *collection, const char *class_name, size_t class_name_length, const cass_byte_t *value, size_t value_size)

Same as cass_collection_append_custom(), but with lengths for string parameters.

Return

same as cass_collection_append_custom()

See

cass_collection_append_custom()

Parameters
  • collection:

  • class_name:

  • class_name_length:

  • value:

  • value_size:

CassError cass_collection_append_uuid(CassCollection *collection, CassUuid value)

Appends a “uuid” or “timeuuid” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_inet(CassCollection *collection, CassInet value)

Appends an “inet” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_decimal(CassCollection *collection, const cass_byte_t *varint, size_t varint_size, cass_int32_t scale)

Appends a “decimal” to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • varint: The value is copied into the collection object; the memory pointed to by this parameter can be freed after this call.

  • varint_size:

  • scale:

CassError cass_collection_append_duration(CassCollection *collection, cass_int32_t months, cass_int32_t days, cass_int64_t nanos)

Appends a “duration” to the collection.

Requires Apache Cassandra: 3.10+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • months:

  • days:

  • nanos:

CassError cass_collection_append_collection(CassCollection *collection, const CassCollection *value)

Appends a “list”, “map” or “set” to the collection.

Requires Apache Cassandra: 2.1+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_tuple(CassCollection *collection, const CassTuple *value)

Appends a “tuple” to the collection.

Requires Apache Cassandra: 2.1+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_user_type(CassCollection *collection, const CassUserType *value)

Appends a “udt” to the collection.

Requires Apache Cassandra: 2.1+

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • value:

CassError cass_collection_append_dse_point(CassCollection *collection, cass_double_t x, cass_double_t y)

Appends a point to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • x:

  • y:

CassError cass_collection_append_dse_line_string(CassCollection *collection, const DseLineString *line_string)

Appends a line string to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • line_string:

CassError cass_collection_append_dse_polygon(CassCollection *collection, const DsePolygon *polygon)

Appends a polygon to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • polygon:

CassError cass_collection_append_dse_date_range(CassCollection *collection, const DseDateRange *range)

Appends a DateRange to the collection.

Return

CASS_OK if successful, otherwise an error occurred.

Parameters
  • collection:

  • range: