PHP 8.4.6 Released!

Memcached::isPristine

(PECL memcached >= 2.0.0)

Memcached::isPristineCheck if the instance was recently created

Description

public Memcached::isPristine(): bool

Memcached::isPristine() checks if the Memcache instance was recently created.

Parameters

This function has no parameters.

Return Values

Returns true if instance is recently created, false otherwise.

See Also

User Contributed Notes

gerben at gerbs dot net
9 years ago
How is the return value determined? What is the definition of 'recently'? Does this function return true if the item was stored using the current connection?
vick dot qi at yahoo dot com
8 years ago
From the source code of contructor, the "recently" means the connection to server of the instence is recently created, that is the instance was created without a persistent_id parameter or the first to use the persistent_id.

For instance, the gives a bool(true):

$memcached = new Memcached();
$isPristine = $memcached->isPristine();
var_dump($isPristine);

This also gives a bool(true):

$memcached = new Memcached('pid1');
$isPristine = $memcached->isPristine();
var_dump($isPristine);

while this gives a bool(false):

$memcached = new Memcached('pid1');
$memcached2 = new Memcached('pid1');
$isPristine = $memcached2->isPristine();
var_dump($isPristine);
To Top