Add APIs to get enumerations from an array schema.

Author: teo-tsirpanis

sources/TileDB.CSharp/ArraySchema.cs

@@ -374,6 +374,73 @@ public Domain Domain()
         return new Domain(_ctx, handle);
     }
 
+    /// <summary>
+    /// Gets the <see cref="Enumeration"/> of the <see cref="ArraySchema"/> with the given name.
+    /// </summary>
+    /// <param name="name">The name of the enumeration.</param>
+    public Enumeration GetEnumeration(string name)
+    {
+        var handle = new EnumerationHandle();
+        var successful = false;
+        tiledb_enumeration_t* enumeration_p = null;
+        try
+        {
+            using (var ctxHandle = _ctx.Handle.Acquire())
+            using (var schemaHandle = _handle.Acquire())
+            using (var ms_name = new MarshaledString(name))
+            {
+                _ctx.handle_error(Methods.tiledb_array_schema_get_enumeration_from_name(ctxHandle, schemaHandle, ms_name, &enumeration_p));
+            }
+            successful = true;
+        }
+        finally
+        {
+            if (successful)
+            {
+                handle.InitHandle(enumeration_p);
+            }
+            else
+            {
+                handle.SetHandleAsInvalid();
+            }
+        }
+        return new Enumeration(_ctx, handle);
+    }
+
+    /// <summary>
+    /// Gets the <see cref="Enumeration"/> attached to the <see cref="CSharp.Attribute"/>
+    /// of the <see cref="ArraySchema"/> with the given name.
+    /// </summary>
+    /// <param name="name">The name of the attribute.</param>
+    public Enumeration GetEnumerationOfAttribute(string name)
+    {
+        var handle = new EnumerationHandle();
+        var successful = false;
+        tiledb_enumeration_t* enumeration_p = null;
+        try
+        {
+            using (var ctxHandle = _ctx.Handle.Acquire())
+            using (var schemaHandle = _handle.Acquire())
+            using (var ms_name = new MarshaledString(name))
+            {
+                _ctx.handle_error(Methods.tiledb_array_schema_get_enumeration_from_attribute_name(ctxHandle, schemaHandle, ms_name, &enumeration_p));
+            }
+            successful = true;
+        }
+        finally
+        {
+            if (successful)
+            {
+                handle.InitHandle(enumeration_p);
+            }
+            else
+            {
+                handle.SetHandleAsInvalid();
+            }
+        }
+        return new Enumeration(_ctx, handle);
+    }
+
     /// <summary>
     /// Gets the <see cref="ArraySchema"/>'s tile order.
     /// </summary>

tests/TileDB.CSharp.Test/EnumerationTest.cs

@@ -97,4 +97,25 @@ public void TestExtend()
         CollectionAssert.AreEqual("HelloWorld👋👋👋👋"u8.ToArray(), rawData);
         CollectionAssert.AreEqual(new ulong[] { 0, 5, 10, 14 }, rawOffsets);
     }
+
+    [TestMethod]
+    public void TestEnumerationFromArraySchema()
+    {
+        using var context = new Context();
+
+        using var schema = new ArraySchema(context, ArrayType.Dense);
+
+        using var enumeration = Enumeration.Create(context, "e", true, ["aaa", "bbb", "ccc"]);
+        schema.AddEnumeration(enumeration);
+
+        using var attr = new Attribute(context, "a1", DataType.Int32);
+        attr.SetEnumerationName(enumeration.GetName());
+        schema.AddAttribute(attr);
+
+        using var enumerationFromSchema = schema.GetEnumeration(enumeration.GetName());
+        Assert.AreEqual(enumeration.GetName(), enumerationFromSchema.GetName());
+
+        using var enumerationFromSchemaAttribute = schema.GetEnumerationOfAttribute(attr.Name());
+        Assert.AreEqual(enumeration.GetName(), enumerationFromSchemaAttribute.GetName());
+    }
 }