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その他のエラー、構文エラーなど。