구문

매개변수를 받고 값을 돌려줄 수 있는, 이름 붙은 코드 블록을 선언합니다. 현재 프레임 안에서 끝까지 한 번에 실행됩니다.

FUNCTION <name>([<parameter>, …]) [AS <type>]
  EXITFUNCTION [<value>]
  RETURN [<value>]
ENDFUNCTION [<value>]
Procedure <name>([<parameter>, …]) [AS <type>]
  ProcedureReturn [<value>]
EndProcedure
<parameter> = [OPTIONAL] <param> [AS <type>] [= <default>]
<parameter> = PARAMARRAY <param> [AS <type>]
<parameter> = <param> [AS <type>]...

다른 표기 : ENDFUNCTION, EXITFUNCTION, Procedure, EndProcedure, ProcedureReturn, OPTIONAL, PARAMARRAY

구성 요소

<name>함수 이름. 대소문자는 구분하지 않습니다. 기호($, #, %, &)로 끝낼 수 있지만 레이블로만 쓰입니다.
<parameter>아래 세 형식 중 하나로 쓰는 매개변수 하나. 쉼표로 구분합니다. 목록은 비어도 됩니다.
<type>숫자 타입, string, HANDLE, 직접 선언한 TYPE, 또는 그 배열(integer[], []는 최대 여섯 개). 함수에 붙이면 반환하는 모든 값을 변환합니다.
<value>돌려주는 값. 선택 사항이며 없으면 함수는 아무것도 반환하지 않거나 AS 타입의 기본값을 반환합니다.
<param>함수에 지역적인 매개변수 이름.
<default>호출자가 인수를 생략했을 때 쓰는 값. 호출할 때마다 계산되며 앞의 매개변수를 쓸 수 있습니다.

반환

ENDFUNCTION, EXITFUNCTION, RETURN 뒤의 값이며 AS 타입이 있으면 그 타입으로 변환됩니다. 값이 없으면 아무것도 없음(출력하면 undefined) 또는 AS 타입의 기본값(0, "", 빈 레코드)입니다.

알아두기

  • ENDFUNCTION과 EXITFUNCTION은 한 단어입니다. END FUNCTION은 거부됩니다("FUNCTION requires ENDFUNCTION"). 두 단어인 EXIT FUNCTION은 거부되지는 않지만 프로그램이 실행되지 않습니다.
  • 호출에는 인수가 없어도 항상 괄호가 붙습니다: showTitle(). 괄호 없는 showTitle은 변수로 컴파일되어 프로그램이 실행될 때에야 실패합니다.
  • 함수는 파일의 최상위에 선언하고 IF, 반복문, 다른 함수 안에는 선언하지 마세요. 선언한 줄보다 위에서 함수를 호출해도 됩니다. 같은 이름이면 사용자 함수가 카탈로그 명령보다 우선합니다.
  • 이름의 기호는 변환이 아닙니다. AS 없는 whole%(9.8)은 9.8을 반환합니다. title$("x")와 title("x")는 같은 함수를 호출합니다. 변환하려면 AS integer나 AS string을 쓰세요.
  • 기본값 없는 OPTIONAL은 매개변수 타입의 기본값을 줍니다. 기호로는 타입이 정해지지 않습니다. OPTIONAL name$는 ""가 아니라 0을 받으므로 OPTIONAL name AS string을 쓰세요. 필수 매개변수는 선택 매개변수 뒤에 올 수 없고, f(1, , 5)는 가운데 인수를 건너뛰지 않습니다. 5가 두 번째 매개변수에 들어갑니다.
  • 가변 인수 매개변수(PARAMARRAY values 또는 values...)는 마지막이어야 하고, 기본값이 없으며 REF일 수 없습니다. 타입을 붙이려면 values AS float...로 쓰세요. values... AS float는 거부됩니다. .length는 마지막 인덱스입니다. 값이 세 개면 2, 없으면 -1입니다.
  • 타입 없는 매개변수는 호출자와 레코드나 배열을 공유합니다. 타입 있는 매개변수는 복사본을 받습니다. 호출자의 변수를 의도적으로 바꾸려면 REF를 쓰세요.
  • 인수 개수 범위가 겹치지 않으면 여러 함수가 이름을 공유할 수 있습니다. 컴파일러는 타입이 아니라 개수만으로 고릅니다. 범위가 겹치면 "Ambiguous BASIC overload"가 납니다.
  • 함수 안에서는 기다리는 것이 허용되지 않습니다. END, Wait(), Sleep(), AWAITTASK, AWAITALL, AWAITANY는 거부됩니다. Sync(), Swap(), YieldTask()는 받아들여지지만 DO … LOOP가 있는 프로그램에서는 프로그램이 시작되지 않습니다. 메인 루프, GOSUB 서브루틴, 태스크에서 기다리세요.
  • DO … LOOP가 있는 프로그램에서 함수는 DO 위에서 설정한 평범한 변수를 보지 못합니다. 공유할 값은 GLOBAL로 선언하고 OPTION EXPLICIT를 켜세요.
  • PureBasic: Procedure, ProcedureReturn, EndProcedure는 FUNCTION, EXITFUNCTION, ENDFUNCTION의 별칭입니다. 타입이 있는 형식 Procedure.s Name()은 거부됩니다. Procedure Name() AS string으로 쓰세요. Visual Basic에는 Sub가 있고, 여기서는 아무것도 반환하지 않는 FUNCTION이 그 역할을 합니다.

예제

BASIC
FUNCTION Greet(name AS string = "stranger", OPTIONAL mark AS string) AS stringENDFUNCTION "Hello " + name + markFUNCTION Total(PARAMARRAY values AS integer) AS integer  LOCAL sum AS integer = 0  FOR i = 0 TO values.length    sum = sum + values[i]  NEXT iENDFUNCTION sumFUNCTION Sign(n)  IF n < 0 THEN EXITFUNCTION -1ENDFUNCTION 1Console(Greet())                 ' Hello strangerConsole(Greet("Ada", "!"))       ' Hello Ada!Console(Str(Total(2, 4, 9)))     ' 15Console(Str(Sign(-5)))           ' -1
매뉴얼에서 : 함수