이 문서에 대하여
이 문서에 대하여
이 문서는 Haxe 4의 공식 매뉴얼이에요. 그렇기 때문에 초보자용 튜토리얼이 아니며 프로그래밍 자체를 가르치지 않습니다. 다만 주제들은 대체로 순서대로 읽도록 설계되어 있고, "이전에 다룬" 주제와 "앞으로 다룰" 주제에 대한 참조가 포함되어 있어요. 어떤 경우에는 설명을 단순하게 만들기 위해 더 뒤쪽 절의 정보를 앞쪽 절에서 사용하기도 합니다. 이런 참조는 모두 링크로 연결되어 있으므로, 다른 주제를 먼저 읽어나가는 데에는 보통 문제가 없답니다.
저희는 이론적인 내용을 실제로 보여주기 위해 Haxe 소스코드를 많이 사용해요. 이 코드 예시들은 종종 main 함수를 포함한 완전한 프로그램이라 그대로 컴파일할 수 있어요. 하지만 때로는 가장 관련 있는 부분만 보여주기도 합니다.
소스코드는 다음과 같이 표시돼요:
Haxe code here
때때로 대상 코드(target code)가 어떻게 생성되는지 보여드리기도 하는데, 이때는 주로 JavaScript 대상의 예를 보여줍니다.
또한 이 문서에는 일련의 용어들이 정의되어 있어요. 주로 새 타입을 소개하거나 Haxe에 특화된 용어를 쓸 때 정의되죠. 복잡함을 피하기 위해 "클래스가 무엇인가" 같은 모든 새로운 측면을 매번 정의하지는 않습니다. 정의는 다음과 같이 표시됩니다:
정의: 용어 — 해당 용어에 대한 설명.
본문
문서의 구성
이 매뉴얼은 크게 언어의 기초(타입, 타입 시스템, 클래스 필드, 표현식), 언어의 고급 기능(매크로, 패턴 매칭, 조건부 컴파일), 표준 라이브러리, 그리고 각 대상 언어별 세부 사항으로 나뉘어 구성되어 있어요.
각 절은 이전 절에서 배운 개념을 자연스럽게 이어받도록 배치되어 있으므로, 처음부터 차례로 읽어나가는 것을 권장해요. 다만 이미 프로그래밍 경험이 있다면 궁금한 주제부터 골라 읽어도 좋답니다.
예제 코드
문서에는 두 종류의 예제가 등장해요. 첫째는 완전한 프로그램으로, Main.hx 같은 파일로 저장해 바로 컴파일·실행할 수 있어요. 둘째는 설명의 핵심 부분만 발췌한 코드 조각이에요. 이런 조각은 실행 가능한 전체 프로그램이 아닐 수 있으니, 그대로 복사해서 실행하려고 하지 않는 것이 좋아요.
대상 언어로 생성된 코드를 보여줄 때는 대부분 JavaScript를 예로 들어요. 이는 JavaScript 출력이 다른 대상보다 읽기 쉽고, Haxe의 타입 시스템이 어떻게 반영되는지 잘 드러나기 때문이에요.
용어 정의
문서에서는 새 타입이나 Haxe 고유의 개념을 도입할 때 특별한 형식으로 정의를 표기해요. 이 형식은 독자가 개념을 처음 만났을 때 정확한 의미를 바로 이해할 수 있게 도와줍니다.
모든 새로운 개념을 정의하는 것은 아니에요. 예를 들어 "클래스"처럼 널리 알려진 프로그래밍 개념은 재정의하지 않아요. 대신 Haxe에 특화된 방식으로 쓰일 때만 추가 설명을 붙인답니다.