Énumérations pour un ensemble fixe de valeurs

Certaines valeurs proviennent d’un petit choix fixe : un feu de signalisation est rouge, jaune ou vert. Une énumération nomme exactement cette liste fermée d’options.

Vous écrivez enum et indiquez entre accolades les noms souhaités. Chaque nom est une valeur valide de ce type.

Chaque entrée comme red ou blue est une véritable valeur du type, et non une chaîne de caractères. Vous y faites référence par l’intermédiaire de l’énumération, ce qui la rend ordonnée et typée.

Lorsque Zig connaît déjà le type attendu, vous pouvez omettre le nom et écrire simplement un point avant la valeur.

Vous comparez les valeurs d’énumération avec ==, comme les nombres. Les embranchements fondés sur un choix fixe restent ainsi clairs et lisibles.

Une énumération ne peut contenir que les noms que vous avez déclarés. Si vous essayez d’en utiliser un qui n’existe pas, le compilateur le refuse immédiatement.

Lire .green est bien plus clair que lire le nombre 1. Les énumérations transforment les nombres magiques en noms significatifs auxquels vous pouvez vous fier.

Acceptez une énumération comme paramètre : l’appelant ne pourra transmettre qu’une de vos options valides, et les entrées incorrectes seront donc détectées lors de la compilation.

Les énumérations révèlent tout leur intérêt avec switch : vous traitez chaque cas nommé et Zig vous rappelle si vous en oubliez un.

Les types d’énumération utilisent la casse TitleCase, comme Color, tandis que les valeurs individuelles utilisent la casse snake_case minuscule, comme light_blue. Les deux rôles restent ainsi distincts.

Lorsqu’une valeur correspond à l’un de quelques états connus, une énumération rend les choix explicites et sûrs, et empêche toute faute d’orthographe silencieuse.

Vous avez découvert les énumérations : un type qui nomme un ensemble fixe de valeurs. Utilisez la notation abrégée avec un point, comparez avec == et laissez le compilateur bloquer les choix invalides. 🚦