QDir Class

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

QDir::QDir(const QString &path = QString())

与えられたディレクトリpath を指す QDir を構築します。path が空の場合、プログラムの作業ディレクトリ (".") が使用されます。

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

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

与えられたディレクトリpath を指す QDir を構築します。path が空の場合、プログラムの作業ディレクトリ (".") が使用されます。

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

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

QDir::QDir(const QString &path, const QString &nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)

パスpath を持つ QDir を構築します。この QDir は、nameFilter を用いて名前で、filters を用いて属性でエントリをフィルタリングします。また、sort を使用して名前をソートします。

デフ ォル トnameFilter は空文字列で、 何も除外 し ません。 デフ ォル トfilters はAllEntries で、 こ れ も 何も除外 し ません。デフォルトのsort は、Name |IgnoreCase 、つまり大文字小文字を区別せずに名前をソートする。

path が空文字列の場合、QDir は "." (カレントディレクトリ) を使用します。nameFilter が空文字列の場合、QDir は名前フィルタ "*" (すべてのファイル) を使用します。

exists()、setPath()、setNameFilters()、setFilter()、setSorting()も参照のこと 。

[since 6.0] QDir::QDir(const std::filesystem::path &path, const QString &nameFilter, QDir::SortFlags sort = SortFlags(Name | IgnoreCase), QDir::Filters filters = AllEntries)

パスpath を持つ QDir を構築します。この QDir は、nameFilter を用いて名前で、filters を用いて属性でエントリをフィルタリングします。また、sort を使用して名前をソートします。

デフ ォル トnameFilter は空文字列で、 何も除外 し ません。 デフ ォル トfilters はAllEntries で、 こ れ も 何も除外 し ません。デフォルトのsort はName |IgnoreCase 、つまり、大文字小文字を区別せずに名前でソートする。

path が空の場合、QDir は "." (カレントディレクトリ) を使用します。nameFilter が空文字列の場合、QDir は名前フィルタ "*" (すべてのファイル) を使用します。

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

exists(),setPath(),setNameFilters(),setFilter(),setSorting()も参照してください 。

QDir::QDir(const QDir &dir)

dir ディレクトリ用の QDir オブジェクトのコピーである QDir オブジェクトを構築します。

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

[noexcept] QDir::~QDir()

QDir オブジェクトを破棄し、リソースを解放する。これは、ファイルシステムの基礎となるディレクトリには影響しません。

QString QDir::absoluteFilePath(const QString &fileName) const

ディレクトリ内のファイルの絶対パス名を返す。ファイルが実際にディレクトリに存在するかどうかはチェックしない。exists() を参照。fileName の冗長な多重区切り文字や "." および ".." ディレクトリは削除されない (cleanPath() を参照)。

relativeFilePath()、filePath()、canonicalPath()も 参照。

QString QDir::absolutePath() const

絶対パス（"/"で始まるパス、またはドライブ指定）を返します。このパスにはシンボリックリンクが 含まれることがありますが、冗長な"."、"... "や複数のセパレータが含まれることはありません。

setPath()、canonicalPath()、exists()、cleanPath()、dirName()、absoluteFilePath()も参照 。

[static] void QDir::addSearchPath(const QString &prefix, const QString &path)

prefix の検索パスにpath を追加する。

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

[static, since 6.0] void QDir::addSearchPath(const QString &prefix, const std::filesystem::path &path)

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

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

QString QDir::canonicalPath() const

正規パス、つまりシンボリックリンクや冗長な". "や"... "要素を含まないパスを返す。

シンボリックリンクのないシステムでは、この関数は常にabsolutePath() が返すのと同じ文字列を返します。正規パスが存在しない場合 (通常はシンボリックリンクのぶら下がりによるもの)、 canonicalPath() は空の文字列を返します。

例

QString bin = "/local/bin";         // where /local/bin is a symlink to /usr/bin
QDir binDir(bin);
QString canonicalBin = binDir.canonicalPath();
// canonicalBin now equals "/usr/bin"

QString ls = "/local/bin/ls";       // where ls is the executable "ls"
QDir lsDir(ls);
QString canonicalLs = lsDir.canonicalPath();
// canonicalLS now equals "/usr/bin/ls".

path()、absolutePath()、exists()、cleanPath()、dirName()、absoluteFilePath()も参照 。

bool QDir::cd(const QString &dirName)

QDir のディレクトリをdirName に変更する。

新しいディレクトリが存在する場合はtrue を返し、存在しない場合はfalse を返す。新しいディレクトリが存在しない場合、論理 cd() 操作は実行されないことに注意。

cd("...")を呼び出すことは、cdUp()を呼び出すことと同じである。

cdUp()、isReadable()、exists()、path()も参照 。

bool QDir::cdUp()

QDir のカレントディレクトリから1つ上に移動してディレクトリを変更する。

新しいディレクトリが存在する場合はtrue を返し、存在しない場合はfalse を返す。新しいディレクトリが存在しない場合、論理 cdUp()操作は実行されないことに注意。

cd()、isReadable()、exists()、path()も参照 。

[static] QString QDir::cleanPath(const QString &path)

path 、ディレクトリの区切り文字を正規化し（つまり、プラットフォーム固有の区切り文字を"/"に変換し）、冗長な区切り文字を削除した上で、". "や". "を（可能な限り）解決して返します。

シンボリックリンクは保持される。この関数は正規パスを返すのではなく、入力の最も単純なバージョンを返す。たとえば、"./local "は "local "に、"local/../bin "は "bin "に、"/local/usr/../bin "は"/local/bin "になる。

absolutePath() およびcanonicalPath()も参照のこと 。

qsizetype QDir::count() const

ディレクトリ内のディレクトリとファイルの総数を返します。

entryList().count() と同じです。

operator[]() およびentryList()も参照してください 。

[static] QDir QDir::current()

アプリケーションのカレント・ディレクトリを返す。

このディレクトリは、カレント・ディレクトリの絶対パスを使用して構築されるため、path() はabsolutePath() と同じになります。

currentPath()、setCurrent()、home()、root()、temp()も参照 。

[static] QString QDir::currentPath()

アプリケーションのカレント・ディレクトリの絶対パスを返す。カレント・ディレクトリは、QDir::setCurrent() で最後に設定されたディレクトリ、または、 () が一度も呼び出されなかった場合は、このアプリケーションが親プロセスによって起動されたときのディレクトリである。

current()、setCurrent()、homePath()、rootPath()、tempPath()、QCoreApplication::applicationDirPath()も参照 。

QString QDir::dirName() const

ディレクトリの名前を返します。これはパスと同じではありません。例えば、"mail "という名前のディレクトリは、"/var/spool/mail "というパスを持っているかもしれません。ディレクトリに名前がない場合(例えば、ルートディレクトリである場合)、空の文字列が返される。

この名前を持つディレクトリが実際に存在するかどうかのチェックは行われない; しかし、exists()を参照のこと。

path()、filePath()、absolutePath()、absoluteFilePath()も参照の こと。

[static] QFileInfoList QDir::drives()

このシステムのルート・ディレクトリのリストを返す。

Windowsでは、"C:/"、"D:/"などを含むQFileInfo オブジェクトのリストを返す。取り出し可能なメディアが空のドライブは返されない。他のオペレーティング・システムでは、1つのルート・ディレクトリ（すなわち "/"）だけを含むリストを返す。

root() およびrootPath()も参照の こと。

QFileInfoList QDir::entryInfoList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

事前にsetNameFilters() とsetFilter() で設定した名前フィルタと属性フィルタに従って並べ替え、setSorting() で設定したフラグに従ってソートした、 ディレクトリ内のすべてのファイルとディレクトリのQFileInfo オブジェクトのリストを返す。

名前フィルタ、ファイル属性フィルタ、およびソート指定は、nameFilters 、filters 、およびsort 引数を使用して上書きすることができる。

ディレクトリが読めない場合、存在しない場合、または指定に一致するものがない場合は、空のリストを返します。

entryList()、setNameFilters()、setSorting()、setFilter()、isReadable()、exists()も参照のこと 。

QFileInfoList QDir::entryInfoList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

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

事前にsetNameFilters() とsetFilter() で設定された名前と属性のフィルタに従って並び替えられ、setSorting() で設定されたフラグに従ってソートされた、 ディレクトリ内のすべてのファイルとディレクトリのQFileInfo オブジェクトのリストを返す。

属性フィルタと並べ替えの指定は、filters とsort 引数を使用して上書きすることができる。

ディレクトリが読めない場合、存在しない場合、または指定に一致するものがない 場合は、空のリストを返します。

entryList()、setNameFilters()、setSorting()、setFilter()、isReadable()、exists()も参照 。

QStringList QDir::entryList(const QStringList &nameFilters, QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

事前にsetNameFilters() とsetFilter() で設定された名前フィルタと属性フィルタに従って並べ替えられ、setSorting() で設定されたフラグに従ってソートされた、 ディレクトリ内のすべてのファイルとディレクトリの名前のリストを返す。

名前フィルタ、ファイル属性フィルタ、およびソート指定は、nameFilters 、filters 、およびsort 引数を使用して上書きすることができる。

ディレクトリが読めない場合、存在しない場合、または指定に一致するものがない場合は、空のリストを返します。

entryInfoList()、setNameFilters()、setSorting()、setFilter()も参照のこと 。

QStringList QDir::entryList(QDir::Filters filters = NoFilter, QDir::SortFlags sort = NoSort) const

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

事前にsetNameFilters() とsetFilter() で設定された名前と属性のフィルタに従って並び替えられ、setSorting() で設定されたフラグに従ってソートされた、 ディレクトリ内のすべてのファイルとディレクトリの名前のリストを返す。

属性フィルタと並べ替えの指定は、filters とsort 引数を使用して上書きすることができる。

ディレクトリが読めない場合、存在しない場合、または指定に一致するものがない場合は、空のリストを返します。

entryInfoList()、setNameFilters()、setSorting()、setFilter()も参照 。

bool QDir::exists(const QString &name) const

name というファイルが存在すればtrue を返し、そうでなければ false を返す。

name に絶対ファイル・パスが含まれていない限り、ファイル名はディレクトリ自体からの相対ファ イルであると仮定されるため、この関数は通常、ディレクトリ内のファイルの存在を確認する ために使用される。

QFileInfo::exists() およびQFile::exists()も参照のこと 。

bool QDir::exists() const

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

ディレクトリが存在する場合はtrue を返し、そうでない場合はfalse を返します（同じ名前のファイルが見つかった場合、この関数は偽を返します）。

引数を受け付けるこの関数のオーバーロードは、ディレクトリ内にファイルやディレクトリが存在するかどうかをテストするために使用されます。

QFileInfo::exists() およびQFile::exists()も参照 。

QString QDir::filePath(const QString &fileName) const

ディレクトリ内のファイルのパス名を返す。ファイルが実際にディレクトリに存在するかどうかはチェックしない。exists() を参照。QDir が相対パスである場合、返されるパス名も相対パスになります。fileName の冗長な多重区切り文字や "." および ".." ディレクトリは削除されない (cleanPath() を参照)。

dirName()、absoluteFilePath()、isRelative()、canonicalPath()も参照 。

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

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

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

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

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

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

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

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

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

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

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

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

QDir::Filters QDir::filter() const

setFilter() で設定した値を返す。

setFilter()も参照 。

[static] QString QDir::fromNativeSeparators(const QString &pathName)

'/' をファイルセパレータとして使用してpathName を返す。例えばWindowsでは、 fromNativeSeparators("c:\\winnt\\system32") は "c:/winnt/system32" を返す。

Unixなど、オペレーティング・システムによっては、返される文字列が引数 と同じになることがある。

toNativeSeparators() およびseparator()も参照 。

[static] QDir QDir::home()

ユーザのホーム・ディレクトリを返す。

このディレクトリは、ホーム・ディレクトリの絶対パスを使用して構築され、path() とabsolutePath() が同じになるようにします。

詳細はhomePath() を参照。

drives()、current()、root()、temp()も参照 。

[static] QString QDir::homePath()

ユーザーのホーム・ディレクトリの絶対パスを返します。

Windowsでは、この関数は現在のユーザのプロファイルのディレクトリを返します。通常、これは

C:/Users/Username

toNativeSeparators() 関数を使用して、セパレータをオペレーティング・システムに適したものに変換します。

現在のユーザ・プロファイルのディレクトリが存在しないか、または取得できない場合は、 存在して利用可能なパスが見つかるまで、以下の選択肢が（指定された順序で）チェックされます：

1. 環境変数USERPROFILE で指定されたパス。
2. HOMEDRIVE とHOMEPATH 環境変数を連結したパス。
3. 環境変数HOME で指定されたパス。
4. SystemDrive 環境変数を使用する）rootPath() 関数によって返されるパス。
5. C:/ ディレクトリ。

Windows以外のオペレーティング・システムでは、HOME 環境変数が存在する場合はそれが使用され、存在しない場合はrootPath() が返すパスが使用される。

home()、currentPath()、rootPath()、tempPath()も参照のこと 。

bool QDir::isAbsolute() const

ディレクトリのパスが絶対パスであればtrue を返し、そうでなければfalse を返す。isAbsolutePath() を参照。

isRelative()、makeAbsolute()、cleanPath()も参照 。

[static] bool QDir::isAbsolutePath(const QString &path)

path が絶対パスであればtrue を返し、相対パスであればfalse を返す。

isAbsolute()、isRelativePath()、makeAbsolute()、cleanPath()、QResourceも参照 。

bool QDir::isEmpty(QDir::Filters filters = Filters(AllEntries | NoDotAndDotDot)) const

ディレクトリが空かどうかを返します。

QDir::AllEntries | QDir::NoDotAndDotDot のフィルタを使用したcount() == 0 と同等ですが、ディレクトリに少なくとも 1 つのエントリが含まれているかどうかをチェックするだけなので、より高速です。

count()、entryList()、setFilter()も参照のこと 。

bool QDir::isReadable() const

ディレクトリが読み取り可能で、ファイルを名前で開くことができる場合はtrue を返し、そうでない場合はfalse を返す。

QFileInfo::isReadable()も参照してください 。

bool QDir::isRelative() const

ディレクトリパスが相対パスであればtrue を返し、そうでなければ false を返す。(Unix では、"/" で始まらないパスは相対パスです）。

makeAbsolute()、isAbsolute()、isAbsolutePath()、cleanPath()も参照のこと 。

[static] bool QDir::isRelativePath(const QString &path)

path が相対パスの場合はtrue を返し、絶対パスの場合はfalse を返す。

isRelative()、isAbsolutePath()、makeAbsolute()も参照 。

bool QDir::isRoot() const

ディレクトリがルート・ディレクトリの場合はtrue を返し、そうでない場合はfalse を返す。

QDirdir("/tmp/root_link"); dir=dir.canonicalPath();if(dir.isRoot())    qWarning("It is a root link");

root() およびrootPath()も参照のこと 。

[static constexpr noexcept] QChar QDir::listSeparator()

ネイティブのパスリスト区切り文字: Unix では ':'、Windows では ';' を返します。

separator()も参照 。

bool QDir::makeAbsolute()

ディレクトリパスを絶対パスに変換する。すでに絶対パスの場合は何も起こらない。変換に成功した場合はtrue を返し、失敗した場合はfalse を返す。

isAbsolute()、isAbsolutePath()、isRelative() およびcleanPath()も参照 。

[static] bool QDir::match(const QString &filter, const QString &fileName)

fileName がワイルドカード（グロブ）パターンfilter にマッチする場合はtrue を返し、マッチしない場合はfalse を返す。filter には、スペースまたはセミコロンで区切られた複数のパターンを含めることができる。マッチングは大文字小文字を区別しない。

QRegularExpression::fromWildcard()、entryList()、entryInfoList()も参照 。

[static] bool QDir::match(const QStringList &filters, const QString &fileName)

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

fileName がfilters のリスト中のワイルドカード（グロブ）パターンのいずれかにマッチする場合はtrue を返し、マッチしない場合はfalse を返す。マッチングは大文字小文字を区別しない。

QRegularExpression::fromWildcard()、entryList()、entryInfoList()も参照 。

[since 6.3] bool QDir::mkdir(const QString &dirName, QFileDevice::Permissions permissions) const

dirName というサブディレクトリを作成する。

成功した場合はtrue を返し、そうでない場合はfalse を返す。

この関数を呼び出したときにすでにディレクトリが存在する場合は、false を返します。

作成されたディレクトリのパーミッションはpermissions に設定される。

POSIXシステムでは、パーミッションはumask の値に影響される。

Windowsでは、パーミッションはACLを使用してエミュレートされる。これらのACLは、グループが他のグループよりも少ないパーミッションを与えられている場合、非正規の順序になることがある。このようなパーミッションを持つファイルやディレクトリは、プロパティダイアログのセキュリティタブを開いたときに警告が発生します。グループに他のグループに与えられている全てのパーミッションを与えることで、そのような警告を避けることができます。

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

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

bool QDir::mkdir(const QString &dirName) const

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

デフォルトのパーミッションでdirName というサブディレクトリを作成する。

POSIX システムでは、デフォルトでumask で許可されているすべてのパーミッションが付与されます。Windows では、新しいディレクトリは親ディレクトリのパーミッションを継承します。

bool QDir::mkpath(const QString &dirPath) const

ディレクトリパスdirPath を作成します。

この関数は、ディレクトリの作成に必要なすべての親ディレクトリを作成します。

成功した場合はtrue を返し、失敗した場合はfalse を返します。

この関数が呼ばれたときにすでにパスが存在する場合は、true を返します。

rmpath()も参照 。

QStringList QDir::nameFilters() const

setNameFilters() で設定した文字列リストを返す。

setNameFilters()も参照 。

QString QDir::path() const

パスを返す。このパスにはシンボリックリンクが含まれることがありますが、 決して冗長な "."、".." や複数のセパレータは含まれません。

返されるパスは、絶対パスでも相対パスでもかまいません (setPath() を参照)。

setPath()、absolutePath()、exists()、cleanPath()、dirName()、absoluteFilePath()、toNativeSeparators()、makeAbsolute()も参照 。

void QDir::refresh() const

ディレクトリ情報を更新する。

QString QDir::relativeFilePath(const QString &fileName) const

fileName のディレクトリからの相対パスを返す。

QDir dir("/home/bob");
QString s;

s = dir.relativeFilePath("images/file.jpg");     // s is "images/file.jpg"
s = dir.relativeFilePath("/home/mary/file.txt"); // s is "../mary/file.txt"

absoluteFilePath()、filePath() およびcanonicalPath()も参照 。

bool QDir::remove(const QString &fileName)

fileName ファイルを削除する。

ファイルの削除に成功した場合はtrue を返し、失敗した場合はfalse を返す。

bool QDir::removeRecursively()

ディレクトリを削除する。

成功すればtrue を返し、そうでなければ false を返す。

ファイルまたはディレクトリを削除できない場合、removeRecursively() は処理を続行し、可能な限り多くのファイルとサブディレクトリの削除を試みてから、false を返す。

ディレクトリがすでに削除されている場合、このメソッドはtrue を返します (期待される結果にはすでに到達しています)。

bool QDir::rename(const QString &oldName, const QString &newName)

ファイルまたはディレクトリの名前をoldName からnewName に変更し、成功すれば真を返し、失敗すればfalse を返す。

ほとんどのファイル・システムでは、rename()が失敗するのは、oldName が存在しないか、新しい名前のファイルが既に存在する場合だけである。しかし、rename()が失敗する理由は他にもある。たとえば、少なくとも1つのファイル・システムでは、newName がオープン・ファイルを指している場合、rename()は失敗する。

oldName が（ディレクトリではなく）ファイルであり、すぐに名前を変更できない場合、Qt はoldName をnewName にコピーし、oldName を削除しようとします。

QFile::rename()も参照してください 。

bool QDir::rmdir(const QString &dirName) const

dirName で指定されたディレクトリを削除する。

rmdir()が成功するには、ディレクトリが空でなければならない。

成功した場合はtrue を返し、失敗した場合はfalse を返す。

mkdir()も参照 。

bool QDir::rmpath(const QString &dirPath) const

ディレクトリパスdirPath を削除します。

この関数は、dirPath のすべての親ディレクトリを削除します。これは mkpath(dirPath) の逆である。

成功すればtrue を返し、そうでなければfalse を返す。

mkpath()も参照 。

[static] QDir QDir::root()

ルート・ディレクトリを返す。

このディレクトリは、ルート・ディレクトリの絶対パスを使用して構築され、path() がabsolutePath() と同じになるようにします。

詳細はrootPath() を参照。

drives()、current()、home()、temp()も参照 。

[static] QString QDir::rootPath()

ルート・ディレクトリの絶対パスを返します。

Unixオペレーティング・システムでは"/"を返します。Windowsファイル・システムでは、通常 "c:/"を返す。

root()、drives()、currentPath()、homePath()、tempPath()も参照 。

[static] QStringList QDir::searchPaths(const QString &prefix)

prefix の検索パスを返す。

setSearchPaths() およびaddSearchPath()も参照 。

[static] QChar QDir::separator()

ネイティブのディレクトリ区切り文字を返します：Unixでは"/"、Windowsでは"◆"を返します。

ファイルパスを構築するためにこの関数を使用する必要はありません。常に "/" を使用する場合、Qt はパスをオペレーティングシステムに合わせて変換します。オペレーティングシステムのセパレータを使用してユーザーにパスを表示したい場合は、toNativeSeparators() を使用してください。

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

[static] bool QDir::setCurrent(const QString &path)

アプリケーションの現在の作業ディレクトリをpath に設定する。ディレクトリが正常に変更された場合はtrue を返し、そうでない場合はfalse を返す。

QString absolute = "/local/bin";
QString relative = "local/bin";
QFileInfo absFile(absolute);
QFileInfo relFile(relative);

QDir::setCurrent(QDir::rootPath());
// absFile and relFile now point to the same file

QDir::setCurrent("/tmp");
// absFile now points to "/local/bin",
// while relFile points to "/tmp/local/bin"

current()、currentPath()、home()、root()、temp()も参照 。

void QDir::setFilter(QDir::Filters filters)

entryList() およびentryInfoList() で使用されるフィルタをfilters に設定します。このフィルタは、entryList() およびentryInfoList() で返されるファイルの種類を指定するために使用されます。QDir::Filter を参照。

filter() およびsetNameFilters()も参照して ください。

void QDir::setNameFilters(const QStringList &nameFilters)

entryList() およびentryInfoList() で使用される名前フィルタを、nameFilters で指定されるフィルタ・リストに設定する。

各名前フィルタは、* および? のワイルドカードを理解するワイルドカード（グロビング）フィルタです。QRegularExpression::fromWildcard()を参照。

例えば、以下のコードでは、QDir に 3 つの名前フィルタを設定し、C++ ソース・ファイルに通常使用される拡張子を持つファイルのみがリストされるようにしています：

    QStringList filters;
    filters << "*.cpp" << "*.cxx" << "*.cc";
    dir.setNameFilters(filters);

nameFilters() およびsetFilter()も参照してください 。

void QDir::setPath(const QString &path)

ディレクトリのパスをpath に設定する。 パスは、冗長な "." や ".." 、複数のセパレータから削除される。このパスを持つディレクトリが実際に存在するかどうかのチェックは行われないが、exists() を使用して自分でチェックすることができる。

パスは絶対パスでも相対パスでもよい。絶対パスは、ディレクトリ区切り文字"/"（Windowsの場合、オプションでその前にドライブを指定する）で始まる。相対ファイル名は、ディレクトリ名またはファイル名で始まり、カレント・ディ レクトリからの相対パスを指定する。絶対パスの例は "/tmp/quartz"、相対パスの例は "src/fatlib" である。

path()、absolutePath()、exists()、cleanPath()、dirName()、absoluteFilePath()、isRelative()、makeAbsolute()も参照の こと。

[since 6.0] void QDir::setPath(const std::filesystem::path &path)

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

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

[static] void QDir::setSearchPaths(const QString &prefix, const QStringList &searchPaths)

接頭辞prefix からsearchPaths を持つファイル名に対する Qt の検索パスを設定または置換します。

ファイル名に接頭辞を指定するには、接頭辞の前にコロン 1 つをつけます（例："images:undo.png"、"xmldocs:books.xml"）。prefix には文字か数字しか入れられません（例：コロンやスラッシュは入れられません）。

Qt はこの検索パスを使用して、既知の接頭辞を持つファイルを検索します。検索パスのエントリは、最初のエントリから順番にテストされます。

QDir::setSearchPaths("icons", QStringList(QDir::homePath() + "/images"));
QDir::setSearchPaths("docs", QStringList(":/embeddedDocuments"));
...
QPixmap pixmap("icons:undo.png"); // will look for undo.png in QDir::homePath() + "/images"
QFile file("docs:design.odf"); // will look in the :/embeddedDocuments resource path

ファイル名のプレフィックスは、Windows のドライブ文字との衝突を避けるため、少なくとも 2 文字以上でなければなりません。

検索パスには、Qt Resource System へのパスを含めることができます。

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

void QDir::setSorting(QDir::SortFlags sort)

entryList() とentryInfoList() で使用されるソート順を設定する。

sort は、列挙型QDir::SortFlag の値を OR することで指定される。

sorting() およびSortFlagも参照 。

QDir::SortFlags QDir::sorting() const

setSorting() で設定された値を返す。

setSorting() およびSortFlagも参照 。

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

このQDir インスタンスをother と交換する。この操作は非常に高速で、失敗することはない。

[static] QDir QDir::temp()

システムの一時ディレクトリを返す。

このディレクトリは、一時ディレクトリの絶対正規パスを使用して構築され、path() がabsolutePath() と同じになるようにします。

詳細はtempPath() を参照。

drives()、current()、home()、root()も参照 。

[static] QString QDir::tempPath()

システムの一時ディレクトリの絶対正規パスを返す。

Unix/Linuxシステムでは、これは環境変数TMPDIR 、またはTMPDIR が定義されていない場合は/tmp のパスである。Windowsでは、これは通常TEMP またはTMP 環境変数内のパスである。このメソッドが返すパスは、（ドライブの）ルート・ディレクトリでない限り、ディレクトリ区切り文字で終わることはない。

temp()、currentPath()、homePath()、rootPath()も参照 。

[static] QString QDir::toNativeSeparators(const QString &pathName)

'/' セパレータを、基本オペレーティングシステムに適したセパレータに変換してpathName を返す。

Windows では、toNativeSeparators("c:/winnt/system32") は、"c: \winntsystem32" を返します。

Unixなど、一部のオペレーティング・システムでは、返される文字列が引数と同じに なることがある。

fromNativeSeparators() およびseparator()も参照 。

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

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

QDir &QDir::operator=(const QDir &dir)

dir オブジェクトのコピーを作成し、このQDir オブジェクトに割り当てる。

QString QDir::operator[](qsizetype pos) const

ファイル名リストの位置pos にあるファイル名を返す。entryList().at(index) と同等です。pos は、リスト内の有効なインデックス位置でなければなりません（つまり、0 <= pos <count()）。

count() およびentryList()も参照してください 。