Memcached Memcached::decrement
(PECL memcached >= 0.1.0)
Memcached::decrement — 숫자 항목 값 감소
설명
public Memcached::decrement( string $key, int $offset = 1, int $initial_value = 0, int $expiry = 0 ): int|false
Memcached::decrement()는 숫자 항목의 값을 지정된 offset
만큼 감소시킵니다. 항목의 값이 숫자가 아니면 오류가 발생합니다. 작업으로 인해 값이 0 미만으로 감소하면 새 값은 0이 됩니다. Memcached::decrement()는 키가 존재하지 않는 경우 항목을 initial_value
매개변수로 설정합니다.
매개변수
key
- 감소할 항목의 키입니다.
offset
- 항목의 값을 감소시킬 양입니다.
initial_value
- 항목이 현재 존재하지 않는 경우 설정할 값입니다.
expiry
- 항목에 설정할 만료 시간입니다.
반환 값
성공하면 항목의 새 값을 반환하고 실패하면 false
를 반환합니다.
Examples
예제 #1 Memcached::decrement() 예제
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->set('counter', 5);
$n = $m->decrement('counter');
var_dump($n);
$n = $m->decrement('counter', 10);
var_dump($n);
var_dump($m->get('counter'));
$m->set('counter', 'abc');
$n = $m->increment('counter');
// ^ will fail due to item value not being numeric
var_dump($n);
?>
위의 예는 다음을 출력합니다.
int(4) int(0) int(0) bool(false)
기타
- Memcached::increment() - 숫자 항목의 값 증가
- Memcached::incrementByKey() - 특정 서버에 저장된 숫자 항목의 값 증가
- Memcached::decrementByKey() - 특정 서버에 저장된 숫자 항목의 값 감소