QFileInfo Class

メンバ関数のドキュメント

QFileInfo::QFileInfo()

ファイル・システム・エントリを参照しない空の QFileInfo オブジェクトを構築します。

setFile()も参照してください 。

[explicit] QFileInfo::QFileInfo(const QFileDevice &file)

ファイルfile に関する情報を提供する新しい QFileInfo を構築します。

file が相対パスの場合、QFileInfo も相対パスになります。

isRelative()も参照してください 。

[explicit] QFileInfo::QFileInfo(const QString &path)

path にあるファイル・システム・エントリに関する情報を提供する QFileInfo を構築します。 は、絶対パスまたは相対パスを指定できます。

path が相対パスの場合、QFileInfo も相対パスになります。

setFile()、isRelative()、QDir::setCurrent() およびQDir::isRelativePath()も参照してください 。

[since 6.0] QFileInfo::QFileInfo(const std::filesystem::path &file)

与えられたfile に関する情報を与える新しい QFileInfo を構築します。

この関数は Qt 6.0 で導入されました。

setFile(),isRelative(),QDir::setCurrent(),QDir::isRelativePath()も参照してください 。

[explicit] QFileInfo::QFileInfo(const QDir &dir, const QString &path)

与えられたファイル・システム・エントリpath に関する情報を与える新しい QFileInfo を構築します。この情報は、ディレクトリdir からの相対パスです。

dir が相対パスの場合、QFileInfo も相対パスになります。

path が絶対パスの場合、dir で指定されたディレクトリは無視されます。

isRelative()も参照してください 。

[since 6.0] QFileInfo::QFileInfo(const QDir &dir, const std::filesystem::path &path)

新しい QFileInfo を構築します。この QFileInfo は、ディレクトリdir からの相対パスを持つpath のファイル・システム・エントリに関する情報を提供します。

dir が相対パスの場合、QFileInfo も相対パスになります。

path が絶対パスの場合、dir で指定されたディレクトリは無視されます。

この関数は Qt 6.0 で導入されました。

QFileInfo::QFileInfo(const QFileInfo &fileinfo)

与えられたfileinfo のコピーである新しい QFileInfo を構築する。

[noexcept] QFileInfo::~QFileInfo()

QFileInfo を破壊し、資源を解放する。

QDir QFileInfo::absoluteDir() const

このQFileInfo が参照するファイルシステムエントリーの親ディレクトリの絶対パスを表すQDir オブジェクトを返します。

// 現在の作業ディレクトリが "/home/user/Documents/memos/" の場合QFileInfoinfo1(u"relativeFile"_s)；qDebug() << info1.absolutePath(); // "/home/user/Documents/memos/"
qDebug() << info1.baseName(); // "relativeFile"
qDebug() << info1.absoluteDir(); // QDir(u"/home/user/Documents/memos"_s)
qDebug() << info1.absoluteDir().path(); // "/home/user/Documents/memos"

// ディレクトリのQFileInfoQFileInfoinfo2(u"/home/user/Documents/memos"_s)；qDebug() << info2.absolutePath(); // "/home/user/Documents"
qDebug() << info2.baseName(); // "memos"
qDebug() << info2.absoluteDir(); // QDir(u"/home/user/Documents"_s)
qDebug() << info2.absoluteDir().path(); // "/home/user/Documents"

dir （）、filePath （）、fileName （）、isRelative （）も参照のこと 。

QString QFileInfo::absoluteFilePath() const

このQFileInfo が参照するファイルシステム・エントリーの絶対フルパス (エントリー名も含む) を返します。

Unix では、絶対パスはディレクトリ区切り文字'/' で始まります。Windows では、絶対パスはドライブ指定 (D:/ など) で始まります。

Windows では、ドライブ文字にマップされていないネットワーク共有のパスは、//sharename/ で始まる。

QFileInfo はドライブ文字を大文字にします。ただし、 ではこのようなことは行われません。以下のコード・スニペットはこれを示している。QDir

    QFileInfofi("c:/temp/foo")；    qDebug() << fi.absoluteFilePath(); // "C:/temp/foo"

この関数は、isRelative （）が真でない限り、filePath （）と同じものを返す。canonicalFilePath() とは対照的に、シンボリックリンクや冗長な "." や ".." 要素は必ずしも削除されない。

filePath()、canonicalFilePath()、isRelative()も参照 。

QString QFileInfo::absolutePath() const

このQFileInfo が参照するファイルシステムエントリーの絶対パスを、エントリー名を除いて返す。

Unix では、絶対パスはディレクトリ区切り文字'/' で始まります。Windows では、絶対パスはドライブ指定（たとえばD:/ ）で始まります。

Windows では、ドライブ文字にマップされていないネットワーク共有のパスは//sharename/ で始まる。

canonicalPath() とは対照的に、シンボリック・リンクや冗長な "." や ".." 要素は必ずしも削除されません。

absoluteFilePath()、path()、canonicalPath()、fileName()、isRelative()も参照 。

QString QFileInfo::baseName() const

ファイルのベース名をパスなしで返す。

ベース名は、ファイルの最初の文字 '.' までのすべての文字で構成されます。

例

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.baseName();  // base = "archive"

例: ファイルのベース名は、ファイルの命名規則とは無関係に、すべてのプラットフォームで等しく計算されます（例えば、Unix上の".bashrc "は空のベース名を持ち、接尾辞は "bashrc "です）。

fileName()、suffix()、completeSuffix()、completeBaseName()も参照のこと 。

QDateTime QFileInfo::birthTime() const

ファイルが作成（誕生）された日時をローカルタイムで返す。

ファイルの誕生時刻が利用できない場合、この関数は無効なQDateTime を返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は、QFileInfo::birthTime(constQTimeZone &tz)をオーバーロードし、birthTime(QTimeZone::LocalTime) と同じものを返します。

lastModified(),lastRead(),metadataChangeTime(),fileTime()も参照してください 。

[since 6.6] QDateTime QFileInfo::birthTime(const QTimeZone &tz) const

ファイルが作成された（生まれた）日時を返す。

返される時刻は、tz で指定されたタイムゾーンになります。たとえば、QTimeZone::LocalTime またはQTimeZone::UTC を使用すると、それぞれローカルタイムゾーンまたは UTC での時刻を取得できます。ネイティブ・ファイル・システムAPIは通常UTCを使用するので、QTimeZone::UTC を使用すると、変換が不要なため、多くの場合より速くなります。

ファイルの誕生時刻が利用できない場合、この関数は無効なQDateTime を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は Qt 6.6 で導入されました。

lastModified(const QTimeZone &),lastRead(const QTimeZone &),metadataChangeTime(const QTimeZone &),fileTime(QFileDevice::FileTime, const QTimeZone &)も参照してください 。

QString QFileInfo::bundleName() const

バンドルの名前を返します。

macOS と iOS では、パスがisBundle() の場合、バンドルの適切なローカライズ名を返します。その他のプラットフォームでは、空のQString が返されます。

例

QFileInfo fi("/Applications/Safari.app");
QString bundle = fi.bundleName();                // name = "Safari"

isBundle(),filePath(),baseName(),suffix()も参照 ください。

bool QFileInfo::caching() const

キャッシュが有効な場合はtrue を返し、そうでない場合はfalse を返す。

setCaching() およびrefresh()も参照 。

QString QFileInfo::canonicalFilePath() const

つまり、シンボリックリンクや'.' や'..' などの冗長な要素を含まない絶対パスとなります。

エントリが存在しない場合は、 canonicalFilePath() は空の文字列を返します。

filePath()、absoluteFilePath()、dir()も参照 。

QString QFileInfo::canonicalPath() const

ファイルシステムのエントリの正規パス (エントリ名を除く)、 つまりシンボリックリンクや "." や "..." 要素を含まない絶対パスを返します。

エントリが存在しない場合は、このメソッドは空の文字列を返します。

path() およびabsolutePath()も参照 ください。

QString QFileInfo::completeBaseName() const

ファイルの完全なベース名を、パスなしで返す。

完全なベース名は、ファイル内の最後の'.' 文字までのすべての文字で構成されます (最後の文字は含まれません)。

例

QFileInfo fi("/tmp/archive.tar.gz");
QString base = fi.completeBaseName();  // base = "archive.tar"

fileName()、suffix()、completeSuffix()、baseName()も参照 。

QString QFileInfo::completeSuffix() const

ファイルの完全なサフィックス（拡張子）を返します。

完全なサフィックスは、ファイル内の最初の '.' 以降 (ただし '.' は含まない) のすべての文字で構成されます。

例

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.completeSuffix();  // ext = "tar.gz"

fileName()、suffix()、baseName()、completeBaseName()も参照のこと 。

QDir QFileInfo::dir() const

このQFileInfo が参照するファイル・システム・エントリーの親ディレクトリのパスを表すQDir オブジェクトを返します。

以下のそれぞれについて、dir() はQDir "~/examples/191697" を返す。

    QFileInfo fileInfo1("~/examples/191697/.");
    QFileInfo fileInfo2("~/examples/191697/..");
    QFileInfo fileInfo3("~/examples/191697/main.cpp");

以下のそれぞれについて、dir() はQDir "." を返す。

    QFileInfo fileInfo4(".");
    QFileInfo fileInfo5("..");
    QFileInfo fileInfo6("main.cpp");

absolutePath()、filePath()、fileName()、isRelative()、absoluteDir()も参照 。

bool QFileInfo::exists() const

このQFileInfo が参照するファイル・システム・エントリが存在する場合はtrue を返し、そうでない場合はfalse を返す。

[static] bool QFileInfo::exists(const QString &path)

ファイル・システム・エントリpath が存在する場合はtrue を返し、存在しない場合はfalse を返す。

QString QFileInfo::fileName() const

このQFileInfo が参照するファイルシステム・エントリーの名前を、パスを除いて返します。

例

QFileInfo fi("/tmp/archive.tar.gz");
QString name = fi.fileName();                // name = "archive.tar.gz"

isRelative()、filePath()、baseName()、suffix()も参照 。

QString QFileInfo::filePath() const

このQFileInfo が参照するファイル・システム・エントリのパスを返す。パスは、絶対パスでも相対パスでもよい。

absoluteFilePath()、canonicalFilePath()、isRelative()も参照 。

QDateTime QFileInfo::fileTime(QFileDevice::FileTime time) const

time で指定されたファイル時刻を返す。

時刻が特定できない場合は、無効な日付時刻が返される。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は、QFileInfo::fileTime(QFileDevice::FileTime, const QTimeZone &) をオーバーロードし、fileTime(time, QTimeZone::LocalTime) と同じものを返します。

birthTime(),lastModified(),lastRead(),metadataChangeTime()も参照してください 。

[since 6.6] QDateTime QFileInfo::fileTime(QFileDevice::FileTime time, const QTimeZone &tz) const

time で指定されたファイル時刻を返す。

返される時刻は、tz で指定されたタイムゾーンの時刻である。たとえば、QTimeZone::LocalTime またはQTimeZone::UTC を使用すると、それぞれローカルタイムゾーンまたは UTC の時刻を取得できます。ネイティブ・ファイル・システムAPIは通常UTCを使用するため、QTimeZone::UTC を使用すると、変換が不要なため、より高速になることが多い。

時刻を決定できない場合、無効な日付時刻が返される。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は Qt 6.6 で導入されました。

birthTime(const QTimeZone &),lastModified(const QTimeZone &),lastRead(const QTimeZone &),metadataChangeTime(const QTimeZone &),QDateTime::isValid()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsoluteFilePath() const

std::filesystem::path としてabsoluteFilePath() を返します。

この関数は Qt 6.0 で導入されました。

absoluteFilePath()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemAbsolutePath() const

std::filesystem::path としてabsolutePath() を返します。

この関数は Qt 6.0 で導入されました。

absolutePath()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalFilePath() const

std::filesystem::path としてcanonicalFilePath() を返します。

この関数は Qt 6.0 で導入されました。

canonicalFilePath()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemCanonicalPath() const

std::filesystem::path としてcanonicalPath() を返します。

この関数は Qt 6.0 で導入されました。

canonicalPath()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemFilePath() const

std::filesystem::path としてfilePath() を返します。

この関数は Qt 6.0 で導入されました。

filePath()も参照してください 。

[since 6.2] std::filesystem::path QFileInfo::filesystemJunctionTarget() const

std::filesystem::path としてjunctionTarget() を返す。

この関数は Qt 6.2 で導入されました。

junctionTarget()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemPath() const

std::filesystem::path としてpath() を返します。

この関数は Qt 6.0 で導入されました。

path()も参照してください 。

[since 6.6] std::filesystem::path QFileInfo::filesystemReadSymLink() const

std::filesystem::path としてreadSymLink() を返す。

この関数は Qt 6.6 で導入されました。

readSymLink()も参照してください 。

[since 6.0] std::filesystem::path QFileInfo::filesystemSymLinkTarget() const

std::filesystem::path としてsymLinkTarget() を返します。

この関数は Qt 6.0 で導入されました。

symLinkTarget()も参照してください 。

QString QFileInfo::group() const

ファイルのグループを返します。Windowsでは、ファイルがグループを持っていないシステム、またはエラーが発生した場合、空の文字列が返される。

Unixでは、この関数は時間がかかることがある（ミリ秒単位）。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返す。

groupId()、owner()、ownerId()も参照のこと 。

uint QFileInfo::groupId() const

ファイルが属するグループの ID を返します。

Windowsやファイルがグループを持たないシステムでは、この関数は常に(uint) -2を返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返す。

group()、owner()、ownerId()も参照のこと 。

bool QFileInfo::isAbsolute() const

ファイルシステム・エントリーのパスが絶対パスである場合はtrue を返し、そうでない場合はfalse を返す（つまり、パスは相対パスである）。

isRelative()も参照 。

[since 6.4] bool QFileInfo::isAlias() const

このオブジェクトがエイリアスを指している場合はtrue を返し、そうでない場合はfalse を返す。

エイリアスはmacOS上にのみ存在する。エイリアスは通常のファイルと同じように扱われるため、エイリアスを開くとそのファイル自体が開かれます。エイリアスが参照するファイルやディレクトリを開くには、symLinkTarget （）を使用する。

この関数は Qt 6.4 で導入されました。

isFile(),isDir(),isSymLink(),symLinkTarget()も参照してください 。

bool QFileInfo::isBundle() const

このオブジェクトがバンドル、または macOS と iOS のバンドルへのシンボリックリンクを指している場合はtrue を返し、そうでない場合はfalse を返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

isDir(),isSymLink(),isFile()も参照してください 。

bool QFileInfo::isDir() const

このオブジェクトがディレクトリまたはディレクトリへのシンボリックリンクを指している場合はtrue を返す。オブジェクトがディレクトリでないもの（ファイルなど）を指しているか、存在しない場合はfalse を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返します。

isFile()、isSymLink()、isBundle()も参照 。

bool QFileInfo::isExecutable() const

このQFileInfo が参照するファイル・システム・エントリーが実行可能な場合はtrue を返し、そうでない場合はfalse を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返す。

isReadable()、isWritable()、permission()も参照 。

bool QFileInfo::isFile() const

このオブジェクトがファイルまたはファイルへのシンボリックリンクを指している場合はtrue を返す。オブジェクトがファイルでないもの（ディレクトリなど）を指しているか、存在しない場合はfalse を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返します。

isDir()、isSymLink()、isBundle()も参照 。

bool QFileInfo::isHidden() const

このQFileInfo が参照するファイル・システム・エントリーが `hidden' の場合はtrue を返し、そうでない場合はfalse を返す。

注意:この関数は、QDir::entryList が示すように扱っているにもかかわらず、Unix上の特別なエントリー "." と ".." に対してtrue を返す。また、この関数はファイル名を検査するので、Unix上では、このファイルがシンボリックリンクの場合、ターゲットの名前ではなく、シンボリックリンクの名前を検査することに注意。

Windowsでは、この関数はターゲット・ファイルが（シンボリックリンクではなく）隠されている場合、true を返します。

bool QFileInfo::isJunction() const

オブジェクトがジャンクションを指している場合はtrue を返し、そうでない場合はfalse を返す。

ジャンクションはWindowsのNTFSファイルシステム上にのみ存在し、通常mklink コマンドで作成される。これはディレクトリのシンボリックリンクと考えることができ、ローカルボリューム上の絶対パスに対してのみ作成することができます。

bool QFileInfo::isNativePath() const

ファイルパスがネイティブ API で直接使用できる場合はtrue を返します。ファイルが QtResource System などの Qt 内部の仮想ファイルシステムでサポートされている場合はfalse を返します。

注意:ネイティブパスは、プラットフォームやネイティブAPIの入力要件によっては、パス区切り文字や文字エンコーディングの変換が必要な場合があります。

QDir::toNativeSeparators(),QFile::encodeName(),filePath(),absoluteFilePath(),canonicalFilePath()も参照してください 。

bool QFileInfo::isReadable() const

このQFileInfo が参照するファイル・システム・エントリーをユーザーが読める場合はtrue を返し、そうでない場合はfalse を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返す。

isWritable()、isExecutable()、permission()も参照のこと 。

bool QFileInfo::isRelative() const

ファイルシステム・エントリーのパスが相対パスの場合はtrue を返し、そうでない場合はfalse を返す (つまり、パスは絶対パスである)。

Unix では、絶対パスはディレクトリ区切り文字'/' で始まる。Windows では、絶対パスはドライブ指定（たとえばD:/ ）で始まります。

isAbsolute()も参照してください 。

bool QFileInfo::isRoot() const

オブジェクトがディレクトリまたはディレクトリへのシンボリックリンクを指し、そのディレクトリがルートディレクトリである場合はtrue を返し、そうでない場合はfalse を返す。

bool QFileInfo::isShortcut() const

このオブジェクトがショートカットを指している場合はtrue を返し、そうでない場合はfalse を返す。

ショートカットはWindows上にのみ存在し、通常.lnk ファイルである。例えば、Windows上のショートカット（*.lnk ファイル）に対してはtrueが返されますが、Unix（macOSやiOSを含む）に対してはfalseが返されます。

ショートカット（.lnk）ファイルは通常のファイルとして扱われます。これらを開くと、.lnk ファイル自体が開きます。ショートカットが参照するファイルを開くには、ショートカット上でsymLinkTarget （）を使用する必要があります。

isFile()、isDir()、isSymbolicLink()、symLinkTarget()も参照 。

bool QFileInfo::isSymLink() const

このオブジェクトがシンボリックリンク、ショートカット、またはエイリアスを指している場合はtrue を返し、そうでない場合はfalse を返す。

シンボリックリンクはUnix（macOSとiOSを含む）とWindowsに存在し、それぞれ通常ln -s またはmklink コマンドで作成されます。シンボリックリンクを開くと、実質的にlink's target を開くことになる。

また、Windowsではショートカット（*.lnk ファイル）、macOSではエイリアスに対してtrueが返されます。この動作は非推奨であり、Qt の将来のバージョンで変更される可能性があります。ショートカットまたはエイリアスを開くと、.lnk またはエイリアスファイル自体が開きます。

例

QFileInfo info(fileName);
if (info.isSymLink())
    fileName = info.symLinkTarget();

isFile()、isDir()、symLinkTarget()も参照してください 。

bool QFileInfo::isSymbolicLink() const

このオブジェクトがシンボリックリンクを指している場合はtrue を返し、そうでない場合はfalse を返す。

シンボリックリンクはUnix（macOSとiOSを含む）とWindows（NTFS-symlink）に存在し、通常それぞれln -s 、mklink コマンドで作成される。

Unixはシンボリックリンクを透過的に扱います。シンボリックリンクを開くと、事実上、link's target を開くことになる。

isSymLink() とは対照的に、Windows のショートカット (*.lnk ファイル) や macOS のエイリアスでは false が返される。代わりにQFileInfo::isShortcut() とQFileInfo::isAlias() を使用してください。

isFile()、isDir()、isShortcut()、symLinkTarget()も参照 。

bool QFileInfo::isWritable() const

ユーザーがこのQFileInfo が参照するファイル・システム・エントリに書き込み可能な場合はtrue を返し、そうでない場合はfalse を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返す。

isReadable()、isExecutable()、permission()も参照のこと 。

[since 6.2] QString QFileInfo::junctionTarget() const

NTFS ジャンクションをそれが参照するパスに解決します。

NTFS ジャンクションが指すディレクトリへの絶対パスを返すか、 オブジェクトが NTFS ジャンクションでない場合は空文字列を返します。

NTFS ジャンクションが指すディレクトリが実際に存在する保証はありません。

この関数は Qt 6.2 で導入されました。

isJunction(),isFile(),isDir(),isSymLink(),isSymbolicLink(),isShortcut()も参照してください 。

QDateTime QFileInfo::lastModified() const

ファイルが最後に変更された日時を返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は、QFileInfo::lastModified(const QTimeZone &) をオーバーロードし、lastModified(QTimeZone::LocalTime) と同じものを返します。

birthTime()、lastRead()、metadataChangeTime()、fileTime()も参照してください 。

[since 6.6] QDateTime QFileInfo::lastModified(const QTimeZone &tz) const

ファイルが最後に変更された日時を返す。

返される時刻は、tz で指定されたタイムゾーンになります。たとえば、QTimeZone::LocalTime またはQTimeZone::UTC を使用すると、それぞれローカルタイムゾーンまたは UTC での時刻を取得できます。ネイティブ・ファイル・システムAPIは通常UTCを使用するので、QTimeZone::UTC を使用した方が変換が不要なため、高速になることが多い。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は Qt 6.6 で導入されました。

birthTime(const QTimeZone &),lastRead(const QTimeZone &),metadataChangeTime(const QTimeZone &),fileTime(QFileDevice::FileTime, const QTimeZone &)も参照してください 。

QDateTime QFileInfo::lastRead() const

ファイルが最後に読み込まれた（アクセスされた）日時を返す。

この情報が利用できないプラットフォームでは、lastModified() と同じ時刻を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は、QFileInfo::lastRead(const QTimeZone &) をオーバーロードし、lastRead(QTimeZone::LocalTime) と同じ時刻を返します。

birthTime()、lastModified()、metadataChangeTime()、fileTime()も参照してください 。

[since 6.6] QDateTime QFileInfo::lastRead(const QTimeZone &tz) const

ファイルが最後に読み込まれた（アクセスされた）日時を返す。

返される時刻は、tz で指定したタイムゾーンの時刻である。たとえば、QTimeZone::LocalTime またはQTimeZone::UTC を使用すると、それぞれローカルタイムゾーンまたは UTC での時刻を取得できます。ネイティブ・ファイル・システムAPIは通常UTCを使用するため、QTimeZone::UTC を使用すると、変換が不要であるため、高速になることが多い。

この情報が利用できないプラットフォームでは、lastModified （）と同じ時刻を返す。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は Qt 6.6 で導入されました。

birthTime(const QTimeZone &),lastModified(const QTimeZone &),metadataChangeTime(const QTimeZone &),fileTime(QFileDevice::FileTime, const QTimeZone &)も参照してください 。

bool QFileInfo::makeAbsolute()

ファイル・システム・エントリーのパスが相対パスの場合、このメソッドはそれを絶対パスに変換し、true を返す。パスがすでに絶対パスの場合、このメソッドはfalse を返す。

filePath() およびisRelative()も参照のこと 。

QDateTime QFileInfo::metadataChangeTime() const

ファイルのメタデータが最後に変更された日時をローカルタイムで返します。

メタデータの変更は、ファイルが最初に作成されたときに発生しますが、ユーザが inode 情報を書き込んだり設定したりするときにも発生します (たとえば、ファイルのパーミッションを変更するなど)。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は、QFileInfo::metadataChangeTime(constQTimeZone &tz)をオーバーロードし、metadataChangeTime(QTimeZone::LocalTime) と同じものを返します。

birthTime(),lastModified(),lastRead(),fileTime()も参照してください 。

[since 6.6] QDateTime QFileInfo::metadataChangeTime(const QTimeZone &tz) const

ファイルのメタデータが最後に変更された日時を返す。メタデータの変更は、ファイルが最初に作成されたときに発生するが、ユーザーがinode情報を書き込んだり設定したりするときにも発生する（例えば、ファイルのパーミッションを変更する）。

返される時刻は、tz で指定されたタイムゾーンになります。たとえば、QTimeZone::LocalTime またはQTimeZone::UTC を使用すると、それぞれローカルタイムゾーンまたは UTC での時刻を取得できます。ネイティブ・ファイル・システムAPIは通常UTCを使用するため、QTimeZone::UTC を使用すると、変換が不要であるため、高速になることが多い。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

この関数は Qt 6.6 で導入されました。

birthTime(const QTimeZone &),lastModified(const QTimeZone &),lastRead(const QTimeZone &),fileTime(QFileDevice::FileTime time, const QTimeZone &)も参照してください 。

QString QFileInfo::owner() const

ファイルの所有者を返す。ファイルに所有者がいないシステム、またはエラーが発生した場合は、空の文字列が返される。

この関数はUnixでは時間がかかることがある（ミリ秒単位）。Windowsでは、NTFS permissions チェックが有効になっていない限り、空文字列が返される。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返す。

ownerId()、group()、groupId()も参照のこと 。

uint QFileInfo::ownerId() const

ファイルの所有者の ID を返します。

Windows や、ファイルに所有者がいないシステムでは、この関数は ((uint) -2) を返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返す。

owner()、group()、groupId()も参照のこと 。

QString QFileInfo::path() const

QFileInfo が参照するファイルシステムエントリのパスを、エントリ名を除いて返す。

filePath()、absolutePath()、canonicalPath()、dir()、fileName()、isRelative()も参照 。

bool QFileInfo::permission(QFileDevice::Permissions permissions) const

ファイルのパーミッションをテストする。permissions 引数には、パーミッションの組み合わせをチェックするために、QFile::Permissions 型の複数のフラグを OR したものを指定することができます。

ファイルにパーミッションがないシステムでは、この関数は常にtrue を返します。

例

QFileInfofi("/tmp/archive.tar.gz");if(fi.permission(QFile::WriteUser|QFile::ReadGroup))    qWarning("I can change the file; my group can read the file");
if(fi.permission(QFile::書き込みグループQFile::WriteOther))    qWarning("The group or others can change the file");

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返す。

isReadable()、isWritable()、isExecutable()も参照 。

QFileDevice::Permissions QFileInfo::permissions() const

ファイルに対する QFile::Permissions の完全な OR 組合せを返します。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットに関する情報を返します。

[since 6.6] QString QFileInfo::readSymLink() const

シンボリックリンクが参照しているパスを読み込む。

シンボリックリンクを含むディレクトリからの相対パスを解決せずに、 シンボリックリンクが参照している生のパスを返します。返される文字列は、シンボリックリンクが実際に参照する場合にのみ絶対パスになります。オブジェクトがシンボリックリンクでない場合は、空の文字列を返します。

この関数は Qt 6.6 で導入されました。

symLinkTarget(),exists(),isSymLink(),isDir(),isFile()も参照してください 。

void QFileInfo::refresh()

QFileInfo つまり、キャッシュされたプロパティが次にフェッチされるときに、ファイルシステムから情報を読み込みます。

void QFileInfo::setCaching(bool enable)

enable がtrueの場合、ファイル情報のキャッシュを有効にする。enable が偽の場合、キャッシュは無効になる。

キャッシングが有効な場合、QFileInfo はファイル・システムからファイル情報を最初に読み込むが、通常はそれ以降は読み込まない。

キャッシュはデフォルトで有効になっている。

refresh() およびcaching()も参照のこと 。

void QFileInfo::setFile(const QString &path)

このQFileInfo が情報を提供するファイル・システム・エントリーのパスを、絶対パスでも相対パスでもよいpath に設定する。

Unix では、絶対パスはディレクトリ区切り文字'/' で始まります。Windows では、絶対パスはドライブ指定（たとえばD:/ ）で始まります。

相対パスは、ディレクトリ名または通常のファイル名で始まり、現在の作業ディレクトリからの相対的なファイル・システム・エントリのパスを指定します。

例

QFileInfo info("/usr/bin/env");

QString path = info.absolutePath(); // path = /usr/bin
QString base = info.baseName(); // base = env

info.setFile("/etc/hosts");

path = info.absolutePath(); // path = /etc
base = info.baseName(); // base = hosts

isFile()、isRelative()、QDir::setCurrent()、QDir::isRelativePath()も参照 。

[since 6.0] void QFileInfo::setFile(const std::filesystem::path &path)

このQFileInfo が情報を提供するファイル・システム・エントリーのパスをpath に設定する。

path が相対パスの場合、QFileInfo も相対パスになります。

この関数は Qt 6.0 で導入されました。

void QFileInfo::setFile(const QFileDevice &file)

これはオーバーロードされた関数である。

QFileInfo が情報を提供するファイルをfile に設定する。

file に相対パスが含まれている場合、QFileInfo にも相対パスが設定されます。

isRelative()も参照してください 。

void QFileInfo::setFile(const QDir &dir, const QString &path)

これはオーバーロードされた関数である。

このQFileInfo が情報を提供するファイルシステムエントリのパスを、ディレクトリdir のpath に設定する。

dir が相対パスの場合、QFileInfo も相対パスになります。

path が絶対パスの場合、dir で指定されたディレクトリは無視される。

isRelative()も参照のこと 。

qint64 QFileInfo::size() const

ファイル・サイズをバイト数で返す。ファイルが存在しないか、取得できない場合は0が返される。

ファイルがシンボリックリンクの場合、この関数はシンボリックリンクではなくターゲットの情報を返す。

exists()も参照 。

[since 6.0] void QFileInfo::stat()

ファイルシステムから全ての属性を読み込みます。

これは、ファイルシステムに関する情報をワーカースレッドで収集し、QFileInfo インスタンスをキャッシュする形で UI に渡す場合に便利です。

この関数は Qt 6.0 で導入されました。

setCaching() およびrefresh()も参照してください 。

QString QFileInfo::suffix() const

ファイルのサフィックス（拡張子）を返します。

接尾辞は、ファイル内の最後の「.」以降のすべての文字で構成されます (最後の「.」は含まれません)。

例

QFileInfo fi("/tmp/archive.tar.gz");
QString ext = fi.suffix();  // ext = "gz"

例: ファイルの接尾辞は、ファイルの命名規則とは無関係に、すべてのプラットフォームで等しく計算されます (たとえば、Unix の ".bashrc" は空のベース名を持ち、接尾辞は "bashrc" です)。

fileName()、completeSuffix()、baseName()、completeBaseName()も参照のこと 。

[noexcept] void QFileInfo::swap(QFileInfo &other)

このファイル情報をother と交換する。この操作は非常に速く、失敗することはない。

QString QFileInfo::symLinkTarget() const

シンボリックリンクが指すファイルまたはディレクトリへの絶対パス、またはオブジェクトがシンボリックリンクでない場合は空の文字列を返します。

この名前は既存のファイルを表すことはなく、単なる文字列である。

exists()、isSymLink()、isDir()、isFile()も参照 。

[noexcept] QFileInfo &QFileInfo::operator=(QFileInfo &&other)

Move-other をこのQFileInfo インスタンスに割り当てる。

QFileInfo &QFileInfo::operator=(const QFileInfo &fileinfo)

与えられたfileinfo のコピーを作成し、このQFileInfo に割り当てる。