Redis String命令大全

介绍

string是redis最基本的类型，你可以理解成与Memcached一模一样的类型，一个key对应一个value。

string类型是二进制安全的。意思是redis的string可以包含任何数据。比如jpg图片或者序列化的对象 。

string类型是Redis最基本的数据类型，一个redis中字符串value最多可以是512M.

key	value
username	张三

一.设置和获取

1. set

可用版本:>=1.0.0

时间复杂度:O(1)

语法

set key value [NX | XX] [GET] [EX seconds |PX milliseconds |EXAT unix-time-seconds |PXAT unix-time-milliseconds |KEEPTTL]

介绍

• 添加一个key,并给该key的值设为value,key存在则覆盖。

• 当值被覆盖时,如果没有给过期时间的参数,则会清空过期时间

• 可选参数:

• NX:当key不存在时才设置(类似于setnx)

• XX:当key存在时才设置

• GET:获取key原来的值(类似于getset)

• EX:设置key的过期时间,以秒为单位(类似于setex)

• PX:设置key的过期时间,以毫秒为单位(类似于psetex)

• EXAT:设置key在什么时间过期,以秒级时间戳为单位

• PXAT:设置key在什么时间过期,以毫秒级时间戳为单位

• KEEPTTL:在覆盖值时保留key的失效时间

NX和XX只能选一个

EXAT、PXAT、EX、PX和KEEPTTL只能选一个

历史

• 从 Redis 版本 2.6.12 开始：添加了EX、PX、NX和XX选项。
• 从 Redis 版本 6.0.0 开始：添加了KEEPTTL选项。
• 从 Redis 版本 6.2.0 开始：添加了GET、EXAT和PXAT选项。
• 从 Redis 版本 7.0.0 开始：允许NX和GET选项一起使用。

返回值

• 设值成功返回OK
• 使用NX或XX选项之后不满足条件而未执行成功返回nil
• 使用了get选项就一定返回之前的值

示例

#不带任何参数
127.0.0.1:6379> set key value
OK

#带get
127.0.0.1:6379> set key value2 get
"value"

#带NX
127.0.0.1:6379> set key value NX
(nil)

#带XX
127.0.0.1:6379> set key value XX
OK

#带EX
127.0.0.1:6379> set key value ex 10
OK

#带PX
127.0.0.1:6379> set key value px 10000
OK

#带EXAT
127.0.0.1:6379> set key value EXAT 8888888888
OK

#带PXAT
127.0.0.1:6379> set key value EXAT 8888888888000
OK

#带KEEPTTL
127.0.0.1:6379> set key value keepttl
OK

2.get

可用版本:>=1.0.0

时间复杂度:O(1)

语法

get key

介绍

• 获取key的值

返回值

• key的值
• key不存在返回nil

示例

#key不存在
127.0.0.1:6379> get key
(nil)

#key存在
127.0.0.1:6379> set key value
OK
127.0.0.1:6379> get key
"value"

3.mset

可用版本:>=1.0.1

时间复杂度:O(N),N是要设置的key的数量

语法

mset key value [key value …]

介绍

• 批量设置key

返回值

• OK

示例

127.0.0.1:6379> mset k1 v1 k2 v2
OK

4.mget

可用版本:>=1.0.1

时间复杂度:O(N),N是要获得的key的数量

语法

mget key [key …]

介绍

• 获得所有指定key的值,不存在的key对应返回nil

返回值

• 指定键的值列表

示例

127.0.0.1:6379> mget k1 k3
1) "v1"
2) (nil)

5.getset

可用版本:>=1.0.0

时间复杂度:O(1)

语法

getset key value

介绍

• 获取key的旧值并设置新值
• 在6.2.0被弃用

返回值

• key的旧值
• key不存在返回nil

示例

#key不存在
127.0.0.1:6379> getset k1 v1
(nil)

#key存在
127.0.0.1:6379> getset k1 v3
"v1"
127.0.0.1:6379> get k1
"v3"

6.getdel

可用版本:>=6.2.0

时间复杂度:O(1)

语法

getdel key

介绍

• 获取key的值并删除

返回值

• key的值
• key不存在返回nil

示例

127.0.0.1:6379> set key value
OK

#key存在
127.0.0.1:6379> getdel key
"value"

#key不存在
127.0.0.1:6379> getdel key
(nil)

7.setnx

可用版本:>=1.0.0

时间复杂度:O(1)

语法

setnx key value

介绍

• 只有当key不存在时在给key设置值

返回值

• key存在返回0
• key不存在返回1

示例

#key不存在
127.0.0.1:6379> setnx key value
(integer) 1

#key存在
127.0.0.1:6379> setnx key value
(integer) 0

8.msetnx

可用版本:>=1.0.1

时间复杂度:O(N),其中 N 是要设置的key的数量。

语法

msetnx key value[key value …]

介绍

• 只有当给定的key都不存在时才批量设值key的值

返回值

• key都不存在返回1
• key有一个存在返回0

示例

#key都不存在
127.0.0.1:6379> msetnx k1 v1 k2 v2
(integer) 1

#存在一个key
127.0.0.1:6379> msetnx k1 v1 k3 v3
(integer) 0

9.setex

可用版本:>=2.0.0

时间复杂度:O(1)

语法

setex key seconds value

介绍

• 设置key的值并设置过期时间(单位秒)
• 等同于先执行set key value后执行expire key seconds

返回值

• 总是OK

示例

127.0.0.1:6379> setex key 10 value
OK

10.psetex

可用版本:>=2.6.0

时间复杂度:O(1)

语法

psetex key millisecondsvalue

介绍

• 设置key的值并设置过期时间(单位毫秒)
• 等同于先执行set key value后执行pexpire key milliseconds

返回值

• 总是OK

示例

127.0.0.1:6379> psetex key 10000 value
OK

11.getex

可用版本:>=6.2.0

时间复杂度:O(1)

语法

getex key [EX seconde | PX milliseconds |EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST]

介绍

• 获取key的值并设置过期时间
• 可选参数:
  • EX seconds:设置还有多少秒过期
  • PX milliseconds:设置还有多少毫秒过期
  • EXAT unix-time-seconds:设置在什么时候过期,秒级时间戳
  • PXAT unix-time-milliseconds:设置在什么时候过期,毫秒级时间戳
  • PERSIST:取消key的过期时间

​ 这些参数只能同时出现一个

返回值

• key的值
• key不存在返回nil

示例

#key不存在
127.0.0.1:6379> getex key
(nil)

#key存在
127.0.0.1:6379> set key value
OK
127.0.0.1:6379> getex key
"value"

#加EX
127.0.0.1:6379> getex key EX 10
"value"

#加PX
127.0.0.1:6379> getex key PX 10000
"value"

#加EXAT
127.0.0.1:6379> getex key EXAT 333333333
"value"

#加PXAT
127.0.0.1:6379> getex key PXAT 333333333000
"value"

#加PERSIST
127.0.0.1:6379> getex key PERSIST
"value"

二.自增、自减

1.incr

可用版本:>=1.0.0

时间复杂度:O(1)

语法

incr key

介绍

• key的值自增1
• 如果key不存在则会先执行set key 0,然后再执行该命令
• 如果key的值不为整数则会报错

返回值

• 自增后的值

示例

127.0.0.1:6379> get key
(nil)
#key不存在
127.0.0.1:6379> incr key
(integer) 1

#key存在
127.0.0.1:6379> incr key
(integer) 2

2.decr

可用版本:>=1.0.0

时间复杂度:O(1)

语法

decr key

介绍

• key的值自减1
• 如果key不存在则会先执行set key 0,然后再执行该命令
• 如果key的值不为整数则会报错

返回值

• 自减后的值

示例

127.0.0.1:6379> get key
(nil)
#key不存在
127.0.0.1:6379> decr key
(integer) -1

#key存在
127.0.0.1:6379> decr key
(integer) -2

3.incrby

可用版本:>=1.0.0

时间复杂度:O(1)

语法

incrby key increment

介绍

• key的值自增increment,increment为负数则自减
• 如果key不存在则会先执行set key 0,然后再执行该命令
• 如果key的值不为整数则会报错

返回值

• 自增后的值

示例

127.0.0.1:6379> get key
(nil)
#key不存在
127.0.0.1:6379> incrby key 2
(integer) 2

#key存在
127.0.0.1:6379> incrby key 3
(integer) 5

#increment为负数
127.0.0.1:6379> incrby key -2
(integer) 3

4.decrby

可用版本:>=1.0.0

时间复杂度:O(1)

语法

decrby key increment

介绍

• key的值自减increment,increment为负数则自增
• 如果key不存在则会先执行set key 0,然后再执行该命令
• 如果key的值不为整数则会报错

返回值

• 自减后的值

示例

127.0.0.1:6379> get key
(nil)
#key不存在
127.0.0.1:6379> decrby key 2
(integer) -2

#key存在
127.0.0.1:6379> decrby key 3
(integer) -5

#increment为负数
127.0.0.1:6379> decrby key -2
(integer) -3

5.incrbyfloat

可用版本:>=2.6.0

时间复杂度:O(1)

语法

incrbyfloat key increment

介绍

• key的值自增increment,increment为负数则自减
• 如果key不存在则会先执行set key 0,然后再执行该命令
• 如果key的值不为小数则会报错
• 和incrby不同的是这个支持自增小数

返回值

• 自减后的值

示例

127.0.0.1:6379> get key
(nil)
#key不存在
127.0.0.1:6379> incrbyfloat key 1.1
(integer) 1.1

#key存在
127.0.0.1:6379> incrbyfloat key 2.2
(integer) 3.3

#increment为负数
127.0.0.1:6379> incrbyfloat key -1.1
(integer) 2.2

三.其他

1.strlen

可用版本:>=2.2.0

时间复杂度:O(1)

语法

strlen key

介绍

• key的值的长度

返回值

• key的值的长度
• key不存在返回0

示例

#key不存在
127.0.0.1:6379> strlen key
(integer) 0

#key存在
127.0.0.1:6379> set key value
OK
127.0.0.1:6379> strlen key
(integer) 5

2.setrange

可用版本:>=2.2.0
时间复杂度:O(1),不计算复制新字符串所需的时间。通常，该字符串非常小，因此摊销复杂度为 O(1)。否则，复杂度为 O(M)，其中 M 是 value 参数的长度

语法

setrange key offset value

介绍

• 替换指定offset的值
• 如果索引大于字符串值的最大索引,则会在空缺的地方补\x00
• key不存在则会先创建key,再执行该操作

返回值

• 字符串的长度

示例

#offset小于等于字符串的长度-1
127.0.0.1:6379> set key 123456
OK
127.0.0.1:6379> setrange key 2 4
(integer) 6
127.0.0.1:6379> get key
"124456"

#offset大于字符串的长度
127.0.0.1:6379> setrange key 7 1
(integer) 8
127.0.0.1:6379> get key
"124456\x001"

3.getrange

可用版本:>=2.4.0
时间复杂度:O(N),N是返回字符串的长度

语法

getrange key start end

介绍

• 获取索引在start-end的字符串,索引从0开始,包含边界
• 可以使用负数来表示,-1表示最后一个字符,-2表示倒数第二个,以此类推
• 使用负数之后会自动变为对应的正数,比如字符串的长度是6,start是-4,转换为正数也就是2
• 如果start或end的值小于0,会自动变为0
• 如果end的值大于字符串的长度-1,会自动变为字符串的长度-1
• start的值一定要小于等于end的值,否则获取不到值

返回值

• 索引在start-end的字符串

示例

#start和end都为正数
127.0.0.1:6379> getrange key 1 5
"24456"

#start和end都为负数
127.0.0.1:6379> getrange key -3 -2
"6\x00"

#start>end
127.0.0.1:6379> getrange key 2 1
""

#end大于最大索引
127.0.0.1:6379> getrange key 0 10
"124456\x001"

#end小于最小索引
127.0.0.1:6379> getrange key 0 -8
"1"

#start小于最小索引
127.0.0.1:6379> getrange key -8 2
"124"

4.append

可用版本:>=2.0.0
时间复杂度:O(1)

语法

append key value

介绍

• 如果key已经存在,会将value追加到旧值后面
• 如果key不存在,则会先创建该key再执行该命令

返回值

• 字符串的长度

示例

#key不存在
127.0.0.1:6379> append key value
(integer) 5

#key存在
127.0.0.1:6379> append key 1
(integer) 6

5.substr

可用版本:>=1.0.0
时间复杂度:O(N),N是返回字符串的长度

语法

substr key value

介绍

• 在2.0.0开始被弃用
• 和getrange命令一模一样

返回值

• 字符串的长度

6.lcs

可用版本:>=7.0.0
时间复杂度:O(N*M),N和M分别是s1和s2的长度

语法

lcs key1 key2 [LEN] [IDX] [MINMATCHLEN len] [WITHMATCHLEN]

介绍

• 获取key1和key2相同字符串的内容,匹配单个字符串,而不是连续的字符串

• 可选参数:

  • LEN:匹配相同字符串的长度

  • IDX:匹配相同字符串时的匹配位置,匹配顺序从从右到左

  • MINMATCHLEN:需要和IDX一起用,用于匹配公共字符串的最小长度,如果两个字符串中相同字符串内容为12和123,将len设置为3则只会匹配123,为2就是都匹配,为4则都不会匹配。

  • WITHMATCHLEN:需要和IDX一起用,在匹配位置加上匹配的字符串长度

    LEN不能和参数一起用,其他的可以组合使用

返回值

• 如果没有给参数,返回公共字符串

• 给了LEN则是返回公共字符串的长度

• 给了IDX

  • 第一行 返回mathes

  • 第二行返回:无匹配内容返回(empty array)

  • 第N个公共字符串 第1个key 开始索引
    					    结束索引
    			   第2个key  开始索引
    					     结束索引
    

  • 返回len

  • 公共字符串的长度

• 给了WITHMATCHLEN:在匹配位置后面加上公共字符串的长度

示例

#不带参数
127.0.0.1:6379> set k1 va123
OK
127.0.0.1:6379> set k2 vs123
OK
127.0.0.1:6379> lcs k1 k2
"v123"

#带LEN
127.0.0.1:6379> lcs k1 k2 LEN
(integer) 4

#带IDX
127.0.0.1:6379> lcs k1 k2 IDX
1) "matches"
2) 1) 1) 1) (integer) 2 #第一次匹配的字符串为123,k1中1的开始索引为2
         2) (integer) 4 #第一次匹配的字符串为123,k1中3的结束索引为4
      2) 1) (integer) 2 #第一次匹配的字符串为123,k2中1的开始索引为2
         2) (integer) 4 #第一次匹配的字符串为123,k2中3的开始索引为4
   2) 1) 1) (integer) 0 #第二次匹配的字符串为v,k1中v的开始索引为0
         2) (integer) 0 #第二次匹配的字符串为v,k1中v的结束索引为0
      2) 1) (integer) 0 #第二次匹配的字符串为v,k2中v的开始索引为0
         2) (integer) 0 #第二次匹配的字符串为v,k2中v的结束索引为0
3) "len"
4) (integer) 4

#带MINMATHCHLEN
127.0.0.1:6379> lcs k1 k2 IDX MINMATHCHLEN 3
1) "matches"
2) 1) 1) 1) (integer) 2
         2) (integer) 4
      2) 1) (integer) 2
         2) (integer) 4
3) "len"
4) (integer) 4

#带WITHMATCHLEN
127.0.0.1:6379> lcs k1 k2 IDX withmatchlen
1) "matches"
2) 1) 1) 1) (integer) 2
         2) (integer) 4
      2) 1) (integer) 2
         2) (integer) 4
      3) (integer) 3 #此次公共字符串的长度
   2) 1) 1) (integer) 0
         2) (integer) 0
      2) 1) (integer) 0
         2) (integer) 0
      3) (integer) 1 #此次公共字符串的长度
3) "len"
4) (integer) 4

#带IDX无匹配内容时
127.0.0.1:6379> set k1 1
OK
127.0.0.1:6379> set k2 2
OK
127.0.0.1:6379> lcs k1 k2 IDX
1) "matches"
2) (empty array)
3) "len"
4) (integer) 0