ApsaraDB for Redis：exString

若key不存在，則建立新的key，並將value儲存到key中；若key已存在，則覆蓋原來value的值。

擷取TairString的value和version。

設定目標key的version。

對TairString的value進行自增自減操作，num的範圍為long。

對TairString的value進行自增自減操作，num的範圍為double。

當目標key的version值與指定的version相等時，則更新key的value值；version不相等，則返回舊的value和version。

當目標key的version值與指定的version相等時，則刪除Key。

若key不存在，則建立新的key，並將value儲存到key中；若key已存在，則覆蓋原來value的值。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• value：為key設定的value。
• EX：指定key的相對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• EXAT：指定key的絕對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• PX：指定key的相對到期時間，單位為毫秒，為0表示馬上到期，不傳此參數表示不到期。
• PXAT：指定key的絕對到期時間，單位為毫秒 ，為0表示馬上到期，不傳此參數表示不到期。
• NX：只在key不存在時寫入。
• XX：只在key存在時寫入。
• VER：版本號碼。
  • 如果key存在，和目前的版本號做比較：
    • 如果相等，寫入，且版本號碼加1。
    • 如果不相等，返回異常。
  • 如果key不存在或者key目前的版本為0，忽略傳入的版本號碼直接設定value，成功後版本號碼變為1。
• ABS：絕對版本號碼。設定後，無論key當前的版本號碼是多少，完成寫入並將key的版本號碼覆蓋為該選項中設定的值。
• KEEPTTL：延用該key原本設定的到期時間（Time to live，TTL資訊），該參數不能與EX、PX、EXAT、PXAT參數同時設定。
  說明 若未設定KEEPTTL參數，也未設定EX、PX等設定到期時間的參數，則該key的到期時間將被刪除，即表示該key不會到期。

• 執行成功：OK。
• 指定了XX且key不存在：nil。
• 指定了NX且key已經存在：nil。
• 其它情況返回相應的異常資訊。

命令樣本：

EXSET foo bar EX 10 NX ABS 100

返回樣本：

OK

擷取TairString的value和version。

• Key：TairString的key，用於指定作為命令調用對象的TairString。

• 執行成功：value與version。
• 其它情況返回相應的異常資訊。

命令樣本：

EXGET foo

返回樣本：

1) "bar"
2) (integer) 1

設定目標key的version。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• version：需要設定的版本號碼。

• 執行成功：1。
• 若key不存在：0。
• 其它情況返回相應的異常資訊。

命令樣本：

EXSETVER foo 2

返回樣本：

(integer) 1

對TairString的value進行自增自減操作，num的範圍為long。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• num：TairString進行自增自減操作的數值，必須為整數。
• EX：指定key的相對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• EXAT：指定key的絕對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• PX：指定key的相對到期時間，單位為毫秒，為0表示馬上到期，不傳此參數表示不到期。
• PXAT：指定key的絕對到期時間，單位為毫秒 ，為0表示馬上到期，不傳此參數表示不到期。
• NX：只在key不存在時寫入。
• XX：只在key存在時寫入。
• VER：版本號碼。
  • 如果key存在，和目前的版本號做比較：
    • 如果相等，進行自增，且版本號碼加1。
    • 如果不相等，返回異常。
  • 如果key不存在或者key目前的版本為0，忽略傳入的版本號碼並進行自增操作，成功後版本號碼變為1。
• ABS：絕對版本號碼。設定後，無論key當前的版本號碼是多少，完成寫入並將key的版本號碼覆蓋為該選項中設定的值。
• MIN：設定TairString value的最小值。
• MAX：設定TairString value的最大值。
• KEEPTTL：延用該key原本設定的到期時間，該參數不能與EX、PX、EXAT、PXAT參數同時設定。
  說明 若未設定KEEPTTL參數，也未設定EX、PX等設定到期時間的參數，則該key的到期時間將被刪除，即表示該key不會到期。

• 執行成功：操作後value的值。
• 若設定了MAX或MIN，而操作後的value超過了該範圍：(error) ERR increment or decrement would overflow。
• 其它情況返回相應的異常資訊。

提前執行EXSET foo 1命令。

命令樣本：

EXINCRBY foo 100 MAX 300

返回樣本：

(integer) 101

對TairString的value進行自增自減操作，num的範圍為double。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• num：TairString進行自增自減操作的數值，類型為浮點數。
• EX：指定key的相對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• EXAT：指定key的絕對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。
• PX：指定key的相對到期時間，單位為毫秒，為0表示馬上到期，不傳此參數表示不到期。
• PXAT：指定key的絕對到期時間，單位為毫秒 ，為0表示馬上到期，不傳此參數表示不到期。
• NX：只在key不存在時寫入。
• XX：只在key存在時寫入。
• VER：版本號碼。
  • 如果key存在，和目前的版本號做比較：
    • 如果相等，進行自增，且版本號碼加1。
    • 如果不相等，返回異常。
  • 如果key不存在或者key目前的版本為0，忽略傳入的版本號碼並進行自增操作，成功後版本號碼變為1。
• ABS：絕對版本號碼。設定後，無論key當前的版本號碼是多少，完成寫入並將key的版本號碼覆蓋為該選項中設定的值。
• MIN：設定TairString value的最小值。
• MAX：設定TairString value的最大值。
• KEEPTTL：延用該key原本設定的到期時間，該參數不能與EX、PX、EXAT、PXAT參數同時設定。
  說明 若未設定KEEPTTL參數，也未設定EX、PX等設定到期時間的參數，則該key的到期時間將被刪除，即表示該key不會到期。

• 執行成功：操作後value的值。
• 若設定了MAX或MIN，而操作後的value超過了該範圍：(error) ERR increment or decrement would overflow。
• 其它情況返回相應的異常資訊。

提前執行EXSET foo 1命令。

命令樣本：

EXINCRBYFLOAT foo 10.123

返回樣本：

(integer) 11.123

當目標key的version值與指定的version相等時，則更新key的value值；version不相等，則返回舊的value和version。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• newvalue：若key的version值與指定的version相等，將value修改為newvalue。
• version：用於跟key的現有version值比較的值。

• 執行成功：["OK", "",最新的version]。中間的""為無意義的Null 字元串。
• 執行失敗：["ERR update version is stale", value, version]。value和version為key當前的value和版本。
• 若key不存在：-1。
• 其它情況返回相應的異常資訊。

提前執行EXSET foo bar命令。

命令樣本：

EXCAS foo bzz 1

返回樣本：

1) OK
2)
3) (integer) 2

當目標key的version值與指定的version相等時，則刪除Key。

• Key：TairString的key，用於指定作為命令調用對象的TairString。
• version：用於跟key的現有version值比較的值。

• 執行成功：1。
• 執行失敗：0。
• 若key不存在：-1。
• 其它情況返回相應的異常資訊。

提前執行EXSET foo bar命令。

命令樣本：

EXCAD foo 1

返回樣本：

(integer) 1