unset

(PHP 4, PHP 5, PHP 7, PHP 8)

unset釋放給定的變量

說明

unset(mixed $var, mixed $... = ?): void

unset() 銷毀指定的變量。

unset() 在函數(shù)中的行為會依賴于想要銷毀的變量的類型而有所不同。

如果在函數(shù)中 unset() 一個全局變量,則只是局部變量被銷毀,而在調用環(huán)境中的變量將保持調用 unset() 之前一樣的值。

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

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

以上例程會輸出:

bar

如果您想在函數(shù)中 unset() 一個全局變量,可使用 $GLOBALS 數(shù)組來實現(xiàn):

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

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

如果在函數(shù)中 unset() 一個通過引用傳遞的變量,則只是局部變量被銷毀,而在調用環(huán)境中的變量將保持調用 unset() 之前一樣的值。

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

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

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

以上例程會輸出:

something
something

如果在函數(shù)中 unset() 一個靜態(tài)變量,那么在函數(shù)內部此靜態(tài)變量將被銷毀。但是,當再次調用此函數(shù)時,此靜態(tài)變量將被復原為上次被銷毀之前的值。

<?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

參數(shù)

var

要銷毀的變量。

...

其他變量……

返回值

沒有返回值。

范例

示例 #1 unset() 示例

<?php
// 銷毀單個變量
unset ($foo);

// 銷毀單個數(shù)組元素
unset ($bar['quux']);

// 銷毀一個以上的變量
unset($foo1$foo2$foo3);
?>

示例 #2 使用 (unset) 類型強制轉換

(unset) 類型強制轉換常常和函數(shù) unset() 引起困惑。 為了完整性,(unset) 是作為一個 NULL 類型的強制轉換。它不會改變變量的類型。

<?php
$name 
'Felipe';

var_dump((unset) $name);
var_dump($name);
?>

以上例程會輸出:

NULL
string(6) "Felipe"

注釋

注意: 因為是一個語言構造器而不是一個函數(shù),不能被 可變函數(shù) 調用。

注意:

It is possible to unset even object properties visible in current context.

注意:

在 PHP 5 之前無法在對象里銷毀 $this。

注意:

unset() 一個無法訪問的對象屬性時,如果定義了 __unset() 則對調用這個重載方法。

參見

  • isset() - 檢測變量是否已聲明并且其值不為 null
  • empty() - 檢查一個變量是否為空
  • __unset()
  • array_splice() - 去掉數(shù)組中的某一部分并用其它值取代