# Value From Data Table (Unit Group)

Grammar — name from the scope|Global/Local data table
Flags — Native | Function

Returns a unit group value from a data table. Data tables allow you to store and recall values using a string identifier.

# Arguments

• bool<preset::DataScope> — Scope
• string — Name

Returns — unitgroup

native unitgroup DataTableGetUnitGroup(
	bool global,
	string name,
);

# Related

Category: Data Table / Load Value

• Value From Data Table (Ability Command) — abilcmd — DataTableGetAbilCmd
• Value From Data Table (Actor) — actor — DataTableGetActor
• Value From Data Table (Actor Scope) — actorscope — DataTableGetActorScope
• Value From Data Table (AI Filter) — aifilter — DataTableGetAIFilter
• Value From Data Table (Bank) — bank — DataTableGetBank
• Value From Data Table (Boolean) — bool — DataTableGetBool
• Value From Data Table (Byte) — byte — DataTableGetByte
• Value From Data Table (Camera Object) — camerainfo — DataTableGetCameraInfo
• Value From Data Table (Cinematic) — int<cinematic> — DataTableGetCinematic
• Value From Data Table (Color) — color — DataTableGetColor
• Value From Data Table (Control) — int<control> — DataTableGetControl
• Value From Data Table (Conversation) — int<conversation> — DataTableGetConversation
• Value From Data Table (Conversation Reply) — int<reply> — DataTableGetReply
• Value From Data Table (Dialog) — int<dialog> — DataTableGetDialog
• Value From Data Table (Dialog Item) — int<control> — libNtve_gf_ValueFromDataTableDialogItem
• Value From Data Table (Difficulty Level) — int<difficulty> — libNtve_gf_ValueFromDataTableDifficultyLevel
• Value From Data Table (Doodad) — doodad — DataTableGetDoodad
• Value From Data Table (Integer) — int — DataTableGetInt
• Value From Data Table (Marker) — marker — DataTableGetMarker
• Value From Data Table (Objective) — int<objective> — DataTableGetObjective
• Value From Data Table (Order) — order — DataTableGetOrder
• Value From Data Table (Ping) — int<ping> — DataTableGetPing
• Value From Data Table (Planet) — int<planet> — DataTableGetPlanet
• Value From Data Table (Player Color) — int<playercolor> — libNtve_gf_ValueFromDataTablePlayerColor
• Value From Data Table (Player Group) — playergroup — DataTableGetPlayerGroup
• Value From Data Table (Point) — point — DataTableGetPoint
• Value From Data Table (Portrait) — int<portrait> — DataTableGetPortrait
• Value From Data Table (Real) — fixed — DataTableGetFixed
• Value From Data Table (Region) — region — DataTableGetRegion
• Value From Data Table (Revealer) — revealer — DataTableGetRevealer
• Value From Data Table (Sound) — sound — DataTableGetSound
• Value From Data Table (Sound Link) — soundlink — DataTableGetSoundLink
• Value From Data Table (String) — string — DataTableGetString
• Value From Data Table (Text) — text — DataTableGetText
• Value From Data Table (Text Tag) — int<preset::TextTag> — libNtve_gf_ValueFromDataTableTextTag
• Value From Data Table (Timer) — timer — DataTableGetTimer
• Value From Data Table (Transmission) — int<transmission> — DataTableGetTransmission
• Value From Data Table (Transmission Source) — transmissionsource — DataTableGetTransmissionSource
• Value From Data Table (Trigger) — trigger — DataTableGetTrigger
• Value From Data Table (Unit) — unit — DataTableGetUnit
• Value From Data Table (Unit Filter) — unitfilter — DataTableGetUnitFilter
• Value From Data Table (Unit Group) — unitgroup — DataTableGetUnitGroup
• Value From Data Table (Unit Reference)
• Value From Data Table (Wave) — wave — DataTableGetWave
• Value From Data Table (Wave Info) — waveinfo — DataTableGetWaveInfo
• Value From Data Table (Wave Target) — wavetarget — DataTableGetWaveTarget

# Examples

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zexpedition02.sc2map/MapScript.galaxy:464

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(true, ("EscortShuttles_" + IntToString(UnitGetTag(lp_escort))));
}

campaigns/swarm.sc2campaign — base.sc2maps/maps/campaign/swarm/zexpedition02.sc2map/MapScript.galaxy:470

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(true, ("ShuttleEscorts_" + IntToString(UnitGetTag(lp_shuttle))));
}

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zexpedition02.sc2map — MapScript.galaxy:464

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(true, ("EscortShuttles_" + IntToString(UnitGetTag(lp_escort))));
}

campaigns/swarm.sc2campaign/base.sc2maps/maps/campaign/swarm/zexpedition02.sc2map — MapScript.galaxy:470

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(true, ("ShuttleEscorts_" + IntToString(UnitGetTag(lp_shuttle))));
}

campaigns/swarmstory.sc2campaign — base.sc2data/TriggerLibs/SwarmCampaignLib.galaxy:1318

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, libSwaC_gf__LastDroppedUnitsDataTableName());
}

campaigns/voidstory.sc2campaign — base.sc2data/TriggerLibs/VoidCampaignMissionLib.galaxy:3354

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, libVCMI_gf_PM_DropPod_LastDroppedUnitsDataTableName());
}

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameLib.galaxy:4594

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, TriggerEventParamName(libGame_gv_eventID_MapUnderworldOpen_C, libGame_gv_eventParam_MapUnderworldOpen_Entrances_C));
}

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameLib.galaxy:4933

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, TriggerEventParamName(libGame_gv_eventID_MinionGroupCreated_C, libGame_gv_eventParam_MinionGroupCreated_C));
}

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/HeroesLib.galaxy:3409

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(true, libCore_gf__UnitDataName(libCore_ge__UnitDataType_UnitGroup, lp_unit, lp_index));
}

mods/missionpacks/novacampaign.sc2mod — base.sc2data/LibNCMI.galaxy:3516

unitgroup libNCMI_gf_LastDroppedUnits () {
    // Implementation
    return DataTableGetUnitGroup(false, libNCMI_gf_NM_DropPod_LastDroppedUnitsDataTableName());
}

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:2222

    // Implementation
    lv_attackForce = DataTableGetUnitGroup(libCOMI_gv_cMC_CoopAI_AttackForce_DataTableScope, libCOMI_gf_CM_CoopAI_AttackForce_ForceName());
    return lv_attackForce;
}

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:11324

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, libCOMI_gf_CM_DropPod_LastDroppedUnitsDataTableName());
}

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMU.galaxy:2830

    // Implementation
    lv_attackingForce = DataTableGetUnitGroup(true, ("CT_GiftAtk_" + IntToString(UnitGetTag(lp_gift))));
    if ((libCOMU_gf_CT_GiftState(lp_gift) == libCOMU_ge_CT_GiftState_CT_GiftStatePlayer)) {
        libCOMU_gv_cT_GiftAmonPower += 1;

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMU.galaxy:13502

            lv_indexGift = UnitGroupUnitFromEnd(auto63BC9A0B_g, auto63BC9A0B_u);
            if (lv_indexGift == null) { break; }
            lv_attackingForce = DataTableGetUnitGroup(true, ("CT_GiftAtk_" + IntToString(UnitGetTag(lv_indexGift))));
            if ((lv_attackingForce != null)) {
                AISetGroupScriptControlled(lv_attackingForce, false);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOOC.galaxy:5099

        for ( ; ( (auto73B3DFB4_ai >= 0 && lv_scoreIndex <= auto73B3DFB4_ae) || (auto73B3DFB4_ai < 0 && lv_scoreIndex >= auto73B3DFB4_ae) ) ; lv_scoreIndex += auto73B3DFB4_ai ) {
            if ((DataTableGetString(true, ("CC_ScoreType_" + IntToString(lv_scoreIndex))) == (lp_scoreType))) {
                lv_scoreGroup = DataTableGetUnitGroup(true, ("CC_ScoreGroup_" + IntToString(lv_scoreIndex)));
                UnitGroupRemove(lv_scoreGroup, lp_trackedUnit);
                return ;

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOOC.galaxy:5112

    for ( ; ( (auto824015EC_ai >= 0 && lv_scoreIndex <= auto824015EC_ae) || (auto824015EC_ai < 0 && lv_scoreIndex >= auto824015EC_ae) ) ; lv_scoreIndex += auto824015EC_ai ) {
        if ((DataTableGetString(true, ("CC_ScoreType_" + IntToString(lv_scoreIndex))) == (lp_scoreType))) {
            lv_scoreGroup = DataTableGetUnitGroup(true, ("CC_ScoreGroup_" + IntToString(lv_scoreIndex)));
            UnitGroupAdd(lv_scoreGroup, lp_trackedUnit);
            return ;

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOOC.galaxy:8588

    lv_scoreIndex = 1;
    for ( ; ( (autoE0A82FF9_ai >= 0 && lv_scoreIndex <= autoE0A82FF9_ae) || (autoE0A82FF9_ai < 0 && lv_scoreIndex >= autoE0A82FF9_ae) ) ; lv_scoreIndex += autoE0A82FF9_ai ) {
        if ((UnitGroupHasUnit(DataTableGetUnitGroup(true, ("CC_ScoreGroup_" + IntToString(lv_scoreIndex))), EventUnit()) == true) && (PlayerGroupHasPlayer(libCOOC_gf_NondefeatedPlayers(), EventUnitDamageSourcePlayer()) == true)) {
            lv_newScore = (DataTableGetFixed(true, ("CC_ScoreVal_" + IntToString(lv_scoreIndex) + "_" + IntToString(EventUnitDamageSourcePlayer()))) + EventUnitDamageAmount());
            DataTableSetFixed(true, ("CC_ScoreVal_" + IntToString(lv_scoreIndex) + "_" + IntToString(EventUnitDamageSourcePlayer())), lv_newScore);

mods/voidprologue.sc2mod — base.sc2data/LibA3DDD02B.galaxy:1006

    // Automatic Variable Declarations
    // Implementation
    return DataTableGetUnitGroup(false, libA3DDD02B_gf__LastDroppedUnitsDataTableName());
}