OperationResult

class aerospike_sdk.operation_result.OperationResult

Bases: object

Typed-accessor wrapper around a single value from a write or operate command.

The wrapped value can be any type the server returns: integer, float, string, bytes, list, map, GeoJSON, HLL, boolean, or None. Each get_* method coerces or rejects the underlying type explicitly so silent miscasts surface as TypeError rather than mysterious runtime failures elsewhere.

Numeric and boolean accessors return idiomatic defaults (0, 0.0, False) when the wrapped value is None, matching how other SDKs model an absent result for a write-then-read sequence on a bin that did not exist.

Example:

result = OperationResult(42)
result.get_int()       # 42
result.get_string()    # raises TypeError — value is int, not str
result.value           # 42 (raw)

See also

OperationResult.value(): Raw access without coercion.

__init__(value)

property value: Any

The raw underlying value, with no coercion.

get_int()

Return the value as an integer; 0 when the value is None.

Booleans are treated as integers per Python semantics (True → 1). The returned value is a full Python int — arbitrary precision, never truncated to a fixed width.

Return type:

int

Returns:

The wrapped integer, or 0 when the value is None.

Raises:

TypeError – When the wrapped value is neither int nor None.

Example:

result = record.typed_operation_result(0)
visits = result.get_int()

See also

get_float(): Floating-point accessor. value(): Raw access without coercion.

get_float()

Return the value as a float; 0.0 when the value is None.

Integers are widened to float for convenience; strings and other types raise. Python floats are double precision, so no narrowing occurs.

Return type:

float

Returns:

The wrapped value as a float, or 0.0 when the value is None.

Raises:

TypeError – When the wrapped value is neither numeric nor None.

Example:

result = record.typed_operation_result(0)
balance = result.get_float()

See also

get_int(): Integer accessor. value(): Raw access without coercion.

get_bool()

Return the value as a boolean; False when the value is None.

Accepts both native booleans and integers so values written by older clients (which encoded booleans as longs) still decode correctly.

Raises:

TypeError – When the wrapped value is not a bool, int, or None.

Return type:

bool

get_string()

Return the value as str; None is propagated.

Raises:

TypeError – When the wrapped value is non-None and not a string.

Return type:

str | None

get_bytes()

Return the value as bytes; None is propagated.

Bytearrays are accepted and converted; other types raise.

Return type:

bytes | None

get_list()

Return the value as list; None is propagated.

Raises:

TypeError – When the wrapped value is non-None and not a list.

Return type:

list[Any] | None

get_map()

Return the value as dict; None is propagated.

Raises:

TypeError – When the wrapped value is non-None and not a dict.

Return type:

dict[Any, Any] | None