구문
매개변수를 받고 값을 돌려줄 수 있는, 이름 붙은 코드 블록을 선언합니다. 현재 프레임 안에서 끝까지 한 번에 실행됩니다.
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매뉴얼에서 : 함수