정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Intl.Collator 개체(JavaScript)

로캘별 문자열 비교를 제공합니다.

collatorObj = new Intl.Collator([locales][, options])

collatorObj

필수 요소. Collator 개체를 할당할 변수 이름입니다.

locales

선택 사항입니다. 하나 이상의 언어 또는 로캘 태그를 포함한 로캘 문자열의 배열입니다. 두 개 이상의 로캘 문자열을 포함하는 경우, 첫 번째 항목이 기본 설정 로캘이 되도록 우선 순위를 내림차순으로 나열합니다. 이 매개 변수를 생략하면 JavaScript 런타임 기본 로캘이 사용됩니다. 자세한 내용은 설명 부분을 참조하십시오.

options

선택 사항입니다. 비교 옵션을 지정하는 하나 이상의 속성을 포함하는 개체입니다. 자세한 내용은 설명 부분을 참조하십시오.

locales 매개 변수는 BCP 47 언어 또는 "en-US" 또는 "zh-Hans-CN"과 같은 로캘 태그를 따라야 합니다. 태그에는 언어, 지역, 국가 및 변수가 포함될 수 있습니다. 언어 목록을 보려면 IANA 언어 하위 태그 레지스트리를 참조하십시오. 언어 태그의 예를 보려면 BCP 47의 Appendix A를 참조하십시오. Collator의 경우 로캘 문자열에 -u 확장을 포함시켜 다음 Unicode 확장명 중 1개 이상을 지정할 수 있습니다.

  • 변형 데이터 정렬을 지정하려는 경우 -co(로캘에 따라 다름): "language-region-u-co-value".

  • 숫자 비교를 지정하는 -kn: "language-region-u-kn-true|false".

  • 첫 번째 대문자 또는 소문자를 정렬할지 여부를 지정하는 –kf: "language-region-u-kf-upper|lower|false"). 이 확장은 현재 지원되지 않습니다.

숫자 비교를 지정하려면 로캘 문자열에 –kn 확장을 설정하거나 options 매개 변수의 numeric 속성을 사용합니다. numeric 속성을 사용 중인 경우 –kn 값이 적용되지 않습니다.

options 매개 변수는 다음 속성을 포함할 수 있습니다.

  • localeMatcher . 사용할 로캘 일치 알고리즘을 지정합니다. 가능한 값은 "조회" 및 "최적"입니다. 기본값은 "best fit"입니다.

  • usage . 비교의 목표가 정렬인지 또는 검색인지를 지정합니다. 가능한 값은 "정렬" 및 "검색"입니다. 기본값은 "sort"입니다.

  • sensitivity . 병합기의 민감도 지정합니다. 가능한 값은 "기본", "악센트", "사례" 및 "변형"입니다. 기본값은 undefined입니다.

  • ignorePunctuation . 비교에서 문장 부호가 무시되는지 여부를 지정합니다. 가능한 값은 "true"와 "false"뿐입니다. 기본값은 false입니다.

  • numeric . 숫자 정렬을 사용할지 여부를 지정합니다. 가능한 값은 "true"와 "false"뿐입니다. 기본값은 false입니다.

  • caseFirst . 현재 지원되지 않습니다.

다음 표에서는 Collator 개체의 속성을 보여 줍니다.

속성

설명

compare

병합기의 정렬 순서를 사용해서 두 문자열을 비교하는 함수를 반환합니다.

생성자

수집기를 만드는 함수를 지정합니다.

프로토타입(Prototype)

병합기의 프로토타입에 대한 참조를 반환합니다.

다음 표에서는 Collator 개체의 메서드를 보여 줍니다.

방법

설명

resolvedOptions

병합기의 속성과 값이 들어 있는 개체를 반환합니다.

다음 예제는 Collator 개체를 만들고 비교를 수행합니다.

var co = new Intl.Collator(["de-DE"]);
co.compare("a", "b"); // Returns -1

다음 예제는 Collator 개체를 이용하여 배열을 정렬합니다. 이 예제에는 로캘별 차이가 표시됩니다.

var co1 = new Intl.Collator(["de-DE-u-co-phonebk"]);
var co2 = new Intl.Collator(["de-DE"]);
var co3 = new Intl.Collator(["en-US"]);

var arr = ["ä", "ad", "af", "a"];

if (console && console.log) {
    console.log(arr.sort(co1.compare));  // Returns a,ad,ä,af
    console.log(arr.sort(co2.compare));  // Returns a,ä,ad,af
    console.log(arr.sort(co3.compare));  // Returns a,ä,ad,af
}

다음 예제는 Collator 개체를 사용하여 문자열을 검색하고 비교 옵션을 지정합니다.

// String to search
var arr = ["ä", "ad", "af", "a"];
// String searched for
var s = "af";

var co = new Intl.Collator("de-DE", { usage: "search" });
var matches = arr.filter(function (i) {
    return co.compare(i, s) === 0;
});

if (console && console.log) {
    console.log(matches);  // Returns af
}

지원되는 문서 모드: Internet Explorer 11 표준. 스토어 앱에서도 지원됩니다(Windows 8.1 및 Windows Phone 8.1). 버전 정보를 참조하십시오.

지원되지 않는 문서 모드: Quirks, Internet Explorer 6 표준, Internet Explorer 7 표준, Internet Explorer 8 표준, Internet Explorer 9 표준, Internet Explorer 10 표준. Windows 8에서는 지원되지 않습니다.

커뮤니티 추가 항목

표시:
© 2014 Microsoft