모듈:Road data/parser/hooks/설명문서

위키백과, 우리 모두의 백과사전.

이 모듈에는 모듈:Road data/parser 및 관련 문자열 모듈에 추가 기능을 제공하는 후크 기능이 포함되어 있습니다.

기본[편집]

각 후크는 이 모듈에서 내보낸 p 패키지 테이블에 저장된 함수입니다. 각 함수는 두 개의 인수를 수용합니다.:

  • parameters: 후크를 참조하는 문자열 모듈의 테이블입니다. 이 예시에서 이 인수는 유형 테이블의 shield 필드에 저장된 테이블입니다.(모듈:Road data/strings/USA/KY의 경우):
KY["KY 1966"] = {shield = {hook = "split",
                           split = 100,
                           below = "Elongated circle %route%.svg", 
                           above = "Circle sign %route%.svg"},
                 link = KY.KY.link,
                 abbr = KY.KY.abbr}
  • args: 이 인수는 원래 구문 분석에 전달됩니다.

후크는 단순히 계산된 값과 동일한 새 키를 설정함으로써 인수 테이블를 수정할 수 있습니다. 기존 값을 수정할 수는 있지만 권장하지 않습니다.

후크의 반환 값은 일반적인 형식 문자열로, 함수 내에서 계산하거나 parameters 인수에서 가져올 수 있습니다. 일반적으로 후크가 반환할 형식 문자열을 계산하지 않을 경우, 후크는 parameters.default를 반환해야 하며, 이는 형식 문자열과 같아야 합니다.

후크[편집]

split[편집]

이 후크는 노선 번호가 특정 번호보다 위인지 아래인지에 따라 구문 분석이 사용할 형식 문자열을 결정합니다.

매개변수:

  • split: 분할할 번호.
  • below: 노선 번호가 split 이하인 경우 사용할 형식 문자열.
  • above: 노선 번호가 split 이상인 경우 사용할 형식 문자열.

splitlen[편집]

이 고리는 split와 유사한 방식으로 작동하지만, 지정 값 대신 노선 번호의 길이를 검사합니다.

매개변수:

  • split: 분할할 길이.
  • below: 노선 번호의 길이가 split 이하인 경우 사용할 형식 문자열.
  • above: 노선 번호의 길이가 split 이상인 경우 사용할 형식 문자열.

between[편집]

이 후크는 노선 번호가 두개의 지정된 번호 사이에 있는지 여부에 따라 구문 분석이 사용할 형식 문자열을 결정합니다.

매개변수:

  • lower: 시험의 하위(포함).
  • upper: 시험의 상위(제외).
  • yes: 노선 번호가 lowerupper 사이인 경우 사용할 형식 문자열.
  • no: 노선 번호가 lowerupper 사이에 있지 않은 경우 사용할 형식 문자열.

mask[편집]

이 후크는 제공된 마스크를 특정 인수에 적용한 결과에 따라 args 테이블에 인수를 추가합니다.

매개변수:

  • base: 마스크될 인수.
  • masked: 마스크 결과를 args 테이블에 저장하는 데 사용되는 키입니다.
  • mask: "Module:" 접두사가 없이 마스크로 사용할 모듈의 이름. 모듈은 base 인수를 argsmasked 필드에 저장된 값에 매핑하는 테이블을 반환해야 합니다.
  • default: 구문 분석이 처리할 형식 문자열. 이 문자열은 이 후크에 의해 인수에 저장된 인수를 참조 할 수 있습니다

padroute[편집]

이 후크는 노선 번호를 0으로 표시하여 노선 번호가 특정 자릿수를 갖도록 합니다.

매개변수:

  • paddedLength: 노선 번호를 0으로 채워야하는 길이.
  • default: 구문 분석이 처리할 형식 문자열. 이 문자열은 0으로 채워진 노선 번호를 paddedRoute 인수로 참조할 수 있습니다.

lowercase[편집]

이 후크는 노선"number(번호)"를 소문자로 변환합니다.

매개변수:

  • default: 구문 분석이 처리할 형식 문자열. 이 문자열은 하단 구획된 소문자 노선 번호를 lowercase 인수로 참조할 수 있습니다.

startswith[편집]

이 후크는 특정 인수가 지정된 패턴 중 하나에서 시작하는지 여부를 결정하고 일치하는 패턴과 관련된 값을 반환합니다.

매개변수:

  • base: 시험할 인수.
  • startPatterns: 시작 패턴의 키값 쌍과 일치 항목이 발견될 경우 반환할 값.
  • default: 일치하는 항목이 없는 경우 반환할 값.