Memcached Memcached::decrementByKey

(PECL memcached >= 2.0.0)

Memcached::decrementByKey — 특정 서버에 저장된 숫자 항목의 값 감소


설명

public Memcached::decrementByKey(
    string $server_key,
    string $key,
    int $offset = 1,
    int $initial_value = 0,
    int $expiry = 0
): int|false
                

Memcached::decrementByKey()는 숫자 항목의 값을 지정된 offset만큼 감소시킵니다. 항목의 값이 숫자가 아니면 오류가 발생합니다. 작업으로 값이 0 미만으로 감소하면 새 값은 0이 됩니다. Memcached::decrementByKey()는 키가 존재하지 않는 경우 항목을 initial_value 매개변수로 설정합니다.


매개변수

server_key
값을 저장하거나 검색할 서버를 식별하는 키입니다. 항목에 대한 실제 키를 해싱하는 대신 통신할 memcached 서버를 결정할 때 서버 키를 해싱합니다. 이를 통해 관련 항목을 단일 서버에서 함께 그룹화하여 다중 작업의 효율성을 높일 수 있습니다.
key
감소할 항목의 키입니다.
offset
항목의 값을 감소시킬 양입니다.
initial_value
항목이 현재 존재하지 않는 경우 설정할 값입니다.
expiry
항목에 설정할 만료 시간입니다.

반환 값

성공하면 항목의 새 값을 반환하고 실패하면 false를 반환합니다.


기타