设置位
SETBIT key offset value
- 从以下位置开始可用：
- 2.2.0
- 时间复杂度：
- O（1）
- ACL 类别：
-
@write,@bitmap,@slow,
设置或清除存储在 key 处的字符串值中 offset 处的位。
该位根据值（可以是 0 或 1.
当 key 不存在时，将创建一个新的字符串值。 字符串被增大以确保它可以在 offset 处保持一点。 offset 参数必须大于或等于 0，并且更小 大于 2^32（这会将位图限制为 512MB）。 当 key 处的字符串增长时，添加的位设置为 0。
警告： 当设置最后一个可能的位（偏移量等于 2^32 -1）并且
存储在 key 中的字符串值尚不保存字符串值，或者保存
small 字符串值，Redis 需要分配所有可以
阻止服务器一段时间。
在 2010 MacBook Pro 上，设置位号 2^32 -1（512MB 分配）需要
~300 毫秒，设置位号 2^30 -1（128MB 分配）需要 ~80 毫秒，设置位
数字 2^28 -1（32MB 分配）需要 ~30 毫秒，设置位号 2^26 -1 （8MB
allocation） 需要 ~8 毫秒。
请注意，完成第一次分配后，对SETBIT为
同一键不会有分配开销。
例子
Pattern：访问整个位图
在某些情况下，您需要一次设置单个位图的所有位，例如
example 将其初始化为默认的非零值。可以做到
this 多次调用SETBIT命令，每个位需要
被设置。但是，作为优化，您可以使用单个SET命令设置
整个位图。
位图不是一种实际的数据类型，而是一组面向位的作
定义 String 类型（有关更多信息，请参阅 数据类型简介 页面的 Bitmaps 部分）。这意味着
bitmaps 可以与字符串命令一起使用，最重要的是与SET和GET.
由于 Redis 的字符串是二进制安全的，因此位图被简单地编码为字节 流。字符串的第一个字节对应于 位图、8..15 范围的第二个字节，依此类推。
例如，设置几个 bit 后，获取 bitmap 的 string 值 将如下所示：
> SETBIT bitmapsarestrings 2 1
> SETBIT bitmapsarestrings 3 1
> SETBIT bitmapsarestrings 5 1
> SETBIT bitmapsarestrings 10 1
> SETBIT bitmapsarestrings 11 1
> SETBIT bitmapsarestrings 14 1
> GET bitmapsarestrings
"42"
通过获取位图的字符串表示形式，客户端可以解析
response 的字节，方法是使用其
本机编程语言。对称地，也可以将整个
bitmap 中，通过在客户端中执行位到字节编码并调用SET替换为生成的字符串。
模式：设置多个位
SETBIT擅长设置单个位，并且可以在
需要设置多个位。要优化此作，您可以将
倍数SETBIT调用对 Variadic 的单个调用BITFIELD命令
以及使用u1.
例如，上面的示例可以替换为：
> BITFIELD bitsinabitmap SET u1 2 1 SET u1 3 1 SET u1 5 1 SET u1 10 1 SET u1 11 1 SET u1 14 1
高级模式：访问位图范围
也可以使用GETRANGE和SETRANGEstring 命令设置为
有效地访问位图中的位偏移范围。下面是一个示例
在惯用的 Redis Lua 脚本中实现，可以使用EVAL命令：
--[[
Sets a bitmap range
Bitmaps are stored as Strings in Redis. A range spans one or more bytes,
so we can call [`SETRANGE`](/commands/setrange/) when entire bytes need to be set instead of flipping
individual bits. Also, to avoid multiple internal memory allocations in
Redis, we traverse in reverse.
Expected input:
KEYS[1] - bitfield key
ARGV[1] - start offset (0-based, inclusive)
ARGV[2] - end offset (same, should be bigger than start, no error checking)
ARGV[3] - value (should be 0 or 1, no error checking)
]]--
-- A helper function to stringify a binary string to semi-binary format
local function tobits(str)
local r = ''
for i = 1, string.len(str) do
local c = string.byte(str, i)
local b = ' '
for j = 0, 7 do
b = tostring(bit.band(c, 1)) .. b
c = bit.rshift(c, 1)
end
r = r .. b
end
return r
end
-- Main
local k = KEYS[1]
local s, e, v = tonumber(ARGV[1]), tonumber(ARGV[2]), tonumber(ARGV[3])
-- First treat the dangling bits in the last byte
local ms, me = s % 8, (e + 1) % 8
if me > 0 then
local t = math.max(e - me + 1, s)
for i = e, t, -1 do
redis.call('SETBIT', k, i, v)
end
e = t
end
-- Then the danglings in the first byte
if ms > 0 then
local t = math.min(s - ms + 7, e)
for i = s, t, 1 do
redis.call('SETBIT', k, i, v)
end
s = t + 1
end
-- Set a range accordingly, if at all
local rs, re = s / 8, (e + 1) / 8
local rl = re - rs
if rl > 0 then
local b = '\255'
if 0 == v then
b = '\0'
end
redis.call('SETRANGE', k, rs, string.rep(b, rl))
end
注意：从位图获取一系列位偏移量的实现是 留给读者作为练习。