Duel.GetFlagEffect

Signature

Duel.GetFlagEffect(int player, int code) -> int|nil

Description

Returns how many player flag effects with code are registered on player. The return value is a count, not a boolean; compare it with 0 when testing whether a player marker exists.

How To Use It

Use this to count matching player markers.

if Duel.GetFlagEffect(tp,id)==0 then
    Duel.RegisterFlagEffect(tp,id,RESET_PHASE+PHASE_END,0,1)
end

The return value is a count. Use Duel.GetFlagEffectLabel when the marker's label value matters.

Related Functions

• Duel.RegisterFlagEffect
• Duel.GetFlagEffectLabel
• Duel.ResetFlagEffect

Parameters

• player int - Player whose flag effects are counted.
• code int - Flag-effect code; the core masks it with MAX_CARD_ID and adds EFFECT_FLAG_EFFECT.

Returns

• int|nil - Number of matching player flag effects, or nil if player is invalid.

Source

• D:\Programs\GitHub\ygopro-core\libduel.cpp:4854

Guided Examples

Learn how to use this function in context:

• Flag Effects

Used By

Generated from the local Scripts/ folder and cards.cdb.

• Detected in 349 indexed script(s).
• Search this function in the Script Explorer with Duel.GetFlagEffect.

Card	ID	Script	Detected Calls
Artmage Non-Finito	74631897	Scripts/c74631897.lua	2
Pendulum Evolution	55795155	Scripts/c55795155.lua	1
Eternal Favorite	87532344	Scripts/c87532344.lua	2
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Mementotlan Fusion	66518509	Scripts/c66518509.lua	3
Favorite HERO Flame Wingman	13243124	Scripts/c13243124.lua	1
Gem-Knight Dispersion	24220368	Scripts/c24220368.lua	3
Magnet Bonding	65514302	Scripts/c65514302.lua	3
Hecahands Tartaros	57809669	Scripts/c57809669.lua	2
Enneacraft - Archa.TAIL	81237046	Scripts/c81237046.lua	1
D/D/D/D Dimensional King Arc Crisis	71398055	Scripts/c71398055.lua	2
Shining Draw	35906693	Scripts/c35906693.lua	1
Barian's Chaos Draw	97769122	Scripts/c97769122.lua	1
Ultimate Crystal Rainbow Dragon Overdrive	84544192	Scripts/c84544192.lua	1
Ashened to Endlessness	34813443	Scripts/c34813443.lua	1
Penetration Fusion	8778267	Scripts/c8778267.lua	1
Fiendsmith Kyrie	26434972	Scripts/c26434972.lua	1
Chef de Nouvelles	29251488	Scripts/c29251488.lua	2
Artmage Pact -Awakening-	23599634	Scripts/c23599634.lua	1
Hunting Horn	55421040	Scripts/c55421040.lua	1
Echelon of the Fire Kings	38798785	Scripts/c38798785.lua	1
Double Interlock	38129297	Scripts/c38129297.lua	3
Mementotlan Shleepy	50042011	Scripts/c50042011.lua	1
K9-X Forced Release	53792930	Scripts/c53792930.lua	1
...and 325 more

Script Examples

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

end
function s.splimit(e,se,sp,st)
	return bit.band(st,SUMMON_TYPE_FUSION)==SUMMON_TYPE_FUSION and Duel.GetFlagEffect(sp,id)==0
end
function s.condition(e,tp,eg,ep,ev,re,r,rp)

Pendulum Evolution (55795155)

Source: Scripts/c55795155.lua

end
function c55795155.pcon(e,tp,eg,ep,ev,re,r,rp)
	return Duel.GetFlagEffect(tp,55795155)>0
end
function c55795155.ptg(e,tp,eg,ep,ev,re,r,rp,chk)

Eternal Favorite (87532344)

Source: Scripts/c87532344.lua

end
function s.sptg(e,tp,eg,ep,ev,re,r,rp,chk)
	if chk==0 then return Duel.GetFlagEffect(tp,id)==0 and Duel.GetLocationCount(tp,LOCATION_MZONE)>0
		and Duel.IsExistingMatchingCard(s.spfilter,tp,LOCATION_GRAVE+LOCATION_REMOVED,0,1,nil,e,tp) end
	Duel.Hint(HINT_OPSELECTED,1-tp,e:GetDescription())