Comment et où utiliser les énumérateurs avec Golang via C++

Un énumérateur est un objet qui permet de parcourir un conteneur ou une collection. Les énumérateurs peuvent être utilisés pour lire les données dans la collection, mais ils ne peuvent pas être utilisés pour modifier la collection sous-jacente, alors que IEnumerable est une interface qui définit une méthode GetEnumerator retournant une interface IEnumerator, ce qui permet un accès en lecture seule à une collection.

Les API Aspose.Cells fournissent une multitude d’énumérateurs, cependant, cet article traite principalement des trois types énumérés ci-dessous.

1. Énumérateur de cellules
2. Énumérateur de lignes
3. Énumérateur de colonnes

Comment utiliser des énumérateurs

Énumérateur de cellules

Il existe diverses façons d’accéder à l’énumérateur de cellules, et l’on peut utiliser l’une de ces méthodes en fonction des besoins de l’application. Voici les méthodes qui renvoient l’énumérateur de cellules.

1. Cells.GetEnumerator
2. Row.GetEnumerator
3. Range.GetEnumerator

Toutes les méthodes mentionnées ci-dessus renvoient l’énumérateur qui permet de parcourir la collection de cellules qui ont été initialisées.

En parcourant les cellules, la collection ne doit pas être modifiée (des opérations qui entraîneront l’instanciation d’une nouvelle cellule ou la suppression d’une cellule existante). Sinon, l’énumérateur risque de ne pas pouvoir parcourir toutes les cellules correctement (certains éléments peuvent être parcourus de manière répétitive ou sautés).

L’exemple de code suivant montre l’implémentation de l’interface IEnumerator pour une collection de cellules.

Itérateur de lignes

L’énumérateur de lignes peut être accessible lors de l’utilisation de la méthode RowCollection.GetEnumerator. L’exemple de code suivant démontre la mise en œuvre de l’interface IEnumerator pour RowCollection.

Colonnes Obtenir

Les colonnes peuvent être accédées lors de l’utilisation de la méthode ColumnCollection.Get. L’exemple de code suivant démontre la mise en œuvre de la méthode Get pour ColumnCollection.

Où utiliser les énumérateurs

Afin de discuter des avantages de l’utilisation des énumérateurs, prenons un exemple en temps réel.

Scénario

Une exigence d’application est de parcourir toutes les cellules dans une Worksheet donnée pour lire leurs valeurs. Il pourrait y avoir plusieurs façons de réaliser cet objectif. Quelques-unes sont démontrées ci-dessous.

Utilisation de la plage d’affichage

Utilisation de MaxDataRow & MaxDataColumn

Comme vous pouvez le constater, les deux approches ci-dessus utilisent plus ou moins une logique similaire, c’est-à-dire parcourir toutes les cellules de la collection pour lire les valeurs des cellules. Cela pourrait poser problème pour un certain nombre de raisons, comme discuté ci-dessous.

1. Des API telles que GetMaxRow(), GetMaxDataRow(), GetMaxColumn(), GetMaxDataColumn() et GetMaxDisplayRange() nécessitent du temps supplémentaire pour recueillir les statistiques correspondantes. Si la matrice de données (lignes x colonnes) est grande, l’utilisation de ces API pourrait entraîner une pénalité de performance.
2. Dans la plupart des cas, toutes les cellules dans une plage donnée ne sont pas instanciées. Dans de telles situations, vérifier chaque cellule dans la matrice n’est pas aussi efficace que de vérifier uniquement les cellules initialisées.
3. Accéder à une cellule dans une boucle en tant que Cells row, column entraînera l’instanciation de tous les objets de cellules dans une plage, ce qui pourrait finalement entraîner une OutOfMemoryException.

Conclusion

Sur la base des faits mentionnés ci-dessus, voici les scénarios possibles où les énumérateurs doivent être utilisés.

1. Un accès en lecture seule de la collection de cellules est requis, c’est-à-dire; la nécessité est uniquement d’inspecter les cellules.
2. Un grand nombre de cellules doit être parcouru.
3. Seules les cellules/rangées/colonnes initialisées doivent être parcourues.