Conjuntos de errores y la unión !T
Trate los errores como valores de primera clase.
Conjuntos de errores y la unión !T es una lección gratuita de Zig Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Zig Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Zig Academy incluye 4 lecciones en total.
Los errores son valores
En Zig no hay excepciones. Un error es simplemente un valor ordinario que su función puede devolver, por lo que el fallo queda visible en el código.
Declarar un conjunto de errores
Un conjunto de errores es un grupo con nombre de posibles errores. Se enumeran sus variantes de forma muy parecida a un enum de las cosas que pueden salir mal.
const FileError = error{
NotFound,
PermissionDenied,
};Referirse a un error
Se accede a cada miembro de un conjunto de errores mediante un punto. El valor FileError.NotFound es un error concreto que puede devolver.
return FileError.NotFound;Conjuntos de errores anónimos
No siempre necesita un nombre. Escribir error{Empty} en línea crea un pequeño conjunto de errores de un solo uso justo donde se utiliza.
return error.Empty;El signo de exclamación significa «quizá un error»
El ! en un tipo crea una unión con errores. El tipo que aparece antes representa el valor correcto; en su lugar también puede aparecer un error.
FileError!u32Leer !T en voz alta
Puede leer !u32 como «un u32 o un error». El valor único contiene ambos resultados posibles, por lo que quien lo llama debe elegir uno.
Las dos partes de la unión
Una unión con errores tiene exactamente dos formas en tiempo de ejecución: un payload válido de tipo T o uno de los errores del conjunto. Nunca ambas cosas.
El conjunto antes del signo de exclamación
Coloque el conjunto de errores a la izquierda de ! para indicar exactamente qué errores están permitidos. Así documenta el fallo directamente en el tipo.
fn parse(s: []const u8) FileError!u32 {
// ...
}Combinar conjuntos de errores
El operador || aplicado a dos conjuntos de errores los combina en uno solo. Esto permite que una función admita errores de varias fuentes a la vez.
const AllError = FileError || NetError;anyerror es el superconjunto
El tipo incorporado anyerror contiene todos los errores posibles. Es práctico, pero pierde la precisión de un conjunto con nombre, así que úselo con moderación.
fn risky() anyerror!void {}Por qué son útiles los conjuntos
Como los errores forman parte del tipo, el compilador conoce todos los fallos que puede producir una función. Nada se le escapa sin gestionar.
Comprobación rápida
En una función aparece el tipo FileError!u32. ¿Qué describe?
Resumen
Ha conocido los conjuntos de errores, la unión !T, la combinación de conjuntos mediante || y anyerror. Los errores son valores normales que el sistema de tipos rastrea por usted. ✅
Preguntas frecuentes
¿La lección «Conjuntos de errores y la unión !T» es gratis?
Sí — el texto completo de «Conjuntos de errores y la unión !T» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Zig Academy, actualiza a CoddyKit PRO. El curso de Zig Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Conjuntos de errores y la unión !T»?
Trate los errores como valores de primera clase. Practicas Zig Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Zig Academy?
No se requiere experiencia previa. Zig Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Conjuntos de errores y la unión !T»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Zig Academy?
Sí. Cada lección de Zig Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Conjuntos de errores y la unión !T
- Devolver errores desde funciones
- Propagar fallos con try
- Conjuntos de errores inferidos