Struct BitmapManager 

pub struct BitmapManager { /* private fields */ }

Implementations

impl BitmapManager

pub async fn setbit(&self, key: &str, offset: usize, value: u8) -> Result<u8>

Set bit at offset to value (SETBIT)

Arguments

• key - Bitmap key
• offset - Bit offset (0-based)
• value - Bit value (0 or 1)

Returns

Previous bit value (0 or 1)

pub async fn getbit(&self, key: &str, offset: usize) -> Result<u8>

Get bit at offset (GETBIT)

Arguments

• key - Bitmap key
• offset - Bit offset (0-based)

Returns

Bit value (0 or 1)

pub async fn bitcount( &self, key: &str, start: Option<usize>, end: Option<usize>, ) -> Result<usize>

Count set bits in bitmap (BITCOUNT)

Arguments

• key - Bitmap key
• start - Optional start offset (inclusive)
• end - Optional end offset (inclusive)

Returns

Number of set bits

pub async fn bitpos( &self, key: &str, value: u8, start: Option<usize>, end: Option<usize>, ) -> Result<Option<usize>>

Find first bit set to value (BITPOS)

Arguments

• key - Bitmap key
• value - Bit value to search for (0 or 1)
• start - Optional start offset (inclusive)
• end - Optional end offset (inclusive)

Returns

Position of first matching bit, or None if not found

pub async fn bitop<S>( &self, operation: BitmapOperation, destination: &str, source_keys: &[S], ) -> Result<usize>

where S: AsRef<str>,

Perform bitwise operation on multiple bitmaps (BITOP)

Arguments

• operation - Bitwise operation (AND, OR, XOR, NOT)
• destination - Destination key for result
• source_keys - Source bitmap keys (NOT requires exactly 1 source)

Returns

Length of resulting bitmap in bits

Errors

Returns an error if:

• NOT operation is used with more than one source key
• No source keys provided

pub async fn bitfield( &self, key: &str, operations: &[Value], ) -> Result<Vec<i64>>

Execute bitfield operations (BITFIELD)

Arguments

• key - Bitmap key
• operations - Vector of bitfield operations

Returns

Vector of result values (one per operation)

Example

use synap_sdk::bitmap::BitmapManager;
use serde_json::json;

let operations = vec![
    json!({
        "operation": "SET",
        "offset": 0,
        "width": 8,
        "signed": false,
        "value": 42
    }),
    json!({
        "operation": "GET",
        "offset": 0,
        "width": 8,
        "signed": false
    }),
    json!({
        "operation": "INCRBY",
        "offset": 0,
        "width": 8,
        "signed": false,
        "increment": 10,
        "overflow": "WRAP"
    }),
];

let results = bitmap.bitfield("mybitmap", &operations).await?;

pub async fn stats(&self) -> Result<BitmapStats>

Retrieve bitmap statistics

Trait Implementations

impl Clone for BitmapManager

fn clone(&self) -> BitmapManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.