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이다.

About Object Type

Object() 생성자 함수에 의해서 생성이 된 인스턴스이거나 객체 리터럴로 생성된 데이터를 나타낸다.

반환

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

지원 웹브라우저