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 を構築し、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 を構築し、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()が返すのと同じ文字列を返します。 このメソッドは、エントリが存在しない場合、到達できない場合（例えば、現在のユーザーがディレクトリパスへのアクセス権を持っていない場合）、またはパスの正規化中にエラーが発生した場合（通常はダングリングシンボリックリンクが原因）、空の文字列を返します。

例:

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

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

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

ディレクトリが読み取り不可の場合、存在しない場合、または仕様に一致するものが何もない場合は、空のリストを返します。

ディレクトリが大きい場合、この関数はディレクトリ内のエントリごとにQFileInfo のインスタンスを作成するため、メモリ使用量が急増する可能性があります。項目を 1 つずつ反復処理することが目的の場合は、QDirListing の使用を検討してください。

entryList()、setNameFilters()、setSorting()、setFilter()、isReadable()、およびexists()も参照してください 。

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

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

属性フィルタおよびソート指定は、filters およびsort 引数を使用して上書きできます。

ディレクトリが読み取り不可の場合、存在しない場合、または仕様に一致する項目がない場合は、空のリストを返します。

大規模なディレクトリの場合、この関数はディレクトリ内の各エントリごとにQFileInfo のインスタンスを作成するため、メモリ使用量が急増する可能性があります。項目を 1 つずつ反復処理することが目的の場合は、QDirListing の使用を検討してください。

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 の引数を使用して上書きできます。

ディレクトリが読み取り不可能である場合、存在しない場合、または指定に一致するものが何もない場合は、空のリストを返します。

ディレクトリが大きい場合、この関数はディレクトリ内のエントリごとにQString のインスタンスを作成するため、メモリ使用量が急増する可能性があります。項目を 1 つずつ反復処理することが目的の場合は、QDirListing の使用を検討してください。

entryInfoList()、setNameFilters()、setSorting()、およびsetFilter()も参照してください 。

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

そのディレクトリ内のすべてのファイルおよびディレクトリの名前の一覧を返します。この一覧は、setNameFilters() およびsetFilter() で事前に設定された名前および属性のフィルタに従って並べ替えられ、setSorting() で設定されたフラグに基づいてソートされます。

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

ディレクトリが読み取り不可の場合、存在しない場合、または仕様に一致するものが何もない場合は、空のリストを返します。

ディレクトリが大きい場合、この関数はディレクトリ内の各エントリごとに `QString ` のインスタンスを作成するため、メモリ使用量が急増する可能性があります。項目を1つずつ反復処理することが目的の場合は、`QDirListing ` の使用を検討してください。

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` を返します。（同名のファイルが見つかった場合、この関数は `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

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

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

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

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

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

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

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

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

path() をstd::filesystem::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. rootPath() 関数（SystemDrive 環境変数を使用）によって返されるパス
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

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

count() == 0 にQDir::AllEntries | QDir::NoDotAndDotDot のフィルタを指定したものと同等ですが、ディレクトリに少なくとも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` を返します。

QDir dir("/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()も参照してください 。

bool QDir::mkdir(const QString &dirName, std::optional<QFileDevice::Permissions> permissions = std::nullopt) const

指定されたpermissions を使用して、dirName という名前のサブディレクトリを作成します。

permissions がstd::nullopt （デフォルト）の場合、この関数はデフォルトの権限を設定します。

成功した場合はtrue を返し、操作が失敗した場合、またはdirName がすでに存在していた場合はfalse を返します。

dirName がすでに存在する場合、このメソッドはその権限を変更しません。

POSIX システムでは、permissions は現在のプロセスの umask (ファイル作成マスク) によって変更されるため、一部の権限ビットが無効になる可能性があります。

Windows では、デフォルトで、新しいディレクトリはその親ディレクトリからアクセス権を継承します。permissions は ACL を使用してエミュレートされます。グループに他のユーザーよりも少ないアクセス権が与えられている場合、これらの ACL は非標準の順序になることがあります。 このような権限を持つファイルやディレクトリは、「プロパティ」ダイアログの「セキュリティ」タブを開いた際に警告が表示されます。他のユーザーに付与されているすべての権限をグループにも付与することで、このような警告を回避できます。

rmdir()、mkpath()、およびrmpath()も参照してください 。

bool QDir::mkpath(const QString &dirPath, std::optional<QFileDevice::Permissions> permissions = std::nullopt) const

「dirPath 」という名前のディレクトリを作成します。

dirPath がまだ存在しない場合、このメソッドは、permissions を使用して、 および存在しない親ディレクトリをすべて作成します。

dirPath がすでに存在する場合、このメソッドはその権限を変更しません。すでに存在する親ディレクトリについても同様です。

permissions がstd::nullopt （デフォルト値）の場合、この関数はデフォルトの権限を設定します。

成功した場合、またはdirPath がすでに存在していた場合はtrue を返します。それ以外の場合はfalse を返します。

POSIX システムでは、permissions は現在のプロセスの umask （ファイル作成マスク）によって変更されるため、一部の権限ビットが無効になる可能性があります。

Windows では、デフォルトで、新しいディレクトリはその親ディレクトリから権限を継承します。permissions は ACL を使用してエミュレートされます。グループに他のグループよりも少ない権限が与えられている場合、これらの ACL は非標準の順序になることがあります。 このような権限を持つファイルやディレクトリは、「プロパティ」ダイアログの「セキュリティ」タブを開いた際に警告が表示されます。グループに「その他」に付与されているすべての権限を付与することで、このような警告を回避できます。

rmpath()、mkdir()、およびrmdir()も参照してください 。

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` に名前変更し、成功した場合は `true` を返し、失敗した場合は `false` を返します。

ほとんどのファイルシステムでは、oldName が存在しない場合、または新しい名前を持つファイルがすでに存在する場合にのみ、rename() は失敗します。ただし、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 」というプレフィックスが付く場合、Qtの検索パスを「searchPaths 」に設定または置き換えます。

ファイル名のプレフィックスを指定するには、プレフィックスの後にコロン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 リソースシステムへのパスを含めることができます。

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:\winnt\system32 " を返します。

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

fromNativeSeparators() およびseparator()も参照してください 。

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

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()も参照してください 。