ㅎ 한글스크립트0.8 문서

정렬 함수

정렬 기능의 입력·반환값·예제·원본 변경 여부. 기본 이름은 같은 파일의 최상위 선언에서 중복 정의하지 마세요. 타입 표기는 내부 TypeScript 서명이며 실행 예제는 문장형 HGS입니다.

정렬

정렬

새 목록을 숫자 크기 또는 한국어 문자열 순서로 정렬합니다. 비교 함수를 전달할 수도 있습니다.

정렬<T extends number | string>(값: readonly T[]): T[]
정렬<T>(값: readonly T[], 비교: (가: T, 나: T) => number): T[]

원본 유지. 안정 정렬. 서로 다른 타입 혼합·비유한 숫자는 기본 정렬에서 오류

출력(정렬([3, 1, 2]))
실행 화면에서 열기 ↗

정렬

오름차순

작은 숫자·앞서는 문자열부터 정렬합니다.

오름차순<T extends number | string>(값: readonly T[]): T[]

원본 유지. 문자열은 한국어 locale, 숫자 문자열 자연 정렬

출력(오름차순([3, 1, 2]))
실행 화면에서 열기 ↗

정렬

내림차순

큰 숫자·뒤서는 문자열부터 정렬합니다.

내림차순<T extends number | string>(값: readonly T[]): T[]

원본 유지. 같은 키의 원래 순서 유지

출력(내림차순([3, 1, 2]))
실행 화면에서 열기 ↗

정렬

기준정렬

각 항목의 기준값으로 정렬합니다.

기준정렬<T>(값: readonly T[], 기준: (항목: T) => number | string, 방향: "오름차순" | "내림차순" = "오름차순"): T[]

기준 함수는 항목마다 한 번 호출. 원본 유지. 세 번째 인자는 오름차순 또는 내림차순

사람들은 [{ 이름: "나", 나이: 30 }, { 이름: "가", 나이: 20 }]이다
출력(기준정렬(사람들, 사람 => 사람.나이))
실행 화면에서 열기 ↗