# QAbstractFileEngineIterator Class Reference ## [[QtCore](index.htm) module] 該QAbstractFileEngineIterator類提供一個迭代器接口，用于自定義文件引擎。[More...](#details) ### Methods * `__init__ (self, QDir.Filters?filters, QStringList?nameFilters)` * `QFileInfo currentFileInfo (self)` * `QString currentFileName (self)` * `QString currentFilePath (self)` * `QDir.Filters filters (self)` * `bool hasNext (self)` * `QStringList nameFilters (self)` * `QString next (self)` * `QString path (self)` * * * ## Detailed Description 該QAbstractFileEngineIterator類提供一個迭代器接口，用于自定義文件引擎。 如果你想要的是遍歷條目目錄，請參見[QDirIterator](qdiriterator.html)代替。這個類是僅適用于自定義文件引擎的作者。 QAbstractFileEngineIterator是一個單向單次使用的虛擬迭代器，可插入[QDirIterator](qdiriterator.html)，支持自定義文件引擎提供透明代理迭代。 你可以繼承QAbstractFileEngineIterator編寫自己的文件引擎時提供一個迭代器。堵塞迭代器到你的文件系統，您只需從一個重新實現返回這個子類的實例[QAbstractFileEngine.beginEntryList](qabstractfileengine.html#beginEntryList)（ ） 。 例如： ``` QAbstractFileEngineIterator * CustomFileEngine.beginEntryList([QDir](qdir.html).Filters filters, const [QStringList](qstringlist.html) &filterNames) { return new CustomFileEngineIterator(filters, filterNames); } ``` QAbstractFileEngineIterator是一個路徑，名稱的過濾器，并進入過濾器相關聯。該路徑是提供文件的發動機，可以在迭代器級別（例如，需要最大限度地減少網絡流量的網絡文件系統）優化目錄列表迭代器列表中的條目英寸的名字過濾器和過濾器進入該目錄，但它們也可以由迭代子類可以忽略; QAbstractFileEngineIterator已經提供了所需的過濾邏輯的matchesFilters （ ）函數。你可以調用目錄名（ ）來獲得目錄名，[nameFilters](qabstractfileengineiterator.html#nameFilters)（）來獲取的名稱過濾器的StringList ，并[filters](qabstractfileengineiterator.html#filters)（ ）來獲得進入過濾器。 純虛函數[hasNext](qabstractfileengineiterator.html#hasNext)如果當前目錄中有至少一個以上的項目（即目錄名稱是有效的和可訪問的，我們還沒有達到參賽名單的末尾） ，否則返回False （）返回True 。重新實現[next](qabstractfileengineiterator.html#next)（）尋求下一個條目。 純虛函數[currentFileName](qabstractfileengineiterator.html#currentFileName)（ ）返回當前條目的名稱，而不推進迭代器。該[currentFilePath](qabstractfileengineiterator.html#currentFilePath)（ ）函數提供了方便，它返回當前項的完整路徑。 下面是如何實現返回每個三個固定條目的序列的迭代器的例子。 ``` class CustomIterator : public QAbstractFileEngineIterator { public: CustomIterator(const [QStringList](qstringlist.html) &nameFilters, [QDir](qdir.html).Filters filters) : QAbstractFileEngineIterator(nameFilters, filters), index(0) { // In a real iterator, these entries are fetched from the // file system based on the value of path(). entries << "entry1" << "entry2" << "entry3"; } bool hasNext() const { return index < entries.size() - 1; } [QString](qstring.html) next() { if (!hasNext()) return [QString](qstring.html)(); ++index; return currentFilePath(); } [QString](qstring.html) currentFileName() { return entries.at(index); } private: [QStringList](qstringlist.html) entries; int index; }; ``` 注： QAbstractFileEngineIterator不處理QDir.IteratorFlags ，它只是返回的條目為一個單一的目錄。 * * * ## Method Documentation ``` QAbstractFileEngineIterator.__init__ (self, QDir.Filters?filters, QStringList?nameFilters) ``` 構造一個[QAbstractFileEngineIterator](qabstractfileengineiterator.html)使用過濾器入口_filters_和通配符名稱的過濾器_nameFilters_。 ``` QFileInfo QAbstractFileEngineIterator.currentFileInfo (self) ``` [](qfileinfo.html) [虛函數返回一個](qfileinfo.html)[QFileInfo](qfileinfo.html)當前目錄項。此功能提供了方便。它也可以是比創建一個稍快[QFileInfo](qfileinfo.html)反對自己，因為這個函數返回的對象可能包含緩存信息[QFileInfo](qfileinfo.html)否則將有通過文件引擎來訪問。 **See also** [currentFileName](qabstractfileengineiterator.html#currentFileName)（ ） 。 ``` QString QAbstractFileEngineIterator.currentFileName (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 這個純虛函數返回當前目錄條目的名稱，不包括路徑。 **See also** [currentFilePath](qabstractfileengineiterator.html#currentFilePath)（ ） 。 ``` QString QAbstractFileEngineIterator.currentFilePath (self) ``` 返回路徑到當前目錄條目。這是一樣的前面加上[path](qabstractfileengineiterator.html#pathx)（ ）的返回值[currentFileName](qabstractfileengineiterator.html#currentFileName)（ ） 。 **See also** [currentFileName](qabstractfileengineiterator.html#currentFileName)（ ） 。 ``` QDir.Filters QAbstractFileEngineIterator.filters (self) ``` [ 返回入口過濾器這個迭代器。 ](index.htm) [**See also**](index.htm) [QDir.filter](qdir.html#filter)（ ）[nameFilters](qabstractfileengineiterator.html#nameFilters)（）和[path](qabstractfileengineiterator.html#pathx)（ ） 。 ``` bool QAbstractFileEngineIterator.hasNext (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 如果在當前目錄中至少有一個以上的項目（例如，迭代器路徑是有效的和可訪問和迭代器還沒有達到參賽名單的末尾）這個純虛函數返回True。 **See also** [QDirIterator.hasNext](qdiriterator.html#hasNext)（ ） 。 ``` QStringList QAbstractFileEngineIterator.nameFilters (self) ``` 返回名稱的過濾器為這個迭代器。 **See also** [QDir.nameFilters](qdir.html#nameFilters)（ ）[filters](qabstractfileengineiterator.html#filters)（）和[path](qabstractfileengineiterator.html#pathx)（ ） 。 ``` QString QAbstractFileEngineIterator.next (self) ``` 這種方法是抽象的，應在任何子類中重新實現。 這個純虛函數前進迭代到下一個目錄項，并返回文件路徑到當前項目。 此功能可以選擇使使用[nameFilters](qabstractfileengineiterator.html#nameFilters)（）和[filters](qabstractfileengineiterator.html#filters)（ ）以優化其性能。 重新實現這個函數在子類中推進迭代器。 **See also** [QDirIterator.next](qdiriterator.html#next)（ ） 。 ``` QString QAbstractFileEngineIterator.path (self) ```