[c++/m] Add Section referringTags(Block)

Author: mpsonntag

+nix/Section.m

@@ -160,9 +160,8 @@
                 obj.nix_handle, @nix.DataArray);
         end
 
-        function ret = referring_tags(obj)
-            ret = nix.Utils.fetchObjList('Section::referringTags', ...
-                obj.nix_handle, @nix.Tag);
+        function ret = referring_tags(obj, varargin)
+            ret = obj.referring_util(@nix.Tag, 'Tags', varargin{:});
         end
 
         function ret = referring_multi_tags(obj)

nix_mx.cc

@@ -357,6 +357,7 @@ void mexFunction(int            nlhs,
         methods->add("Section::createProperty", nixsection::createProperty);
         methods->add("Section::createPropertyWithValue", nixsection::createPropertyWithValue);
         methods->add("Section::referringBlockSources", nixsection::referringBlockSources);
+        methods->add("Section::referringBlockTags", nixsection::referringBlockTags);
 
         classdef<nix::Feature>("Feature", methods)
             .desc(&nixfeature::describe)

src/nixsection.cc

@@ -87,4 +87,10 @@ namespace nixsection {
         output.set(0, currSec.referringSources(currBlock));
     }
 
+    void referringBlockTags(const extractor &input, infusor &output) {
+        nix::Section currSec = input.entity<nix::Section>(1);
+        nix::Block currBlock = input.entity<nix::Block>(2);
+        output.set(0, currSec.referringTags(currBlock));
+    }
+
 } // namespace nixsection

src/nixsection.h

@@ -23,6 +23,8 @@ namespace nixsection {
 
     void referringBlockSources(const extractor &input, infusor &output);
 
+    void referringBlockTags(const extractor &input, infusor &output);
+
 } // namespace nixsection
 
 #endif

tests/TestSection.m

@@ -29,6 +29,7 @@
     funcs{end+1} = @test_inherited_properties;
     funcs{end+1} = @test_referring_data_arrays;
     funcs{end+1} = @test_referring_tags;
+    funcs{end+1} = @test_referring_block_tags;
     funcs{end+1} = @test_referring_multi_tags;
     funcs{end+1} = @test_referring_sources;
     funcs{end+1} = @test_referring_block_sources;
@@ -350,7 +351,7 @@
 end
 
 %% Test: referring tags
-function [] = test_referring_multi_tags( varargin )
+function [] = test_referring_tags( varargin )
     f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.Overwrite);
     b1 = f.create_block('testBlock1', 'nixBlock');
     t1 = b1.create_tag('testTag1', 'nixTag', [1, 2]);
@@ -371,8 +372,44 @@
     assert(isempty(s.referring_tags));
 end
 
+%% Test: referring block tags
+function [] = test_referring_block_tags( varargin )
+    err = 'Provide either empty arguments or a single Block entity';
+    testName = 'testTag1';
+
+    f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.Overwrite);
+    b1 = f.create_block('testBlock1', 'nixBlock');
+    t1 = b1.create_tag(testName, 'nixTag', [1, 2]);
+    b2 = f.create_block('testBlock2', 'nixBlock');
+    t2 = b2.create_tag('testTag2', 'nixTag', [3, 4]);
+    s = f.create_section('testSection', 'nixSection');
+
+    t1.set_metadata(s);
+    t2.set_metadata(s);
+
+    % test multiple arguments fail
+    try
+        s.referring_tags('a', 'b');
+    catch ME
+        assert(strcmp(ME.message, err));
+    end
+
+    % test non block entity argument fail
+    try
+        s.referring_tags(s);
+    catch ME
+        assert(strcmp(ME.message, err));
+    end
+
+    % test return only tags from block 1
+    testTag = s.referring_tags(b1);
+    assert(size(testTag, 2) == 1);
+    assert(strcmp(testTag{1}.name, testName));
+end
+
+
 %% Test: referring multi tags
-function [] = test_referring_tags( varargin )
+function [] = test_referring_multi_tags( varargin )
     f = nix.File(fullfile(pwd, 'tests', 'testRW.h5'), nix.FileMode.Overwrite);
     b1 = f.create_block('testBlock1', 'nixBlock');
     d = b1.create_data_array('testDataArray1', 'nixDataArray', nix.DataType.Double, [1 2]);