选项

• key：key 名称，用于指定作为命令调用对象的 ExString。
• value：为 key 所设的 value。
• EX：指定 key 的相对过期时间，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• EXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• PX：指定 key 的相对过期时间，单位：毫秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• PXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：毫秒 ，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• NX：仅当 key 不存在时写入数据。
• XX：仅当 key 存在时写入数据。
• VER：版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。场景不同，版本号生效情况不同，其中：
  • 若 key 存在：
    • 且传入的版本号和 key 当前的版本号相等，那么直接写入 value，且版本号会在原来的版本号基础上加 1。
    • 但传入的版本号和 key 当前的版本号不相等，那么拒绝写入 value 并返回异常信息。
  • 若 key 不存在，那么忽略传入的版本号直接写入 value，写入成功后版本号变为 1。
• ABS：绝对版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。设置后会直接写入 value，并将 key 的版本号修改为该选项所设的版本号。
• KEEPTTL：延用该 key 已设置的过期时间（Time to live，TTL 信息）。

  说明

  • KEEPTTL 不能与 EX、PX、EXAT、PXAT 参数同时设置。
  • 若未设置 KEEPTTL 参数，也未设置 EX、EXAT、PX、PXAT 等设置过期时间的参数，则该 key 已设置的过期时间将被删除，即该 key 不会过期。

返回值

• OK：执行成功。
• nil：指定了 XX 参数但 key 不存在，或指定了 NX 参数但 key 已经存在。
• 其它情况返回相应的异常信息（如 invalid arguments、update version is stale 等）。

示例

• 命令示例一
  创建一个 key 名称为 test_exstring ，值为 test_value1 的 ExString，并将该 ExString 的相对过期时间设置为 10 秒，绝对版本号为 100，仅指定仅当 key 不存在时写入。

  EXSET test_exstring test_value1 EX 10 NX ABS 100
  

  返回示例。

  OK
  

• 命令示例二
  为已存在的 ExString test_exstring 赋一个新值 test_value2，并将该 ExString 的绝对过期时间设置为 100 毫秒，版本号为 100，仅指定仅当 key 存在时写入。

  EXSET test_exstring test_value2 PXAT 1739455218750 XX VER 100
  

  返回示例。

  OK
  

返回值

• 执行成功时，会返回指定 key 的 value 与 version 信息。
• 其它情况返回相应的异常信息（如 nil、wrong number of arguments for command 等）。

示例

命令示例。

EXGET test_exstring

返回示例。

1) test_value1
2) 100

选项

• key：key 名称，用于指定作为命令调用对象的 ExString。
• version：需要设置的版本号，取值范围为 0 ~ Integer 数据类型允许的最大值。

返回值

• 1：执行成功。
• 0：指定的 key 不存在。
• 其它情况返回相应的异常信息（如 syntax error 等）。

示例

命令示例。

EXSETVER test_exstring 66

返回示例。

1

选项

• key：key 名称，用于指定作为命令调用对象的 ExString。
• num： 需要进行增、减的数值，取值必须为整数，其中正整数为需要增加的数值，负整数为需要减少的数值。
• MIN：设置指定 key 的 value 最小值。
• MAX：设置指定 key 的 value 最大值。
• EX：指定 key 的相对过期时间，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• EXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• PX：指定 key 的相对过期时间，单位：毫秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• PXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：毫秒 ，0 表示立即过期，不设置该参数表示 key 没有过期时间。
• NX：仅当 key 不存在时写入数据。
• XX：仅当 key 存在时写入数据。
• VER：版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。场景不同，版本号生效情况不同，其中：
  • 若 key 存在：
    • 且传入的版本号和 key 当前的版本号相等，那么直接进行增减操作，且版本号会在原来的版本号基础上加 1。
    • 但传入的版本号和 key 当前的版本号不相等，那么拒绝进行增加操作并返回异常信息。
• ABS：绝对版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。设置后会直接进行增减操作，并将 key 的版本号修改为该选项所设的版本号。
• KEEPTTL：延用该 key 已设置的过期时间（Time to live，TTL 信息）。

  说明

  • KEEPTTL 不能与 EX、PX、EXAT、PXAT 参数同时设置。
  • 若未设置 KEEPTTL 参数，也未设置 EX、EXAT、PX、PXAT 等设置过期时间的参数，则该 key 已设置的过期时间将被删除，即该 key 不会过期。

返回值

• 执行成功时，会返回进行增减操作后获得的 value 值。
• 当设置了 MAX 或 MIN，且进行自增或自减操作后获得的 value 超过了该范围时，会返回 increment or decrement would overflow。
• 其它情况返回相应的异常信息（如 update version is stale 等）。

示例

假设已使用 EXSET test_exstring1 25 ABS 100 命令创建了一个 ExString。
您可以通过如下命令，在原值基础上再加上 15.

EXINCRBY test_exstring1 15 MIN 35 VER 100

返回示例。

40

选项

• key：key 名称，用于指定作为命令调用对象的 ExString。

• num： 需要进行增、减的数值，取值必须为浮点数，其中正浮点数为需要增加的数值，负浮点数为需要减少的数值。

• MIN：设置指定 key 的 value 最小值。

• MAX：设置指定 key 的 value 最大值。

• EX：指定 key 的相对过期时间，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。

• EXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。

• PX：指定 key 的相对过期时间，单位：毫秒，0 表示立即过期，不设置该参数表示 key 没有过期时间。

• PXAT：指定 key 的绝对过期时间，格式为 Unix 时间戳，单位：毫秒 ，0 表示立即过期，不设置该参数表示 key 没有过期时间。

• NX：仅当 key 不存在时写入数据。

• XX：仅当 key 存在时写入数据。

• VER：版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。场景不同，版本号生效情况不同，其中：

  • 若 key 存在：
    • 且传入的版本号和 key 当前的版本号相等，那么直接进行增减操作，且版本号会在原来的版本号基础上加 1。
    • 但传入的版本号和 key 当前的版本号不相等，那么拒绝进行增加操作并返回异常信息。

• ABS：绝对版本号。取值范围为 0 ~ Integer 数据类型允许的最大值。设置后会直接进行增减操作，并将 key 的版本号修改为该选项所设的版本号。

• KEEPTTL：延用该 key 已设置的过期时间（Time to live，TTL 信息）。

  说明

  • KEEPTTL 不能与 EX、PX、EXAT、PXAT 参数同时设置。
  • 若未设置 KEEPTTL 参数，也未设置 EX、EXAT、PX、PXAT 等设置过期时间的参数，则该 key 已设置的过期时间将被删除，即该 key 不会过期。

返回值

• 执行成功时，会返回进行增减操作后获得的 value 值。
• 当设置了 MAX 或 MIN，且进行自增或自减操作后获得的 value 超过了该范围时，会返回 increment or decrement would overflow。
• 其它情况返回相应的异常信息（如 update version is stale 等）。

示例

假设已使用 EXSET test_exstring1 25 ABS 100 命令创建了一个 ExString。
您可以通过如下命令，在原值的基础上再减去 3.1415926.

EXINCRBYFLOAT test_exstring1 -3.1415926 MAX 100 VER 100

返回示例。

21.8584074

选项

• key：key 名称，用于指定作为命令调用对象的 ExString。
• newvalue：若传入的 version 与指定 key 的 version 一致时，则使用传入的 newvalue 覆盖原来的 value。
• version：用于与指定 key 当前 version 相比较的 version 值，取值范围为 0 ~ Integer 数据类型允许的最大值。

返回值

• OK：命令执行成功，且同时会返回一行空字符串，以及 key 最新的 version 信息。
• CAS_FAILED：命令执行失败，且同时会返回 key 当前的 value 和 version 版本。
• -1：指定 key 不存在。
• 其它情况返回相应的异常信息（如 syntax error、version should be integer 等）。

示例

假设已存在一个 ExString test_exstring1 且需要将该 ExString 的 value 改为 66，但不确定其当前的 value 和 version。
您可以在如下命令中输入一个任意 version（例如 35），并尝试将原值修改为 66。

EXCAS test_exstring1 66 35

返回示例。

1) CAS_FAILED
2) 30
3) 100

从上述返回结果可知 test_exstring2 当前的 value 为 30， version 为 100，那么您可以通过如下命令将原值修改为 66。

EXCAS test_exstring1 66 100

返回示例。

1) OK
2)
3) 101

选项

• key：key 名称，用于指定作为命令调用对象的 ExString。
• version：用于与指定 key 当前 version 相比较的 version 值，取值范围为 0 ~ Integer 数据类型允许的最大值。

返回值

• 1：执行成功。
• 0：执行失败。
• -1：指定 key 不存在。
• 其它情况返回相应的异常信息（如 syntax error、version should be integer 等）。

示例

假设已存在一个 version 为 100 的 ExString test_exstring1：

• 当您使用如下命令时，删除 test_exstring1 会失败。

  EXCAD test_exstring1 101
  

  返回示例。

  0
  

• 当您使用如下命令时，可成功删除 test_exstring1。

  EXCAD test_exstring1 101
  

  返回示例。

  1