A collection of primitive values.

Functions

CassCollection *

cass_collection_new

( CassCollectionType type, cass_size_t item_count )

Creates a new collection.

Parameters:
Name Type Details
in type CassCollectionType
in item_count cass_size_t

The approximate number of items in the collection.

Returns:
Type Details
CassCollection *

Returns a collection that must be freed.

See Also:
void

cass_collection_free

( CassCollection * collection )

Frees a collection instance.

Parameters:
Name Type Details
in collection CassCollection *
CassError

cass_collection_append_int32

( CassCollection * collection, cass_int32_t value )

Appends an “int” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value cass_int32_t
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_int64

( CassCollection * collection, cass_int64_t value )

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

Parameters:
Name Type Details
in collection CassCollection *
in value cass_int64_t
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_float

( CassCollection * collection, cass_float_t value )

Appends a “float” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value cass_float_t
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_double

( CassCollection * collection, cass_double_t value )

Appends a “double” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value cass_double_t
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_bool

( CassCollection * collection, cass_bool_t value )

Appends a “boolean” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value cass_bool_t
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_string

( CassCollection * collection, CassString value )

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

Parameters:
Name Type Details
in collection CassCollection *
in value CassString

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

Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_bytes

( CassCollection * collection, CassBytes value )

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

Parameters:
Name Type Details
in collection CassCollection *
in value CassBytes

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

Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_uuid

( CassCollection * collection, CassUuid value )

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

Parameters:
Name Type Details
in collection CassCollection *
in value CassUuid
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_inet

( CassCollection * collection, CassInet value )

Appends an “inet” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value CassInet
Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.

CassError

cass_collection_append_decimal

( CassCollection * collection, CassDecimal value )

Appends a “decimal” to the collection.

Parameters:
Name Type Details
in collection CassCollection *
in value CassDecimal

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

Returns:
Type Details
CassError

CASS_OK if successful, otherwise an error occurred.