unset

PHP マニュアル
前のページ		次のページ

説明

void unset ( mixed var [, mixed var [, mixed ...]] )

unset() は指定した変数を破棄します。PHP 3 では、 unset() は常に TRUE(実際には整数値 1) を返していました。しかし、PHP 4 では unset() はもはや真の意味で関数ではなく、命令となっています。値が返されないため、 unset() の値を取得しようとすると、パースエラーとなります。

例 1. unset() の例


<?php
// 変数を一つ破棄する
unset ($foo);

// 配列の要素の一つを破棄する
unset ($bar['quux']);

// 複数の変数を破棄する
unset ($foo1, $foo2, $foo3);
?>

注意: 現在のコンテキストで見えるものであれば、オブジェクトのプロパティでさえも破棄することが可能です。

関数 unset() の内部動作は、破棄しようとする変数の型に依存します。

あるグローバル変数が関数の中で unset() された場合、ローカル変数のみが破棄されます。呼出側の環境にある変数は、 unset() がコールされる前と同じ値を保持します。


<?php
function destroy_foo()
{
    global $foo;
    unset($foo);
}

$foo = 'bar';
destroy_foo();
echo $foo;
?>

上の例の出力は以下となります。

bar

グローバル変数を関数の内部で unset() したい場合は、 $GLOBALS 配列を使用することが可能です。


<?php
function foo() 
{
    unset($GLOBALS['bar']);
}

$bar = "something";
foo();
?>

参照渡しされた変数が関数内で unset() された場合に、ローカル変数のみが破棄されます。呼出側の環境でその変数は、 unset() がコールされる前と同じ値を保持します。


<?php
function foo(&$bar)
{
    unset($bar);
    $bar = "blah";
}

$bar = 'something';
echo "$bar\n";

foo($bar);
echo "$bar\n";
?>

上の例の出力は以下となります。

something
something

静的変数が関数の内部で unset() された場合、 unset() は、その関数の残りのコンテキスト内においてのみ変数を破棄します。関数を再度コールすると、破棄する前の値が復元されます。


<?php
function foo()
{
    static $bar;
    $bar++;
    echo "Before unset: $bar, ";
    unset($bar);
    $bar = 23;
    echo "after unset: $bar\n";
}

foo();
foo();
foo();
?>

上の例の出力は以下となります。

Before unset: 1, after unset: 23
Before unset: 2, after unset: 23
Before unset: 3, after unset: 23

注意: これは、関数ではなく言語構造のため、可変関数を用いてコールすることはできません。

isset()、 empty()、 array_splice() も参照ください。

前のページ	ホーム	次のページ
unserialize	上に戻る	var_dump