PHP 8.4.0 RC4 available for testing

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

add a note

User Contributed Notes 2 notes

up
4
gerben at gerbs dot net
8 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?
up
0
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