Conditions.equipment.matches

호출 방법

Conditions.equipment.matches(value, record)

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

하는 일

Tests one equipment slot record against a WEAPON_TYPE condition: empty slot, shield, any weapon, holdable, one-hand, two-hand, ranged, or a specific weapon subclass. Returns nil with a reason when the item's class or equip location is not known yet.

인수

이름	유형	하는 일
`value`	`table`	Condition settings: kind (empty, shield, weapon, holdable, onehand, twohand or ranged) or a weapon subclass ID in subclass.
`record`	`table \| boolean`	Slot record with classID, subClassID, equipLoc and an optional typeReason, or false for an empty slot.

반환값

1	`boolean \| nil`	Whether the slot matches, or nil when it cannot be decided.
2	`string \| nil`	Reason for nil: the record's typeReason, item-data-unavailable or invalid-weapon-type.

버전

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

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

애드온에서 호출하는 방식

무기 유형 (evaluate)
```
return matches(value, record)
```

의존성

ARMOR_CLASS (builtin:Conditions/equipment.lua:ARMOR_CLASS)
ONEHAND (builtin:Conditions/equipment.lua:ONEHAND)
RANGED (builtin:Conditions/equipment.lua:RANGED)
SHIELD_SUBCLASS (builtin:Conditions/equipment.lua:SHIELD_SUBCLASS)
WEAPON_CLASS (builtin:Conditions/equipment.lua:WEAPON_CLASS)

소스

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

Conditions.equipment.matches(value, record)

    if record == false then return value.kind == "empty" end
    if value.kind == "empty" then return false end
    if record.classID == nil then return nil, record.typeReason or "item-data-unavailable" end
    if value.subclass ~= nil then
        return record.classID == WEAPON_CLASS and record.subClassID == value.subclass
    end
    local kind = value.kind
    if kind == "shield" then return record.classID == ARMOR_CLASS and record.subClassID == SHIELD_SUBCLASS end
    if kind == "weapon" then return record.classID == WEAPON_CLASS end
    if record.equipLoc == nil then return nil, "item-data-unavailable" end
    if kind == "holdable" then return record.equipLoc == "INVTYPE_HOLDABLE" end
    if record.classID ~= WEAPON_CLASS then return false end
    if kind == "onehand" then return ONEHAND[record.equipLoc] == true end
    if kind == "twohand" then return record.equipLoc == "INVTYPE_2HWEAPON" end
    if kind == "ranged" then return RANGED[record.equipLoc] == true end
    return nil, "invalid-weapon-type"

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