QDirListing::const_iterator Class
class QDirListing::const_iteratorEsta clase se introdujo en Qt 6.8.
- Lista de todos los miembros, incluidos los heredados
- const_iterator forma parte de Entrada/Salida y Redes.
Tipos públicos
Funciones públicas
| const_iterator() | |
| const_iterator(QDirListing::const_iterator &&) | |
| QDirListing::const_iterator::reference | operator*() const |
| QDirListing::const_iterator & | operator++() |
| void | operator++(int) |
| QDirListing::const_iterator::pointer | operator->() const |
| QDirListing::const_iterator & | operator=(QDirListing::const_iterator &&) |
Descripción detallada
El tipo de iterador devuelto por ` QDirListing::cbegin()`.
- Se trata de un iterador de avance único y de una sola pasada (no se pueden recorrer las entradas del directorio en orden inverso).
- No se puede copiar, solo se puede llamar a `
std::move()d`. - El valor de retorno del postincremento en objetos que implementan
std::input_iteratorestá parcialmente formado (una copia de un iterador que se ha avanzado desde entonces); las únicas operaciones válidas en dicho objeto son la destrucción y la asignación de un nuevo iterador. Por lo tanto, el operador de postincremento avanza el iterador y devuelvevoid. - No permite el acceso aleatorio
- Se puede utilizar en bucles «for» con rangos; o con los algoritmos de `std::ranges` de C++20 que no requieren iteradores de acceso aleatorio
- La desreferenciación de un iterador válido devuelve un
const DirEntry & - (c)end() devuelve un QDirListing::sentinel que señala el final de la iteración. Desreferenciar un iterador que se compara como igual a end() es un comportamiento indefinido
Nota: Los algoritmos «clásicos» de la STL no admiten iterador/centinela, por lo que es necesario utilizar los algoritmos std::ranges de C++20 para QDirListing, o bien una biblioteca de terceros que proporcione algoritmos basados en rangos en C++17.
Véase también QDirListing, QDirListing::sentinel y QDirListing::DirEntry.
Documentación sobre tipos de miembros
[alias] const_iterator::pointer
Un `typedef` para ` const QDirListing::DirEntry *`.
[alias] const_iterator::reference
Un `typedef` para ` const QDirListing::DirEntry &`.
Documentación de las funciones de miembro
[constexpr noexcept default] const_iterator::const_iterator()
Crea por defecto una instancia de ` const_iterator`.
[constexpr noexcept default] const_iterator::const_iterator(QDirListing::const_iterator &&)
Crea una instancia de ` const_iterator` mediante la construcción «move».
QDirListing::const_iterator::reference const_iterator::operator*() const
Devuelve un objeto ` const QDirListing::DirEntry & ` correspondiente a la entrada de directorio a la que apunta este iterador.
QDirListing::const_iterator &const_iterator::operator++()
Operador de preincremento. Avanza el iterador y devuelve una referencia al mismo.
void const_iterator::operator++(int)
Operador de postincremento.
QDirListing::const_iterator Modela el std::input_iterator de C++20, es decir, es un iterador de una sola pasada, solo de avance y solo de movimiento, que no permite el acceso aleatorio.
El valor de retorno del postincremento en objetos que implementan ` std::input_iterator ` es parcialmente formado (una copia de un iterador que se ha avanzado desde entonces); las únicas operaciones válidas en dicho objeto son la destrucción y la asignación de un nuevo iterador. Por lo tanto, el operador de postincremento avanza el iterador y devuelve ` void`.
QDirListing::const_iterator::pointer const_iterator::operator->() const
Devuelve un objeto ` const QDirListing::DirEntry * ` correspondiente a la entrada de directorio a la que apunta este iterador.
[constexpr noexcept default] QDirListing::const_iterator &const_iterator::operator=(QDirListing::const_iterator &&)
Asigna « other » a esta instancia de « const_iterator ». ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.