Modding:TreeAttribute: Difference between revisions

From Vintage Story Wiki
(Simple example of TreeAttribute)
 
Line 6: Line 6:
== Use in API ==
== Use in API ==
Within the API, TreeAttribute is often employed to store persistent entity data, and to store data extracted from JSON files.<br>
Within the API, TreeAttribute is often employed to store persistent entity data, and to store data extracted from JSON files.<br>
'''TreeAttribute''' is often available as the interface '''ITreeAttribute'''.<br>
'''TreeAttribute''' is often supplied as the interface '''ITreeAttribute'''.<br>
== Example in code ==  
== Example in code ==  
<syntaxhighlight lang="c#">
<syntaxhighlight lang="c#">

Revision as of 08:21, 14 April 2020

TreeAttribute

Tree attribute is a nested data structure.
TreeAttribute can hold generic data for most primitives, such as int, string, float, etc. This data can be stored and accessed using a key or index.
It is also possible to serialize data and store it as a byte array. See data serialization.

To use TreeAttribute, add the using statement for Vintagestory.API.Datastructures.

Use in API

Within the API, TreeAttribute is often employed to store persistent entity data, and to store data extracted from JSON files.
TreeAttribute is often supplied as the interface ITreeAttribute.

Example in code

using Vintagestory.API.Datastructures;

class Example
{
    Example()
    {
        // Setting and getting values
        TreeAttribute tree;
        tree = new TreeAttribute();

        float someValue = 0.35f;
        string someKey = "valueKey";

        // Set the value
        tree.SetFloat(someKey, someValue);
        // Retrieve the value
        tree.GetFloat(someKey);
    }
}