C++で「ファイル名を取得する」と言っても、その意味は一つではありません。
何のファイル名を、いつ、どの環境で取得したいのかによって、考え方も手段も大きく変わります。
この点を整理せずに解説すると誤解が生じやすいため、本記事では 目的別に正しい理解を整理し、あわせて よくある勘違いや注意点も明確にします。
ソースコードのファイル名を取得する場合
C++には、ソースコード自身のファイル名を示すための仕組みがあります。
これは実行時に取得される情報ではなく、コンパイル時に文字列として埋め込まれるものです。
重要なポイント
- 取得できるのは 「実行ファイル名」ではなく「ソースファイル名」
- 値は コンパイル時に確定する
- フルパスになるか相対パスになるかは ビルド方法・ツールチェーンに依存
多くの環境では、コンパイラに渡されたソースファイルのパスがそのまま反映されます。
つまり「コンパイラが勝手にフルパスにする」のではなく、ビルド時にどう指定されたかが結果を左右します。
主な用途
- ログ出力
- デバッグ情報
- エラーメッセージの詳細化
なお、この方法は 実行ファイル名の取得には使えません。
ここを混同するのは非常によくある誤解です。
実行ファイル自身の名前・パスを取得する場合
実行中のプログラムが「自分自身の実行ファイル」を知りたい場合、C++標準だけで完結する方法は存在せず、OS依存の仕組みを使う必要があります。
OSごとの基本的な考え方
- Windows：Windows API を利用する
- Linux：
/procファイルシステムを利用する方法が一般的 - macOS：Linuxとは異なる専用APIを使う
- BSD系：さらに別の仕組みになる
特に注意すべき点として、LinuxとmacOSは同じ方法では取得できません。
見た目が似ていても、内部の仕組みが異なるためです。
そのため、「Unix系だから同じでいい」という理解は危険で、クロスプラットフォーム対応が必要な場合は、OSごとに処理を分ける設計が必須になります。
コマンドライン引数から取得する方法について
多くのC++プログラムでは、起動時にコマンドライン引数が渡されます。
その中には、慣習的に「実行ファイル名」や「実行時に指定されたパス」が含まれることがあります。
ただし注意点
- これは 仕様として保証された挙動ではない
- 実行方法や起動元によって内容が変わる
- フルパスとは限らず、相対パスや単なる名前だけの場合もある
- 起動元が任意の文字列を渡すことも理論上は可能
そのため、この情報は 「表示用」や「参考情報」程度に扱うのが安全であり、「必ず正確な実行ファイルパスが取れる」と期待するべきではありません。
ファイルパスから「ファイル名だけ」を取り出したい場合
実行ファイル・入力ファイル・設定ファイルなど、すでにパス文字列を持っている状態で、その一部（ファイル名や拡張子）を扱いたいというケースは非常に多くあります。
この用途に関しては、現在のC++では明確なベストプラクティスがあります。
正しい考え方
- パスは「文字列」ではなく「構造化された情報」として扱う
- OSごとの区切り文字や仕様差を自分で処理しない
- 標準ライブラリのパス操作機能を使う
これにより、以下のような情報を安全に扱えます。
- ファイル名
- 拡張子
- 拡張子を除いた名前
- 親ディレクトリ
- 絶対パスか相対パスか
逆に、文字列操作で区切り文字を探す方法は、
- OS差異
- UNCパス
- ドライブレター
- 特殊プレフィックス
などで破綻しやすく、実務では避けるべき方法です。
よくある誤解と注意点
誤解①
「ソースファイル名を取得できるなら、実行ファイル名も同じ方法で取れる」
→ 完全に別物です。用途も仕組みも異なります。
誤解②
「Unix系OSなら同じ方法で実行ファイルパスが取れる」
→ LinuxとmacOSは別です。混同すると確実に動かなくなります。
誤解③
「固定長の最大パス長を前提にして問題ない」
→ 環境によっては成り立たないケースがあります。
厳密な安全性を求めるなら注意が必要です。
実務的な整理（結論）
目的ごとに考えると、選択肢は明確になります。
- ソースコードのファイル名が欲しい
→ コンパイル時情報として扱う - 実行ファイル自身の名前やパスが欲しい
→ OSごとの仕組みを使う（共通化には設計が必要） - 入力ファイル名や指定されたパスを扱いたい
→ 起動引数として受け取る - パスからファイル名・拡張子などを分解したい
→ 標準ライブラリのパス操作機能を使う
まとめ
C++における「ファイル名取得」は、一つのテクニックを覚えれば済む話ではなく、目的と文脈を正しく分けることが重要です。
この整理ができていれば、
- ログ設計
- CLIツール開発
- クロスプラットフォーム対応
- 保守性の高いコード設計
すべてで判断を誤りにくくなります。
以上、C++のファイル名の取得についてでした。
最後までお読みいただき、ありがとうございました。
