DseLineStringIterator¶

struct DseLineStringIterator¶

Public Functions

DseLineStringIterator *dse_line_string_iterator_new()¶

Creates a new line string iterator.

See also

dse_line_string_iterator_free()

Returns:

Returns an iterator that must be freed.

void dse_line_string_iterator_free(DseLineStringIterator *iterator)¶

Frees a line string iterator instance.

Parameters:

iterator – [in]

CassError dse_line_string_iterator_reset(DseLineStringIterator *iterator, const CassValue *value)¶

Resets a line string iterator so that it can be reused to process a binary representation.

Parameters:

• iterator – [in] the iterator to reset

• value – [in] binary representation of the line string

Returns:

CASS_OK if successful, otherwise an error occurred.

CassError dse_line_string_iterator_reset_with_wkt(DseLineStringIterator *iterator, const char *wkt)¶

Resets a line string iterator so that it can be reused to parse WKT.

Note

The wkt string must remain allocated throughout the lifetime of the iterator since the iterator traverses the string without copying it.

Parameters:

• iterator – [in] the iterator to reset

• wkt – [in] WKT representation of the line string

Returns:

CASS_OK if successful, otherwise an error occurred.

CassError dse_line_string_iterator_reset_with_wkt_n(DseLineStringIterator *iterator, const char *wkt, size_t wkt_length)¶

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

Note

The wkt string must remain allocated throughout the lifetime of the iterator since the iterator traverses the string without copying it.

Parameters:

• iterator – [in] the iterator to reset

• wkt – [in] WKT representation (string) of the line string

• wkt_length – [in] length of wkt string

Returns:

CASS_OK if successful, otherwise an error occurred.

cass_uint32_t dse_line_string_iterator_num_points(const DseLineStringIterator *iterator)¶

Gets the number of points in the line string.

Parameters:

iterator – [in]

Returns:

The number of points in the line string.

CassError dse_line_string_iterator_next_point(DseLineStringIterator *iterator, cass_double_t *x, cass_double_t *y)¶

Gets the next point in the line string.

Parameters:

• iterator – [in]

• x – [out]

• y – [out]

Returns:

CASS_OK if successful, otherwise an error occurred.