구문

맵을 선언합니다. 텍스트 키로 값을 저장합니다. <name>(<key>)는 항목 하나를 읽거나 쓰고, <name>()은 현재 항목을 읽거나 씁니다.

NewMap <name>.<type>([<slots>])
NewMap <name>([<slots>])
GLOBAL NewMap <name>.<type>([<slots>])
LOCAL NewMap <name>.<type>([<slots>])
<name>(<key>)
<name>()
<name>(<key>).<field>

구성 요소

<name>기호 없는 맵 이름. 리스트의 이름과 같을 수 없습니다.
<type>값의 타입이며 NewList와 같습니다: 짧은 접미사, 전체 타입 이름, 또는 TYPE 이름. 없으면 맵은 정수를 담습니다.
<slots>PureBasic 프로그램을 위해 남겨 둔 선택적 크기 힌트. 양의 정수여야 하며(0 이하는 프로그램을 멈춥니다) 그 밖에는 아무것도 바꾸지 않습니다.
<key>텍스트인 키. 숫자는 텍스트로 바뀌므로 m(1)과 m("1")은 같은 항목입니다. 키는 대소문자를 구분합니다.
<field>레코드 맵에서 항목의 필드: bag("sword").qty = 1.

알아두기

  • m("key") = v는 항목을 만들거나 값을 바꿉니다. +=, -=, *=, /=도 항목에 쓸 수 있습니다.
  • m("key")를 읽으면 없는 항목이 기본값으로 만들어집니다. 만들지 않고 검사하려면 FindMapElement()를 쓰세요.
  • 접근할 때마다 그 항목이 현재 항목이 됩니다. 현재 항목이 없을 때 m()을 읽으면 프로그램이 멈춥니다: BASIC map has no current element.
  • NewMap m$()는 m()을 처음 쓸 때 거부됩니다. 타입은 점 뒤에 쓰세요: NewMap m.s().
  • DO … LOOP가 있는 프로그램에서 FUNCTION은 DO 위에서 선언한 맵을 보지 못합니다(… is not defined). GLOBAL NewMap으로 선언하세요.

예제

BASIC
NewMap stock.i()stock("apple") = 3stock("pear") = 5stock("apple") += 2Console(Str(stock("apple")) + " " + Str(MapSize(stock())))   ' 5 2IF FindMapElement(stock(), "plum") = 0 THEN Console("no plum")   ' no plumConsole(Str(stock("plum")) + " " + Str(MapSize(stock())))   ' 0 3
매뉴얼에서 : 배열, 리스트, 맵