Funciones pub y visibilidad
Exponga funciones entre archivos.
Funciones pub y visibilidad es una lección gratuita de Zig Academy en CoddyKit. Esta es la lección 3 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 archivos son módulos
En Zig, cada archivo de código fuente es su propio módulo. Las reglas de visibilidad controlan qué comparte con otros archivos. 📦
Privado de forma predeterminada
Una función normal es privada para su archivo. Otros archivos no pueden llamarla, lo que mantiene ocultos y seguros los auxiliares internos.
fn helper() void {
// only this file can call me
}pub lo hace público
Añada la palabra clave pub para exponer una función, de modo que otros archivos puedan importarla y llamarla en todo el proyecto.
pub fn greet() void {
std.debug.print("Hi!\n", .{});
}Importar lo incorpora
Otro archivo usa @import para cargar el módulo y, después, accede a los nombres públicos mediante el valor devuelto.
const utils = @import("utils.zig");
utils.greet();Solo se puede acceder a los nombres pub
A través de esa importación solo puede llamar a los nombres públicos. Las funciones privadas permanecen invisibles y no pueden utilizarse indebidamente.
Por qué main necesita pub
Por eso main se escribe como pub: el tiempo de ejecución está fuera de su archivo y debe poder acceder al punto de entrada.
pub funciona con más que fn
La palabra clave pub también expone constantes, tipos y variables, lo que permite publicar una interfaz externa clara para un módulo.
pub const version = "1.0.0";Diseñe una API pequeña
Marque como público solo lo que realmente necesiten quienes llamen al módulo. Mantener privados los auxiliares le proporciona una interfaz pequeña y estable que mantener.
La encapsulación reduce los errores
Ocultar los detalles internos es encapsulación. Al exponer menos elementos, puede cambiar los detalles de implementación sin romper otros archivos.
No se necesitan encabezados
A diferencia de C, Zig no necesita archivos de encabezado. Importar un archivo le proporciona directamente sus declaraciones públicas, sin duplicación.
La visibilidad se comprueba en tiempo de compilación
Zig aplica la visibilidad en tiempo de compilación. Llamar a una función privada desde fuera de su archivo simplemente hace que la compilación falle.
Comprobación rápida
Ha escrito una función en math.zig y otro archivo no puede llamarla. ¿Qué falta probablemente?
Resumen
Las funciones son privadas para su archivo hasta que añade pub. Exponga solo lo que necesiten quienes llamen al módulo, importe con @import y prescinda por completo de los encabezados. 🎯
Preguntas frecuentes
¿La lección «Funciones pub y visibilidad» es gratis?
Sí — el texto completo de «Funciones pub y visibilidad» 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 «Funciones pub y visibilidad»?
Exponga funciones entre archivos. 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 3 de 4.
¿Cuánto tiempo toma la lección «Funciones pub y visibilidad»?
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
- Sintaxis de funciones y tipos de retorno
- Pasar valores frente a referencias
- Funciones pub y visibilidad
- Recursión y retornos múltiples