En esta página

QDirListing::const_iterator Class

class QDirListing::const_iterator

Esta clase se introdujo en Qt 6.8.

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_iterator está 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.
  • 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.