Redis缓存命令整理—String字符串操作命令

String字符串操作命令

APPEND:APPEND key value
描述：如果key 已经存在并且是一个字符串，APPEND
命令将 value 追加到
key 原来的值的末尾。
如果
key 不存在，
APPEND 就简单地将给定
key 设为 value ，就像执行
SET key value 一样。

返回值：追加
value 之后， key 中字符串的长度。

BITCOUNT：BITCOUNT key [start] [end]
描述：计算给定字符串中，被设置为1 的比特位的数量。一般情况下，给定的整个字符串都会被进行计数，通过指定额外的start 或end
参数，可以让计数只在特定的位上进行。start 和end 参数的设置和

GETRANGE 命令类似，都可以使用负数值：比如-1 表示最后一个位，而-2 表示倒数第二个位，以此类推。不存在的
key 被当成是空字符串来处理，因此对一个不存在的key 进行BITCOUNT 操作，结果为
0 。

返回值：被设置为
1 的位的数量。

BITOP：BITOP operation destkey key [key ...]
描述：对一个或多个保存二进制位的字符串key 进行位元操作，并将结果保存到destkey 上。
operation 可以是AND 、OR 、
NOT 、
XOR 这四种操作中的任意一种：

BITOP AND destkey key [key ...] ，对一个或多个key 求逻辑并，并将结果保存到destkey
。

BITOP OR destkey key [key ...] ，对一个或多个key 求逻辑或，并将结果保存到destkey
。

BITOP XOR destkey key [key ...] ，对一个或多个key 求逻辑异或，并将结果保存到destkey
。

BITOP NOT destkey key ，对给定key 求逻辑非，并将结果保存到destkey
。

除了
NOT 操作之外，其他操作都可以接受一个或多个 key 作为输入。
处理不同长度的字符串
当
BITOP 处理不同长度的字符串时，较短的那个字符串所缺少的部分会被看作0 。空的key 也被看作是包含
0 的字符串序列。

返回值：保存到
destkey 的字符串的长度，和输入 key 中最长的字符串长度相等。

DECR：DECR key
描述：将key 中储存的数字值减一。
如果
key 不存在，那么 key 的值会先被初始化为
0 ，然后再执行
DECR 操作。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于递增(increment) / 递减(decrement)操作的更多信息，请参见INCR
命令。

返回值：执行
DECR 命令之后
key 的值。

DECRBY：DECRBY key decrement
描述：将key 所储存的值减去减量decrement 。
如果
key 不存在，那么 key 的值会先被初始化为
0 ，然后再执行
DECRBY 操作。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于更多递增(increment) / 递减(decrement)操作的更多信息，请参见INCR
命令。

返回值：减去
decrement 之后， key 的值。

GET：GET key
描述：返回key 所关联的字符串值。
如果
key 不存在那么返回特殊值 nil 。
假如
key 储存的值不是字符串类型，返回一个错误，因为
GET 只能用于处理字符串值。

返回值：当 key 不存在时，返回nil ，否则，返回key 的值。

如果 key 不是字符串类型，那么返回一个错误。

GETBIT：GETBIT key offset
描述：对key 所储存的字符串值，获取指定偏移量上的位(bit)。
当
offset 比字符串值的长度大，或者 key 不存在时，返回0 。
返回值：字符串值指定偏移量上的位(bit)。

GETRANGE：GETRANGE key start end
描述：返回key 中字符串值的子字符串，字符串的截取范围由start 和
end 两个偏移量决定(包括
start 和 end 在内)。
负数偏移量表示从字符串最后开始计数，-1 表示最后一个字符，-2 表示倒数第二个，以此类推。
GETRANGE 通过保证子字符串的值域(range)不超过实际字符串的值域来处理超出范围的值域请求。
返回值：截取得出的子字符串。

GETSET：GETSET key value
描述：将给定key 的值设为value ，并返回
key 的旧值(old value)。
当
key 存在但不是字符串类型时，返回一个错误
返回值：返回给定key 的旧值。

当 key 没有旧值时，也即是，
key 不存在时，返回 nil 。

INCR：INCR key
描述：将key 中储存的数字值增一。
如果
key 不存在，那么 key 的值会先被初始化为
0 ，然后再执行
INCR 操作。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
返回值：执行INCR
命令之后key 的值。

INCRBY：INCRBY key increment
描述：将key 所储存的值加上增量increment 。
如果
key 不存在，那么 key 的值会先被初始化为
0 ，然后再执行
INCRBY 命令。
如果值包含错误的类型，或字符串类型的值不能表示为数字，那么返回一个错误。
本操作的值限制在 64 位(bit)有符号数字表示之内。
关于递增(increment) / 递减(decrement)操作的更多信息，参见INCR
命令。
返回值：加上increment 之后，key 的值。

INCRBYFLOAT：INCRBYFLOAT key increment
描述：为key 中所储存的值加上浮点数增量increment 。
如果
key 不存在，那么
INCRBYFLOAT 会先将
key 的值设为 0 ，再执行加法操作。
如果命令执行成功，那么
key 的值会被更新为（执行加法之后的）新值，并且新值会以字符串的形式返回给调用者。
无论是
key 的值，还是增量 increment ，都可以使用像
2.0e7 、 3e5 、
90e-2 那样的指数符号(exponential notation)来表示，但是，执行 INCRBYFLOAT 命令之后的值总是以同样的形式储存，也即是，它们总是由一个数字，一个（可选的）小数点和一个任意位的小数部分组成（比如3.14 、69.768
，诸如此类)，小数部分尾随的 0 会被移除，如果有需要的话，还会将浮点数改为整数（比如3.0 会被保存成3 ）。
除此之外，无论加法计算所得的浮点数的实际精度有多长，INCRBYFLOAT
的计算结果也最多只能表示小数点的后十七位。
当以下任意一个条件发生时，返回一个错误：

key 的值不是字符串类型(因为 Redis 中的数字和浮点数都以字符串的形式保存，所以它们都属于字符串类型）

key 当前的值或者给定的增量
increment 不能解释(parse)为双精度浮点数(double precision floating point number）

返回值：执行命令之后key 的值。

MGET：MGET key [key ...]
描述：返回所有(一个或多个)给定key 的值。
如果给定的
key 里面，有某个 key 不存在，那么这个
key 返回特殊值 nil 。因此，该命令永不失败。
返回值：一个包含所有给定key 的值的列表。

MSET：MSET key value [key value ...]
描述：同时设置一个或多个key-value 对。
如果某个给定
key 已经存在，那么
MSET 会用新值覆盖原来的旧值，如果这不是你所希望的效果，请考虑使用MSETNX
命令：它只会在所有给定key 都不存在的情况下进行设置操作。
MSET 是一个原子性(atomic)操作，所有给定key
都会在同一时间内被设置，某些给定 key 被更新而另一些给定
key 没有改变的情况，不可能发生。
返回值：总是返回OK (因为MSET 不可能失败)

MSETNX ：MSETNX key value [key value ...]
描述：同时设置一个或多个key-value 对，当且仅当所有给定key 都不存在。
即使只有一个给定
key 已存在，
MSETNX 也会拒绝执行所有给定key 的设置操作。
MSETNX 是原子性的，因此它可以用作设置多个不同key
表示不同字段(field)的唯一性逻辑对象(unique logic object)，所有字段要么全被设置，要么全不被设置。
返回值：当所有key 都成功设置，返回1 。

如果所有给定 key 都设置失败(至少有一个
key 已经存在)，那么返回 0 。

PSETEX：PSETEX key milliseconds value
描述：这个命令和SETEX
命令相似，但它以毫秒为单位设置key 的生存时间，而不是像
SETEX 命令那样，以秒为单位。
返回值：设置成功时返回OK 。

SET：SET key value [EX seconds] [PX milliseconds] [NX|XX]
描述：将字符串值value 关联到key 。
如果
key 已经持有其他值，
SET 就覆写旧值，无视类型。
对于某个原本带有生存时间（TTL）的键来说， 当SET
命令成功在这个键上执行时， 这个键原有的 TTL 将被清除。
可选参数
从 Redis 2.6.12 版本开始，SET
命令的行为可以通过一系列参数来修改：

EX second ：设置键的过期时间为
second 秒。 SET key value EX second 效果等同于SETEX key second value 。

PX millisecond ：设置键的过期时间为
millisecond 毫秒。 SET key value PX millisecond 效果等同于PSETEX key millisecond value 。

NX ：只在键不存在时，才对键进行设置操作。
SET key value NX 效果等同于 SETNX key value 。

XX ：只在键已经存在时，才对键进行设置操作。

因为
SET 命令可以通过参数来实现和SETNX
、SETEX 和PSETEX
三个命令的效果，所以将来的 Redis 版本可能会废弃并最终移除SETNX 、SETEX
和PSETEX 这三个命令。
返回值：在 Redis 2.6.12 版本以前，SET
命令总是返回OK 。

从 Redis 2.6.12 版本开始，
SET 在设置操作成功完成时，才返回OK 。

如果设置了 NX 或者
XX ，但因为条件没达到而造成设置操作未执行，那么命令返回空批量回 复（NULL Bulk Reply）。

SETBIT：SETBIT key offset value
描述：对key 所储存的字符串值，设置或清除指定偏移量上的位(bit)。
位的设置或清除取决于
value 参数，可以是 0 也可以是
1 。
当
key 不存在时，自动生成一个新的字符串值。
字符串会进行伸展(grown)以确保它可以将value 保存在指定的偏移量上。当字符串值进行伸展时，空白位置以0 填充。
offset 参数必须大于或等于0 ，小于 2^32 (bit 映射被限制在 512 MB 之内)。
对使用大的
offset 的
SETBIT 操作来说，内存分配可能造成 Redis 服务器被阻塞。具体参考SETRANGE
命令，warning(警告)部分。
返回值：指定偏移量原来储存的位。

SETEX：SETEX key seconds value
描述：将值value 关联到key ，并将
key 的生存时间设为
seconds (以秒为单位)。
如果
key 已经存在，
SETEX 命令将覆写旧值。
这个命令类似于以下两个命令：
SET key valueEXPIRE key seconds # 设置生存时间
不同之处是，
SETEX 是一个原子性(atomic)操作，关联值和设置生存时间两个动作会在同一时间内完成，该命令在 Redis 用作缓存时，非常实用。
返回值：设置成功时返回OK 。

当 seconds 参数不合法时，返回一个错误。

SETNX：SETNX key value
描述：将key 的值设为value ，当且仅当
key 不存在。
若给定的
key 已经存在，则
SETNX 不做任何动作。
SETNX 是『SET if Not eXists』(如果不存在，则
SET)的简写。

返回值：设置成功，返回
1 。

设置失败，返回 0 。

SETRANGE：SETRANGE key offset value
描述：用value 参数覆写(overwrite)给定key 所储存的字符串值，从偏移量
offset 开始。
不存在的
key 当作空白字符串处理。
SETRANGE 命令会确保字符串足够长以便将value
设置在指定的偏移量上，如果给定 key 原来储存的字符串长度比偏移量小(比如字符串只有5 个字符长，但你设置的offset 是10 )，那么原字符和偏移量之间的空白将用零字节(zerobytes,
"\x00" )来填充。
注意你能使用的最大偏移量是 2^29-1(536870911) ，因为 Redis 字符串的大小被限制在 512 兆(megabytes)以内。如果你需要使用比这更大的空间，你可以使用多个key 。
当生成一个很长的字符串时，Redis 需要分配内存空间，该操作有时候可能会造成服务器阻塞(block)。在2010年的Macbook Pro上，设置偏移量为 536870911(512MB 内存分配)，耗费约 300 毫秒， 设置偏移量为 134217728(128MB 内存分配)，耗费约 80 毫秒，设置偏移量 33554432(32MB 内存分配)，耗费约 30 毫秒，设置偏移量为
8388608(8MB 内存分配)，耗费约 8 毫秒。 注意若首次内存分配成功之后，再对同一个
key 调用
SETRANGE 操作，无须再重新内存。
返回值：被SETRANGE
修改之后，字符串的长度。

STRLEN：STRLEN key
描述：返回key 所储存的字符串值的长度。
当
key 储存的不是字符串值时，返回一个错误。
返回值：字符串值的长度。

当 key 不存在时，返回
0 。