redis命令全掌握系列——字符串2(get、getSet、strLen、appEnd、setRange、getRange)

一、get命令

1.1、用法

时间复杂度： O(1)；

用法——get  key

作用——返回与键 key 相关联的字符串值

返回值：

• 如果键 key 不存在， 那么返回特殊值 nil ； 否则， 返回键 key 的值；
• 如果键 key 的值并非字符串类型， 那么返回一个错误， 因为 GET 命令只能用于字符串值。

1.2、代码示例

（1）对不存在的键 key 或是字符串类型的键 key 执行 GET 命令

redis> GET db
(nil)

redis> SET db redis
OK

redis> GET db
"redis"

（2）对不是字符串类型的键 key 执行 GET 命令

redis> DEL db
(integer) 1

redis> LPUSH db redis mongodb mysql
(integer) 3

redis> GET db
(error) ERR Operation against a key holding the wrong kind of value

二、getSet命令

2.1、用法

时间复杂度： O(1)；

用法——getSet  key  value

作用——键 key 的值设为 value ， 并返回键 key 在被设置之前的旧值

返回值：

• 返回给定键 key 的旧值；
• 如果键 key 没有旧值， 也即是说， 键 key 在被设置之前并不存在， 那么命令返回 nil；
• 当键 key 存在但不是字符串类型时， 命令返回一个错误。

2.2、代码示例

redis> GETSET db mongodb    # 没有旧值，返回 nil
(nil)

redis> GET db
"mongodb"

redis> GETSET db redis      # 返回旧值 mongodb
"mongodb"

redis> GET db
"redis"

三、strLen命令

3.1、用法

复杂度： O(1)；

用法——strLen  key

作用——返回键 key 储存的字符串值的长度

返回值：

• STRLEN 命令返回字符串值的长度。
• 当键 key 不存在时， 命令返回 0 。
• 当 key 储存的不是字符串值时， 返回一个错误。

3.2、代码示例

（1）获取字符串值的长度：

redis> SET mykey "Hello world"
OK

redis> STRLEN mykey
(integer) 11

不存在的键的长度为 0 ：

redis> STRLEN nonexisting
(integer) 0

四、appEnd命令

4.1、用法

时间复杂度： 平摊O(1)；

用法——appEnd  key  value

作用——如果键 key 已经存在并且它的值是一个字符串， APPEND 命令将把 value 追加到键 key 现有值的末尾；如果 key 不存在， APPEND 就简单地将键 key 的值设为 value ， 就像执行 SET key value 一样

返回值：

• 追加 value 之后， 键 key 的值的长度

4.2、代码示例

（1）对不存在的 key 执行 APPEND ：

redis> EXISTS myphone               # 确保 myphone 不存在
(integer) 0

redis> APPEND myphone "nokia"       # 对不存在的 key 进行 APPEND ，等同于 SET myphone "nokia"
(integer) 5  

（2）对已存在的字符串进行 APPEND ：

redis> APPEND myphone " - 1110"     # 长度从 5 个字符增加到 12 个字符
(integer) 12

redis> GET myphone
"nokia - 1110"

五、setRange命令

5.1、用法

时间复杂度： 对于长度较短的字符串，命令的平摊复杂度O(1)；对于长度较大的字符串，命令的复杂度为 O(M) ，其中 M 为 value 的长度；

用法——setRange  key offset  value

作用——从偏移量 offset 开始， 用 value 参数覆写(overwrite)键 key 储存的字符串值；不存在的键 key 当作空白字符串处理

（注意：

SETRANGE 命令会确保字符串足够长以便将 value 设置到指定的偏移量上， 如果键 key 原来储存的字符串长度比偏移量小(比如字符串只有 5 个字符长，但你设置的 offset 是 10 )， 那么原字符和偏移量之间的空白将用零字节(zerobytes, "\x00" )进行填充。

因为 Redis 字符串的大小被限制在 512 兆(megabytes)以内， 所以用户能够使用的最大偏移量为 2^29-1(536870911) ， 如果你需要使用比这更大的空间， 请使用多个 key

）

返回值：

• SETRANGE 命令会返回被修改之后， 字符串值的长度

5.2、代码示例

（1）对非空字符串执行 SETRANGE 命令：

redis> SET greeting "hello world"
OK

redis> SETRANGE greeting 6 "Redis"
(integer) 11

redis> GET greeting
"hello Redis"

（2）对空字符串/不存在的键执行 SETRANGE 命令：

redis> EXISTS empty_string
(integer) 0

redis> SETRANGE empty_string 5 "Redis!"   # 对不存在的 key 使用 SETRANGE
(integer) 11

redis> GET empty_string                   # 空白处被"\x00"填充
"\x00\x00\x00\x00\x00Redis!"

六、getRange命令

6.1、用法

时间复杂度：  O(N)，其中 N 为被返回的字符串的长度；

用法——getRange   key start end

作用——返回键 key 储存的字符串值的指定部分， 字符串的截取范围由 start 和 end 两个偏移量决定 (包括 start 和 end 在内)；负数偏移量表示从字符串的末尾开始计数， -1 表示最后一个字符， -2 表示倒数第二个字符， 以此类推。

返回值：

GETRANGE 命令会返回字符串值的指定部分。

6.2、代码示例

redis> SET greeting "hello, my friend"
OK

redis> GETRANGE greeting 0 4          # 返回索引0-4的字符，包括4。
"hello"

redis> GETRANGE greeting -1 -5        # 不支持回绕操作
""

redis> GETRANGE greeting -3 -1        # 负数索引
"end"

redis> GETRANGE greeting 0 -1         # 从第一个到最后一个
"hello, my friend"

redis> GETRANGE greeting 0 1008611    # 值域范围不超过实际字符串，超过部分自动被符略
"hello, my friend"