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);

때로는 범위 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()`와 동일한 값을 가지는 이터레이터를 간접 참조하는 것은 정의되지 않은 동작입니다.

(위의 제한 사항 중 일부는 기본이 되는 시스템 라이브러리 함수의 구현에 의해 결정됩니다).

예를 들어:

using ItFlag = 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 로 이동-할당합니다.