View source for API:GetFortressStatuses

{{LuaApi|group=RvR}}
Returns the owner of each fortress and of its sub-areas.

<pre>
fortresses = GetFortressStatuses()
</pre>

== Arguments ==
None.

== Returns ==
;fortresses : <code>table</code> – Array of fortress tables, indexed from 1, or nothing if the client has no fortress data.

Each fortress table has these fields:
{| class="wikitable"
! Key !! Type !! Meaning
|-
| <code>id</code> || <code>number</code> || Fortress (keep) id.
|-
| <code>currentOwningRealm</code> || <code>number</code> || Realm that owns the fortress.
|-
| <code>currentOwningGuild</code> || <code>wstring</code> || Name of the owning guild. Empty if no guild owns it; the stock UI then shows "unclaimed".
|-
| <code>[1]</code> … <code>[n]</code> || <code>table</code> || The fortress's sub-areas, see below.
|}

Each sub-area table:
{| class="wikitable"
! Key !! Type !! Meaning
|-
| <code>id</code> || <code>number</code> || Sub-area id.
|-
| <code>currentOwningGuild</code> || <code>wstring</code> || Name of the guild owning the sub-area, or empty.
|}

== Details ==
* The fortress table mixes named fields and an array part. <code>ipairs(fortress)</code> walks only the sub-areas.
* The entries are ordered by fortress id, and the sub-areas by sub-area id.
* A new table is built on every call.

== Errors ==
None.

== Example ==
From <code>default/ea_advancedwarwindow/source/advancedwarwindow.lua</code> (shortened):
<pre>
EA_Window_AdvancedWar.fortressData = GetFortressStatuses()

for index, data in ipairs( EA_Window_AdvancedWar.fortressData )
do
    local keepId = EA_Window_AdvancedWar.fortressData[index].id
    ...
    for subareaIndex, subareaData in ipairs( EA_Window_AdvancedWar.fortressData[index] )
    do
        local subareaId = subareaData.id
        ...
        LabelSetText(labelSubareaOwner, subareaData.currentOwningGuild)
</pre>

== See also ==
* [[API:GetKeepData|GetKeepData]]
* [[API:GetRelicStatuses|GetRelicStatuses]]