Russian Ukraine English
Catalog RSS


unset

(unknown)

unset -- Unset a given variable

Description

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

unset() destroys the specified variables and returns true.

Example 1. Unset() example


// destroy a single variable unset ($foo);  // destroy a single element of an array unset ($bar['quux']);  // destroy more than one variable unset ($foo1, $foo2, $foo3);       

The behavior of unset() inside of a function can vary depending on what type of variable you are attempting to destroy.

If a globalized variable is unset() inside of a function, only the local variable is destroyed. The variable in the calling environment will retain the same value as before unset() was called.


function destroy_foo() {     global $foo;     unset($foo); }  $foo = 'bar'; destroy_foo(); echo $foo;       

The above example would output:


bar       

If a variable that is PASSED BY REFERENCE is unset() inside of a function, only the local variable is destroyed. The variable in the calling environment will retain the same value as before unset() was called.


function foo(&$bar) {      unset($bar);      $bar = "blah";  }  $bar = 'something'; echo "$bar\n";  foo($bar); echo "$bar\n";       

The above example would output:


something something       

If a static variable is unset() inside of a function, unset() unsets the reference to the static variable, rather than the static variable itself.


function foo() {      static $a;     $a++;        echo "$a\n";      unset($a); }  foo(); foo(); foo();       

The above example would output:


1 2 3       

If you would like to unset() a global variable inside of a function, you can use the $GLOBALS array to do so:


function foo() {     unset($GLOBALS['bar']);        }  $bar = "something"; foo();       

See also isset() and empty().

Led