Différences

Cette page vous donne les différences entre la révision choisie et la version actuelle de la page.

--- fonctions_generiques [2016/10/16 23:26]
gbdivers
+++ fonctions_generiques [2016/12/19 01:11] (Version actuelle)
gbdivers
@@ Ligne 1: / Ligne 1: @@
-^ [[surcharge_fonctions|Chapitre précédent]] ^ [[programmez_avec_le_langage_c|Sommaire principal]] ^ [[fonctions_lambdas|Chapitre suivant]] ^
+^ Chapitre précédent ^ [[programmez_avec_le_langage_c|Sommaire principal]] ^ Chapitre suivant ^
-====== Fonctions génériques ======
+====== Les fonctions génériques ======
 ===== Intérêt de la programmation générique =====
@@ Ligne 28: / Ligne 29: @@
 </code>
-Rien de compliqué, c'est une fonction classique qui prend deux parametres entiers et retourne un entier.
+Rien de compliqué, c'est une fonction classique qui prend deux paramètres entiers et retourne un entier.
 Si vous ajoutez le second calcul suivant :
@@ Ligne 41: / Ligne 42: @@
 int main() {
     std::cout << add(3, 4) << std::endl;
-    std::cout << add(1.2, 3.4) << std::endl;
+    std::cout << add(1.7, 3.8) << std::endl;
 }
 </code>
@@ Ligne 49: / Ligne 50: @@
 <code>
 main.cpp:9:22: warning: implicit conversion from 'double' to 'int'
-changes value from 1.2 to 1 [-Wliteral-conversion]
+changes value from 1.7 to 1 [-Wliteral-conversion]
-    std::cout << add(1.2, 3.4) << std::endl;
+    std::cout << add(1.7, 3.8) << std::endl;
                  ~~~ ^~~
 main.cpp:9:27: warning: implicit conversion from 'double' to 'int'
-changes value from 3.4 to 3 [-Wliteral-conversion]
+changes value from 3.8 to 3 [-Wliteral-conversion]
-    std::cout << add(1.2, 3.4) << std::endl;
+    std::cout << add(1.7, 3.8) << std::endl;
                  ~~~      ^~~
 warnings generated.
@@ Ligne 61: / Ligne 62: @@
 </code>
-Premièrement, le code émet deux avertissements, du fait de la conversion implicite de ''double'' en ''int''. Et deuxièmement, le résultat obtenu n'est pas correct, la valeur attendue (4.6) est arrondie. La raison est que vous avez écrit une fonction ''add'' qui utilise des entiers comme parametres. Le compilateur a le choix entre réaliser une conversion des types si c'est possible, ou de produire une erreur si ce n'est pas le cas.
+Premièrement, le code émet deux avertissements, du fait de la conversion implicite de ''double'' en ''int''. Et deuxièmement, le résultat obtenu n'est pas correct, la valeur attendue (5.5) est arrondie à la valeur 4.
+La raison est que vous avez écrit une fonction ''add'' qui utilise des entiers comme paramètres. Le compilateur a le choix entre réaliser une conversion des types si c'est possible, ou de produire une erreur si ce n'est pas le cas. Dans le cas present, il choisit la conversion implicite, avec un avertissement.
 L'appel de la fonction ''add'' avec des valeurs de type ''double'' est équivalent au code suivant :
 <code cpp>
-const int lhs = 1.2;  // arrondi en 1
+const int lhs = 1.7;  // arrondi en 1
-const int rhs = 3.4;  // arrondi en 3
+const int rhs = 3.8;  // arrondi en 3
 add(lhs, rhs);        // calcul 1 + 3
+</code>
+Notez que la conversion est réalisée sur les valeurs entrée dans ce cas, ce qui retourne la valeur 4. Si la conversion était réalisée uniquement sur la valeur de sortie, la valeur 5.5 serait arrondie à la valeur 5.
+<code cpp
+int add(double lhs, double rhs) {
+    return lhs + rhs;
+}
+std::cout << add(1.7, 3.8) << std::endl;  // affiche 5
 </code>
@@ Ligne 85: / Ligne 98: @@
 Dans ce cas, le compilateur n'a pas besoin de faire de conversion, il utilise la fonction correspondante aux types des arguments.
-Cependant, cette approche est limitée. Si vous appelez cette fonction avec des arguments de type ''short int'' ou ''float'' (par exemple), le résultat sera automatiquement convertie respectivement en ''int'' et en ''double'' (par promotion).
+Cependant, cette approche est limitée. Si vous appelez cette fonction avec des arguments de type ''short int'' ou ''float'' (par exemple), le résultat sera automatiquement convertie respectivement en ''int'' et en ''double'' (par promotion). Pour éviter cela, il faudra proposer une surcharge de la fonction ''add'' pour chaque type d'arguments que vous voulez utiliser. Le code n'est pas facilement évolutif, vous devez modifier un code existant si vous ajouter des nouveaux types. Et il devient très vite lourd de devoir écrire toutes les fonctions ''add'' possibles.
-Pour éviter cela, il faudra proposer une surcharge de la fonction ''add'' pour chaque type d'arguments que vous voulez utiliser. Le code n'est pas facilement évolutif, vous devez modifier un code existant si vous ajouter des nouveaux types.
+La programmation générique va permettre de résoudre ce problème, en écrivant des fonctions dont les types des paramètres s'adapteront en fonction des arguments utilisés dans l'appel de fonction. Un exemple de telles fonctions que vous avez déjà rencontrée est les algorithmes de la bibliothèque standard, qui peuvent être appelés sur plusieurs types de conteneurs.
-La programmation générique va permettre de résoudre ce problème, en écrivant des fonctions qui prendront plusieurs types de parametres. Un exemple de telles fonctions que vous avez déjà rencontrée est les algorithmes de la bibliothèque standard, qui peuvent être appellee sur plusieurs types de conteneurs.
 <code cpp>
 std::string s { "azerty" };
-std::sort(std::begin(s), std::end(s));  // ok
+std::sort(std::begin(s), std::end(s));  // ok, tri une chaine
 vector<int> v { 1, 3, 5, 2, 4 };
-std::sort(std::begin(v), std::end(v));  // ok
+std::sort(std::begin(v), std::end(v));  // ok, tri un tableau
 </code>
-===== Definir une fonction template =====
+===== Définir une fonction template =====
-Dans une fonction template, un ou plusieurs types utilisés dans la fonction (généralement les types des parametres de fonction ou du retour de la fonction) sont remplacés par un parametre template, pouvant representer plusieurs types.
+Dans une fonction template, un ou plusieurs types utilisés dans la fonction (généralement les types des paramètres de fonction ou du retour de la fonction) sont remplacés par un paramètre //template//, pouvant représenter plusieurs types.
-La syntaxe d'une fonction template est la suivante :
+La syntaxe d'une fonction //template// est la suivante :
 <code cpp>
@@ Ligne 111: / Ligne 122: @@
 </code>
-La première ligne permet de definir un ou plusieurs paramètres template, qui seront utilisés dans la fonction //comme si c'était des types//.
+La première ligne permet de définir un ou plusieurs paramètres //template//, qui seront utilisés dans la fonction comme si c'était des types.
 Un paramètre template s'écrit de la façon suivante :
@@ Ligne 119: / Ligne 130: @@
 </code>
-Le mot-clé ''typename'' indique que l'identifiant represente un nom de type. L'identifiant respecte les règles habituelles pour écrire un identifiant (contient des lettres minuscules ou majuscules, le caractère ''_'' ou des chiffre sauf en premiere position).
+Le mot-clé ''typename'' indique que l'identifiant represente un nom de type. L'identifiant respecte les règles habituelles pour écrire un identifiant (contient des lettres minuscules ou majuscules, le caractère ''_'' ou des chiffres sauf en premiere position).
-Une liste de parametres template sera constitué de plusieurs parametres template (mot-clé ''typename'' et identifiant), séparés par des virgules.
+Une liste de paramètres template sera constitué de plusieurs paramètres template (mot-clé ''typename'' et identifiant), séparés par des virgules.
 <code cpp>
@@ Ligne 127: / Ligne 138: @@
 </code>
-Il est classique d'utiliser des majuscules uniquement pour ecrire les parametres template. En particulier, vous verrez souvent des parametres template nommes ''T'', ''U'', etc. Bien sur, il est préférable de donner des noms les plus expressifs possible.
+Il est classique d'utiliser des majuscules pour écrire les paramètres template. En particulier, vous verrez souvent des paramètres template nommés ''T'', ''U'', etc. Bien sur, il est préférable de donner des noms les plus expressifs possible, mais quand le nom représente "n'importe quoi", c'est moins problématique.
-Par exemple, avec la fonction ''add'' precedente :
+Par exemple, avec la fonction ''add'' précédente :
 <code cpp>
@@ Ligne 138: / Ligne 149: @@
 </code>
-Ce code definie une fonction template qui possède un paramètre template nomme ''T''. Ce paramètre template est utilisée trois fois dans la fonction : dans les deux parametres de fonction en entrée et comme type de retour de la fonction.
+Ce code définit une fonction template qui possède un paramètre template nomme ''T''. Ce paramètre template est utilisée trois fois dans la fonction : dans les deux paramètres de fonction en entrée et comme type de retour de la fonction.
 <note>**typename et class**
-Il est également possible d'utiliser le mot-clé ''class'' a la place de ''typename''. Pour éviter les ambiguïtés avec les classes de la programmation objet, seul le mot-clé ''typename''sera utilisée dans ce cours. Mais retenez que vous pouvez rencontrer aussi ''class'' dans un code.
+Il est également possible d'utiliser le mot-clé ''class'' a la place de ''typename''. Pour éviter les ambiguïtés avec les classes de la programmation objet, seul le mot-clé ''typename''sera utilisée dans ce cours. Mais retenez que vous pouvez rencontrer aussi ''class'' dans un code pour définir un paramètre template.
 </note>
-Ce code implique que les types des parametres en entrée et en sortie sont le même type : ''T'' peut être remplacé par n'importe quel type, mais chaque occurrence de ''T'' correspondra toujours au même type.
+Ce code implique que les types des paramètres en entrée et en sortie sont le même type : ''T'' peut être remplacé par n'importe quel type, mais chaque occurrence de ''T'' correspondra toujours au même type. Par exemple, cette fonction ''add'' pourra être appelée avec deux entiers et retourner un entier, ou être appelée avec deux réels retourner un réel, mais elle ne pourra pas prendre en paramètre des entiers et retourner des réels.
-Il est possible d'utiliser des types differents pour les differents parametres. Par exemple :
+Il est possible d'utiliser des types différents pour les différents paramètres. Par exemple :
 <code cpp>
@@ Ligne 156: / Ligne 167: @@
 </code>
-Ce code utilise trois paramètre template ''T'', ''U'' et ''V'', chaque paramètre pouvant être remplacé par un type différent.
+Ce code utilise trois paramètre template ''T'', ''U'' et ''V'', chaque paramètre pouvant être remplacé par un type différent. Par exemple, cette fonction pourra prendre en paramètre un''int'' et un ''double'' et retourner un ''float''.
-Vous etes libre de definir autant de parametre template que vous souhaitez et de les mélanger avec des types concrets.
+Vous êtes libre de définir autant de paramètre template que vous souhaitez et de les mélanger avec des types concrets.
 <code cpp>
 template<typename T, typename U>
-T f(int a, U b, double c, T d) {}
+T add(double lhs, V rhs) {
+    return lhs + rhs;
+}
 </code>
+Cette fonction a un paramètre template en entrée (qui sera remplacé par n'importe quel type lors de l'appel), un paramètre de type ''double'' en entrée, et peut retourner n'importe quel type.
 ===== Appeler une fonction template =====
-Lors de l'appel d'une fonction template, le compilateur va remplacer les parametres template par des types concret. Cette étape s'appelle l'instanciation des template.
+Lors de l'appel d'une fonction //template//, le compilateur va remplacer les paramètres //template// par des types concret. Cette étape s'appelle l'instanciation des template. A partir d'une fonction template, le compilateur va générer les fonctions concrète correspondant à chaque type concret qui sont utilisés dans les appels de fonction.
+Par exemple, si la fonction ''add'' précédente est appelée avec les types ''int'' et ''double'', le compilateur va générer deux fonction surchargées, correspondant à ces types concrets.
-A partir d'une fonction template, le compilateur va générer les fonctions concrète correspondant a chaque type concret qui sont utilisés dans les appels de fonction.
+<code cpp>
+template<typename T>
+T add(T lhs, T rhs) {
+    return lhs + rhs;
+}
-Par exemple, pour la fonction ''add'' precedente, si cette fonction est appellee avec les types ''int'' et ''double'', le compilateur va générer deux fonction surchargées, correspondant a ces types concrets.
+add(1, 2);      // int
+add(1.0, 2.0);  // double
+</code>
+Le code précédent sera équivalent au code suivant, après l'instanciation des templates par le compilateur :
+<code cpp>
+int add(int lhs, int rhs) {           // int remplace T
+    return lhs + rhs;
+}
+double add(double lhs, double rhs) {  // double remplace T
+    return lhs + rhs;
+}
+add(1, 2);      // int
+add(1.0, 2.0);  // double
+</code>
+Lorsqu'un paramètre template est utilisé dans plusieurs paramètre de fonction (comme c'est le cas avec la fonction ''add'' précédente), il est nécessaire que les types soient identiques lors de l'appel de fonction, sinon la déduction échoué et cela produit une erreur.
 <code cpp>
 template<typename T>
-T add(T lhs, T rhs);
+T add(T lhs, T rhs) {
+    return lhs + rhs;
+}
-// devient :
+int main() {
+    add(1, 1.2);  // int ou double ?
+}
+</code>
-int add(int lhs, int rhs);
+Affiche l'erreur suivante :
-double add(double lhs, double rhs);
+<code>
+main.cpp: In function 'int main()':
+main.cpp:7:15: error: no matching function for call to 'add(int, double)'
+     add(1, 1.2);  // int ou double ?
+               ^
+main.cpp:2:3: note: candidate: template<class T> T add(T, T)
+ T add(T lhs, T rhs) {
+   ^~~
+main.cpp:2:3: note:   template argument deduction/substitution failed:
+main.cpp:7:15: note:   deduced conflicting types for parameter 'T' ('int' and 'double')
+     add(1, 1.2);  // int ou double ?
+               ^
 </code>
+Le compilateur indique qu'il ne trouve pas une fonction ''add'' pouvant correspondre à l'appel ("no matching function for call"), et qu'il trouve une fonction candidate possible, mais qu'il y a un conflit pour les types ("deduced conflicting types for parameter 'T' ('int' and 'double')").
+==== Déduction des types et appel explicit ====
+Le code précédent est la façon la plus simple d'appeler une fonction //template//. La syntaxe est identique à un appel de fonction classique, la seule différence est que le compilateur ajoute deux étapes lors de l'appel :
+  * la déduction des types : le compilateur regarde les types des arguments dans l'appel de la fonction et déduit les types à utiliser ;
+  * l'instanciation des //templates// : pour chaque combinaison de types déduits, le compilateur génère une fonction avec des types concrets.
+Cependant, il n'est pas toujours possible de déduire les types lors de l'appel de la fonction. La déduction des types n'est possible que pour les paramètres //template// utilisés comme paramètre de fonction, pas les paramètres //template// utilisés en retour de fonction ou dans le corps de la fonction. Vous pouvez egalement souhaitez appeler une fonction template en forçant l'utilisation d'arguments //templates// spécifiques.
+<code cpp>
+template<typename T>
+T add(int lhs, int rhs) {
+    return lhs + rhs;
+}
+add(1, 2);  // erreur
+</code>
+Dans ce cas, il faut expliciter les types que vous souhaitez utiliser pour l'instanciation des templates. La syntaxe pour appeler la fonction est la suivante :
+<code cpp>
+NOM_FONCTION<ARGUMENTS_TEMPLATE>(ARGUMENTS_FUNCTION);
+</code>
+La différence avec un appel de fonction classique est donc cette liste d'arguments template ajoutée entre les chevrons après le nom de la fonction.
+Le code précédent devient, par exemple :
+<code cpp>
+template<typename T>
+T add(int lhs, int rhs) {
+    return lhs + rhs;
+}
+add<int>(1, 2);     // T == int
+add<double>(1, 2);  // T == double
+</code>
-<note>**Parametres et arguments**
+<note>**Paramètres et arguments**
-Notez la similitude des termes utilisés entre parametres et arguments de fonction et parametres et argument template : les parametres apparaissent dans la declaration des fonctions et les arguments dans les appels de fonction.
+Notez la similitude des termes utilisés entre "paramètre" et "argument" de fonction et "paramètre" et "argument" //template// : les paramètres apparaissent dans la déclaration des fonctions et les arguments dans les appels de fonction.
-Pour les parametres et arguments de fonction :
+Pour les paramètres et arguments de fonction :
 <code cpp>
-void f(int a, int b, int x) {}  // a, b et c = parametres de fonction
+void f(int a, int b, int x) {}  // a, b et c = paramètres de fonction
 int main() {
@@ Ligne 204: / Ligne 296: @@
 </code>
-Pour les parametres et arguments template :
+Pour les paramètres et arguments //template// :
 <code cpp>
-template<typename T, typename U>  // T et U = parametres template
+template<typename T, typename U>  // T et U = paramètres template
 void f(T a, U b) {}
@@ Ligne 216: / Ligne 308: @@
 </note>
+De la même manière, pour l'exemple précédent qui avait un conflit sur les types :
+<code cpp>
+template<typename T>
+T add(T lhs, T rhs) {
+    return lhs + rhs;
+}
-deduction automatique des arguments template
+int main() {
+    add<int>(1, 1.2);  // int !
+}
+</code>
-type par defaut
+Notez que lorsque l'argument template est spécifié, les arguments de fonction sont convertie, si nécessaire, pour s'adapter à l'argument template (il ne peut pas y avoir d'échec de déduction des types, puisque cette étape n'est pas réalisée). Dans ce code, la valeur ''1.2'' (''double'') est convertie (et arrondie) en ''1'' (''int'').
-valeur et type, compile time et runtime.
+Il est possible de mélanger déduction de types et arguments //template// explicite dans un appel de fonction template. Dans ce cas, les arguments template explicite correspondent aux premiers paramètres template, les autres paramètres template sont déduits.
-similitude argument/parametre
+<code cpp>
+template<typename T, typename U>
+T add(T lhs, U rhs) {
+    return lhs + rhs;
+}
-fonction template intermediaire, forward
+int main() {
+    add(1, 1.2);                // T = int,   U = double
+    add<float>(1, 1.2);         // T = float, U = double
+    add<float, float>(1, 1.2);  // T = float, U = float
+}
+</code>
+Lors du premier appel de la fonction ''add'', les parametre //template// ''T'' et ''U'' sont déduits des arguments de fonction (''int'' et ''double''). Lors du deuxième appel, le paramètre //template// ''T'' est explicite (''float''), le second paramètre ''U'' est déduits (''double''). Lors du dernier appel, les deux paramètres template sont déduits (''float'' et ''float'').
+===== Type par defaut =====
-''auto'' n'est pas pris en charge par tous les compilateurs. Possibilité d'expliciter le type générique en utilisant des fonctions template.
+Pour pour les paramètres de fonction, il est possible de spécifier un paramètre template par défaut lors de la déclaration d'un template. Lorsque l'argument template n'est pas spécifié lors de l'appel de la fonction template et que la déduction des types n'est pas possible, ce type par défaut sera utilisé.
-Une fonction classique permet de passer des données en paramètre. Les fonctions template vont plus loin, elles permettent de passer des types comme paramètre. C'est-à-dire que les types manipulés par un template ne sont pas fixés (''int'', ''double'', etc), mais sont des paramètres.
+La syntaxe pour indiquer un type par défaut est la suivante :
-Vous avez déjà vu des template dans ce cours, le meilleur exemple est ''std::vector'' et ''std::array''. Ces classes template représentent des collections pouvant contenir n'importe quel type de données. Le type manipulé dans la collection est indiqué dans les chevrons :
+<code cpp>
+typename PARAMETRE_TEMPLATE = TYPE_DEFAUT
+</code>
+Par exemple :
 <code cpp>
-std::vector<int> ints {};    // tableau de int
+template<typename T = int>
-std::vector<double> doubles {}; // tableau de double
+T add(int lhs, int rhs) {
+    return lhs + rhs;
+}
+add<float>(1, 2);  // ok, T = float
+add(1, 2);         // ok, T = int
 </code>
-Pour définir une fonction template, la syntaxe :
+A la dernière ligne de ce code, le type de retour n'est pas explicite et ne peut pas être déduit. Le type par défaut (''int'') est donc utilisé.
+===== Surcharge de fonctions =====
+Les fonctions template peuvent être surchargées, entre elles et avec les fonctions classiques. Cette fois-ci aussi, le compilateur travaille par étapes :
+  * le compilateur instancie les fonctions //templates// ;
+  * puis la résolution de la surcharge est réalisée sur l'ensemble des fonctions.
+La résolution de la surcharge est similaire à celle sans fonction template, les fonctions template ont une priorité intermédiaire entre les fonctions sans conversion et avec conversion :
+  * appel de fonction sans aucune conversion ;
+  * appel de fonction template
+  * appel de fonction avec promotion ;
+  * appel de fonction avec conversion.
+Voici un exemple pour que les choses soient plus concrètes.
 <code cpp>
-template<paramètres template>
+#include <iostream>
-paramètre_retour nom_fonction(paramètres de fonction) {
+template<typename T, typename U>
+void f(T lhs, U rhs) {
+    std::cout << "#1" << std::endl;
+}
+void f(int lhs, int rhs) {
+    std::cout << "#2" << std::endl;
+}
+int main() {
+    f(1, 2);    // #2
+    f(1, 2.0);  // #1
 }
 </code>
-On voit ici qu'une fonction template prend deux types de paramètre :
+Dans ce code, le premier appel de la fonction ''f'' contient deux arguments de type ''int''. La fonction fonction template ''#1'' sera instancié avec le paramètre ''T = int'', ce qui produira une fonction avec la signature suivante : ''f(int, int)''.
-  * les paramètres template, qui sont des types et sont évalués à la compilation. Mot-clé "typename" ou "class" suivi d'un nom de paramètre ;
+Lors de la résolution de la surcharge, les deux fonctions ont donc la même signature, mais l'une est une instance de fonction //template// et n'est donc pas prioritaire. La fonction ''#2'' est donc choisie par le compilateur.
-  * les paramètres de fonction, qui sont des valeurs et sont évaluées à l'exécution (__ sauf ''constexpr''... __)
-Les paramètres template déclarés entre les chevrons peuvent ensuite être utilisés dans la fonction (même dans les paramètres de fonction et le type de retour de fonction).
+Dans le second appel de la fonction ''f'', celle-ci contient des arguments de types ''int'' et ''double''. La fonction //template// sera donc instanciée avec la signature suivante : ''f(int, double)''. Lors de la résolution de la surcharge, le compilateur a le choix entre une fonction //template// dont les types des paramètres correspondent aux arguments, et une fonction non template qui nécessite une conversion de ''double'' en ''int'' pour être appelée. La fonction template ''#1'' est donc choisie.
-Par exemple, pour la fonction ''add'', on peut écrire :
+===== Echec d'instanciation =====
+Lors de l'utilisation des //templates//, vous pouvez rencontrer deux types d'erreurs :
+  * lors de la déduction des types, comme vous l'avez précédemment ("template argument déduction/substitution failed") ;
+  * lors de l'appel de la fonction après instanciation.
+En effet, comme le compilateur fonctionne par étape, il ne se préoccupe pas du corps de la fonction lorsqu'il instancie les fonctions templates. Il est donc possible qu'une fonction template soit instanciée, mais que la fonction n'a pas de sens.
+Par exemple :
 <code cpp>
 template<typename T>
 T add(T lhs, T rhs) {
     return lhs + rhs;
+}
+int main() {
+    add("123", "abc");
 }
 </code>
-On déclare ici un paramètre template qui se nomme "T", que l'on utilise comme retour de fonction et comme type pour les paramètres de fonction (n'oubliez pas que ''T'' représente un type, pas une variable).
+Dans ce code, les arguments de la fonction ''add'' sont des littérales chaînes (''const char*'') et la fonction template est instanciée avec la signature suivante : ''add(const char*, const char*)''. Cette étape ne pose pas de problème de déduction des types et aucune erreur s'est produite.
-Pour appeler une fonction template, en spécifiant les arguments :
+Le code est donc equivalent a :
 <code cpp>
-nom_fonction&lt;arguments template&gt;(arguments de fonction);
+const char* add(const char* lhs, const char* rhs) {
+    return lhs + rhs;
+}
+int main() {
+    add(&quot;123&quot;, "abc";);
+}
 </code>
-Les arguments template sont les types qui seront utilisés pour appeler la fonction. Par exemple, écrire ''add<int>'' permet au compilateur de remplacer ''T'' par ''int'' dans le code précédent, qui devient :
+Et la se pose un problème : l'opérateur d'addition ''+'' n'a pas de sens pour le type ''const char*''. Ce code produit donc l'erreur suivante ("invalid operands ... to binary operator+") :
+<code>
+main.cpp: In instantiation of 'T add(T, T) [with T = const char*]':
+main.cpp:7:21:   required from here
+main.cpp:3:16: error: invalid operands of types 'const char*'
+and 'const char*' to binary 'operator+'
+     return lhs + rhs;
+            ~~~~^~~~~
+</code>
+===== Assertion sur les types =====
+Vous connaissez déjà les assertions, qui permettent de vérifier à l'exécution qu'une condition est vraie.
 <code cpp>
-int add(int lhs, int rhs) {
+#include <cassert>
-    return lhs + rhs;
+int main() {
+    assert(1 == 1);  // ok
+    assert(1 == 2);  // produit une erreur
 }
 </code>
-De même si on écrit ''add<double>'' ou n'importe quoi d'autre.
+Affiche :
-On peut donc appeler cette fonction ''add'' avec différents types d'arguments :
+<code>
+a.out: main.cpp:5: int main(): Assertion `1 == 2' failed.
+</code>
+Il existe un second type d'assertion, qui permet de vérifier une condition à la compilation. Comme les types (et donc les //templates//) sont résolues à la compilation, ce type d'assertion va permettre d'imposer des conditions sur les parametres templates.
+La syntaxe est la suivante :
 <code cpp>
-int i = add<int>(1, 2);
+static_assert(CONDITION, MESSAGE);
-double d = add<double>(1.2, 3.4);
 </code>
-Le type ''T'' est défini uniquement dans la fonction template, donc il n'est pas possible d'écrire :
+Note : contrairement à ''assert'' qui nécessaire d'inclure un fichier d'en-tête (''<cassert>''), ''static_assert'' est un mot-clé du langage et ne nécessite pas d'inclusion.
+Et pour écrire des conditions sur les types, vous pouvez utiliser les fonctionnalités permettant d'obtenir des informations sur les types que vous avez vu dans le chapitre : [[informations_sur_les_types|]].
+Pour prendre un exemple concret, imaginez que vous souhaitez limiter l'utilisation de votre fonction ''add'' uniquement aux types représentant un nombre (et donc interdire l'utilisation de votre fonction avec une chaine de caracteres par exemple). Vous pouvez pour cela utiliser ''static_assert'' avec ''is_arithmetic''.
+<code cpp main.cpp>
+#include <type_traits>
+template<typename T>
+T add(T lhs, T rhs) {
+    static_assert(std::is_arithmetic<T>::value, "T is not arithmetic type!");
+    return lhs + rhs;
+}
+int main() {
+    add(1, 2);          // ok
+    add("123", "abc");  // erreur
+}
+</code>
+Dans le premier appel à la fonction ''add'', le paramètre //template// ''T'' est instancié en utilisant le type ''int''. L'assertion est vraie et cela ne produit pas d'erreur.
+Le second appel n'est pas un type de nombre et produit une assertion :
+<code>
+main.cpp:5:5: error: static_assert failed "T is not arithmetic type!"
+    static_assert(std::is_arithmetic<T>::value, "T is not arithmetic type!");
+    ^             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+main.cpp:11:5: note: in instantiation of function template specialization 'add<const char *>' requested here
+    add("123", "abc");  // erreur
+    ^
+</code>
+Une assertion statique accepte n'importe quelle expression qui retourne un booléen a la compilation, vous pouvez en particulier utiliser les opérateurs logiques ''!'' (NON), ''&&'' (ET) et ''||'' (OU)
+===== Substitution failure is not an error (SFINAE) =====
+Derrière cet acronyme un peu étrange se cache en fait un concept assez simple. Prenons le code suivant, que vous avez déjà vu :
 <code cpp>
-T i = add<int>(1, 2);
+#include <iostream>
-T d = add<double&gt;(1.2, 3.4);
+template<typename T>
+void f(T lhs, T rhs) {
+    std::cout << "#1" << std::endl;
+}
+void f(int lhs, int rhs) {
+    std::cout <&lt; "#2" << std::endl;
+}
+int main() {
+    f(1, 2.0);  // #2
+}
 </code>
-(cela n'aurait pas de sens, le compilateur ne sait pas si ''T'' = ''int'' ou ''double''). Il est possible d'utiliser l'inférence de type :
+Ce code ne produit pas d'erreur.
+Le même code, sans la seconde fonction ''f'' :
 <code cpp>
-auto i = add<int>(1, 2);
+#include <iostream>
-auto d = add<double&gt;(1.2, 3.4);
+template<typename T>
+void f(T lhs, T rhs) {
+    std::cout <&lt; "#1" << std::endl;
+}
+int main() {
+    f(1, 2.0);  // #2
+}
 </code>
-Dans ce cas, le compilateur sait déterminer le type.
+Ce code produit une erreur, puisque les arguments de la fonction sont de types differents (''int'' et ''double'').
+<code>
+main.cpp:9:5: error: no matching function for call to 'f'
+    f(1, 2.0);  // #2
+    ^
+main.cpp:4:6: note: candidate template ignored: deduced conflicting
+types for parameter 'T' ('int' vs. 'double')
+void f(T lhs, T rhs) {
+     ^
+</code>
+Vous pouvez alors vous demander pourquoi la fonction //template//, qui est manifestement problématique, ne produit également pas une erreur dans le premier code ?
+La raison est que l'échec de l'instanciation des template ne produit pas d'erreur (c'est ce que signifie "Substitution failure is not an error" : "l'echec d'une substitution n'est pas une erreur"). Ce qui produit une erreur est le fait que le compilateur ne trouve aucune fonction valide dans le second code, pas l'échec de l'instanciation.
-déduction automatique des arguments template
+Dans cet exemple, le SFINAE a ete utilise sans le savoir. Mais il existe de nombreuses techniques de méta-programmation qui utilise ce concept. Cela signifie en particulier que vous pouvez écrire autant de fonctions template que vous voulez, du moment qu'au moins une fonction est valide, le code compilera sans erreur.
-différence avec ''auto'' -> un seul type pour ''lhs'' et ''rhs'', ''add(1, 1.2)'' pose problème. Possible écrire :
+===== Un exemple d'application : les algorithmes de la bibliothèque standard =====
+Supposez que vous écrivez un algorithme qui prend en paramètre une collection de bibliothèque standard (par exemple ''std::vector<int>''). Vous pourriez écrire une fonction qui prend en parametre cette collection. Par exemple :
 <code cpp>
-template<typename T1, typename T2, typename T3>
+void do_something(const std::vector<int>& v);
-T1 add(T2 lhs, T3 rhs);
 </code>
-Nécessite de mettre ''T1'' au moins (ne peut pas être déduit)
+Comme ce chapitre est consacré à la généricité, vous avez surement compris le problème : ce code n'est pas générique (vous ne pouvez pas l'utiliser avec n'importe quel type de collection).
-Possible aussi de ne pas mettre ''common_type'' :
+Vous pouvez améliorer les choses en transformant cette fonction en template. Par exemple :
 <code cpp>
-template<typename T1, typename T2>
+template<typename T>
-std::common_type<T1, T2> add(T1 lhs, T2 rhs);
+void do_something(const std::vector<T>& v);
 </code>
-plus besoin de spécifier le type de retour
+Cette fonction est un peu plus générique, il est maintenant possible de changer le type d'éléments dans la collection. Cependant, ce n'est pas encore totalement générique : il n'est pas possible de changer le type de collection, cela sera forcement un ''std::vector''.
-note : template != generique. Plus puissant, langage complet (langage dans un langage, turing complet, meta programmation).
+Vous pourriez alors écrire le code suivant :
+<code cpp>
+template<typename T>
+void do_something(const T& v);
+</code>
-===== Les algorithmes de la bibliothèque standard =====
+Ce code est totalement generique... et peut être un peu trop  : la notion de collection est perdue, ''T'' peut représenter n'importe quel type autre qu'une collection.
-Idem, avec Itérateur en paramètre template. Prototype :
+Pour résoudre cette problématique, la bibliothèque standard implémente le concept d'itérateur (que vous avez déjà vu). Pour rappel, un itérateur est une indirection sur un élément d'une collection.
+Vous avez vu dans le chapitre sur les algorithmes de la bibliothèque standard que ceux-ci peuvent s'adapter a differents types de collections de donnees.
 <code cpp>
-template<typename Iterator>
+std::vector<int>; v_int { 1, 2, 3 };
-void sort(Iterator begin, Iterator end);
+std::sort(std::begin(v_int), std::end(v_int);  // ok
+std::vector<std::string> v_str { "abc", "123" };
+std::sort(std::begin(v_str), std::end(v_str);  // ok
 </code>
-Lorsque l'on appelle cette fonction, le compilateur détermine quel est le type de ''Iterator'' en fonction des arguments passés :
+Comme vous pouvez vous en douter, cela est possible en utilisant les //templates//.
+La signature de la fonction ''std::sort'' est une fonction //template//, qui prend en parametre //template// le type d'iterateurs (voir la documentation sur cppreference : [[http://en.cppreference.com/w/cpp/algorithm/sort|sort]]) :
 <code cpp>
-std::vector<int>; v {};
+template<typename RandomIt>
-std::sort(std::begin(v), std::end(v); // on sait que Iterator correspond à un itérateur sur un vector<int>;
+void sort(RandomIt first, RandomIt last);
 </code>
+Dans ce code, le paramètre //template// a été nommé ''RandomIt'', pour indiquer que c'est un itérateur de type "random" (pour rappel, voir le chapitre [[autres_collections|]]).
+Lorsque vous écrirez vos propres algorithmes, essayez de respecter cette signature pour les fonctions. Cela permettra la plus grande flexibilité dans le code et garantira que vos algorithmes soient compatibles avec les collections de la bibliotheque standard.
+===== Template et meta-programmation =====
+Ce chapitre est une introduction aux fonctions //template// et à la programmation générique. L'utilisation des //template// est donc limitée au stricte minimum. Mais il faut savoir que les templates en C++ sont beaucoup plus puissant que cela et forme un véritable langage de programme dans le C++. Ce méta-langage propose les fonctionnalites classiques d'un langage de programmation, en particulier la possibilité de faire des tests et des boucles.
+Cette méta-programmation présente un avantage très spécifique : elle ne fonctionne que lors de la compilation, pas lors de l'exécution. Elle permet donc d'écrire du code de haut niveau, qui va adapter le comportement du code en fonction des types, faire des vérifications avancées sur la qualité du code, et cela sans aucun coût à l'exécution du programme.
+La méta-programmation est une caractéristique du C++ qui différencie ce langage de la majorité des autres langages de programmation. Son apprentissage n'est pas simple et sera vu dans un autre cours.
+^ Chapitre précédent ^ [[programmez_avec_le_langage_c|Sommaire principal]] ^ Chapitre suivant ^
-^ [[surcharge_fonctions|Chapitre précédent]] ^ [[programmez_avec_le_langage_c|Sommaire principal]] ^ [[fonctions_lambdas|Chapitre suivant]] ^

C++, Qt, OpenGL, CUDA

Outils d'utilisateurs

Outils du Site

Différences

Outils de la Page