Skip to content

原始字符串命令

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。