【PHP8.x】lineプロパティの使い方

lineプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

lineプロパティは、OutOfRangeExceptionがスローされたソースコードの行番号を保持するプロパティです。OutOfRangeExceptionは、配列などで定義された範囲外のインデックスにアクセスしようとした場合など、無効なキーが要求された際に発生する例外です。このlineプロパティは、PHPの基本的な例外クラスであるExceptionクラスから継承されたものであり、すべての組み込み例外で利用可能です。プログラムの実行中にOutOfRangeExceptionが発生すると、PHPエンジンは例外が生成された時点の行番号をこのプロパティに自動的に設定します。開発者はtry...catchブロックで例外を捕捉し、getLine()メソッドを通じてこのプロパティの値にアクセスできます。この行番号の情報は、エラーの原因となっているコードの箇所を迅速かつ正確に特定するために非常に重要であり、デバッグ作業において不可欠な役割を果たします。同じく継承されているfileプロパティ(ファイル名)と組み合わせることで、問題の発生場所をより詳細に把握することが可能になります。

構文(syntax)

1<?php
2
3try {
4    // この行で例外がスローされます
5    throw new OutOfRangeException("インデックスが範囲外です。");
6
7} catch (OutOfRangeException $e) {
8    // 例外がスローされた行番号を取得して出力します
9    echo $e->getLine();
10}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

このプロパティは、例外が発生した行番号を整数型で返します。

関連コンテンツ

関連プログラミング言語