Redis string类型键相关命令整理

谁践踏了优雅 2022-04-24 15:14 218阅读 0赞

字符串类型既可以存储字符，也可以存储数字。可以通过type命令返回string，表示是字符串类型。

127.0.0.1:6379> set sam good
    OK
    127.0.0.1:6379> type sam
    string
    127.0.0.1:6379> set tom 1
    OK
    127.0.0.1:6379> type tom
    string

以下介绍string类型相关的命令：  
1.SET  
`SET key value [EX seconds] [PX milliseconds] [NX|XX]`  
将字符串类型的key设为value值。  
如果key已存在，则覆盖，无视key原来的类型和内容。  
如果原key带有生存时间，覆盖后生存时间被清除。  
EX seconds：设置键的过期时间为seconds秒，等同于setex key second value；  
PX milliseconds：设置键的过期时间为milliseconds毫秒，等同于psetex key millisecond value；  
NX：仅key不存在时才对该键进行设置操作，等同于setnx key value;  
XX：仅key存在时才对该键进行设置操作。

2.GET  
`GET key`  
返回key所对应的值，如果key不存在则返回nil，如果key不是字符串类型，返回一个错误，GET只能处理字符串类型键。

3.MSET  
`MSET key value [key value ...]`  
同时设置一个或多个key-value对，如果key已存在，则会覆盖；是一个原子性操作，所有给定key会在同一时间设置，且一定会成功。

4.MGET  
`MGET key [key ...]`  
返回所有给定key的值，如果key不存在或不是字符串类型，返回nil，该命令一定成功。

5.SETEX  
`SETEX key seconds value`  
设置key值为value，过期时间为seconds。原子性操作，值和过期时间同时设置。  
如果key已存在，覆盖写入。

6.SETNX  
`SETNX key value`  
当key不存在时，设置key为value值，已存在则不做任何操作。

7.MSETNX  
`MSETNX key value [key value ...]`  
当所有给定key不存在时，设置key-value对，即使其中一个key已存在，都会取消所有key的设置操作。

8.PSETEX  
`PSETEX key milliseconds value`  
作用等同于SETEX，只是时间单位为毫秒。

9.SETBIT  
`SETBIT key offset value`  
设置key的offset位为value，key值会进行伸展以满足offset需求，空白处补充0，如果key不存在，则新建并设置。offset 参数必须大于或等于 0 ，小于 2^32 (bit 映射被限制在 512 MB 之内)。  
setbit bit 4 1 \#1000  
setbit bit 3 1 \#1100

10.SETRANGE  
`SETRANGE key offset value`  
用value覆写key的字符串值，从偏移量offset开始。不存在的key当做空白字符处理。  
SETRANGE 命令会确保字符串足够长以便将 value 设置在指定的偏移量上，如果给定 key 原来储存的字  
符串长度比偏移量小 (比如字符串只有 5 个字符长，但你设置的 offset 是 10 )，那么原字符和偏移量之间  
的空白将用零字节 (zerobytes, “\\x00” ) 来填充。  
注意你能使用的最大偏移量是 2^29-1(536870911) ，因为 Redis 字符串的大小被限制在 512 兆(megabytes)以内。  
当生成一个很长的字符串时，Redis 需要分配内存空间，该操作有时候可能会造成服务器阻塞 (block)。  
若首次内存分配成功之后，再对同一个 key 调用SETRANGE 操作，无须再重新内存。

127.0.0.1:6379> get sam
    "good"
    127.0.0.1:6379> setrange sam 4 boy
    (integer) 7
    127.0.0.1:6379> get sam
    "goodboy"
    127.0.0.1:6379> exists ken
    (integer) 0
    127.0.0.1:6379> setrange ken 6 bad
    (integer) 9
    127.0.0.1:6379> get ken
    "\x00\x00\x00\x00\x00\x00bad"

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

12.GETRANGE  
`GETRANGE key start end`  
返回 key 中字符串值的子字符串，字符串的截取范围由 start 和 end 两个偏移量决定 (包括 start 和 end在内)。  
负数偏移量表示从字符串最后开始计数，-1 表示最后一个字符，-2 表示倒数第二个，以此类推。  
值域范围不超过实际字符串，超过部分自动被符略。

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

14.BITCOUNT  
`BITCOUNT key [start] [end]`  
计算给定字符串中，被设置为 1 的比特位的数量。  
一般情况下，给定的整个字符串都会被进行计数，通过指定额外的 start 或 end 参数，可以让计数只在特定的位上进行。  
start 和 end 参数的设置和GETRANGE 命令类似，都可以使用负数值：比如 -1 表示最后一个位，而 -2表示倒数第二个位，以此类推。  
不存在的 key 被当成是空字符串来处理，因此对一个不存在的 key 进行 BITCOUNT 操作，结果为 0 。

15.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 的字符串序列。

16.APPEND  
`APPEND key value`  
如果 key 已经存在并且是一个字符串，APPEND 命令将 value 追加到 key 原来的值的末尾。  
如果 key 不存在，APPEND 就简单地将给定 key 设为 value ，就像执行 SET key value 一样。  
追加 value 之后，key 中字符串的长度。

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

18.INCRBY  
`INCRBY key increment`  
等同于INCR，但增幅不是1，而是increment。

19.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）

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

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