C#の#lineディレクティブとは？使い方と具体例をわかりやすく解説

#lineディレクティブの概要

C#の#lineディレクティブを使うと、コンパイラがエラーや警告を出力する際に表示される行番号、および（オプションで）ファイル名を変更できます。

これは主に、コード生成ツールやテンプレートエンジンなど、中間コードを自動生成する場面で役立ちます。生成元のソースファイルの行番号やファイル名を正しく報告できるようにすることで、デバッグの効率が大幅に向上します。

#lineディレクティブの基本的な使い方

まずは具体的な例を見てみましょう。

#line 100 "demo"
int a;    // 100行目で CS0168
int b;    // 101行目で CS0168
int c;    // 102行目で CS0168

上記の例では、3つの警告が行番号とともに報告されます。#line 100 "demo"ディレクティブによって行番号が強制的に100に設定され、次の#lineディレクティブが現れるまで、ファイル名は「demo」として報告されます。

つまり、実際の物理的な行位置ではなく、開発者が指定した仮想的な行番号・ファイル名がコンパイラの出力に反映されるのです。

#line defaultで既定の行番号に戻す

次に、もう一つの例を見てみましょう。#line defaultディレクティブは、行番号を既定（デフォルト）の状態に戻します。このディレクティブ以降は、以前の#lineディレクティブによる再番号付けをリセットし、実際の行数に基づいてカウントされます。

#line default
char a;   // 15行目で CS0168
float b;  // 16行目で CS0168

このように、#line defaultを記述した以降の行では、通常の行番号が再び使用されるようになります。

まとめ

• #line 行番号 "ファイル名"：以降のエラー・警告出力における行番号とファイル名を指定した値に変更する。
• #line default：行番号とファイル名を既定の状態に戻す。
• 主にコードジェネレーターなど、自動生成コードのデバッグ情報を整える目的で活用される。

#lineディレクティブを適切に使えば、自動生成コードを含むプロジェクトでも、元のソースに対応した正確なデバッグ情報を得ることができ、開発効率の向上につながります。