Group.GetFirst

Signature

Group.GetFirst(Group g) -> Card|nil

Description

Returns the first card in g and resets g's internal iterator to that card. Returns nil when g is empty.

How To Use It

Use GetFirst/GetNext to iterate through a Group when helper iterators are not available.

local tc=g:GetFirst()
while tc do
    -- work with tc
    tc=g:GetNext()
end

GetFirst resets the Group's internal pointer. Starting a second iteration on the same Group resets that pointer again.

Parameters

• g Group

Returns

• Card|nil

Source

• D:\Programs\GitHub\ygopro-core\libgroup.cpp:909

Guided Examples

Learn how to use this function in context:

• Common Script Errors And Debugging
• Conditions, Costs, Activation Procedures, and Resolution
• Filters, Card Objects, and Group Objects
• Selection And Group Handling

Used By

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

• Detected in 3591 indexed script(s).
• Search this function in the Script Explorer with Group.GetFirst.

Card	ID	Script	Detected Calls
Salamandra with Chain	62091148	Scripts/c62091148.lua	2
Astrograph Sorcerer, the Starfrost Magician	48171151	Scripts/c48171151.lua	3
Artmage Non-Finito	74631897	Scripts/c74631897.lua	2
Pendulum Evolution	55795155	Scripts/c55795155.lua	2
Lady's Dragonmaid	48658295	Scripts/c48658295.lua	1
Eternal Favorite	87532344	Scripts/c87532344.lua	2
Surprise Fusion	35167375	Scripts/c35167375.lua	3
Astrograph Sorcerer	76794549	Scripts/c76794549.lua	4
Spellbook of the Grand Circle	11911336	Scripts/c11911336.lua	1
Ultra Polymerization	76647978	Scripts/c76647978.lua	2
Goyo Emperor	59255742	Scripts/c59255742.lua	4
Accel Synchro Stardust Dragon	30983281	Scripts/c30983281.lua	5
Melffy Playtime Surprise	58036097	Scripts/c58036097.lua	1
Ashtraja Susanoo	17020474	Scripts/c17020474.lua	1
Deftero Enneacraft - "alazoneIA"	92171126	Scripts/c92171126.lua	4
Destiny HERO - Destro-Dogma	25158975	Scripts/c25158975.lua	1
Yomagna the Fire Phantom	17350692	Scripts/c17350692.lua	1
Fiendsmith's Sequence	49867899	Scripts/c49867899.lua	1
D/D/D Alfred the Divine Sage King	11852093	Scripts/c11852093.lua	1
El Shaddoll Apkallone	50907446	Scripts/c50907446.lua	4
Mementotlan Fusion	66518509	Scripts/c66518509.lua	1
Meteoroa Drytron	24166324	Scripts/c24166324.lua	1
Favorite HERO Flame Wingman	13243124	Scripts/c13243124.lua	1
Mixousia the Confounder	80843006	Scripts/c80843006.lua	2
...and 3567 more

Script Examples

Salamandra with Chain (62091148)

Source: Scripts/c62091148.lua

			local g=Duel.SelectMatchingCard(tp,s.posfilter,tp,LOCATION_MZONE,LOCATION_MZONE,1,1,nil)
			Duel.HintSelection(g)
			local tc2=g:GetFirst()
			Duel.ChangePosition(tc2,POS_FACEDOWN_DEFENSE)
		end

Astrograph Sorcerer, the Starfrost Magician (48171151)

Source: Scripts/c48171151.lua

	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_TOFIELD)
	local g=Duel.SelectMatchingCard(tp,s.pfilter,tp,LOCATION_HAND+LOCATION_DECK,0,1,1,nil,tp)
	local tc=g:GetFirst()
	if tc and Duel.MoveToField(tc,tp,tp,LOCATION_PZONE,POS_FACEUP,true) then
		local e1=Effect.CreateEffect(c)

Artmage Non-Finito (74631897)

Source: Scripts/c74631897.lua

	Duel.Hint(HINT_SELECTMSG,tp,HINTMSG_SET)
	local g=Duel.SelectMatchingCard(tp,s.setfilter,tp,LOCATION_DECK,0,1,1,nil)
	local tc=g:GetFirst()
	if tc then
		Duel.SSet(tp,tc)