구문
레코드 리스트를 레코드의 한 필드를 기준으로 제자리에서 정렬합니다.
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매뉴얼에서 : 배열, 리스트, 맵