SortStructuredList

리스트 명령어

구문

레코드 리스트를 레코드의 한 필드를 기준으로 제자리에서 정렬합니다.

SortStructuredList(<list>(), <field>, <options> [, <start>, <end>])

구성 요소

<list>NewList로 선언한 레코드 리스트이며 빈 괄호를 붙여 씁니다: foes().
<field>텍스트로 쓴 필드 이름: "hp". 대소문자는 구분하지 않습니다. 중첩된 레코드의 필드는 점으로 씁니다: "pos.x". 필드는 숫자나 문자열이어야 합니다.
<options>필수. #AK_ORDER_LOW_TO_HIGH(0), #AK_ORDER_HIGH_TO_LOW(1), 글자의 대소문자를 무시하는 #AK_ORDER_FOLD_CASE(2). 더해서 조합합니다.
<start>선택 사항. 정렬할 첫 요소의 위치이며 0부터 시작합니다.
<end>선택 사항이지만 <start>와 함께 필수. 정렬할 마지막 요소의 위치이며 포함됩니다.

알아두기

  • 아무것도 반환하지 않습니다. 단독 줄에 쓰세요.
  • 정렬 뒤에는 현재 요소가 없습니다.
  • 알 수 없는 필드는 "Unknown BASIC structure field"로 프로그램을 멈춥니다. 레코드를 담은 필드는 "SortStructuredList requires a numeric or string value"로 멈춥니다.
  • 숫자나 문자열 리스트는 프로그램을 멈춥니다. SortList()를 쓰세요.
  • <start>와 <end>가 없으면 리스트 전체를 씁니다. <start>만 주면 컴파일은 되지만 "BASIC collection range requires start and end"로 프로그램이 멈춥니다. 리스트 밖의 범위는 "BASIC collection range is out of bounds"로 멈춥니다.
  • PureBasic에서 왔다면: 필드는 오프셋과 타입이 아니라 텍스트로 쓴 이름으로 지정합니다.

예제

BASIC
TYPE Foe  name AS string  hp AS integerENDTYPENewList foes.Foe()AddElement(foes())foes().name = "orc"foes().hp = 30AddElement(foes())foes().name = "elf"foes().hp = 10SortStructuredList(foes(), "hp", #AK_ORDER_LOW_TO_HIGH)FOREACH foes()  Console(foes().name + " " + Str(foes().hp))   ' elf 10, orc 30NEXT
매뉴얼에서 : 배열, 리스트, 맵