QDirListing Class

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

[explicit] QDirListing::QDirListing(const QString &path, QDirListing::IteratorFlags flags = IteratorFlag::Default)

path を反復処理できる QDirListing を生成します。

flags を通じてオプションを渡すことで、ディレクトリの反復処理方法を制御できます。

デフォルトでは、flags はIteratorFlag::Default です。

IteratorFlagsも参照してください 。

[explicit] QDirListing::QDirListing(const QString &path, const QStringList &nameFilters, QDirListing::IteratorFlags flags = IteratorFlag::Default)

path を反復処理できる QDirListing を作成します。

flags を介してオプションを渡すことで、ディレクトリの反復処理方法を制御できます。デフォルトでは、flags はIteratorFlag::Default に設定されています。

リストされるエントリは、nameFilters 内のファイルグロブパターンに従ってフィルタリングされます。これらのパターンは、QRegularExpression::fromWildcard を使用して正規表現に変換されます（詳細については、QDir::setNameFilters()を参照してください）。

たとえば、オーディオファイルを反復処理するには、次のようなイテレータを使用できます：

QDirListing audioFileIt(u"/home/johndoe/"_s, QStringList{u"*.mp3"_s, u"*.wav"_s},
                        QDirListing::IteratorFlag::FilesOnly);

場合によっては、文字列比較を用いて range-for ループでエントリを反復処理することで、名前によるフィルタリングをより効率的に行うことができます。例えば：

    using F = QDirListing::IteratorFlag;
    const auto flags = F::FilesOnly | F::Recursive | F::ResolveSymlinks;
    for (const auto &dirEntry : QDirListing(u"/usr"_s, flags)) {
        // Faster than using name filters, filter ".txt" and ".html" files
        // using QString API
        const QString fileName = dirEntry.fileName();
        if (fileName.endsWith(".txt"_L1) || fileName.endsWith(".html"_L1)) {
            // ...
        }
    }
}

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

[noexcept] QDirListing::QDirListing(QDirListing &&other)

移動コンストラクタ。other をこの QDirListing に移動します。

[noexcept] QDirListing::~QDirListing()

QDirListing を削除します。

(c) `begin()` は、ディレクトリエントリを反復処理するために使用できる `QDirListing::const_iterator ` を返します。

• これは順方向のみのシングルパス・イテレータです（ディレクトリエントリを逆順に反復処理することはできません）
• コピーすることはできず、std::move()d のみが使用可能です。
• std::input_iterator をモデル化するオブジェクトに対するポストインクリメントの戻り値は、部分的に形成されたもの（それ以降に前進したイテレータのコピー）であり、そのようなオブジェクトに対して有効な操作は、破棄と新しいイテレータの代入のみです。したがって、ポストインクリメント演算子はイテレータを前進させ、void を返します。
• ランダムアクセスは許可されません
• 範囲指定の for ループで使用可能。または、ランダムアクセスイテレータを必要としない C++20 の std::ranges アルゴリズムと併用可能
• 有効なイテレータの参照解除は、const DirEntry &
• (c) `end()`は、反復の終了を示すQDirListing::sentinel を返します。`end()`と等価なイテレータを間接参照すると、未定義の挙動となります

（上記の制限事項の一部は、基盤となるシステムライブラリ関数の実装によって定められています）。

例：

usingItFlag=QDirListing::IteratorFlag;
for(const auto &dirEntry: QDirListing(u"/etc"_s,ItFlag::Recursive)) {
    qDebug() << dirEntry.filePath();
   // /etc/.
    // /etc/..
    // /etc/X11
    // /etc/X11/fs
    // ...
}

名前でフィルタリングされたすべてのファイルを再帰的に検索して読み込む方法は次のとおりです:

F=QDirListing::IteratorFlag;
QDirListing dirList(u"/sys"_s,QStringList{u"scaling_cur_freq"_s},F::FilesOnly|F::Recursive);
for(const auto &dirEntry: dirList) {
    QFile f(dirEntry.filePath());
    if(f.open(QIODevice::ReadOnly))
        qDebug() << f.fileName() << f.readAll().trimmed().toDouble() / 1000 << "MHz";
}

「QDirListing::DirEntry」も参照してください 。

QDirListing::IteratorFlags QDirListing::iteratorFlags() const

この `QDirListing` の構築に使用された `IteratorFlags ` の集合を返します。

QString QDirListing::iteratorPath() const

このQDirListing を構築するために使用されたディレクトリパスを返します。

QStringList QDirListing::nameFilters() const

この `QDirListing` の構築に使用されたファイル名グロブフィルタのリストを返します。

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

other をこのQDirListing に移動・代入します。