Replace value of the existing item

# Memcache::replace

# memcache_replace

(PECL memcache >= 0.2.0)

Memcache::replace -- memcache_replace — Replace value of the existing item

### Description

Memcache::replace(
string `$key`,
mixed `$var`,
int `$flag` = ?,
int `$expire` = ?
): bool
memcache_replace(
Memcache `$memcache`,
string `$key`,
mixed `$var`,
int `$flag` = ?,
int `$expire` = ?
): bool

Memcache::replace() should be used to replace value of existing item with `key`. In case if item with such key doesn't exists, Memcache::replace() returns `false`. For the rest Memcache::replace() behaves similarly to Memcache::set().

### Parameters

`key`
  The key that will be associated with the item.
`var`
  The variable to store. Strings and integers are stored as is, other types are stored serialized.
`flag`
  Use `MEMCACHE_COMPRESSED` to store the item compressed (uses zlib).
`expire`
  Expiration time of the item. If it's equal to zero, the item will never expire. You can also use Unix timestamp or a number of seconds starting from current time, but in the latter case the number of seconds may not exceed 2592000 (30 days).

### Return Values

Returns `true` on success or `false` on failure.

### Examples

Example #1 Memcache::replace() example

`<?php
$memcache_obj = memcache_connect('memcache_host', 11211);
/* procedural API */
memcache_replace($memcache_obj, "test_key", "some variable", false, 30);
/* OO API */
$memcache_obj->replace("test_key", "some variable", false, 30);
?>`

### See Also

- Memcache::set() - Store data at the server
- Memcache::add() - Add an item to the server

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open