Anvil.API.TwoDimArray< T > Class Template Reference

A two dimensional array data resource. More...

Inheritance diagram for Anvil.API.TwoDimArray< T >:

Collaboration diagram for Anvil.API.TwoDimArray< T >:

Public Member Functions
bool?	GetBool (int rowIndex, int columnIndex)
	Gets the specified boolean value.
bool?	GetBool (int rowIndex, string columnName)
	Gets the specified boolean value.
int	GetColumnIndex (string columnName)
	Gets the index of the column with the specified name/label.
T?	GetEnum< T > (int rowIndex, int columnIndex)
	Gets the specified enum value value.
T?	GetEnum< T > (int rowIndex, string columnName)
	Gets the specified StrRef value.
IEnumerator< T >	GetEnumerator ()
float?	GetFloat (int rowIndex, int columnIndex)
	Gets the specified float value.
float?	GetFloat (int rowIndex, string columnName)
	Gets the specified float value.
int?	GetInt (int rowIndex, int columnIndex)
	Gets the specified int value.
int?	GetInt (int rowIndex, string columnName)
	Gets the specified int value.
T	GetRow (int rowIndex)
	Gets the row at the specified index.
string?	GetString (int rowIndex, int columnIndex)
	Gets the specified string value.
string?	GetString (int rowIndex, string columnName)
	Gets the specified string value.
StrRef?	GetStrRef (int rowIndex, int columnIndex)
	Gets the specified StrRef value.
StrRef?	GetStrRef (int rowIndex, string columnName)
	Gets the specified StrRef value.
TwoDimArray< T >?	GetTable< T > (int rowIndex, int columnIndex)
	Interprets the specified value as a table name, and returns the associated table.
TwoDimArray< T >?	GetTable< T > (int rowIndex, string columnName)
	Interprets the specified value as a table name, and returns the associated table.
T?	GetTableEntry< T > (int rowIndex, int columnIndex, TwoDimArray< T > table)
	Interprets the specified value as a table index, and returns the associated table entry.
T?	GetTableEntry< T > (int rowIndex, string columnName, TwoDimArray< T > table)
	Interprets the specified value as a table index, and returns the associated table entry.
Vector3?	GetVector3 (int rowIndex, int columnIndexX, int columnIndexY, int columnIndexZ)
	Gets the specified Vector3 value.
Vector3?	GetVector3 (int rowIndex, string columnNameX, string columnNameY, string columnNameZ)
	Gets the specified Vector3 value.

Properties
int	ColumnCount [get]
	Gets the number of columns in this 2da.
string[]	Columns [get]
	Gets the column labels/names for this 2da.
int	Count [get]
int	RowCount [get]
	Gets the number of rows in this 2da.
IReadOnlyList< T >	Rows [get]
	Gets a read-only list of all rows in this 2da.
T	this[int rowIndex] [get]

Detailed Description

A two dimensional array data resource.

A two dimensional array resource, with a decoded row type.

Examples

/*
 * Define a implementation to deserialize "xptable.2da", and use this class to determine how much XP is remaining until the next level.
 */
 
using System.Linq;
using Anvil.API;
using Anvil.API.Events;
using Anvil.Services;
 
namespace NWN.Anvil.Samples
{
  // This is the deserialization class for this specific type of 2da.
  // We can implement our own helper functions here that operate on the 2da data, and cache it.
  public sealed class ExpTableEntry : ITwoDimArrayEntry
  {
    public int Level { get; private set; }
 
    public int XP { get; private set; }
 
    // RowIndex is already populated externally, and we do not need to assign it in InterpretEntry.
    public int RowIndex { get; init; }
 
    // InterpretEntry is where we populate our entry properties (Level & XP) with the correct data.
    public void InterpretEntry(TwoDimArrayEntry entry)
    {
      Level = entry.GetInt("Level").GetValueOrDefault(0);
      XP = entry.GetInt("XP").GetValueOrDefault(0);
    }
  }
 
  [ServiceBinding(typeof(XPReportService))]
  public class XPReportService
  {
    // The TwoDimArray is created here.
    // ExpTableEntry (the type above) is passed in as a type parameter to be used to create our row data from exptable.2da.
    private readonly TwoDimArray<ExpTableEntry> expTable = NwGameTables.GetTable<ExpTableEntry>("exptable.2da")!;
 
    public XPReportService()
    {
      NwModule.Instance.OnClientEnter += OnClientEnter;
    }
 
    private void OnClientEnter(ModuleEvents.OnClientEnter onClientEnter)
    {
      NwPlayer player = onClientEnter.Player;
      NwCreature? creature = player.ControlledCreature;
      if (creature == null)
      {
        return;
      }
 
      int nextLevel = GetLevelFromXp(creature.Xp) + 1;
      if (nextLevel > MaxLevel)
      {
        return;
      }
 
      player.SendServerMessage($"Next level up: {GetXpForLevel(nextLevel) - creature.Xp}");
    }
 
    public int MaxLevel => expTable[^1].Level;
 
    public int GetXpForLevel(int level)
    {
      return expTable.First(entry => entry.Level == level).XP;
    }
 
    public int GetLevelFromXp(int xp)
    {
      int level = 1;
      foreach (ExpTableEntry entry in expTable.Rows)
      {
        if (entry.XP > xp)
        {
          break;
        }
 
        level = entry.Level;
      }
 
      return level;
    }
  }
}

Template Parameters

T	The row/entry type to decode the array.

Type Constraints

T	:	class
T	:	ITwoDimArrayEntry
T	:	new()

Member Function Documentation

GetBool() [1/2]

bool? Anvil.API.TwoDimArray< T >.GetBool ( int rowIndex, int columnIndex )

inline

Gets the specified boolean value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

GetBool() [2/2]

bool? Anvil.API.TwoDimArray< T >.GetBool ( int rowIndex, string columnName )

inline

Gets the specified boolean value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

GetColumnIndex()

int Anvil.API.TwoDimArray< T >.GetColumnIndex ( string columnName )

inline

Gets the index of the column with the specified name/label.

Parameters

columnName

The column to lookup.

Returns

The zero-based index of the column if found, otherwise -1.

GetEnum< T >() [1/2]

T? Anvil.API.TwoDimArray< T >.GetEnum< T > ( int rowIndex, int columnIndex )

inline

Gets the specified enum value value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

Type Constraints

T	:	struct
T	:	Enum

GetEnum< T >() [2/2]

T? Anvil.API.TwoDimArray< T >.GetEnum< T > ( int rowIndex, string columnName )

inline

Gets the specified StrRef value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

Type Constraints

T	:	struct
T	:	Enum

GetFloat() [1/2]

float? Anvil.API.TwoDimArray< T >.GetFloat ( int rowIndex, int columnIndex )

inline

Gets the specified float value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

GetFloat() [2/2]

float? Anvil.API.TwoDimArray< T >.GetFloat ( int rowIndex, string columnName )

inline

Gets the specified float value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

GetInt() [1/2]

int? Anvil.API.TwoDimArray< T >.GetInt ( int rowIndex, int columnIndex )

inline

Gets the specified int value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

GetInt() [2/2]

int? Anvil.API.TwoDimArray< T >.GetInt ( int rowIndex, string columnName )

inline

Gets the specified int value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

GetRow()

T Anvil.API.TwoDimArray< T >.GetRow ( int rowIndex )

inline

Gets the row at the specified index.

Parameters

rowIndex

The row index.

GetString() [1/2]

string? Anvil.API.TwoDimArray< T >.GetString ( int rowIndex, int columnIndex )

inline

Gets the specified string value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

GetString() [2/2]

string? Anvil.API.TwoDimArray< T >.GetString ( int rowIndex, string columnName )

inline

Gets the specified string value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

GetStrRef() [1/2]

StrRef? Anvil.API.TwoDimArray< T >.GetStrRef ( int rowIndex, int columnIndex )

inline

Gets the specified StrRef value.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Returns

The associated value. null if no value is set.

GetStrRef() [2/2]

StrRef? Anvil.API.TwoDimArray< T >.GetStrRef ( int rowIndex, string columnName )

inline

Gets the specified StrRef value.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Returns

The associated value. null if no value is set.

GetTable< T >() [1/2]

TwoDimArray< T >? Anvil.API.TwoDimArray< T >.GetTable< T > ( int rowIndex, int columnIndex )

inline

Interprets the specified value as a table name, and returns the associated table.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.

Template Parameters

T	The type of table entry.

Returns

The associated value, otherwise null.

Type Constraints

T	:	class
T	:	ITwoDimArrayEntry
T	:	new()

GetTable< T >() [2/2]

TwoDimArray< T >? Anvil.API.TwoDimArray< T >.GetTable< T > ( int rowIndex, string columnName )

inline

Interprets the specified value as a table name, and returns the associated table.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.

Template Parameters

T	The type of table entry.

Returns

The associated value, otherwise null.

Type Constraints

T	:	class
T	:	ITwoDimArrayEntry
T	:	new()

GetTableEntry< T >() [1/2]

T? Anvil.API.TwoDimArray< T >.GetTableEntry< T > ( int rowIndex, int columnIndex, TwoDimArray< T > table )

inline

Interprets the specified value as a table index, and returns the associated table entry.

Parameters

rowIndex	The index of the row to query.
columnIndex	The index of the column to query.
table	The table that should be used to resolve the value.

Template Parameters

T	The type of table entry.

Returns

The associated value, otherwise the default array entry value (typically null)

Type Constraints

T	:	class
T	:	ITwoDimArrayEntry
T	:	new()

GetTableEntry< T >() [2/2]

T? Anvil.API.TwoDimArray< T >.GetTableEntry< T > ( int rowIndex, string columnName, TwoDimArray< T > table )

inline

Interprets the specified value as a table index, and returns the associated table entry.

Parameters

rowIndex	The index of the row to query.
columnName	The name/label of the column to query.
table	The table that should be used to resolve the value.

Template Parameters

T	The type of table entry.

Returns

The associated value, otherwise the default array entry value (typically null)

Type Constraints

T	:	class
T	:	ITwoDimArrayEntry
T	:	new()

GetVector3() [1/2]

Vector3? Anvil.API.TwoDimArray< T >.GetVector3 ( int rowIndex, int columnIndexX, int columnIndexY, int columnIndexZ )

inline

Gets the specified Vector3 value.

Parameters

rowIndex	The index of the row to query.
columnIndexX	The index of the column containing the x component of the vector.
columnIndexY	The index of the column containing the y component of the vector.
columnIndexZ	The index of the column containing the z component of the vector.

Returns

The associated value. null if no value is set.

GetVector3() [2/2]

Vector3? Anvil.API.TwoDimArray< T >.GetVector3 ( int rowIndex, string columnNameX, string columnNameY, string columnNameZ )

inline

Gets the specified Vector3 value.

Parameters

rowIndex	The index of the row to query.
columnNameX	The name/label of the column containing the x component of the vector.
columnNameY	The name/label of the column containing the y component of the vector.
columnNameZ	The name/label of the column containing the z component of the vector.

Returns

The associated value. null if no value is set.

---

The documentation for this class was generated from the following files:

• NWN.Anvil/src/main/API/TwoDimArray/TwoDimArray.cs
• NWN.Anvil/src/main/API/TwoDimArray/TwoDimArray`1.cs