레퍼런스 › 함수 레퍼런스 › Platform

Platform.mobinfo2.readField

의존성

호출 방법

Platform.mobinfo2.readField(self, object, key)

의존성 Platform.mobinfo2.readField을(를) 기록한 뒤 그 이름으로 호출하세요. 네임스페이스 호출은 self를 넘기지 않으므로 콜론 호출을 쓰거나 객체를 직접 넘기세요.

하는 일

Reads object[key] in protected mode for MobInfo2 data. Returns the value (possibly nil), or nil with "restricted-value" when the object or the value is secret, "invalid-mobinfo2-data" when object is not a table, or "mobinfo2-data-error" when indexing raises an error.

인수

이름유형하는 일
selfRMPlatformRotation Master platform adapter (normally addon.Platform), used for its CanReadValue check.
objecttableTable to index; any other type is rejected.
keyanyField name to read.

반환값

1anyThe field value, possibly nil; nil on failure.
2string | nilReason on failure; nil on success.

버전

기본 제공 도우미는 모든 버전에 등록됩니다. 다른 점은 읽는 게임 API이며, API가 없으면 도우미는 대체 동작을 하거나 이유와 함께 nil을 반환합니다.

게임 API를 직접 읽지 않습니다.

비공개 값 (Retail과 Forever)

Retail과 Forever에서는 게임이 애드온에 비공개 값을 넘깁니다. 이 도우미는 읽는 값을 확인하고(addon.Platform:CanReadValue), 비교할 수 없는 비공개 값 대신 restricted-value 같은 이유와 함께 nil을 반환합니다. nil은 거짓이 아니라 사용할 수 없음으로 취급하세요.

애드온에서 호출하는 방식

소스

Platform/mobinfo2.lua, 29번째 줄. 게임에서는 읽기 전용이며, 복제하면 편집 가능한 사본이 생깁니다.

Platform.mobinfo2.readField(self, object, key)
    if not self:CanReadValue(object) then return nil,'restricted-value' end
    if type(object)~='table' then return nil,'invalid-mobinfo2-data' end
    local ok,value=pcall(function() return object[key] end)
    if not ok then return nil,'mobinfo2-data-error' end
    if not self:CanReadValue(value) then return nil,'restricted-value' end
    return value

함수 레퍼런스(으)로 돌아가기