Memcache::decrement

memcache_decrement

(PECL memcache >= 0.2.0)

Memcache::decrement -- memcache_decrement — 項目の値を減らす

説明

function Memcache::decrement(string $key, int $value = 1): int|false

function memcache_decrement(Memcache $memcache, string $key, int $value = 1): int|false

Memcache::decrement() は、項目の値を value だけ減らします。 Memcache::increment() と同様、項目の現在の値がまず数値に変換されてから value を引きます。

注意: 項目の新しい値をゼロより小さくすることはできません。

注意: 圧縮して格納されている項目に対して Memcache::decrement() を使用しないでください。なぜなら、それ以降の Memcache::get() のコールが失敗してしまうからです。

Memcache::decrement() は、指定した項目が存在しない場合に項目を作成することは ありません。

パラメータ

key: 値を減らす項目のキー。
value: 項目の値を value だけ減らします。

戻り値

項目の新しい値か、失敗した場合に false を返します。

例

例1 Memcache::decrement() の例

<?php

/* 手続き型の API */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* 項目の値を 2 減らします */
$new_value = memcache_decrement($memcache_obj, 'test_item', 2);

/* オブジェクト指向の API */
$memcache_obj = new Memcache;
$memcache_obj->connect('memcache_host', 11211);
/* 項目の値を 3 減らします */
$new_value = $memcache_obj->decrement('test_item', 3);
?>

参考

Memcache::increment() - 項目の値を増やす
Memcache::replace() - 既存項目の値を置換する

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes

There are no user contributed notes for this page.