Appearance
原始字符串命令
DECR
语法
bash
DECR key
将存储在 key 中的数字减 1。如果 key 不存在,则在执行操作之前将其设置为 0。如果 key 包含错误类型的值或包含无法表示为整数的字符串,则返回错误。
返回值
整数返回:执行减法操作后 key 的值。
DECRBY
语法
bash
DECR key decrement
将存储在 key 中的数字减去参数 decrement
的值。如果 key 不存在,则在执行操作之前将其设置为 0。如果 key 包含错误类型的值或包含无法表示为整数的字符串,则返回错误。
返回值
整数返回:执行减法操作后 key 的值。
GET
语法
bash
GET key
获取 key 的值。如果 key 不存在,则返回 nil。
返回值
以下之一:
- 块字符串返回值:key 的值。
- Nil 返回值: 如果 key 不存在。
GETDEL
语法
bash
GETDEL key
获取 key 的值并删除 key。此命令类似于 GET,但成功后还会删除 key(仅当 key 的值类型为字符串时)。
返回值
以下之一:
- 块字符串返回值:key 的值。
- Nil 返回值:如果 key 不存在或 key 的值类型不是字符串。
GETRANGE
语法
bash
GETRANGE key start end
返回存储在 key 中的字符串值的子字符串,由偏移量 start 和 end(两者都包括在内)确定。
返回值
块字符串返回值:存储在 key 中的字符串值的子字符串,由偏移量 start 和 end(两者都包括在内)确定。
INCR
语法
bash
INCR key
将存储在 key 中的数字加 1。如果 key 不存在,则在执行操作之前将其设置为 0。
返回值
整数返回值:增加操作后 key 的值。
INCRBY
语法
bash
INCRBY key increment
将存储在 key 中的数字增加参数 increment 的值。如果 key 不存在,则在执行操作之前将其设置为 0。
返回值
整数返回值:增加操作后 key 的值。
MGET
语法
bash
MGET key [key ...]
返回所有指定键的值。对于每个不存在的键,返回特殊值 nil。
MSET
语法
bash
MSET key value [key value ...]
将给定键设置为相应的值。MSET 用新值替换现有值,就像常规 SET 一样。如果不想覆盖现有值,请参阅 MSETNX。
返回值
数组返回值:指定键的值列表。
MSETNX
语法
bash
MSETNX key value [key value ...]
将给定键设置为相应的值。即使只有一个键已存在,MSETNX 也不执行任何操作。
返回值
以下之一:
- 整数返回值:如果未设置任何键(至少一个键已存在)为 0。
- 整数返回值:如果已设置所有键返回1。
PSETEX
语法
bash
PSETEX key milliseconds value
PSETEX 的工作方式与 SETEX 完全相同,唯一的区别在于超时时间以毫秒为单位指定,而不是以秒为单位。
返回值
字符串返回值:OK。
SET
语法
bash
SET key value [NX | XX] [GET] [EX seconds | PX milliseconds |
设置 key 来保存字符串值。如果 key 已包含值,则无论其类型如何,该值都会被覆盖。成功的 SET 操作后,与该 key 关联的任何先前未过期的值都将被丢弃。
Options:
- EX seconds -- 设置指定的到期时间(以秒为单位,为正整数)。
- PX milliseconds -- 设置指定的到期时间(以毫秒为单位,为正整数)。
- NX -- 仅当键不存在时设置键。
- XX -- 仅当键存在时设置键。
- KEEPTTL -- 保留与键关联的到期时间。
返回值
以下的任一值:
- Nil 返回值: 未提供 GET 选项:操作已中止(与 XX/NX 选项之一冲突)。
- 字符串返回值:未提供 GET 选项:已设置键。
- Nil 返回值: 已提供 GET,但键不存在。
- 块字符串返回值:已提供 GET,键的前一个值。
SETEX
语法
bash
SETEX key value
将 key 设置为存储的字符串值,并设置 key 在给定的秒数后超时。
返回值
字符串返回值:OK。
SETNX
语法
bash
SETNX key value
如果 key 不存在,则将其设置为值。当 key 已经持有一个值时,不执行任何操作。
返回值
以下之一:
- 整数返回值:如果未设置键,则为 0。
- 整数返回值:如果已设置键,则为 1。
STRLEN
语法
bash
STRLEN key
返回存储在 key 中的字符串值的长度。
返回值
- 整数返回值:存储在 key 中的字符串的长度,如果 key 不存在,则为 0。