Ensembles d'erreurs et union !T
Traitez les erreurs comme des valeurs à part entière.
Ensembles d'erreurs et union !T est une leçon Zig Academy gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Zig Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Zig Academy comprend 4 leçons au total.
Les erreurs sont des valeurs
Dans Zig, il n’y a pas d’exceptions. Une erreur est simplement une valeur ordinaire que votre fonction peut renvoyer : l’échec est donc visible dans le code.
Déclarer un ensemble d’erreurs
Un ensemble d’erreurs est un groupe nommé d’erreurs possibles. Vous répertoriez ses variantes un peu comme les éléments d’une énumération représentant les problèmes possibles.
const FileError = error{
NotFound,
PermissionDenied,
};Faire référence à une erreur
Chaque membre d’un ensemble d’erreurs est accessible avec un point. La valeur FileError.NotFound est une erreur concrète que vous pouvez renvoyer.
return FileError.NotFound;Ensembles d’erreurs anonymes
Vous n’avez pas toujours besoin d’un nom. Écrire error{Empty} directement crée un petit ensemble d’erreurs ponctuel à l’endroit où il est utilisé.
return error.Empty;Le point d’exclamation indique une erreur possible
Le ! dans un type construit une union avec erreurs. Le type qui le précède est la valeur en cas de réussite ; une erreur peut apparaître à sa place.
FileError!u32Lire !T à voix haute
Vous pouvez lire !u32 comme « un u32 ou une erreur ». Cette valeur unique porte les deux issues possibles, le code appelant doit donc choisir laquelle traiter.
Les deux côtés de l’union
À l’exécution, une union avec erreurs a exactement deux formes : une charge utile valide de type T, ou l’une des erreurs de l’ensemble. Jamais les deux.
Placer l’ensemble avant le point d’exclamation
Placez l’ensemble d’erreurs à gauche de ! pour indiquer précisément quelles erreurs sont autorisées. Cela documente l’échec directement dans le type.
fn parse(s: []const u8) FileError!u32 {
// ...
}Fusionner des ensembles d’erreurs
L’opérateur || appliqué à deux ensembles d’erreurs les combine en un seul. Une fonction peut ainsi accepter simultanément des erreurs provenant de plusieurs sources.
const AllError = FileError || NetError;anyerror est le sur-ensemble
Le type intégré anyerror contient toutes les erreurs possibles. Il est pratique, mais perd la précision d’un ensemble nommé : utilisez-le donc avec parcimonie.
fn risky() anyerror!void {}Pourquoi les ensembles sont utiles
Comme les erreurs font partie du type, le compilateur connaît chaque échec qu’une fonction peut produire. Rien ne vous échappe si ce n’est pas géré.
Vérification rapide
Vous voyez le type FileError!u32 sur une fonction. Que décrit-il ?
Récapitulatif
Vous avez découvert les ensembles d’erreurs, l’union !T, la fusion avec || et anyerror. Les erreurs sont de simples valeurs suivies par le système de types. ✅
Questions Fréquemment Posées
La leçon « Ensembles d'erreurs et union !T » est-elle gratuite ?
Oui — le texte complet de « Ensembles d'erreurs et union !T » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Zig Academy, passe à CoddyKit PRO. Le cours Zig Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Ensembles d'erreurs et union !T » ?
Traitez les erreurs comme des valeurs à part entière. Tu pratiques Zig Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Zig Academy ?
Aucune expérience préalable n'est requise. Zig Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Ensembles d'erreurs et union !T » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Zig Academy ?
Oui. Chaque leçon Zig Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Ensembles d'erreurs et union !T
- Renvoyer des erreurs depuis des fonctions
- Propager les échecs avec try
- Ensembles d'erreurs déduits