#INCLUDE

지시문

구문

프로젝트의 BASIC 모듈의 줄들을 디렉티브 자리에 넣으며 프로그램당 한 번만 합니다. 같은 모듈을 다시 요청하면 건너뜁니다.

#INCLUDE "<path>"
#INCLUDE("<path>")

구성 요소

<path>프로젝트 안의 모듈 이름이며 lib/math.bas처럼 큰따옴표로 감쌉니다. 디렉티브가 있는 파일 옆에서 먼저 찾고, 그다음 프로젝트 루트에서 찾습니다. /와 \는 폴더를 구분하고 ..는 한 단계 위로 갑니다. 대소문자는 무시합니다.

알아두기

  • 예제에서 모듈 lib/math.bas는 FUNCTION Clamp(value, low, high)를 선언합니다. 두 번 요청되지만 한 번만 포함됩니다.
  • 선언 파일(함수, TYPE, GLOBAL)에 쓰세요. 그런 파일을 #INSERT로 두 번 넣으면 모든 것이 두 번 선언되어 거부됩니다.
  • 건너뛰기는 파일 사이에서도 동작합니다. 다른 모듈이 이미 포함한 모듈은 다시 포함되지 않습니다.
  • 어떤 모듈과도 맞지 않는 경로는 디렉티브가 있는 줄의 컴파일 오류입니다: BASIC include file not found: <path>. 버려진 #IF 분기 안의 파일은 읽지 않으므로 없어도 됩니다.
  • 컴파일러는 디스크 경로나 URL을 읽지 않습니다. 모듈은 File, New Script, BASIC Module로 만들거나 .bas 또는 .agc 파일에서 가져옵니다. 이름이 곧 경로입니다.
  • 한 줄에 디렉티브 하나, 단독으로 씁니다. 뒤에 ' 주석이 오는 것은 괜찮습니다. : 뒤에 쓰면 거부되지는 않지만 텍스트로 남아 프로그램이 시작되지 않습니다.
  • 큰따옴표가 없는 #INCLUDE lib/math.bas도 거부되지는 않습니다. 컴파일은 되지만 프로그램이 시작되지 않습니다.
  • 컴파일 전에 이루어지는 단순한 텍스트 삽입입니다. 런타임 IF 안에 있어도 조건과 관계없이 파일이 삽입됩니다. 파일을 빼려면 디렉티브를 #IF로 감싸세요.
  • 서로를 포함하는 두 모듈은 조용히 멈춥니다. 두 번째 요청이 건너뛰어집니다.
  • AGK의 #include도 같은 의미입니다. PureBasic의 XIncludeFile은 거부됩니다. #INCLUDE라고 쓰세요.

예제

lib/math.bas

BASIC
FUNCTION Clamp(value, low, high)  IF value < low THEN EXITFUNCTION low  IF value > high THEN EXITFUNCTION highENDFUNCTION value

main.bas

BASIC
#INCLUDE "lib/math.bas"#INCLUDE "lib/math.bas"Console(Str(Clamp(15, 0, 10)))   ' 10
매뉴얼에서 : 전처리기