<?php

public function &getRef();

?>

getRef() メソッドは、オブジェクトの値への参照を返します。

移動可能なオブジェクトは、もしメモリ内になければ この時点でキャッシュから読み込まれます。 オブジェクトをキャッシュから読み込んだ場合に、 メモリ内で管理しているオブジェクトのサイズが制限に達すると、 他のオブジェクトのスワップが発生します。

PHP のバージョンが 5.2 より古い場合、メモリオブジェクトのデータにアクセスするには 必ず getRef() メソッドを使用する必要があります。

データの変更内容を追いかけるには、余分なリソースが必要となります。 getRef() メソッドは文字列への参照を返し、 これはアプリケーションから直接変更することになります。 つまり、データの内容を処理する際には getRef() メソッドを使用するのがうまいやり方となります。

<?php

$memObject = $memoryManager->create($data);

$value = &$memObject->getRef();

for ($count = 0; $count < strlen($value); $count++) {
    $char = $value[$count];
    ...
}
?>

<?php

public function touch();

?>

touch() メソッドは getRef() と同じように使用しなければなりません。 これは、オブジェクトの値が変更されたことを通知します。

<?php

$memObject = $memoryManager->create($data);
...

$value = &$memObject->getRef();

for ($count = 0; $count < strlen($value); $count++) {
    ...
    if ($condition) {
        $value[$count] = $char;
    }
    ...
}

$memObject->touch();

?>

<?php

public function lock();

?>

lock() メソッドは、オブジェクトをメモリ内にロックします。 これを使用して、スワップしたくないオブジェクトを選択します。 通常はこれは不要です。なぜなら、メモリマネージャが うまい具合にスワップする候補を選ぶようにできているからです。 しかし、どうしてもスワップしてはならないオブジェクトがあることがわかっている場合は、 それをロックするとよいでしょう。

オブジェクトをメモリ内にロックすることで、ロックを解除するまでは getRef() メソッドの返す参照が有効であることが保証されます。

<?php

$memObject1 = $memoryManager->create($data1);
$memObject2 = $memoryManager->create($data2);
...

$memObject1->lock();
$memObject2->lock();

$value1 = &$memObject1->getRef();
$value2 = &$memObject2->getRef();

for ($count = 0; $count < strlen($value2); $count++) {
    $value1 .= $value2[$count];
}

$memObject1->touch();
$memObject1->unlock();
$memObject2->unlock();

?>

<?php

public function unlock();

?>

unlock() メソッドは、 ロックが不要となったオブジェクトのロックを解除します。 上の例を参照ください。

<?php

public function isLocked();

?>

isLocked() メソッドを使用して、 オブジェクトがロックされているかどうかを調べます。 オブジェクトがロックされている場合は true、 ロックされていない場合は false を返します。 "ロックされている" オブジェクトについては、これは常に true を返します。また "移動可能な" オブジェクトの場合は true あるいは false のいずれかを返します。