Memcached の incr および decr コマンド

Memcached incr および decr コマンドは、既存のキーの数値を増加または減少させるために使用されます。

incr および decr コマンドで操作されるデータは、10 進数の 32 ビット符号なし整数である必要があります。

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

incrコマンド

構文:

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

incr key increment_value

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

• key: Key value Key-Valueのキー構造体はキャッシュされた値を検索するために使用されます。

• increment_value: 増加した値。

例

次の例では、訪問者をキーとして使用し、初期値は 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

Output

出力情報の説明:

• NOT_FOUND: キーが存在しません。

• CLIENT_ERROR: 自動インクリメントされる値はオブジェクトではありません。

• ERROR文法上の誤りなどのその他のエラー。

decrコマンド

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

decr key decrement_value

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

• key: Key value キーと値の構造内のキーは次のとおりです。キャッシュされた値を検索するために使用されます。

• 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

次の例では、訪問者をキーとして使用し、初期値は 10 で、その後 5 減算されます。

出力

出力情報の説明:

• NOT_FOUND: キーが存在しません。

• CLIENT_ERROR: 自己増加する値はオブジェクトではありません。

• ERROR文法上の誤りなどのその他のエラー。