Differences

This shows you the differences between two versions of the page.

--- in204:tds:sujets:td4:part2 [2019/10/15 10:04]
bmonsuez [Question 1.0]
+++ in204:tds:sujets:td4:part2 [2022/11/18 10:49] (current)
@@ Line 107: / Line 107: @@
 <hidden Correction Complétion de la classe interval>
 Nous débutons par compléter la classe ''interval''. La classe ''interval'' doit exposer au moins deux méthodes que sont les méthodes :
@@ Line 193: / Line 194: @@
 </code>
-\\
+ \\
 La fonction ''begin'' retourne un objet de type ''interval_iterator'' qui fait référence à l'interval courant et qui fait référence à ''minValue'' qui correspond à la première valeur de l'interval d'entier.
-\\
+ \\
 La fonction ''end'' retourne un objet de type ''interval_iterator'' qui fait référence à l'interval courant et qui fait référence à ''maxValue'' qui correspond à la valeur situé après la dernière valeur valide de l'interval, donc fait bien référence à la première valeur située en dehors de la séquence de valeur.
-\\
+ \\
 Les fonctions ''begin'' et ''end'' font appel à un constructeur de la classe ''interval_iterator''. En C++, avant de pouvoir appeller un constructeur, il faut que la classe soit définie. Comme la classe ''interval_iterator'' est définie après la classe ''interval'', il est nécessaire que le code des fonctions ''begin'' et ''end'' soit située après la classe ''interval_iterator''. Il n'est pas possible de les définir dans le corps de la classe ''interval''.
+ \\
 </hidden>
 <hidden Correction Complétion de la classe interval_iterator>
-</hidden>
+<nodisp 2>
+Pour la classe ''interval_iterator'' nous devons implanter les exigences relatives à un [[https://en.cppreference.com/w/cpp/named_req/ForwardIterator|forward iterator]].
+\\
+  - En ce qui concerne les définitions de type, il est attendu que l'itérateur expose les types suivants : \\ <code cpp>
+difference_type // un type d'entier signé servant à indiquer la distance entre deux itérateurs
+value_type 	// le type des valeurs qui sont référencés par l'itérateur
+                // habituellement ''T''
+pointer 	// le type d'un pointeur pointant sur les valeurs qui sont référencés par l'itérateur
+                // habituellement ''T*''
+reference 	// le type d'une référence sur les valeurs qui sont référencés par l'itérateur,
+                // habituellement ''T&''
+iterator_category 	// Le type qui indique la nature de l'itérateur, comme [https://en.cppreference.com/w/cpp/iterator/iterator_tags|std::random_access_iterator_tag]], [https://en.cppreference.com/w/cpp/iterator/iterator_tags|std::bidirectional_iterator_tag]], [https://en.cppreference.com/w/cpp/iterator/iterator_tags|std::forward_iterator_tag]]  ou enfin [https://en.cppreference.com/w/cpp/iterator/iterator_tags|std::input_iterator_tag]].
+</code> \\  \\ Pour effectuer la définition de ces types, nous pouvons soit les définir directement (attention: les valeurs stockées dans l'interval n'est pas modifiable, il s'agit donc de ''const int''. : \\ <code cpp>
+class interval_iterator
+{
+public:
+    typedef ptrdiff_t difference_type;
+    typedef const int value_type;
+    typedef const int* pointer;
+    typedef const int& reference;
+    typedef std::forward_iterator_tag iterator_category;
+};
+</code> \\  \\ On peut voir que l'on aurait pu faire références aux définitions faites dans la classe ''interval'', ce qui aurait donné le code suivant :  \\ <code cpp>
+class interval_iterator
+{
+public:
+    typedef ptrdiff_t difference_type;
+    typedef interval::value_type value_type;
+    typedef value_type* pointer;
+    typedef value_type& reference;
+    typedef std::forward_iterator_tag iterator_category;
+};
+</code>  \\ L'avantage est que dans ce cas là, si nous modifions le type manipulé par la classe ''interval'', automatiquement, les types sont bien mis à jour dans la classe ''interval_iterator''  \\  \\ Pour éviter d'avoir trop à écrire, nous pouvons au contraire  hériter de la classe [[https://en.cppreference.com/w/cpp/iterator/iterator|std::iterator]] qui fournit une implantation par défaut de ces types.  \\ <code cpp>
+class interval_iterator:
+    std::iterator<const int, std::forward_iterator_tag>
+{
+public:
+   ...
+};
+</code> \\ Cependant cette méthode est déclarée obsolète depuis l'introduction de C++17.
+  - En ce qui concerne les déclarations des opérateurs et fonctions membres, nous devons définir les opérateurs suivants : \\ <code cpp>
+reference operator*(); 	// retourne la valeur à laquelle l'itérateur fait référence.
+pointer operator->();           // retourne un pointeur sur la valeur à laquelle l'itérateur fait référence.
+iterator& operator++();         // avance à la valeur suivante de la séquence et retourne l'itérateur courant
+iterator operator++(int);       // copie l'itérateur à la position actuelle, avance l'itérateur courant
+                                // à la valeur suivante de la séquence et retourne la copie de l'itérateur.
+bool operator ==(iterator) const;
+                                // compare si l'itérateur courant et l'itérateur passé en argument
+                                // font référence à la même valeur,
+bool operator !=(iterator, iterator) const;
+                                // compare si l'itérateur courant et l'itérateur passé en argument
+                                // ne font pas référence à la même valeur,
+</code> \\ En ce qui concerne l'opérateur ''*'', il s'agit de l'opération de déréférencement qui va retourner une référence sur la valeur à laquelle l'itérateur fait référence et qui est défini par ''mCurrent''. Le code de cette fonction s'écrit : <code cpp>
+    reference operator*() const
+    {
+        return mCurrent;
+    }
+</code> \\ Par similitude l'opérateur ''->'' qui retourne un pointeur sur la valeur référencée par l'itérateur va retourner un pointeur sur le champ interne ''mCurrent''. \\ <code cpp>
+    reference operator->() const
+    {
+        return &mCurrent;
+    }
+</code> \\ \\ Il faut désormais implanter les opérateurs d'incrémentation de l'itérateur (ie. pour passer à la valeur suivante). C'est l'opérateur ''++'' qui a est sélectionné, cependant cet opérateur possède deux syntaxes : (1) ''++it'' qui signifie applique l'opération ''++'' à l'objet ''it'' et retourne une référence à cet objet après que l'opération ''++'' a été effectuée; (2) ''it++'' qui signifie fait une copie de l'objet //copy//, applique l'opération à l'objet ''it'' et retourne l'objet //copy// comme résultat de l'opération. L'opérateur ''operator ++()'' correspond à la première synataxe, l'opérateur ''operator ++(int)'' correspond à la seconde syntaxe. Ce qui se traduit par : <code>
+    iterator& operator++()
+    {
+        // Passe à la valeur suivant si nous ne sommes pas
+        // déjà à la fin de l'interval.
+        if(mCurrent <= mInterval->maxValue)
+            mCurrent ++;
+        return *this;
+    }
+    iterator operator++(int)
+    {
+        interval_iterator it(*this); // Crée une copie de l'itérateur.
+        ++(*this);          // Incrément l'itérateur courant en appellant
+                            // l'opérateur iterator& operator()
+        return it;          // Retourne la copie de l'itérateur (avant modification).
+    }
+</code> \\ Il ne reste plus qu'à implanter les opérateurs relatifs à la comparaison. Deux itérateurs sont égaux s'ils font références à la même valeur située dans le même containeur. Dans ce cas, nous devons avoir les champs ''mCurrent'' et ''mInterval'' qui doivent être égaux. <code cpp>
+    bool operator ==(const interval_iterator& anotherIterator) const
+    {
+        return mCurrent == anotherIterator.mCurrent &&
+          *mInterval == *anotherIterator.mInterval;
+    }
+    bool operator !=(const interval_iterator& anotherIterator) const
+    {
+        return mCurrent != anotherIterator.mCurrent ||
+          *mInterval != *anotherIterator.mInterval;
+    }
+</code>
+  - Enfin, l'itérateur doit aussi être [[https://en.cppreference.com/w/cpp/named_req/CopyConstructible|constructible par recopie]],  [[https://en.cppreference.com/w/cpp/named_req/CopyAssignable|supporter l'affection]] et [[https://en.cppreference.com/w/cpp/named_req/Swappable|supporter les permutations]]), ce qui impose de définir en complément le constructeur de recopie, les fonctions membres ''swap'' et l'opérateur ''='' comme suit: \\ <code cpp>
+public:
+    // Définition du constructeur de recopie.
+    // Crée un itérateur qui fait référence au même élément que l'itérateur
+    // passé en argument.
+    interval_iterator(const interval_iterator& anotherIterator):
+        mCurrent(anotherIterator.mCurrent), mInterval(anotherIterator.mInterval)
+    {}
+    // Définition de l'opération d'affectation consistant à ce que
+    // l'itérateur courant fait référence au même élément que l'itérateur
+    // passé en argument.
+    interval_iterator& operator=(const interval_iterator& anotherIterator)
+    {
+        mCurrent = anotherIterator.mCurrent;
+        mInterval = anotherIterator.mInterval;
+        return *this;
+    }
+    // Opération de permutation.
+    // A la fin de l'opération,
+    // - anotherIterator fait référence à l'élément
+    // qui était référencé par l'itérateur courant avant l'opération,
+    // - l'itérateur courant  fait référence à l'élément
+    // qui était référencé par l'itérateur anotherIterator avant l'opération,
+    void swap(interval_iterator& anotherIterator)
+    {
+        std::swap(mCurrent, anotherIterator.mCurrent);
+        std::swap(mInterval, anotherIterator.mInterval);
+    }
+</code> \\ Et normalement l'ensemble des éléments ont été définis pour à la classe ''interval_iterator'' pour que ce dernier puisse répondre aux exigences auxquelles un itérateur de type [[https://en.cppreference.com/w/cpp/named_req/ForwardIterator|forward iterator]] doit répondre.
+</hidden>
@@ Line 212: / Line 345: @@
 Tester le bon fonctionnement de classe avec le code suivant :
+<code cpp>
+#include"interval.hpp"
+#include<algorithm>
+#include<iostream>
+#include<vector>
+template<class inputIterator>
+void print(inputIterator beginIt, inputIterator endIt)
+{
+    if(beginIt == endIt)
+    {
+        std::cout << "[]" << std::endl;
+        return;
+    }
+    for(;;)
+    {
+        std::cout << *beginIt;
+        beginIt++;
+        if(beginIt == endIt)
+            break;
+        std::cout << ", ";
+    }
+    std::cout << "]" << std::endl;
+    return;
+}
+void testInterval()
+{
+    interval inter(5, 15);
+    std::cout << "Contenu de l'interval : ";
+    print(inter.begin(), inter.end());
+    // Recherche du plus grand élément.
+    auto maxIt = max_element(inter.begin(), inter.end());
+    std::cout << "Element maximal de la séquence: " << *maxIt << std::endl;
+    // Duplication des valeurs dans un vecteur
+    std::vector<int> vec(inter.begin(), inter.end());
+    std::cout << "Contenu du vecteur : ";
+    print(vec.begin(), vec.end());
+}
+int main()
+{
+    testInterval();
+    return 0;
+}
+</code>
+<hidden Explications>
+<nodisp 2>
+  * La fonction ''print'' prend une séquence d'éléments définie par un itérateur de début ''beginIt'' et un itérateur marquant la fin de la séquence ''endIt'' et affiche cette séquence sur la console. La seule particularité, c'est qu'en fonction de la position de l'élément, le séparateur "," est placé entre les valeurs ou non.
+  * Dans le cas de la fonction ''testInterval()'', le code <code cpp>
+    interval inter(5, 15);
+    </code> crée un interval allant de 5 à 15. Nous appelons la fonction ''print'' en passant l'itérateur référençant la première valeur contenue dans l'interval ainsi que l'itérateur marquant la fin de la séquence et nous vérifions que la fonction ''print'' peut bien afficher les valeurs contenues dans l'interval. <code cpp>
+    print(inter.begin(), inter.end());
+</code>. Nous vérifions en utilisant une fonction [[https://en.cppreference.com/w/cpp/algorithm/max_element|max_element]] de la bibliothèque standard qui recherche le plus grand élément d'une séquence que notre containeur fonctionne aussi avec des fonctions de la bibliothèque standard. <code cpp>
+    auto maxIt = max_element(inter.begin(), inter.end());
+    std::cout << "Element maximal de la séquence: " << *maxIt << std::endl;
+</code>Nous affichons l'élément retourné qui est bien entendu la borne supérieure de l'interval. Enfin, nous créons un vecteur auquel nous affectons l'ensemble des valeurs contenues dans l'interval ''inter''. Et nous vérifions que notre fonction ''print'' fonctionne aussi avec un containeur de type ''std::vector''.<code cpp>
+    // Duplication des valeurs dans un vecteur
+    std::vector<int> vec(inter.begin(), inter.end());
+    std::cout << "Contenu du vecteur : ";
+    print(vec.begin(), vec.end());
+</code>
+</nodisp>
+</hidden>

Cours

User Tools

Site Tools

Differences

Page Tools