関数・クラス解説

unset

version:PHP 4, PHP 5, PHP 7 (公式)

指定した変数の割当を解除する

公式リファレンス

書式

unset ( mixed $var , mixed ...$vars ) : void

説明

unset() は指定した変数を破棄します。

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

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

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

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

bar

グローバル変数を関数の内部で unset() するには、 $GLOBALS 配列を使います。

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

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

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

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

somethingsomething

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

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: 23Before unset: 2, after unset: 23Before unset: 3, after unset: 23

パラメータ

var
破棄する変数。
vars
別の変数。

返値

値を返しません。

注意

注意: これは、関数ではなく言語構造のため、可変関数 を用いてコールすることはできません。
注意: 現在のコンテキストで見えるものであれば、 オブジェクトのプロパティでさえも破棄することが可能です。
注意: オブジェクトのメソッド内で $this を破棄することはできません。
注意: オブジェクトのアクセス不能なプロパティに対して unset() を使用した場合は、もしオーバーロードメソッド __unset() が宣言されていればそれをコールします。

サンプル

例1 unset() の例

// 変数を一つ破棄する unset($foo); // 配列の要素の一つを破棄する unset($bar['quux']); // 複数の変数を破棄する unset($foo1, $foo2, $foo3);

例2 (unset) によるキャスト

(unset) によるキャストは unset() 関数と混同されがちです。 (unset) によるキャストは、 単に NULL 型へのキャストを徹底するだけであり、 キャストした変数の値を書き換えるわけではありません。 (unset) によるキャストは、PHP 7.2.0 で非推奨になります。

$name = 'Felipe'; var_dump((unset) $name); var_dump($name);

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

NULL string(6) "Felipe"

参考

  • isset() - 変数が宣言されていること、そして NULL とは異なることを検査する
  • empty() - 変数が空であるかどうかを検査する
  • __unset()
  • array_splice() - 配列の一部を削除し、他の要素で置換する
  • (unset) casting
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール