Instructions/Match: Difference between revisions

Match

     Filters the passed unit


Lua ID	match
Category	Unit
Icon	Compare Values.png
Argument One: Type	Input
Argument One: Name	Unit
Argument One: Description	Unit to Filter, defaults to Self
Argument One: Data Type	entity
Argument Two: Type	Input
Argument Two: Name	Filter
Argument Two: Description	Filter to check
Argument Two: Data Type	radar
Argument Three: Type	Input
Argument Three: Name	Filter
Argument Three: Description	Second Filter
Argument Three: Data Type	radar
Argument Four: Type	Input
Argument Four: Name	Filter
Argument Four: Description	Third Filter
Argument Four: Data Type	radar
Argument Five: Type	Exec
Argument Five: Name	Failed
Argument Five: Description	Did not match filter

Description[edit | edit source]

Filters the input entity and if it matches all specified filters, the instruction will proceed through the top pin.

Uses[edit | edit source]

If used in conjunction with Loop Entities (Range), this instruction can be used to verify if a given entity matches filters in the same manner as a radar. This may be faster due to radar requiring game ticks to operate.

Similar Instructions[edit | edit source]

Loop Signal (Match), Radar

Instructions
Unit	Check Altitude:Check Battery:Check Blightness:Check Grid Efficiency:Check Health:Clear All Links:Clear Link:Connect:Count Items:Count Slots:Disable Transport Route:Disconnect:Drop Off Items:Enable Transport Route:Equip Component:First Item:Fix Item Slots:Get Active Order:Get Closest Entity:Get Closest Unit:Get First Locked Id:Get Inventory Item:Get Item Info:Get Unit Info:Get Unit Power Info:Get Unit Type:Inventory Total:Is Docked:Is Equipped:Is Fixed:Is Inside Logistics Network:Is Moving:Is Same Grid:Is Unit A:Lock Itemslot:Loop Nearby Resources:Match:Order to Shared Storage:Order Transfer To:Package All:Pick Up Items:Read Radio:Read Signal:Request Item:Request Wait:Set Link:Solve Explorable:Sort Storage:Switch:Turn Off:Turn On:Unequip Component:Unfix Item Slots:Unlock Itemslot:Unpackage All
Move	Move Unit (Range):Attack Move:Is Passable:Move Away (Range):Move East:Move North:Move South:Move Unit:Move Unit (Async)*:Move West:Scout:Scout Range:Stop Unit
Component	Deploys held unit:Mine:Radar:Set Signpost
Flow	Loop Signal:Break:call:Call:Clear Research:Compare Entity:Compare Item:Compare Register:Compare Unit:Data type switch:Exit:Get Max Stack:Get Research:Get Research Requirement:Have Item:Is a:Is Empty:Is Unlocked:Jump:Label:Lock:Loop Components:Loop Entities (Range):Loop Inventory Slots:Loop Number:Loop Producers:Loop Recipe Ingredients:Loop Research:Loop Research Ingredients:Loop Research Unlocks:Loop Signal (Match):Loop Units (Range):Restart:Select Nearest:Set Research:Unit Type:Unlock:Wait Ticks
Math	Add:Check space for item:Combine Coordinate:Combine Register:Compare Number:Copy:Divide:Get Battery:Get Entity At:Get Equipped Num:Get from Component:Get Grid Efficiency:Get Health:Get Resource Num:Get Self:Get Shield:Get space for item:Get Unit At:Is Working:Modulo:Multiply:Random Coordinate:Random Number:Separate Coordinate:Separate Register:Set Number:Set to Component:Subtract
Global	Abort Construction:Can Produce:DebugPrint:Distance:Faction Item Amount:Get Home:Get Ingredients:Get Location:Get Season:Get Stability:Get Trust:Get Type:Is Day/Night:Land:Launch:Lookat:Notify:Percent:Pings a Unit:Place Construction:Produce Registered Unit:Produce Unit:Read Key:Remap:Resource Type

@@ Line 3: / Line 3: @@
 ==== Description ====
+Filters the input entity and if it matches all specified filters, the instruction will proceed through the top pin.
 ==== Uses ====
+If used in conjunction with [[Instructions/Loop Entities (Range)|Loop Entities (Range)]], this instruction can be used to verify if a given entity matches filters in the same manner as a radar. This may be faster due to radar requiring game ticks to operate.
 ==== Similar Instructions ====
+[[Instructions/Loop Signal (Match)|Loop Signal (Match)]], [[Instructions/Radar|Radar]]
 {{Instruction_Bottom}}

Latest revision as of 16:48, 22 September 2023

Description[edit | edit source]

Uses[edit | edit source]

Similar Instructions[edit | edit source]