Memcached incr と decr コマンド

Memcached incr と decr コマンドは、既存の key(キー) の数値に対してインクリメントまたはデクリメント操作を行うために使用されます。

incr と decr コマンドで操作するデータは、10進数の32ビット符号なし整数でなければなりません。

key が存在しない場合は返しますNOT_FOUND、キーの値が数値でない場合は返しますCLIENT_ERROR、その他のエラーは返しますERROR。


incr コマンド

構文:

incr コマンドの基本的な構文形式は次のとおりです:

incr key increment_value

パラメータの説明は次のとおりです:

  • key:キーと値の key-value 構造における key で、キャッシュ値を検索するために使用されます。
  • increment_value: 増加する数値。

例

以下の例では、visitors を key として使用し、初期値を 10 として、その後 5 を加算する操作を行います。

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
incr visitors 5
15
get visitors
VALUE visitors 0 2
15
END

出力

出力情報の説明:

  • NOT_FOUND:key が存在しません。
  • CLIENT_ERROR:インクリメント値がオブジェクトではありません。
  • ERRORその他のエラー、構文エラーなど。

decr コマンド

decr コマンドの基本的な構文形式は次のとおりです:

decr key decrement_value

パラメータの説明は次のとおりです:

  • key:キーと値の key-value 構造における key で、キャッシュ値を検索するために使用されます。
  • decrement_value: 減らす数値。

例

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
decr visitors 5
5
get visitors
VALUE visitors 0 1
5
END

以下の例では、visitors を key として使用し、初期値を 10 として、その後 5 を減算する操作を行います。

出力

出力情報の説明:

  • NOT_FOUND:key が存在しません。
  • CLIENT_ERROR:インクリメント値がオブジェクトではありません。
  • ERRORその他のエラー、構文エラーなど。
その他の拡張