구문
핸들을 만듭니다. 변수를 가리키는 값으로, 저장하고 전달하고 반환할 수 있으며 그것을 통해 변수를 읽고 쓸 수 있습니다.
@<target>
<name> AS HANDLE [= @<target>]
<name> AS POINTER [= @<target>]
GetRef(<name>)
SetRef(<name>, <value>)
IsRef(<name>)
ReleaseRef(<name>)다른 표기 : @, HANDLE, POINTER
구성 요소
| <target> | 핸들이 가리키는 대상: 변수, 레코드 필드(@hero.hp), 배열 요소(@scores[1]), 현재 리스트 요소, 맵 항목(@names("ann")). |
|---|---|
| <name> | 핸들을 담는 변수. HANDLE과 POINTER는 같은 타입입니다. 비어 있는 상태로 시작합니다. |
| <value> | 대상에 쓸 값. 대상의 타입으로 변환됩니다. |
알아두기
@에는 대입할 수 있는 대상이 필요합니다.@42는 컴파일 오류입니다: "BASIC @ requires an assignable variable, field, array, list, or map element".- 핸들은 대상을 살려 둡니다.
LOCAL을 가리키는 핸들은 함수가 반환된 뒤에도 동작합니다. - 대상의 타입이 우선합니다.
AS uint8변수를 가리키는 핸들로SetRef(p, 300)을 하면 44가 저장됩니다. ReleaseRef()이후, 또는 필드를 가진 레코드가 삭제된 뒤에는IsRef()가 거짓이 되고GetRef()나SetRef()는 프로그램을 멈춥니다("BASIC reference handle has been released"). 한 번도 대입하지 않은HANDLE변수도 같습니다. 의심스러우면IsRef()로 검사하세요.- 따로 만든 두 핸들은 같은 변수를 가리켜도
=가 아닙니다. - 핸들은 PureBasic의
@variable과 달리 숫자가 아닙니다. 주소 산술도, 정수로의 캐스트도, 그것을 통한PeekI나PokeI도 없습니다. REF매개변수는 한 번의 호출 동안만 살아 있습니다. 핸들은 보관하는 동안 살아 있으며 레코드에 저장하거나 반환할 수 있습니다.
예제
BASIC
OPTION EXPLICITGLOBAL gold AS integer = 5FUNCTION AddGold(target AS HANDLE, amount AS integer) SetRef(target, GetRef(target) + amount)ENDFUNCTIONFUNCTION MakeCounter() AS HANDLE LOCAL counter AS integer = 0ENDFUNCTION @counterAddGold(@gold, 10)Console(Str(gold)) ' 15GLOBAL c AS HANDLE = MakeCounter()SetRef(c, GetRef(c) + 1)SetRef(c, GetRef(c) + 1)Console(Str(GetRef(c))) ' 2ReleaseRef(c)IF NOT IsRef(c) THEN Console("released") ' released매뉴얼에서 : 함수