구문

핸들을 만듭니다. 변수를 가리키는 값으로, 저장하고 전달하고 반환할 수 있으며 그것을 통해 변수를 읽고 쓸 수 있습니다.

@<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
매뉴얼에서 : 함수