BITOP

The BITOP command in Redis is used to perform bitwise operations on multiple keys (or Redis strings) and store the result in a destination key. It supports standard logical operations (AND, OR, XOR, NOT) and advanced operations (DIFF, DIFF1, ANDOR, ONE) for complex bit manipulation.

Arguments

Response

# AND operationredis.setbit("key1", 0, 1)redis.setbit("key2", 0, 0)redis.setbit("key2", 1, 1)assert redis.bitop("AND", "dest", "key1", "key2") == 1# OR operationredis.bitop("OR", "dest", "key1", "key2")# XOR operationredis.bitop("XOR", "dest", "key1", "key2")# NOT operation (only accepts one source key)redis.bitop("NOT", "dest", "key1")

# Set bits in multiple bitmapsredis.setbit("bitmap1", 0, 1)redis.setbit("bitmap1", 1, 1)redis.setbit("bitmap2", 1, 1)redis.setbit("bitmap2", 2, 1)# DIFF: bits set in all sourcesresult = redis.bitop("DIFF", "result", "bitmap1", "bitmap2")# Result: bit 1 is set (only bit present in both)

# Set bits in bitmapsredis.setbit("exclude", 0, 1)redis.setbit("exclude", 1, 1)redis.setbit("include1", 1, 1)redis.setbit("include2", 2, 1)# DIFF1: bits in first key but not in othersresult = redis.bitop("DIFF1", "result", "exclude", "include1", "include2")# Result: bit 0 is set (only in exclude, not in include1 or include2)

# Set bits in bitmapsredis.setbit("required", 0, 1)redis.setbit("required", 1, 1)redis.setbit("option1", 1, 1)redis.setbit("option2", 2, 1)# ANDOR: bits in required AND in at least one optionresult = redis.bitop("ANDOR", "result", "required", "option1", "option2")# Result: bit 1 is set (in required AND in option1)

# Set bits in multiple sourcesredis.setbit("source1", 0, 1)redis.setbit("source1", 1, 1)redis.setbit("source2", 1, 1)redis.setbit("source2", 2, 1)redis.setbit("source3", 2, 1)# ONE: bits set in exactly one sourceresult = redis.bitop("ONE", "result", "source1", "source2", "source3")# Result: bit 0 is set (only in source1)

Advanced Operations Details (Redis 8.2+)

DIFF

A bit in the destination is set if it is set in all source bitmaps. This is equivalent to the intersection of all source bitmaps.

Use Cases:

• Finding common features across multiple datasets
• Identifying users present in all segments
• Intersection of multiple filters

DIFF1

A bit in the destination is set if it is set in the first key but not in any of the other keys. This finds bits unique to the first bitmap.

Use Cases:

• Finding exclusive features
• Identifying users in one segment but not in others
• Exclusion filtering

ANDOR

A bit in the destination is set if it is set in X and also in one or more of Y1, Y2, .... This implements "X AND (Y1 OR Y2 OR ...)" logic.

Use Cases:

• Required condition with optional alternatives
• Users with a required attribute and at least one optional attribute
• Complex filtering with mandatory and optional criteria

ONE

A bit in the destination is set if it is set in exactly one of the source keys. This finds bits that are unique to a single source.

Use Cases:

• Finding unique occurrences
• Identifying exclusive memberships
• Detecting singular conditions across multiple sets