호출 방법
addon.Platform:GetRangeCheckBounds(unit)
addon을 통해 바로 쓸 수 있으며, 의존성이 필요 없습니다.
하는 일
유닛에 대한 공개 LibRangeCheck 구간을 읽습니다. 성공한 상한은 포함 범위이고, 실패한 양의 하한은 엄격한 범위입니다. 하한 0은 인위적인 값입니다. 어느 쪽도 정확한 거리가 아니며, 상한이 없다고 유닛이 모든 반경 밖에 있다는 증거는 아닙니다. 사용할 수 없거나 잘못되거나 제한되거나 실패한 관찰은 nil과 이유를 반환합니다.
인수
| 이름 | 유형 | 하는 일 |
|---|---|---|
self | RMPlatform | Rotation Master 플랫폼 어댑터 (콜론 호출에서는 암묵적). |
unit | string | 플레이어와의 거리를 관찰할 현재 유닛 토큰. |
반환값
| 1 | table | nil | 선택적인 최소, 최대 범위(미터)를 가진 읽을 수 있는 구간. 범위가 하나 이상 있으며, 사용할 수 없으면 nil. |
|---|---|---|
| 2 | string | nil | nil 결과에 대한 사용 불가 또는 검증 이유. |
버전
기본 제공 도우미는 모든 버전에 등록됩니다. 다른 점은 읽는 게임 API이며, API가 없으면 도우미는 대체 동작을 하거나 이유와 함께 nil을 반환합니다.
게임 API를 직접 읽지 않습니다.
비공개 값 (Retail과 Forever)
Retail과 Forever에서는 게임이 애드온에 비공개 값을 넘깁니다. 이 도우미는 읽는 값을 확인하고(addon.Platform:CanReadValue), 비교할 수 없는 비공개 값 대신 restricted-value 같은 이유와 함께 nil을 반환합니다. nil은 거짓이 아니라 사용할 수 없음으로 취급하세요.
예시
local bounds = addon.Platform:GetRangeCheckBounds("target")
if not bounds then return nil end
if bounds.maximum and bounds.maximum <= 8 then return true end
if bounds.minimum and bounds.minimum >= 8 then return false end
return nil -- the interval straddles 8 yards소스
Platform/range.lua, 129번째 줄. 게임에서는 읽기 전용이며, 복제하면 편집 가능한 사본이 생깁니다.
Platform.range.GetRangeCheckBounds(self, unit)
if not self:CanReadValue(unit) then return nil,'restricted-value' end
if type(unit)~='string' or unit=='' then return nil,'invalid-unit' end
if not LibStub then return nil,'missing-range-provider' end
local loaded,provider=pcall(function() return LibStub('LibRangeCheck-3.0',true) end)
if not loaded or not provider or type(provider.GetRange)~='function' then return nil,'missing-range-provider' end
local ok,minimum,maximum=pcall(provider.GetRange,provider,unit)
if not ok then return nil,'range-provider-error' end
if not self:CanReadValue(minimum) or not self:CanReadValue(maximum) then return nil,'restricted-value' end
for _,bound in pairs({minimum=minimum,maximum=maximum}) do
if type(bound)~='number' or bound~=bound or bound<0 or bound==math.huge then return nil,'invalid-range-result' end
end
if minimum==nil and maximum==nil then return nil,'range-unavailable' end
if minimum and maximum and minimum>maximum then return nil,'invalid-range-result' end
return {minimum=minimum,maximum=maximum}