Memcache::decrement()函式—用法及示例

函式名稱：Memcache::decrement()

適用版本：PHP 5 >= 5.2.0, PECL memcache >= 2.0.0

函式描述：Memcache::decrement() 函式用於減少指定鍵對應的值。如果鍵不存在，則建立一個新的鍵，並將其值設定為指定的減量值。

用法：

bool Memcache::decrement ( string $key [, int $value = 1 [, int &$initial_value ]] )

引數：

• key: 要減少值的鍵名。
• value: 要減少的值。預設為1。
• initial_value: 如果鍵不存在，設定的初始值。如果設定了該引數，當鍵不存在時，將使用該值作為鍵的初始值。

返回值：

• 減少後的值，如果操作失敗則返回 false。

示例：

// 建立一個 Memcache 物件
$memcache = new Memcache;

// 連線到 Memcached 伺服器
$memcache->connect('localhost', 11211) or die ("無法連線到 Memcached 伺服器");

// 設定初始值為10的鍵 'count'
$memcache->set('count', 10, 0, 3600);

// 減少鍵 'count' 的值
$newValue = $memcache->decrement('count', 3);

if ($newValue !== false) {
    echo "鍵 'count' 的新值為: " . $newValue;
} else {
    echo "操作失敗";
}

// 輸出結果：
// 鍵 'count' 的新值為: 7

注意事項：

• Memcache::decrement() 函式只能用於與 Memcached 伺服器連線的情況，不適用於 Memcache 伺服器。
• 如果鍵的值不是數字，或者無法被減少，則函式返回 false。
• 如果沒有指定初始值引數，並且鍵不存在，則函式會建立一個新的鍵，並將其值設定為0減去指定的減量值。