pub 함수와 가시성

Zig에서는 모든 소스 파일이 하나의 모듈입니다. 다른 파일과 무엇을 공유할 수 있는지는 공개 범위 규칙으로 제어합니다. 📦

일반 함수는 해당 파일에서 비공개입니다. 다른 파일에서는 호출할 수 없으므로 내부 도우미를 안전하게 숨길 수 있습니다.

pub 키워드를 추가하면 함수를 공개하여 다른 파일에서 가져오고 프로젝트 전체에서 호출할 수 있게 됩니다.

다른 파일에서는 @import를 사용해 모듈을 불러온 다음, 반환된 값을 통해 공개 이름에 접근합니다.

가져온 모듈을 통해 호출할 수 있는 것은 공개 이름뿐입니다. 비공개 함수는 보이지 않으므로 잘못 사용할 수 없습니다.

이 때문에 main은 pub으로 작성합니다. 실행 환경은 파일 외부에 있으므로 진입점에 접근할 수 있어야 합니다.

pub 키워드는 상수, 자료형, 변수도 공개하여 모듈에 깔끔한 공개 영역을 만들 수 있게 합니다.

호출하는 쪽에 정말 필요한 것만 공개로 표시하십시오. 도우미를 비공개로 유지하면 관리해야 할 작고 안정적인 인터페이스를 만들 수 있습니다.

내부 구현을 숨기는 것이 캡슐화입니다. 외부에 노출되는 부분이 적으면 다른 파일을 깨뜨리지 않고 구현 세부 사항을 변경할 수 있습니다.

C와 달리 Zig에는 헤더 파일이 필요하지 않습니다. 파일을 가져오면 중복 없이 해당 파일의 공개 선언을 바로 사용할 수 있습니다.

Zig는 컴파일 시점에 공개 범위를 적용합니다. 파일 외부에서 비공개 함수를 호출하면 컴파일에 실패합니다.

math.zig에 함수를 작성했는데 다른 파일에서 호출할 수 없습니다. 무엇이 빠졌을 가능성이 가장 높을까요?

함수는 pub을 추가하기 전까지 해당 파일에서 비공개입니다. 호출하는 쪽에 필요한 것만 공개하고, @import로 가져오며, 헤더는 완전히 생략하십시오. 🎯