prop_tree: Added advanced coercion capability to property

- Added auto and manual coerce modes
- Added set_coerced API for manual coercion
- Added detailed doxy comments describing behavior of property class

1 files changed, 52 insertions, 1 deletions

diff --git a/host/tests/property_test.cpp b/host/tests/property_test.cpp
index b7aa29e4b..61d1de9a6 100644
--- a/host/tests/property_test.cpp
+++ b/host/tests/property_test.cpp
@@ -28,18 +28,26 @@ struct coercer_type{
 };
 
 struct setter_type{
+    setter_type() : _count(0), _x(0) {}
+
     void doit(int x){
+        _count++;
         _x = x;
     }
 
+    int _count;
     int _x;
 };
 
 struct getter_type{
+    getter_type() : _count(0), _x(0) {}
+
     int doit(void){
+        _count++;
         return _x;
     }
 
+    int _count;
     int _x;
 };
 
@@ -57,7 +65,25 @@ BOOST_AUTO_TEST_CASE(test_prop_simple){
     BOOST_CHECK_EQUAL(prop.get(), 34);
 }
 
-BOOST_AUTO_TEST_CASE(test_prop_with_subscriber){
+BOOST_AUTO_TEST_CASE(test_prop_with_desired_subscriber){
+    uhd::property_tree::sptr tree = uhd::property_tree::make();
+    uhd::property<int> &prop = tree->create<int>("/");
+
+    setter_type setter;
+    prop.add_desired_subscriber(boost::bind(&setter_type::doit, &setter, _1));
+
+    prop.set(42);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 42);
+    BOOST_CHECK_EQUAL(prop.get(), 42);
+    BOOST_CHECK_EQUAL(setter._x, 42);
+
+    prop.set(34);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 34);
+    BOOST_CHECK_EQUAL(prop.get(), 34);
+    BOOST_CHECK_EQUAL(setter._x, 34);
+}
+
+BOOST_AUTO_TEST_CASE(test_prop_with_coerced_subscriber){
     uhd::property_tree::sptr tree = uhd::property_tree::make();
     uhd::property<int> &prop = tree->create<int>("/");
 
@@ -65,14 +91,39 @@ BOOST_AUTO_TEST_CASE(test_prop_with_subscriber){
     prop.add_coerced_subscriber(boost::bind(&setter_type::doit, &setter, _1));
 
     prop.set(42);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 42);
     BOOST_CHECK_EQUAL(prop.get(), 42);
     BOOST_CHECK_EQUAL(setter._x, 42);
 
     prop.set(34);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 34);
     BOOST_CHECK_EQUAL(prop.get(), 34);
     BOOST_CHECK_EQUAL(setter._x, 34);
 }
 
+BOOST_AUTO_TEST_CASE(test_prop_manual_coercion){
+    uhd::property_tree::sptr tree = uhd::property_tree::make();
+    uhd::property<int> &prop = tree->create<int>("/", uhd::property_tree::MANUAL_COERCE);
+
+    setter_type dsetter, csetter;
+    prop.add_desired_subscriber(boost::bind(&setter_type::doit, &dsetter, _1));
+    prop.add_coerced_subscriber(boost::bind(&setter_type::doit, &csetter, _1));
+
+    BOOST_CHECK_EQUAL(dsetter._x, 0);
+    BOOST_CHECK_EQUAL(csetter._x, 0);
+
+    prop.set(42);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 42);
+    BOOST_CHECK_EQUAL(dsetter._x, 42);
+    BOOST_CHECK_EQUAL(csetter._x, 0);
+
+    prop.set_coerced(34);
+    BOOST_CHECK_EQUAL(prop.get_desired(), 42);
+    BOOST_CHECK_EQUAL(prop.get(), 34);
+    BOOST_CHECK_EQUAL(dsetter._x, 42);
+    BOOST_CHECK_EQUAL(csetter._x, 34);
+}
+
 BOOST_AUTO_TEST_CASE(test_prop_with_publisher){
     uhd::property_tree::sptr tree = uhd::property_tree::make();
     uhd::property<int> &prop = tree->create<int>("/");