BITFIELD_RO

对字符串执行任意只读位域整数操作。

语法

BITFIELD RO key [GET encoding offset [GET encoding offset ...]]

引入版本:6.0.0

复杂度摘要:O(1)

BITFIELD 命令的只读变体。它与原始 BITFIELD 类似,但仅接受 GET 子命令,并且可以安全地在只读副本中使用。

由于原始 BITFIELD 有 SET 和 INCRBY 选项,因此从技术上来说,它在 Redis 命令表中被标记为写入命令。因此,即使连接处于只读模式,Redis 集群中的只读副本也会将其重定向到主实例(请参阅 Redis 集群的 READONLY 命令)。

自 Redis 6.2 起,引入了 BITFIELD_RO 变体,以便在只读副本中允许 BITFIELD 行为,而不破坏命令标志的兼容性。

更多详情请参见原始BITFIELD。

必需参数

key

保存字符串的键的名称。

可选参数

GET encoding offset

返回 offset 处的值,用 encoding 解释(例如 u8 或 i16)。可以多次给予。

示例

BITFIELD_RO hello GET i8 16

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
✅ 标准
✅ 主动-主动
✅ 标准
✅ 主动-主动

返回值

RESP2

数组回复:每个条目是同一位置给出的子命令的相应结果。

RESP3

数组回复:每个条目是同一位置给出的子命令的相应结果。

资料来源:Redis 官方 BITFIELD_RO 文档;中文内容参考 Redis 文档许可。