# Unit From Unit Group
Grammar — Unit i from g|Unit Group
Flags —Native|Function
Returns a specific unit, by index, from the unit group. Use the “Number Of Units In Unit Group” function to determine how many units are in the unit group.
# Arguments
unitgroup— Groupint— Index
Returns — unit
native unit UnitGroupUnit(unitgroup inGroup, int inIndex);
# Related
Category: Unit Group / Groups
- [F] —
void— Add Unit To Unit Group — ( UnitGroupAdd ) - [F] —
void— Add Unit Group To Unit Group Old — ( libNtve_gf_AddUnitGroupToUnitGroup ) - [F] —
void— Add Unit Group To Unit Group — ( UnitGroupAddUnitGroup ) - [F] —
void— Unit Object Group Call For Help — ( UnitObjectGroupCallForHelp ) - [F] —
void— Remove Unit From Unit Group — ( UnitGroupRemove ) - [F] —
void— Remove Unit Group From Unit Group Old — ( libNtve_gf_RemoveUnitGroupFromUnitGroup ) - [F] —
void— Remove Unit Group From Unit Group — ( UnitGroupRemoveUnitGroup ) - [F] —
void— Remove All Units From Unit Group — ( UnitGroupClear ) - [F] —
void— Pause All Units In Unit Group — ( UnitGroupPauseAll ) - [F] —
int— Create Unit Object Group From Unit Group — ( UnitObjectGroupFromUnitGroup ) - [F] —
int— Number Of Units In Unit Group — ( UnitGroupCount ) - [F] —
bool— Unit In Unit Group — ( UnitGroupHasUnit ) - [F] —
unit— Unit From Unit Group — ( UnitGroupUnit ) - [F] —
unit— Random Unit From Unit Group — ( UnitGroupRandomUnit ) - [F] —
unitgroup— Copy Of Unit Group — ( UnitGroupCopy ) - [F] —
unit— Closest Unit To Point Old — ( libNtve_gf_ClosestUnitToPoint ) - [F] —
unit— Closest Unit To Point — ( UnitGroupClosestToPoint ) - [F] —
point— Center Of Unit Group Old — ( libNtve_gf_CenterOfUnitGroup ) - [F] —
point— Center Of Unit Group — ( UnitGroupCenterOfGroup )
# Examples
# campaigns/liberty.sc2campaign
// L60
UnitGroupUnit(threatGroup, numPossibleThreats)
// L87
UnitGroupUnit(barrageThreatGroup, numPossibleThreatsInBarrage)
// L133
UnitGroupUnit(scanGroup, loop)
// L353
UnitGroupUnit(scanGroup, scanCount)
# campaigns/liberty.sc2campaign
// L2077
UnitGroupUnit(UnitGroup("SupplyDepot", gv_pLAYER_USER, RegionCircle(PointFromId(105), 2.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L932
UnitGroupUnit(UnitGroup("Overseer", gv_pLAYER_COMPUTER1, RegionFromId(1), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L933
UnitGroupUnit(UnitGroup("Overseer", gv_pLAYER_COMPUTER1, RegionFromId(2), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L934
UnitGroupUnit(UnitGroup("Overseer", gv_pLAYER_COMPUTER1, RegionFromId(3), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L633
UnitGroupUnit(auto49A2DDD7_g, auto49A2DDD7_u)
// L634
UnitGroupUnit(auto49A2DDD7_g, auto49A2DDD7_u)
// L642
UnitGroupUnit(auto6B9B76D8_g, auto6B9B76D8_u)
// L643
UnitGroupUnit(auto6B9B76D8_g, auto6B9B76D8_u)
// L2576
UnitGroupUnit(autoB7804980_g, autoB7804980_u)
// L2577
UnitGroupUnit(autoB7804980_g, autoB7804980_u)
// L2924
UnitGroupUnit(auto3F4C99E6_g, auto3F4C99E6_u)
// L2925
UnitGroupUnit(auto3F4C99E6_g, auto3F4C99E6_u)
// L2930
UnitGroupUnit(auto1B6E7E41_g, auto1B6E7E41_u)
// L2931
UnitGroupUnit(auto1B6E7E41_g, auto1B6E7E41_u)
// L1253
UnitGroupUnit(lv_zerglingGroup, 1)
// L1254
UnitGroupUnit(lv_zerglingGroup, 2)
// L1255
UnitGroupUnit(lv_zerglingGroup, 3)
// L903
UnitGroupUnit(lv_attackersLeft, lv_i)
// L904
UnitGroupUnit(lv_attackersLeft, (lv_i + 7))
// L906
UnitGroupUnit(lv_attackersRight, lv_i)
// L907
UnitGroupUnit(lv_attackersRight, (lv_i + 7))
// L2864
UnitGroupUnit(gv_rockDestroyers, 1)
// L5906
UnitGroupUnit(UnitGroup("AdjutantCapsule", c_playerAny, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L5966
UnitGroupUnit(UnitGroup("AdjutantCapsule", c_playerAny, RegionCircle(CameraGetTarget(gv_pLAYER_01_USER), 10.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L5969
UnitGroupUnit(UnitGroup("AdjutantCapsule", c_playerAny, RegionCircle(CameraGetTarget(gv_pLAYER_01_USER), 10.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L5889
UnitGroupUnit(lv_vultures, 2)
// L5891
UnitGroupUnit(lv_vultures, 4)
// L5893
UnitGroupUnit(lv_vultures, 5)
// L2616
UnitGroupUnit(lv_intruderGroup, 1)
// L2672
UnitGroupUnit(lv_brutaliskGroup, 1)
// L2728
UnitGroupUnit(lv_hybridGroup, 1)
// L755
UnitGroupUnit(UnitGroup("CommandCenter", gv_pLAYER_01_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L2386
UnitGroupUnit(auto5345FD8F_g, auto5345FD8F_u)
// L2387
UnitGroupUnit(auto5345FD8F_g, auto5345FD8F_u)
// L2412
UnitGroupUnit(auto800FE0DA_g, auto800FE0DA_u)
// L2413
UnitGroupUnit(auto800FE0DA_g, auto800FE0DA_u)
// L2460
UnitGroupUnit(auto64A00279_g, auto64A00279_u)
// L2461
UnitGroupUnit(auto64A00279_g, auto64A00279_u)
// L2557
UnitGroupUnit(autoF8BA0C0A_g, autoF8BA0C0A_u)
// L2558
UnitGroupUnit(autoF8BA0C0A_g, autoF8BA0C0A_u)
// L3648
UnitGroupUnit(auto1645265F_g, auto1645265F_u)
// L3649
UnitGroupUnit(auto1645265F_g, auto1645265F_u)
// L470
UnitGroupUnit(lp_candidates, 1)
// L2252
UnitGroupUnit(lv_patrolGroup, 1)
// L3408
UnitGroupUnit(UnitGroup("Diamondback", 0, RegionFromId(18), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3482
UnitGroupUnit(UnitGroup("SiegeTank", 0, RegionFromId(20), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3490
UnitGroupUnit(UnitGroup("SiegeTank", 0, RegionFromId(19), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3749
UnitGroupUnit(UnitLastCreatedGroup(), 1)
// L703
UnitGroupUnit(UnitGroup("CommandCenter", gv_p1_USER, RegionCircle(PointFromId(1), 16.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L2467
UnitGroupUnit(UnitGroup("SpineCrawler", gv_p2_ZERG, RegionFromId(14), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterUnderConstruction - 32)) | (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L2477
UnitGroupUnit(UnitGroup("SpineCrawler", gv_p2_ZERG, RegionFromId(16), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterUnderConstruction - 32)) | (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3727
UnitGroupUnit(lv_localUnits, 1)
// L3806
UnitGroupUnit(lv_localUnits, 1)
// L5495
UnitGroupUnit(lv_siegeTankGroup, 1)
// L5496
UnitGroupUnit(lv_siegeTankGroup, 2)
// L5500
UnitGroupUnit(lv_infantryGroup, lv_i)
// L5662
UnitGroupUnit(UnitGroup("XelNagaTemple", c_playerAny, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L6128
UnitGroupUnit(UnitGroup("CommandCenter", gv_p01_USER, RegionFromId(1), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L6318
UnitGroupUnit(UnitGroup("CommandCenter", gv_p01_USER, RegionFromId(1), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3575
UnitGroupUnit(UnitGroup("Barracks", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3576
UnitGroupUnit(UnitGroup("Factory", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3577
UnitGroupUnit(UnitGroup("Starport", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3578
UnitGroupUnit(UnitGroup("CommandCenter", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3580
UnitGroupUnit(UnitGroup("BarracksFlying", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3581
UnitGroupUnit(UnitGroup("FactoryFlying", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3582
UnitGroupUnit(UnitGroup("StarportFlying", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3586
UnitGroupUnit(UnitGroup("CommandCenter", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L3588
UnitGroupUnit(UnitGroup("CommandCenterFlying", gv_pLAYER01_USER, RegionFromId(9), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4586
UnitGroupUnit(UnitGroup("RipFieldGenerator", gv_pLAYER_05_WORLDSHIP, RegionCircle(PointFromId(169), 4.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4669
UnitGroupUnit(UnitGroup("RipFieldGenerator", gv_pLAYER_05_WORLDSHIP, RegionCircle(PointFromId(169), 4.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4736
UnitGroupUnit(UnitGroup("Battlecruiser", gv_pLAYER_01_USER, RegionCircle(PointFromId(139), 2.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4738
UnitGroupUnit(UnitGroup("Battlecruiser", gv_pLAYER_01_USER, RegionCircle(PointFromId(179), 2.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4740
UnitGroupUnit(UnitGroup("Battlecruiser", gv_pLAYER_01_USER, RegionCircle(PointFromId(183), 2.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L11673
UnitGroupUnit(UnitGroup("FlamingBetty", c_playerAny, RegionCircle(PointFromId(2274), 3.0), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L2940
UnitGroupUnit(UnitGroup("Leviathan", gv_pLAYER_ZERG_SPECIAL, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L4829
UnitGroupUnit(UnitGroup("MercCompound", gv_pLAYER_USER, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L5361
UnitGroupUnit(UnitGroup("CommandCenter", gv_pLAYER_USER, RegionEntireMap(), UnitFilter(0, 0, 0, (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 0), 1)
// L2078
UnitGroupUnit(UnitGroup("Maar", gv_p10_HYBRID_MANIFESTATIONS, RegionEntireMap(), UnitFilter(0, 0, (1 << c_targetFilterMissile), (1 << (c_targetFilterDead - 32)) | (1 << (c_targetFilterHidden - 32))), 1), 1)
// L633
UnitGroupUnit(auto49A2DDD7_g, auto49A2DDD7_u)
// L634
UnitGroupUnit(auto49A2DDD7_g, auto49A2DDD7_u)
// L642
UnitGroupUnit(auto6B9B76D8_g, auto6B9B76D8_u)
// L643
UnitGroupUnit(auto6B9B76D8_g, auto6B9B76D8_u)
// L2576
UnitGroupUnit(autoB7804980_g, autoB7804980_u)
// L2577
UnitGroupUnit(autoB7804980_g, autoB7804980_u)
// L2924
UnitGroupUnit(auto3F4C99E6_g, auto3F4C99E6_u)
// L2925
UnitGroupUnit(auto3F4C99E6_g, auto3F4C99E6_u)
// L2930
UnitGroupUnit(auto1B6E7E41_g, auto1B6E7E41_u)
// L2931
UnitGroupUnit(auto1B6E7E41_g, auto1B6E7E41_u)
// L1253
UnitGroupUnit(lv_zerglingGroup, 1)
// L1254
UnitGroupUnit(lv_zerglingGroup, 2)
// L1255
UnitGroupUnit(lv_zerglingGroup, 3)
// L903
UnitGroupUnit(lv_attackersLeft, lv_i)
// L904
UnitGroupUnit(lv_attackersLeft, (lv_i + 7))
// L906
UnitGroupUnit(lv_attackersRight, lv_i)
// L907
UnitGroupUnit(lv_attackersRight, (lv_i + 7))
// L2864
UnitGroupUnit(gv_rockDestroyers, 1)