Qtプログラミング：QFileInfo::isReadable()を使ったファイル権限チェックの実践例

2025-05-31

QFileInfo::isReadable()とは

QFileInfo::isReadable()は、指定されたファイルが現在のユーザーによって読み取り可能であるかどうかを判断するためのQtの関数です。戻り値はbool型で、読み取り可能であればtrueを、そうでなければfalseを返します。

主な特徴と注意点

WindowsにおけるNTFS権限
Windows環境でNTFS権限チェックが有効になっていない場合、isReadable()の結果はファイルが存在するかどうかのみを反映することがあります。より詳細な権限チェックが必要な場合は、permission()関数を使用するか、OS固有のAPIを検討する必要があるかもしれません。
キャッシュ
QFileInfoはファイルシステムに関する情報をキャッシュする場合があります。ファイルシステムの状況が変化した可能性がある場合は、refresh()関数を呼び出して情報を更新することで、最新の情報を取得できます。
シンボリックリンクの扱い
対象がシンボリックリンク（symlink）である場合、isReadable()はシンボリックリンク自体ではなく、それが指す実際のファイル（ターゲット）が読み取り可能であればtrueを返します。
読み取り権限の確認
この関数は、ファイルシステムにおける現在のユーザーの読み取り権限を確認します。ファイルが存在するかどうかだけでなく、そのファイルに対して読み取り操作が許可されているかどうかを判断します。

使用例

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

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

    // 存在しないファイル
    QFileInfo nonExistentFile("non_existent_file.txt");
    if (nonExistentFile.isReadable()) {
        qDebug() << "non_existent_file.txt は読み取り可能です。";
    } else {
        qDebug() << "non_existent_file.txt は読み取り可能ではありません。（存在しない可能性があります）";
    }

    // 既存のファイル（例としてmain.cpp自体）
    QFileInfo existingFile("main.cpp"); // もしmain.cppが実行ファイルと同じディレクトリにある場合
    if (existingFile.exists()) {
        if (existingFile.isReadable()) {
            qDebug() << "main.cpp は読み取り可能です。";
        } else {
            qDebug() << "main.cpp は読み取り可能ではありません。";
        }
    } else {
        qDebug() << "main.cpp が見つかりません。";
    }

    // 特定のディレクトリ
    QFileInfo dirInfo("/tmp"); // Linux/macOSの場合。Windowsの場合は "C:/" など
    if (dirInfo.isDir()) {
        if (dirInfo.isReadable()) {
            qDebug() << "/tmp は読み取り可能なディレクトリです。";
        } else {
            qDebug() << "/tmp は読み取り可能なディレクトリではありません。";
        }
    }

    return a.exec();
}

このコードは、ファイルやディレクトリの読み取り可能性をチェックし、その結果をコンソールに出力します。ファイルのパスは、実行環境に合わせて変更してください。

ファイルが存在しない場合

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

QFileInfo fileInfo("path/to/your/file.txt");
if (!fileInfo.exists()) {
    qDebug() << "エラー: ファイルが存在しません。";
    // ファイルを作成するか、パスを修正するなどの対応
    return;
}

if (fileInfo.isReadable()) {
    qDebug() << "ファイルは読み取り可能です。";
} else {
    qDebug() << "ファイルは読み取り可能ではありません。";
}

原因
ファイルが存在しないため、読み取り権限以前の問題として、そのファイルに対する操作ができません。isReadable()は、ファイルが存在することを前提としていません。
問題
isReadable()がfalseを返す。

権限の問題（特にWindowsのNTFSやUAC）

トラブルシューティング
- 手動での権限確認
  問題のファイルをエクスプローラー（Windows）やターミナル（Linux/macOSのls -lコマンド）で確認し、現在のユーザーが実際に読み取り権限を持っているかを確認します。
- 管理者権限での実行
  Windowsの場合、アプリケーションを右クリックして「管理者として実行」を試します。これで問題が解決する場合、UACが原因である可能性が高いです。
- QFile::open()の利用
  isReadable()はあくまで権限チェックですが、実際にファイルを開く際にQFile::open()を使用し、その戻り値を確認する方が確実です。open()がtrueを返せば、読み取り可能です。
```
QFile file("path/to/your/file.txt");
if (file.open(QIODevice::ReadOnly)) {
    qDebug() << "ファイルはQFileで正常に開かれ、読み取り可能です。";
    file.close();
} else {
    qDebug() << "ファイルはQFileで開けませんでした。エラー:" << file.errorString();
}
```
- QFileInfo::permission()の利用
  より詳細なパーミッション情報を取得し、どの権限が不足しているのかを確認できます。
```
QFileInfo fileInfo("path/to/your/file.txt");
if (fileInfo.exists()) {
    QFile::Permissions perms = fileInfo.permissions();
    if (!(perms & QFile::ReadUser) && !(perms & QFile::ReadGroup) && !(perms & QFile::ReadOther)) {
        qDebug() << "このファイルはどのユーザーからも読み取り可能ではありません。";
    } else if (!fileInfo.isReadable()) {
        qDebug() << "QFileInfo::isReadable()はfalseですが、permission()からは読み取り可能と判断されます。UACなどのOSレベルの制限かもしれません。";
    }
}
```
問題
ファイルに読み取り権限があるはずなのに、isReadable()がfalseを返す。または、管理者権限で実行しないと期待通りに動作しない。

パスが正しくない（相対パスと絶対パス）

トラブルシューティング
- 絶対パスの使用
  可能な限り、ファイルパスは絶対パスで指定するようにします。
- 現在の作業ディレクトリの確認
  QDir::currentPath()を使用して、アプリケーションの現在の作業ディレクトリがどこであるかを確認します。
```
qDebug() << "現在の作業ディレクトリ:" << QDir::currentPath();
QFileInfo fileInfo("relative/path/to/file.txt");
qDebug() << "QFileInfoの絶対パス:" << fileInfo.absoluteFilePath();
if (fileInfo.isReadable()) {
    qDebug() << "ファイルは読み取り可能です。";
} else {
    qDebug() << "ファイルは読み取り可能ではありません。";
}
```
- パスの正規化
  QFileInfo::canonicalFilePath()やQDir::cleanPath()などを使用して、パスを正規化し、シンボリックリンクなどを解決した真のパスを確認します。
原因
QFileInfoに設定されたファイルパスが、期待するファイルのものではない。特に相対パスを使用している場合、アプリケーションの現在の作業ディレクトリ（current working directory）が想定と異なることがあります。
問題
isReadable()がfalseを返す、または意図しないファイルに対する結果を返す。

キャッシュの問題

トラブルシューティング
ファイルの状態が変更された可能性がある場合は、QFileInfo::refresh()を呼び出してキャッシュを更新します。

QFileInfo fileInfo("path/to/your/file.txt");
// ファイルの状態が変更された可能性がある処理...
fileInfo.refresh(); // キャッシュを更新
if (fileInfo.isReadable()) {
    qDebug() << "更新後: ファイルは読み取り可能です。";
} else {
    qDebug() << "更新後: ファイルは読み取り可能ではありません。";
}

原因
QFileInfoは、パフォーマンスのためにファイルシステム情報をキャッシュします。ファイルが外部から変更された場合、QFileInfoオブジェクトが持つ情報が古くなることがあります。
問題
ファイルの権限や存在状況が変更されたにも関わらず、isReadable()が古い情報を返す。

シンボリックリンクのターゲット問題

トラブルシューティング
シンボリックリンク自体ではなく、そのターゲットファイルのパスを確認する必要がある場合は、QFileInfo::symLinkTarget()を使用します。

QFileInfo symLinkInfo("path/to/symlink");
if (symLinkInfo.isSymLink()) {
    QString targetPath = symLinkInfo.symLinkTarget();
    qDebug() << "シンボリックリンクのターゲット:" << targetPath;
    QFileInfo targetFileInfo(targetPath);
    if (targetFileInfo.isReadable()) {
        qDebug() << "ターゲットファイルは読み取り可能です。";
    } else {
        qDebug() << "ターゲットファイルは読み取り可能ではありません。";
    }
} else {
    qDebug() << "これはシンボリックリンクではありません。";
}

原因
QFileInfo::isReadable()は、シンボリックリンクが指すターゲットファイルの読み取り可能性を評価します。
問題
シンボリックリンクに対してisReadable()を呼び出しているが、リンク自体ではなくリンク先のファイルに問題がある。

例1: 基本的な読み取り可能性のチェック

この例では、指定されたファイルが読み取り可能であるかどうかを最も基本的な方法で確認します。

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QDir> // QDir::currentPath()のために必要

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

    QString filePath = "test_file.txt"; // 現在のディレクトリにあると仮定
    // このファイルは手動で作成しておくと良いでしょう。
    // 例: echo "Hello, Qt!" > test_file.txt

    QFileInfo fileInfo(filePath);

    qDebug() << "現在の作業ディレクトリ:" << QDir::currentPath();
    qDebug() << "チェックするファイルの絶対パス:" << fileInfo.absoluteFilePath();

    if (fileInfo.exists()) { // まずファイルが存在するかを確認
        if (fileInfo.isReadable()) {
            qDebug() << "'" << filePath << "' は読み取り可能です。";
        } else {
            qDebug() << "'" << filePath << "' は読み取り可能ではありません。";
        }
    } else {
        qDebug() << "'" << filePath << "' は存在しません。";
    }

    return a.exec();
}

説明

#include: 必要なヘッダファイル（QCoreApplication, QFileInfo, QDebug, QDir）をインクルードします。
QString filePath = "test_file.txt";: チェックしたいファイルの名前を設定します。この例では、実行可能ファイルと同じディレクトリにtest_file.txtというファイルがあると仮定しています。
- ポイント
  test_file.txtを手動で作成し、読み取り権限を与えておくことで、isReadable()がtrueを返すことを確認できます。もし読み取り権限を削除したり、ファイルが存在しない場合はfalseを返すでしょう。
QFileInfo fileInfo(filePath);: 指定されたパスからQFileInfoオブジェクトを作成します。
qDebug() << "現在の作業ディレクトリ:" << QDir::currentPath();: 現在のアプリケーションの作業ディレクトリを表示します。相対パスを使用している場合、この情報がデバッグに役立ちます。
if (fileInfo.exists()): isReadable()を呼び出す前に、ファイルが実際に存在するかどうかを確認します。これは非常に重要です。ファイルが存在しない場合、isReadable()は常にfalseを返します。
if (fileInfo.isReadable()): ファイルが存在する場合、この関数が現在のユーザーによってファイルが読み取り可能であるかどうかをチェックします。
結果をqDebug()でコンソールに出力します。

例2: ディレクトリの読み取り可能性チェック

isReadable()はファイルだけでなく、ディレクトリの読み取り可能性もチェックできます。ディレクトリの読み取り可能性とは、そのディレクトリ内の内容をリスト表示できるか（ファイル名を取得できるか）を意味します。

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

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

    QString dirPath = QDir::tempPath(); // システムの一時ディレクトリをチェック
    // Windows: C:\Users\<ユーザー名>\AppData\Local\Temp
    // Linux/macOS: /tmp

    QFileInfo dirInfo(dirPath);

    qDebug() << "チェックするディレクトリのパス:" << dirInfo.absoluteFilePath();

    if (dirInfo.exists()) { // ディレクトリが存在するかを確認
        if (dirInfo.isDir()) { // それがディレクトリであるかを確認
            if (dirInfo.isReadable()) {
                qDebug() << "'" << dirPath << "' は読み取り可能なディレクトリです。";
                // 読み取り可能な場合、QDirを使用して内容をリスト表示してみる
                QDir tempDir(dirPath);
                qDebug() << "ディレクトリ内の最初の5つのエントリ:";
                foreach (const QFileInfo &entry, tempDir.entryInfoList(QDir::AllEntries | QDir::NoDotAndDotDot, QDir::Name | QDir::DirsFirst).mid(0, 5)) {
                    qDebug() << "  - " << entry.fileName();
                }
            } else {
                qDebug() << "'" << dirPath << "' は読み取り可能なディレクトリではありません。";
            }
        } else {
            qDebug() << "'" << dirPath << "' はディレクトリではありません。";
        }
    } else {
        qDebug() << "'" << dirPath << "' は存在しません。";
    }

    return a.exec();
}

説明

QString dirPath = QDir::tempPath();: システムの一時ディレクトリのパスを取得します。これは通常、読み取り可能であるはずです。
if (dirInfo.isDir()): QFileInfoがファイルではなくディレクトリを表していることを確認します。
if (dirInfo.isReadable()): ディレクトリの読み取り可能性をチェックします。
読み取り可能であれば、QDirを使用して実際にディレクトリの内容をリスト表示する例も含まれています。これは、isReadable()が実際にディレクトリ内の情報にアクセスできることを意味することを示しています。

例3: `refresh()` とキャッシュの利用

QFileInfoはパフォーマンスのためにファイル情報をキャッシュします。外部からファイルの状態（権限など）が変更された場合、refresh()を呼び出すことでキャッシュを更新できます。

#include <QCoreApplication>
#include <QFileInfo>
#include <QDebug>
#include <QFile> // ファイル操作のために必要

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

    QString filePath = "permissions_test.txt";

    // 1. ファイルを作成し、最初は読み取り可能にする
    QFile file(filePath);
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&file);
        out << "This is a test file for permissions.\n";
        file.close();
        // 読み取り権限を設定（例: 誰でも読み取り可能に）
        file.setPermissions(QFile::ReadOwner | QFile::WriteOwner |
                            QFile::ReadGroup | QFile::ReadOther);
        qDebug() << "'" << filePath << "' を作成し、読み取り可能に設定しました。";
    } else {
        qDebug() << "ファイルの作成に失敗しました: " << file.errorString();
        return 1;
    }

    QFileInfo fileInfo(filePath);

    // 最初のチェック
    if (fileInfo.isReadable()) {
        qDebug() << "初回チェック: '" << filePath << "' は読み取り可能です。";
    } else {
        qDebug() << "初回チェック: '" << filePath << "' は読み取り可能ではありません。";
    }

    // 2. ファイルの読み取り権限を削除（書き込みのみ可能に）
    if (file.setPermissions(QFile::WriteOwner)) { // 所有者のみ書き込み可能
        qDebug() << "'" << filePath << "' の読み取り権限を削除しました。";
    } else {
        qDebug() << "権限の変更に失敗しました: " << file.errorString();
        return 1;
    }

    // キャッシュが更新されていない場合、結果は変わらない可能性がある
    if (fileInfo.isReadable()) {
        qDebug() << "権限変更後のチェック（refreshなし）: '" << filePath << "' はまだ読み取り可能と表示されるかもしれません。";
    } else {
        qDebug() << "権限変更後のチェック（refreshなし）: '" << filePath << "' は読み取り可能ではありません。";
    }

    // 3. QFileInfoのキャッシュを更新
    fileInfo.refresh();
    qDebug() << "QFileInfoのキャッシュを更新しました。";

    // 再度チェック
    if (fileInfo.isReadable()) {
        qDebug() << "権限変更後のチェック（refreshあり）: '" << filePath << "' は読み取り可能です。";
    } else {
        qDebug() << "権限変更後のチェック（refreshあり）: '" << filePath << "' は読み取り可能ではありません。";
    }

    // クリーンアップ
    file.remove();

    return a.exec();
}

説明

ファイルの作成と初期権限設定: QFileを使用してpermissions_test.txtを作成し、初期状態で読み取り可能に設定します。
初回チェック: QFileInfoを作成し、isReadable()で読み取り可能性をチェックします。この時点ではtrueが返るはずです。
権限の変更: QFile::setPermissions()を使用して、ファイルの読み取り権限を削除します（例では所有者のみ書き込み可能に設定）。
refresh()なしでのチェック: この時点でfileInfo.isReadable()を再度呼び出しても、QFileInfoが以前の情報をキャッシュしているため、結果が変わらない可能性があります。
fileInfo.refresh(): ここでQFileInfoのキャッシュを明示的に更新します。これにより、QFileInfoはファイルシステムから最新の情報を取得し直します。
refresh()ありでの再チェック: refresh()後にisReadable()を再度呼び出すと、更新された情報が反映され、今度はfalseが返るはずです。
クリーンアップ: 作成したテストファイルを削除します。

この例は、QFileInfoがキャッシュを使用すること、そしてファイルシステムの状態がプログラムの外部で変更された場合にrefresh()がいかに重要であるかを示しています。

QFileInfo::isReadable()は手軽にファイルの読み取り可能性をチェックできる便利な関数ですが、より詳細な制御が必要な場合や、特定の状況下で別の方法を検討することがあります。

QFile::open() を試す

最も確実で推奨される代替方法は、実際にファイルを開こうとすることです。QFile::open()は、指定されたアクセスモード（読み取り、書き込みなど）でファイルを開けるかどうかを試み、その成否を返します。

利点

ファイル操作の準備
成功した場合、すぐにファイルからの読み取り操作を開始できます。
エラー詳細
QFile::error()とQFile::errorString()を呼び出すことで、ファイルを開けなかった具体的な理由（権限不足、ファイルが見つからない、ディスクフルなど）を詳細に取得できます。
確実性
実際のファイルシステム操作を試みるため、読み取り権限だけでなく、ファイルが現在他のプロセスによってロックされているか、ディスクがいっぱいかなど、より多くの要因を考慮に入れます。

欠点

単に権限をチェックしたいだけで、ファイルをすぐに開く必要がない場合には、少し冗長に感じられるかもしれません。
ファイルを実際に開こうとするため、わずかなオーバーヘッドが発生します（通常は無視できるレベル）。

コード例

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

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

    QString filePath = "another_test_file.txt"; // 適当なパス

    // ファイルを作成し、権限を調整しておくとテストしやすい
    // (例: `echo "Hello" > another_test_file.txt` 後に `chmod 000 another_test_file.txt` など)
    QFile file(filePath);

    qDebug() << "Checking if '" << filePath << "' is readable using QFile::open()...";

    if (file.open(QIODevice::ReadOnly)) {
        qDebug() << "'" << filePath << "' は読み取り可能です (QFile::open()成功)。";
        file.close(); // 読み取り操作が不要ならすぐに閉じる
    } else {
        qDebug() << "'" << filePath << "' は読み取り可能ではありません (QFile::open()失敗)。";
        qDebug() << "エラー詳細: " << file.errorString(); // エラー理由を表示
    }

    return a.exec();
}

QFileInfo::permissions() を使用する

利点

論理演算による組み合わせ
QFile::Permissionsはビットフラグなので、論理AND演算子&を使用して特定の権限が設定されているかを確認できます。
詳細な権限情報
isReadable()よりも具体的な権限の内訳（例: 所有者のみ読み取り可能、グループは不可など）を取得できます。

Qt開発者必見！QFileInfo::baseName()を使いこなすためのヒントとテクニック

具体的には、QFileInfo オブジェクトが指すファイルのフルパス（ディレクトリを含む完全なパス）から、最後のドット (.) 以降の部分（拡張子）を取り除いた文字列を取得します。もしファイル名にドットが含まれていない場合は、ファイル名全体がそのまま返されます。

Qt QFileInfo::birthTime()徹底解説：ファイルの作成日時を正確に取得する方法

QtプログラミングにおけるQFileInfo::birthTime()は、ファイルが作成された日時（生成日時）を返す関数です。もう少し詳しく説明すると、以下のようになります。注意点: OSやファイルシステムによる制限: ファイルの作成日時（birth time）は、すべてのオペレーティングシステムやファイルシステムで利用できるわけではありません。例えば、一部のLinuxファイルシステム（EXT2/3など）では、デフォルトで作成日時が記録されない場合があります。このような場合、birthTime()は無効なQDateTimeオブジェクトを返します。 Qtのバージョン: birthTime()関数はQt 5.10で導入されました。それより古いQtのバージョンでは利用できません。 created()との違い: かつてはcreated()という関数もありましたが、これは非推奨（deprecated）となり、birthTime()またはmetadataChangeTime()の使用が推奨されています。created()はファイルのメタデータが最後に変更された時刻を返すことが多かったため、純粋な作成日時とは異なる場合がありました。