NATIVE

settings_applicationsObject  >   settings_applicationsIntl  >   settings_applicationsIntl.Collator  >   settings_applicationsConstructor

NATIVE

Editing
  • account_tree
  • bug_report

Intl.CollatorcollatorIntl.Collator(string, Arraylocales, Objectoptions]])

새로운 Intl.Collator 객체를 생성하여 반환한다. new 연산자를 사용하거나 사용하지 않고도 생성자를 호출할 수 있다.

구문

형식
Intl.Collator([locales[, options]])

매개 변수

string, Arraylocales선택

BCP 47 언어 태그 또는 Intl.Locale 인스턴스가 포함된 문자열 또는 이러한 식별값을 원소로 가진 배열을 지정한다.

다음의 확장 키워드가 허용된다. 아래의 확장 키워드와 동일한 설정을 opitions에서도 지정할 수 있다. 만약에 동시에 지정이 되면 options 설정이 우선적으로 적용된다. 

  • co : optionscollation와 동일
  • knoptionsnumeric와 동일
  • kf : optionscaseFirst와 동일
Objectoptions선택

검색된 순서대로 다음 프로퍼티를 갖는 객체를 지정한다.

usage
비교가 문자열 목록의 정렬인지 퍼지(fuzzy)를 기준으로 문자열 목록을 필터링하는지의 여부를 나타낸다. 설정하는 값은 다음과 같다.
  • "sort" : 기본 값이며 문자열 목록을 정렬한다.
  • "search" : 키와 전체 문자열이 일치하는지 각 목록 항목을 테스트하여 문자열 목록을 필터링한다. 정렬을 하기위한 값은 아니다.
localeMatcher
사용할 지역 일치 알고리즘을 다음 중에서 선택할 수 있다.
  • "lookup"
  • "best fit" : 기본 값
collation
특정 지역에 대한 변형 데이터 정렬을 지정한다. 기본 값은 "default" 이다. 지원되는 데이터 정렬 유형 목록은 Intl.Locale.prototype.getCollations() 메소드를 참고한다.
numeric
"1" < "2" < "10"과 같은 숫자 조합을 사용하는지 여부를 불리언(boolean)으로 지정한다. 기본값은 false이다. 
caseFirst
대문자 또는 소문자를 먼저 정렬해야 하는지를 나타내는 값이다. 다음 중에서 지정한다.
  • "upper" : 대문자를 먼저 정렬한다.
  • "lower" : 소문자를 먼저 정렬한다.
  • "fasle" : 지역의 기본값을 사용한다. 기본값이다.
sensitivity
문자열의 어떤 차이가 0(false)이 아닌 결과값으로 나와야 하는지를 지정한다. 기본값은 usage 값이 "sort"이면 "variant"이고 "search"이면 "base"가 기본이다.
  • "base" : 기본 문자가 전혀 다른 문자와 같지 않은 것으로만 비교한다.(예: "a" != "b", "a" == "á", "a" == "A")
  • "accent" : 기본 문자나 액센트 및 기타 분음 부호가 다른 문자열만 같지 않은 것으로 비교한다. (예: "a" != "b", "a" != "á", "a" == "A")
  • "case" :  기본 문자 또는 대소문자가 다른 문자열만 같지 않은 것으로 비교한다. (예: "a" != "b", "a" == "á", "a" != "A")
  • "variant" : 기본 문자, 액센트 및 기타 발음 부호 또는 대소문자가 다른 문자열은 같지 않은 것으로 비교한다. (예:  "a" != "b", "a" != "á", "a" != "A")
ignorePunctuation
문장 부호를 무시할지 여부를 블리언(boolean)으로 지정한다. 기본값은 false이다.

반환

Intl.Collatorcollator

새로운 Intl.Collator 객체가 반환된다.

매개변수가 바르지 못하면 RangeError 예외가 발생한다.

Exception

RangeError

어떤 값이 집합 구조에 없거나 허용되는 범위가 아닐 때 오류를 다루는 객체이다.

상속 계층 탐색

Function

  • Properties

    • arguments

      함수에 전달된 인수를 조회한다. 유사 배열로 참조되며 인덱스로 접근이 가능하다.

    • caller

      지정된 함수를 호출한 함수를 참조한다. strict 모드에서는 사용할 수 없다.

    • length

      함수에 사용 되고 있는 인수의 개수를 조회한다.

    • name

      함수 이름을 조회한다.

    • prototype

      생성자 함수(constructor function)에 의해 생성된 인스턴스(instance)에게 상속되어지는 생성자의 프로토타입을 나타낸다.

  • Methods

    • apply()

      지정된 this와 제공된 인수를 가진 배열 또는 유사 배열로 함수를 호출한다.

    • bind()

      원본 함수와 동일한 본문을 갖는 바인딩된 함수를 만든다. this 키워드가 있는 경우 실제로 자신을 참조할 수 있도록 활성화된다.

    • call()

      인수를 지정하여 함수를 호출한다.

    • toString()

      함수의 소스 코드를 반환한다.

Object

  • Methods

    • hasOwnProperty()

      객체가 특정 프로퍼티를 가지고 있는지를 블린(boolean) 값으로 반환한다.

    • isPrototypeOf()

      해당 객체가 다른 객체의 프로토타입 체인에 속한 객체인지를 체크한다.

    • propertyIsEnumerable()

      매개 변수의 속성이 열거가능(enumerable)한지 여부를 체크한다.

    • toLocaleString()

      객체를 나타내는 문자열을  작동하는 지역(locale)의 방식으로 출력이 된다.

    • toString()

      객체를 나타내는 문자열을 반환한다.

    • valueOf()

      객체의 원시(primitive) 값을 반환한다.

  • Properties

    • constructor

      객체의 생성자 함수를 참조한다.

    • __proto__

      상속된 [[Prototype]] 참조하거나 설정가능하며 일반적으로 실제 코드상에서는 잘 사용되지 않는다. ECMAScript에서 사용되지 않는 비표준이지만 최신 웹브라우저에서는 비공식적으로 지원하고 있다. 따라서 곧 표준 속성으로 지원될 확률이 높다.

      현재는 표준 사양에 명시되었다.

버전 명세

ECMAScript Internationalization API Specification
#sec-the-intl-collator-constructor

지원 웹브라우저