La version 3 d'OCaml a introduit plusieurs nouveaux concepts « avancés » dont LablGTK se sert beaucoup. On dit généralement qu'ils sont « avancés » dans la mesure où il n'est absolument pas indispensable de les aborder dans le cadre d'une introduction au langage. Tout ceci m'a donc incité à commencer ce tutoriel par une brève présentation de ces quelques points. Ceux qui savent déjà tout des arguments nommés, des arguments optionnels et des variants polymorphes peuvent passer d'emblée à la deuxième partie du tutoriel.
Les arguments nommés
Si vous utilisez déjà OCaml, vous avez probablement déjà utilisé les modules
String et
Unix. Si vous regardez attentivement la liste des modules de la bibliothèque standard, vous verrez qu'il existe également des modules
StringLabels et
UnixLabels.
C'est vrai ça ! Mais, à quoi peuvent-ils bien servir vu qu'ils contiennent exactement les mêmes fonctions que String et Unix ?
En fait, la grande différence entre ces modules réside dans la présence d'étiquettes (ou
labels en anglais), que j'appellerai « arguments nommés » dans la suite de ce tutoriel (je crois que c'est la bonne traduction, mais comme je les ai toujours connus comme étant des
labels, je suis un peu démuni

).
Bon, d'accord, il y a de petites différences... mais ça ne change pas le code. Alors à quoi cela peut-il bien servir ?
Eh bien, les arguments nommés permettent de préciser la nature de certains arguments lorsque leur type n'est pas très explicite, ou quand il y a vraiment
beaucoup d'arguments. Je vais vous donner un exemple. Considérez cette fonction sans grand intérêt :
Code : OCaml1
2
3
4
5
6 | let boucle min max step f =
let rec loop = function
| i when i > max -> ()
| i -> f i;
loop (i + step)
in loop min
|
Si vous la tapez dans l'interpréteur, vous verrez que sa signature n'utilise que des types simples... mais qu'on ne sait pas trop, en la voyant, à quoi correspondent tous ces entiers :
Code : OCaml1 | val boucle : int -> int -> int -> (int -> 'a) -> unit
|
Nous rencontrons donc un premier problème : celui de la
lisibilité. On aimerait bien que la seule signature d'une fonction suffise à nous en faire comprendre le fonctionnement (c'est ce qui rend précieux des outils tels que
ocamlbrowser et
ocamldoc). Or, dans le cas présent, les types ne nous sont d'aucun secours. Nous allons donc écrire quelque chose comme ça :
Code : OCaml1
2
3
4
5
6 | let boucle ~min ~max ~step f =
let rec loop = function
| i when i > max -> ()
| i -> f i;
loop (i + step)
in loop min
|
L'ajout d'un tilde (~) devant
min,
max et
step permet d'associer un nom à chacun des arguments dans la signature de la fonction :
Code : OCaml1 | val boucle : min:int -> max:int -> step:int -> (int -> 'a) -> unit
|
Même si cela vous plaît et qu'il vous prend l'envie d'en utiliser partout dans vos développements futurs, notez quand même que cela n'est pas sans conséquence sur le typage (notamment pour les applications partielles, mais je n'en dis pas plus).
L'utilisation des arguments nommés permet aussi d'écrire les arguments dans n'importe quel ordre (ou presque). Par exemple, ceci fonctionne très bien :
Code : OCaml1
2
3 | # boucle ~step:2 ~max:5 ~min:1 print_int ;;
135- : unit = ()
#
|
Notez que si vous indiquez tous les arguments d'une fonction, autrement dit si vous ne faites pas d'application partielle, vous pouvez vous abstenir de préciser les étiquettes des arguments.
Une petite information sur la syntaxe, pour clore cette partie : notez que lorsqu'une variable porte le même nom qu'un argument nommé, la notation habituelle ~nom:variable peut être abrégée en ~nom.
Code : OCaml1
2 | let min = 2 and max = 8 in
boucle ~min ~max ~step:2 print_int
|
Les arguments optionnels
Avec une valeur par défaut
Les arguments optionnels sont aussi des arguments nommés, mais ils introduisent une propriété supplémentaire puisqu'ils permettent de rendre un argument facultatif (avec, éventuellement, une valeur par défaut). Voici d'abord un exemple avec des valeurs par défaut :
Code : OCaml1
2
3
4
5
6 | let boucle ?(min = 0) ?(max = 100) ?(step = 1) f =
let rec loop = function
| i when i > max -> ()
| i -> f i;
loop (i + step)
in loop min
|
La signature de la fonction est aussi lisible qu'avec les arguments nommés, mais, chose nouvelle, il n'est plus nécessaire d'indiquer tous les paramètres (min, max et step). Notez que les tildes (~) ont été remplacés par des points d'interrogation (?).
Code : OCaml1 | val boucle : ?min:int -> ?max:int -> ?step:int -> (int -> 'a) -> unit
|
C'est simple non ? Oui ? Eh bien non ! Il y a quelques subtilités à comprendre. Je vais vous les présenter, et il faut vraiment bien les saisir pour utiliser ensuite LablGTK en toute sérénité.
Sans valeur par défaut
Que se passe-t-il maintenant si nous ne mettons pas de valeur par défaut ? Eh bien, c'est une bonne question... qui me permet de vous présenter une première subtilité. S'il n'y a pas de valeur par défaut, l'argument est de type
'a option dans le
corps de la fonction. C'est logique, mais il faut le savoir. Un exemple pour illustrer ce comportement :
Code : OCaml1
2
3
4 | let weird_is_lower ?x y =
match x with
| None -> true
| Some x -> y < x
|
J'ai qualifié cette fonction de curieuse (
weird) parce qu'elle n'est pas vraiment très utile. Son seul mérite est de montrer que le paramètre
x est bien de type
'a option.
Utilisation des arguments optionnels
Puisqu'un exemple vaut mieux qu'un long discours, je vous propose quelques lignes de code à essayer dans l'interpréteur... pour découvrir la deuxième subtilité.
Code : Console | # let incr ?(step = 1) x = x + step;;
val incr : ?step:int -> int -> int = <fun>
# incr 1 ;;
- : int = 2
# incr ~step:2 1 ;;
- : int = 3
# incr ?step:(Some 3) 1 ;;
- : int = 4
# |
C'est bien si vous avez trouvé ! Un argument optionnel utilisé avec un tilde (~) sert à indiquer une valeur de type 'a. Un argument optionnel utilisé avec un point d'interrogation (?) sert à indiquer une valeur de type 'a option.
Variants polymorphes
Vous savez sans doute que le
type somme d'OCaml permet de créer de nouveaux types dont la manipulation est grandement facilitée par le filtrage. Par exemple, on peut construire un module
Carte dans lequel est défini le type suivant :
Code : OCaml1 | type t = As | Roi | Dame | Valet | Valeur of int
|
Le principal reproche que l'on peut formuler à l'encontre de ce type réside dans le manque de flexibilité qui apparaît lorsqu'on veut s'en servir dans un autre module. On doit en effet utiliser la notation longue
Carte.As ou
Carte.Dame. Il y a derrière tout ça la notion d'espace de nom (
namespace en anglais), mais il est inutile d'en dire plus ici.
Je ne suis ni « pour » ni « contre » cette notation longue, car elle présente des avantages indéniables. En revanche, dans le cas de LablGTK, où certains types sont conçus pour être accessibles dans tous les autres modules (par exemple GtkStock.id qui définit les icônes prédéfinies de GTK), il vaut mieux remplacer le type somme habituel par des variants polymorphes. La présence de nombreux modules n'est alors plus un obstacle à l'utilisation d'un type donné.
C'est pourquoi LablGTK utilise exclusivement les
variants polymorphes.
De quoi s'agit-il ?
Les variants polymorphes sont conçus pour être accessibles tels quels en dehors du module où ils sont définis. Ils ont bien d'autres caractéristiques (détaillées dans le manuel de référence), mais nous ne nous y attarderons pas. Voyons plutôt à quoi ressemble le type
Carte.t lorsqu'il est réécrit avec des variants polymorphes :
Code : OCaml1 | type t = [ `As | `Roi | `Dame | `Valet | `Valeur of int ]
|
Le caractère qui introduit un variant polymorphe est un
accent grave (AltGr + 7).
Comme je l'ai dit plus haut, la bibliothèque LablGTK utilise beaucoup les variants polymorphes pour définir des groupes de valeurs possibles (par exemple pour une fenêtre :
`CENTER centre la fenêtre sur l'écran,
`CENTER_ON_PARENT centre la fenêtre par rapport à son parent, et ainsi de suite). Voici d'autres exemples :
- le type GtkStock.id contient les icônes prédéfinies de GTK ;
- le type Gtk.Tags contient de très nombreux types à base de variants polymorphes... qui ont été ainsi regroupés parce qu'on peut s'en servir sans se soucier de leur module d'origine.