Documentation: getEnumerationContent Function in intlayer
설명:
getEnumerationContent 함수는 열거 객체의 미리 정의된 조건에 따라 특정 수량에 해당하는 콘텐츠를 검색합니다. 조건은 키로 정의되며, 그 우선 순위는 객체 내에서의 순서에 의해 결정됩니다.
매개변수:
enumerationContent: QuantityContent<Content>
- 설명: 키가 조건을 나타내는 객체(예: <=, <, >=, =)와 값이 해당 콘텐츠를 나타냅니다. 키의 순서가 일치 우선 순위를 정의합니다.
- 유형: QuantityContent<Content>
- Content는 모든 유형일 수 있습니다.
quantity: number
- 설명: enumerationContent의 조건에 대해 일치시키기 위해 사용되는 숫자 값입니다.
- 유형: number
반환값:
- 유형: Content
- 설명: enumerationContent에서 첫 번째로 일치하는 조건에 해당하는 콘텐츠입니다. 일치하는 항목이 없으면 구현에 따라 기본 처리(예: 오류 또는 백업 콘텐츠)가 수행됩니다.
예제 사용법:
기본 사용법:
typescript
import { getEnumerationContent } from "intlayer";const content = getEnumerationContent( { "<=-2.3": "당신은 -2.3보다 적습니다.", "<1": "당신은 하나보다 적습니다.", "2": "당신은 두 개를 가지고 있습니다.", ">=3": "당신은 세 개 이상을 가지고 있습니다.", }, 2);console.log(content); // 출력: "당신은 두 개를 가지고 있습니다."
조건의 우선 순위:
typescript
import { getEnumerationContent } from "intlayer";const content = getEnumerationContent( { "<4": "당신은 네 개보다 적습니다.", "2": "당신은 두 개를 가지고 있습니다.", }, 2);console.log(content); // 출력: "당신은 네 개보다 적습니다."
엣지 케이스:
일치하는 조건이 없음:
- 제공된 수량과 일치하는 조건이 없으면, 함수는 undefined를 반환하거나 기본/백업 시나리오를 명시적으로 처리합니다.
모호한 조건들:
- 조건이 겹치는 경우, 첫 번째 일치하는 조건(객체 순서 기준)이 우선합니다.
유효하지 않은 키:
- 함수는 enumerationContent의 모든 키가 유효하고 조건으로 구문 분석 가능하다고 가정합니다. 유효하지 않거나 잘못 형식화된 키는 예기치 않은 동작을 초래할 수 있습니다.
TypeScript 강제성:
- 함수는 Content 유형이 모든 키에서 일관되도록 보장하여 검색된 콘텐츠에서 유형 안전성을 제공합니다.
주의 사항:
- findMatchingCondition 유틸리티는 주어진 수량을 기반으로 적절한 조건을 결정하는 데 사용됩니다.
이 문서를 개선할 아이디어가 있으시면 GitHub에 풀 리퀘스트를 제출하여 자유롭게 기여해 주세요.
문서에 대한 GitHub 링크