QFileInfo::canonicalFilePath()だけじゃない！Qtでパス操作をする代替手段

QFileInfo::canonicalFilePath() とは

QFileInfo::canonicalFilePath()は、指定されたファイルまたはディレクトリの**「正規化された絶対パス」**を返します。

具体的には、以下の特徴を持つパスを返します。

1. 絶対パスであること: 相対パス（例: ../foo/bar.txt）ではなく、ファイルシステムのルートから始まる完全なパス（例: /home/user/document/foo/bar.txt）を返します。
2. シンボリックリンクを解決すること: もしファイルがシンボリックリンク（Windowsでいうショートカット）である場合、そのリンクが指し示す実際のファイルまたはディレクトリのパスを追跡して返します。
3. 冗長な要素を取り除くこと: パスに含まれる冗長な要素（例: ./ や ../）を取り除き、最短で正確なパスを返します。
   • ./ は現在のディレクトリを意味するため、通常は省略されます。
   • ../ は親ディレクトリを意味しますが、これを適切に解決し、実際にたどるパスを返します。

なぜ "canonical" (正規化された) なのか？

ファイルシステム上では、同じファイルやディレクトリに対して複数のパスが存在する可能性があります。

• 冗長なパス要素: /path/to/./file.txt や /path/to/../other_path/file.txt のように、./ や ../ を含むことで、実際にはより短いパスで表現できる場合があります。
• シンボリックリンク: /usr/bin/my_program が /opt/my_app/bin/my_program_actual へのシンボリックリンクである場合、どちらのパスも同じ実行ファイルを指します。
• 相対パスと絶対パス: my_file.txt と /home/user/my_file.txt は同じファイルを指すことがあります。

canonicalFilePath() は、これらの複数の表現の中から、システムが認識する唯一の、最も直接的なパスを返そうとします。これにより、同じファイルを指す異なるパスを比較する際に、一貫した結果を得ることができます。

使用例

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QDir>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 存在しないファイルの場合
    QFileInfo nonExistentFile("non_existent_file.txt");
    qDebug() << "Non-existent file canonical path:" << nonExistentFile.canonicalFilePath();
    // 出力例: "Non-existent file canonical path:" "" (空文字列)

    // 相対パス
    QFileInfo relativeFile("./my_data/data.txt"); // 仮にこのファイルが存在するとする
    // 実行時のカレントディレクトリによって結果は変わります
    qDebug() << "Relative file canonical path:" << relativeFile.canonicalFilePath();
    // 出力例 (カレントディレクトリが /home/user/app の場合): "Relative file canonical path:" "/home/user/app/my_data/data.txt"

    // シンボリックリンクの例 (Linux/macOSの場合)
    // 例えば、/tmp/mylink が /var/log/syslog を指しているとする
    // system("ln -sf /var/log/syslog /tmp/mylink"); // テスト用にシンボリックリンクを作成

    QFileInfo symlinkFile("/tmp/mylink");
    if (symlinkFile.isSymLink()) {
        qDebug() << "Symlink target:" << symlinkFile.symLinkTarget();
        qDebug() << "Symlink canonical path:" << symlinkFile.canonicalFilePath();
    } else {
        qDebug() << "Not a symlink or symlink does not exist.";
    }
    // 出力例:
    // "Symlink target:" "/var/log/syslog"
    // "Symlink canonical path:" "/var/log/syslog"

    // 冗長なパス要素の例
    QFileInfo redundantPath("/usr/local/../local/bin/./program");
    qDebug() << "Redundant path canonical path:" << redundantPath.canonicalFilePath();
    // 出力例: "Redundant path canonical path:" "/usr/local/bin/program"

    // 実際のファイルパス
    QFileInfo actualFile("/etc/hosts");
    qDebug() << "Actual file canonical path:" << actualFile.canonicalFilePath();
    // 出力例: "Actual file canonical path:" "/etc/hosts" (ほとんどの場合、そのままのパス)

    return 0;
}

• absoluteFilePath()と比較すると、absoluteFilePath()は単に相対パスを絶対パスに変換するだけで、シンボリックリンクの解決や冗長な要素の除去は行いません。
• ファイルシステムのパフォーマンスに影響を与える可能性があります。特に、多くのファイルの正規パスを頻繁に取得する必要がある場合は、キャッシュなどを考慮する必要があります。
• canonicalFilePath()は、ファイルシステムを実際に問い合わせて情報を取得します。そのため、ファイルやディレクトリが存在しない場合、空の文字列を返します。

---

存在しないファイルのパスが空文字列になる

問題
canonicalFilePath() を呼び出した結果、空の QString が返ってくることがあります。

原因
QFileInfo::canonicalFilePath() は、ファイルシステムを実際に参照してパスを解決します。そのため、指定したファイルやディレクトリが存在しない場合、その正規パスを特定できないため、空文字列を返します。これはエラーではなく、仕様通りの動作です。

トラブルシューティング
canonicalFilePath() を呼び出す前に、QFileInfo::exists() を使ってファイルが存在するかどうかを確認することが重要です。

QFileInfo fileInfo("path/to/your/file.txt");
if (!fileInfo.exists()) {
    qWarning() << "Warning: File does not exist:" << fileInfo.filePath();
    // ファイルが存在しない場合の処理 (例: エラーメッセージの表示、処理の中止など)
} else {
    QString canonicalPath = fileInfo.canonicalFilePath();
    if (canonicalPath.isEmpty()) {
        // 通常は exists() が true ならここには来ないはずだが、
        // 特殊なファイルシステムの問題などで念のためチェック
        qWarning() << "Error: Could not get canonical path for existing file:" << fileInfo.filePath();
    } else {
        qDebug() << "Canonical path:" << canonicalPath;
    }
}

canonicalPath() との混同

問題
QFileInfo::canonicalPath() というよく似た名前の関数があり、間違ってこちらを使ってしまうことがあります。canonicalPath() はファイルの親ディレクトリの正規パスを返すため、期待するファイル自体のパスが得られません。

原因
名前が似ているため、誤って canonicalPath() を呼び出してしまう。

トラブルシューティング
ファイルやディレクトリ自体の正規パスが必要な場合は、必ず **canonicalFilePath()** を使用しているか確認してください。

QFileInfo fileInfo("/home/user/document/my_file.txt");

// 正しい: ファイル自体の正規パス
QString fileCanonicalPath = fileInfo.canonicalFilePath();
qDebug() << "Canonical File Path:" << fileCanonicalPath; // 例: "/home/user/document/my_file.txt"

// 間違いやすい: 親ディレクトリの正規パス
QString parentCanonicalPath = fileInfo.canonicalPath();
qDebug() << "Canonical Parent Path:" << parentCanonicalPath; // 例: "/home/user/document"

シンボリックリンクの無限ループ (稀)

問題
非常に稀なケースですが、シンボリックリンクが互いに参照し合うような循環参照（例: A -> B, B -> A）がある場合、canonicalFilePath() が無限ループに陥る可能性があります。ただし、Qt の内部実装はこのようなケースに対処するよう設計されているため、通常は発生しません。

原因
ファイルシステム上に不正なシンボリックリンク構造が存在する場合。

トラブルシューティング
これはアプリケーションコード側で直接解決できる問題ではありませんが、もしパスの解決が異常に遅い、またはアプリケーションがハングアップする場合、シンボリックリンクの構造を疑ってみる価値があります。開発環境で、ls -lR (Linux/macOS) や dir /s /a (Windows) などでファイルシステムの構造を詳細に確認し、不正なリンクがないか調べてください。

パフォーマンスの問題

問題
大量のファイルに対して canonicalFilePath() を繰り返し呼び出すと、アプリケーションの動作が遅くなることがあります。

原因
canonicalFilePath() は、システムコール（OSへの問い合わせ）を通じてファイルシステムから情報を取得します。これは I/O 処理であり、CPU 処理よりもはるかに時間がかかります。

トラブルシューティング

• QFileInfo::setCaching(true) の確認
  QFileInfo はデフォルトでキャッシングが有効になっていることが多いですが、明示的に QFileInfo::setCaching(true) を設定することで、パフォーマンスが改善する場合があります。ただし、ファイルシステムが変更された場合は、キャッシュが無効になるか、QFileInfo::refresh() を呼び出す必要があることに注意してください。
• バックグラウンドスレッド
  パス解決が大量に発生する場合、UI スレッドをブロックしないように、バックグラウンドスレッドで処理を行うことを検討してください。ただし、Qt の一部のI/Oクラスはスレッドセーフではない場合があるので、ドキュメントを確認するか、適切な同期メカニズムを使用する必要があります。
• 遅延評価
  本当に正規パスが必要な時だけ canonicalFilePath() を呼び出すようにします。
• キャッシュの利用
  一度取得した正規パスは、必要に応じてアプリケーション内でキャッシュしてください。特に、頻繁にアクセスするパスについては、QMap<QString, QString> などに保存しておくと良いでしょう。

スレッドセーフティの問題 (古い Qt バージョンでの報告)

問題
過去のQtバージョン（特にQt4時代）では、マルチスレッド環境で QFileInfo::canonicalFilePath() を使用すると、稀に競合状態による誤った結果やクラッシュが発生するという報告がありました。

原因
古い Qt バージョンにおける QFileInfo の内部実装の制約や、スレッドセーフティの考慮不足。

• ミューテックスによる保護 (回避策)
  どうしても古い Qt バージョンを使用せざるを得ない場合や、問題が再現する場合、QFileInfo オブジェクトの作成と canonicalFilePath() の呼び出しを QMutex で保護することで、スレッド間の競合を防ぐことができます。
• 最新の Qt バージョンの使用
  ほとんどのこのような問題は、現代の Qt バージョン（Qt5以降、特にQt6）では修正されています。常に最新の安定版を使用することを推奨します。

// 非常に稀なケース、古いQtバージョンでのみ必要になる可能性
QMutex staticCanonicalPathMutex; // グローバルまたはシングルトンで管理

QString getCanonicalPathSafe(const QString& filePath) {
    QMutexLocker locker(&staticCanonicalPathMutex);
    QFileInfo fileInfo(filePath);
    return fileInfo.canonicalFilePath();
}

---

例1：相対パス、冗長なパス要素、存在しないファイルの処理

この例では、さまざまな種類のパスが canonicalFilePath() によってどのように処理されるかを示します。

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QDir> // QDir::currentPath() を使用するために必要

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 1. 絶対パス (ほとんどの場合、そのまま返される)
    QFileInfo info1("/etc/hosts"); // Linux/macOS の例
    // Windows の場合: QFileInfo info1("C:/Windows/System32/drivers/etc/hosts");
    qDebug() << "Original: /etc/hosts";
    qDebug() << "Canonical:" << info1.canonicalFilePath();
    qDebug() << "Exists:" << info1.exists();
    qDebug() << "--------------------";

    // 2. 相対パス (カレントディレクトリを基準に解決される)
    // 実行する前に、このファイルが実際に存在するようにします
    // 例: カレントディレクトリに "test_dir/sub_dir/my_file.txt" を作成
    QDir().mkdir("test_dir");
    QDir().mkdir("test_dir/sub_dir");
    QFile file("test_dir/sub_dir/my_file.txt");
    if (file.open(QIODevice::WriteOnly)) {
        file.write("Hello, world!");
        file.close();
    }

    QFileInfo info2("test_dir/sub_dir/../sub_dir/my_file.txt");
    qDebug() << "Original: test_dir/sub_dir/../sub_dir/my_file.txt";
    qDebug() << "Absolute (without canonical):" << info2.absoluteFilePath(); // canonicalではない絶対パス
    qDebug() << "Canonical:" << info2.canonicalFilePath(); // 冗長な要素が解決される
    qDebug() << "Exists:" << info2.exists();
    qDebug() << "--------------------";

    // 3. 存在しないファイル (空文字列を返す)
    QFileInfo info3("non_existent_file.xyz");
    qDebug() << "Original: non_existent_file.xyz";
    qDebug() << "Canonical:" << info3.canonicalFilePath(); // 空文字列
    qDebug() << "Exists:" << info3.exists(); // false
    qDebug() << "--------------------";

    // 4. シンボリックリンクの解決 (Linux/macOS の例)
    // テスト用にシンボリックリンクを作成
    // コマンドラインで: ln -s /etc/hosts /tmp/hosts_link
    // Windowsの場合: mklink C:\temp\hosts_link C:\Windows\System32\drivers\etc\hosts
#ifdef Q_OS_UNIX
    // Linux/macOS でのシンボリックリンク作成
    QProcess::execute("ln", {"-sf", "/etc/hosts", "/tmp/hosts_link"});
#elif defined(Q_OS_WIN)
    // Windows でのシンボリックリンク (ジャンクション) 作成
    // この方法は管理者権限が必要な場合があります
    // mklink /J C:\temp\hosts_link C:\Windows\System32\drivers\etc
    // (ファイルをリンクする場合は mklink C:\temp\hosts_link.txt C:\Windows\System32\drivers\etc\hosts)
    // 簡単のため、この例ではWindowsでのシンボリックリンクの作成は省略します
    // 自分で手動で作成してから実行してください
#endif

    QFileInfo info4("/tmp/hosts_link"); // 作成したシンボリックリンクのパス
    qDebug() << "Original: /tmp/hosts_link";
    qDebug() << "Is Symlink:" << info4.isSymLink();
    qDebug() << "Symlink Target:" << info4.symLinkTarget(); // リンクが指し示すパス
    qDebug() << "Canonical:" << info4.canonicalFilePath(); // 解決された実際のファイルのパス
    qDebug() << "Exists:" << info4.exists(); // リンク先が存在すれば true
    qDebug() << "--------------------";

    // 5. ディレクトリの正規パス
    QFileInfo info5("test_dir/sub_dir");
    qDebug() << "Original Dir: test_dir/sub_dir";
    qDebug() << "Canonical Dir Path:" << info5.canonicalFilePath(); // ディレクトリの正規パス
    qDebug() << "Exists:" << info5.exists();
    qDebug() << "--------------------";

    // 後処理 (作成したファイルを削除)
    QFile::remove("test_dir/sub_dir/my_file.txt");
    QDir().rmdir("test_dir/sub_dir");
    QDir().rmdir("test_dir");
#ifdef Q_OS_UNIX
    QFile::remove("/tmp/hosts_link");
#endif

    return 0;
}

解説

• info5: ディレクトリに対しても canonicalFilePath() を使用できます。ディレクトリの正規絶対パスを返します。
• info4: シンボリックリンクの場合、isSymLink() が true を返します。symLinkTarget() はリンクが指し示す文字列を返しますが、これは必ずしも正規のパスではありません。canonicalFilePath() はリンクをたどり、実際のファイル（/etc/hosts）の正規パスを返します。
• info3: 存在しないファイルの場合、canonicalFilePath() は空文字列を返します。これは意図された挙動であり、エラーではありません。
• info2: "test_dir/sub_dir/../sub_dir/my_file.txt" は冗長な ../ と sub_dir/ を含んでいます。canonicalFilePath() はこれを解決し、test_dir/sub_dir/my_file.txt の絶対パスを返します。absoluteFilePath() との違いに注目してください。absoluteFilePath() は単に相対パスを絶対パスに変換するだけで、冗長な要素は解決しません。
• info1: /etc/hosts のような絶対パスは、通常、それ自体が正規の形式であるため、canonicalFilePath() は同じパスを返します。

例2：パスの比較における canonicalFilePath() の利用

異なる記述のパスが実際には同じファイルを指しているかを安全に比較するために canonicalFilePath() を利用する例です。

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QFile>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // テスト用のファイルを作成
    QFile testFile("compare_test_dir/data.log");
    QDir().mkpath("compare_test_dir"); // 親ディレクトリも作成
    if (testFile.open(QIODevice::WriteOnly)) {
        testFile.write("Log data here.");
        testFile.close();
    }

    // 異なる形式で同じファイルを指すパス
    QString path1 = "compare_test_dir/data.log";
    QString path2 = "./compare_test_dir/data.log";
    QString path3 = QDir::currentPath() + "/compare_test_dir/data.log"; // 絶対パス
    QString path4 = "compare_test_dir/../compare_test_dir/data.log";

    // 存在しないが、構造は似ているパス
    QString path5 = "compare_test_dir/non_existent.log";

    QFileInfo info1(path1);
    QFileInfo info2(path2);
    QFileInfo info3(path3);
    QFileInfo info4(path4);
    QFileInfo info5(path5);

    qDebug() << "Comparing paths:";

    // 通常の filePath() や absoluteFilePath() で比較した場合
    qDebug() << "Using absoluteFilePath():";
    qDebug() << "info1.absoluteFilePath() == info2.absoluteFilePath():"
             << (info1.absoluteFilePath() == info2.absoluteFilePath()); // 環境によっては false になる可能性
    qDebug() << "info1.absoluteFilePath() == info3.absoluteFilePath():"
             << (info1.absoluteFilePath() == info3.absoluteFilePath()); // true
    qDebug() << "info1.absoluteFilePath() == info4.absoluteFilePath():"
             << (info1.absoluteFilePath() == info4.absoluteFilePath()); // false (冗長な要素のため)
    qDebug() << "--------------------";

    // canonicalFilePath() で比較した場合
    qDebug() << "Using canonicalFilePath():";
    qDebug() << "info1.canonicalFilePath() == info2.canonicalFilePath():"
             << (info1.canonicalFilePath() == info2.canonicalFilePath()); // true (同じファイル)
    qDebug() << "info1.canonicalFilePath() == info3.canonicalFilePath():"
             << (info1.canonicalFilePath() == info3.canonicalFilePath()); // true (同じファイル)
    qDebug() << "info1.canonicalFilePath() == info4.canonicalFilePath():"
             << (info1.canonicalFilePath() == info4.canonicalFilePath()); // true (同じファイル)
    qDebug() << "info1.canonicalFilePath() == info5.canonicalFilePath():"
             << (info1.canonicalFilePath() == info5.canonicalFilePath()); // false (ファイルが存在しない、または異なるファイル)
    qDebug() << "info5.canonicalFilePath():" << info5.canonicalFilePath(); // 空文字列

    // 後処理
    QFile::remove(path1);
    QDir().rmdir("compare_test_dir");

    return 0;
}

解説

この例では、path1、path2、path3、path4 が論理的には同じファイルを指していますが、文字列としての表現は異なります。

• path5 のようにファイルが存在しない場合、canonicalFilePath() は空文字列を返すため、これも比較で正しく「異なる」と判断されます。
• canonicalFilePath() を使うと、これらのパスはすべて実際のファイルシステムの「正規の場所」に解決されるため、すべて同じ文字列になり、安全に比較できます。
• absoluteFilePath() を使った比較では、path4 のように冗長な要素を含むパスは、同じファイルを指していても異なる文字列として扱われるため、比較が false になることがあります。

---

ここでは、canonicalFilePath() の代替手段と関連するパス操作について説明します。

QFileInfo::absoluteFilePath()

これは canonicalFilePath() の最も直接的な代替...というよりは、異なる目的を持つ関数です。

• 使用場面
  ファイルが存在するかどうかを問わず、単にパス文字列を絶対形式にしたい場合。例えば、QFile::open() に絶対パスを渡したいが、シンボリックリンクの解決やパスの正規化は不要な場合など。
• 違い
  
  • シンボリックリンクの解決は行いません。 シンボリックリンクのパスがそのまま絶対パスとして返されます。
  • 冗長な要素（./ や ../）は解決しません。 単純にカレントディレクトリを基準とした絶対パスに展開します。
• 目的
  相対パスを絶対パスに変換します。

例

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QDir>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // /tmp/test_dir/file.txt が存在すると仮定
    QDir().mkpath("/tmp/test_dir");
    QFile file("/tmp/test_dir/file.txt");
    file.open(QIODevice::WriteOnly);
    file.close();

    // シンボリックリンクを作成 (Linux/macOSの場合)
    // ln -s /tmp/test_dir /tmp/link_to_test_dir
#ifdef Q_OS_UNIX
    QProcess::execute("ln", {"-sf", "/tmp/test_dir", "/tmp/link_to_test_dir"});
#endif

    QFileInfo info1("./test_dir/file.txt"); // 相対パス
    QFileInfo info2("/tmp/link_to_test_dir/file.txt"); // シンボリックリンク経由のパス

    qDebug() << "--- Using absoluteFilePath() ---";
    qDebug() << "Original 1:" << info1.filePath();
    qDebug() << "Absolute 1:" << info1.absoluteFilePath(); // 例: "/path/to/current/dir/test_dir/file.txt"

    qDebug() << "Original 2:" << info2.filePath();
    qDebug() << "Absolute 2:" << info2.absoluteFilePath(); // 例: "/tmp/link_to_test_dir/file.txt" (リンクは解決されない)

    qDebug() << "--- Using canonicalFilePath() ---";
    qDebug() << "Canonical 1:" << info1.canonicalFilePath();
    qDebug() << "Canonical 2:" << info2.canonicalFilePath(); // 例: "/tmp/test_dir/file.txt" (リンクが解決される)

    // 後処理
    QFile::remove("/tmp/test_dir/file.txt");
    QDir().rmdir("/tmp/test_dir");
#ifdef Q_OS_UNIX
    QFile::remove("/tmp/link_to_test_dir");
#endif

    return 0;
}

QDir::cleanPath()

これはパス文字列から冗長な要素（./ や ../、二重スラッシュ // など）を取り除き、クリーンな形式にするための静的関数です。ただし、ファイルシステムを参照せず、シンボリックリンクの解決も行いません。

• 使用場面
  ファイルシステムへのアクセスなしに、パス文字列を整形したい場合。例えば、設定ファイルに保存する前にパスを簡潔にしたいが、ファイルが存在しない可能性もある場合など。
• 違い
  ファイルが存在するかどうかは関与せず、純粋に文字列操作を行います。シンボリックリンクは解決されません。
• 目的
  パス文字列の構文的な正規化。

例

#include <QCoreApplication>
#include <QDir>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString path1 = "/usr/local/./bin/../lib/./my_app";
    QString path2 = "relative/path/to/./file.txt";
    QString path3 = "//home/user//data.log";
    QString path4 = "/tmp/symlink_to_dir/../another_dir"; // シンボリックリンクは解決されない

    qDebug() << "Original 1:" << path1;
    qDebug() << "Cleaned 1:" << QDir::cleanPath(path1); // 出力例: "/usr/lib/my_app"

    qDebug() << "Original 2:" << path2;
    qDebug() << "Cleaned 2:" << QDir::cleanPath(path2); // 出力例: "relative/path/to/file.txt"

    qDebug() << "Original 3:" << path3;
    qDebug() << "Cleaned 3:" << QDir::cleanPath(path3); // 出力例: "/home/user/data.log"

    qDebug() << "Original 4:" << path4;
    qDebug() << "Cleaned 4:" << QDir::cleanPath(path4); // 出力例: "/tmp/another_dir" (シンボリックリンクは考慮されない)

    // QFileInfo::canonicalFilePath() との違いを比較
    // もし /tmp/symlink_to_dir が /actual/dir を指している場合
    // QFileInfo("/tmp/symlink_to_dir/../another_dir").canonicalFilePath() は /actual/another_dir を返す可能性がある
    // cleanPath は /tmp/another_dir を返す
    return 0;
}

QDir::toNativeSeparators() と QDir::fromNativeSeparators()

これらはパスの区切り文字をOSのネイティブ形式とQtの統一形式（/）間で変換するための関数です。パスの正規化とは少し異なりますが、クロスプラットフォームでパスを扱う上で重要です。

• 使用場面
  ユーザーにパスを表示する際や、OS固有のAPIにパスを渡す際に、ネイティブの区切り文字（Windowsの \ など）に変換したい場合。
• 違い
  パスの意味自体を変更するわけではなく、文字列表現のみを変換します。
• 目的
  OSに応じたパス区切り文字の変換。

例

#include <QCoreApplication>
#include <QDir>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString qtPath = "/home/user/documents/report.pdf";

    qDebug() << "Qt style path:" << qtPath;

    // ネイティブ区切り文字に変換
    QString nativePath = QDir::toNativeSeparators(qtPath);
    qDebug() << "Native path:" << nativePath; // Windows: "C:\\home\\user\\documents\\report.pdf" (例)
                                              // Linux/macOS: "/home/user/documents/report.pdf"

    // ネイティブ区切り文字からQtスタイルに変換 (逆変換)
    QString convertedBack = QDir::fromNativeSeparators(nativePath);
    qDebug() << "Converted back to Qt style:" << convertedBack;

    return 0;
}

std::filesystem::canonical() (C++17以降)

C++17からは標準ライブラリにファイルシステム操作が導入され、std::filesystem::canonical() という関数が利用できます。Qt アプリケーションでも、必要に応じて C++ 標準ライブラリの機能を使用することができます。

• 使用場面
  C++17以降の標準ファイルシステム機能を利用したい場合や、Qt にあまり依存したくない場合。
• 違い
  
  • Qt 固有のクラス（QString、QFileInfo）に依存しないため、Qt 以外のC++コードとの連携が容易です。
  • ファイルが存在しない場合は std::filesystem::filesystem_error 例外をスローします（またはエラーコードを返します）。QFileInfo::canonicalFilePath() が空文字列を返すのとは異なります。
• 目的
  QFileInfo::canonicalFilePath() と同様に、パスを正規化された絶対パスに変換します。シンボリックリンクを解決し、冗長な要素を削除します。

例 (C++17以降)

#include <QCoreApplication>
#include <QDebug>
#include <filesystem> // C++17 のファイルシステムライブラリ
#include <fstream>    // ファイル作成用

namespace fs = std::filesystem;

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    fs::path testDir = fs::temp_directory_path() / "my_test_fs_dir";
    fs::path testFile = testDir / "my_test_file.txt";

    // テスト用のファイルとディレクトリを作成
    fs::create_directories(testDir);
    std::ofstream(testFile) << "Hello, world!";

    fs::path relativePath = ".." / testDir.filename() / "my_test_file.txt"; // 相対パス
    fs::path symlinkPath;

#ifdef Q_OS_UNIX
    // Linux/macOS でシンボリックリンクを作成
    symlinkPath = fs::temp_directory_path() / "my_test_symlink";
    fs::create_symlink(testDir, symlinkPath);
#endif

    try {
        qDebug() << "--- Using std::filesystem::canonical() ---";

        // 存在する相対パスの正規化
        fs::path canonicalRelative = fs::canonical(relativePath);
        qDebug() << "Original Relative:" << relativePath.string().c_str();
        qDebug() << "Canonical Relative:" << canonicalRelative.string().c_str();

#ifdef Q_OS_UNIX
        // シンボリックリンクの正規化
        fs::path canonicalSymlink = fs::canonical(symlinkPath / "my_test_file.txt");
        qDebug() << "Original Symlink:" << (symlinkPath / "my_test_file.txt").string().c_str();
        qDebug() << "Canonical Symlink:" << canonicalSymlink.string().c_str();
#endif

        // 存在しないファイルの正規化 (例外をスローする)
        fs::path nonExistentPath = testDir / "non_existent.txt";
        qDebug() << "Attempting canonical for non-existent file...";
        // この行は例外をスローするので、コメントアウトするか try-catch で囲む
        // fs::path canonicalNonExistent = fs::canonical(nonExistentPath);
        // qDebug() << "Canonical Non-Existent:" << canonicalNonExistent.string().c_str();

    } catch (const fs::filesystem_error& e) {
        qDebug() << "Filesystem error:" << e.what();
    }

    // 後処理
    fs::remove(testFile);
#ifdef Q_OS_UNIX
    fs::remove(symlinkPath);
#endif
    fs::remove(testDir);

    return 0;
}

QFileInfo::canonicalFilePath() は、Qt アプリケーションでファイルやディレクトリの正規絶対パスを取得する際に、最も便利で推奨される方法です。これは、シンボリックリンクの解決と冗長なパス要素の除去を自動的に行い、ファイルが存在しない場合は空文字列を返すという明確なセマンティクスを提供します。

代替手段は、特定のニーズ（例えば、ファイルが存在しない場合でもパス文字列の整形だけを行いたい場合、あるいは Qt に依存せず C++ 標準ライブラリを使いたい場合）に合わせて選択されます。

• std::filesystem::canonical(): C++標準ライブラリ版の正規パス取得（ファイルが存在しない場合は例外スロー）。
• QDir::cleanPath(): パス文字列の構文的な正規化（ファイルシステム参照なし、シンボリックリンク解決なし）。
• absoluteFilePath(): 単純な絶対パス変換（シンボリックリンク解決なし、冗長要素除去なし）。