Update document

Author: chenBright

docs/cn/mbvar_c++.md

@@ -412,6 +412,7 @@ public:
 ```
 
 ### get_stats
+
 根据指定label获取对应的单维度统计项bvar。
 
 get_stats除了支持（默认）std::list<std::string>参数类型，也支持自定义参数类型，满足以下条件：
@@ -421,6 +422,12 @@ get_stats除了支持（默认）std::list<std::string>参数类型，也支持
 
 推荐使用不需要分配内存的容器（例如，std::array、absl::InlinedVector）和不需要拷贝字符串的数据结构（例如，const char*、std::string_view、butil::StringPieces），可以提高性能。
 
+bvar::MultiDimension的模板参数Shared，默认为false：
+1. 如果Shared等于false，get_stats返回模板参数T的指针，例如bvar::Adder<int>*。
+2. 如果Shared等于true，get_stats返回模板参数T的shared_ptr，例如std::shared_ptr\<bvar::Adder<int>\>。
+
+**注意**：因为shared_ptr的开销，Shared等于true的性能会比Shared等于false的性能差一些。
+
 ```c++
 #include <bvar/bvar.h>
 #include <bvar/multi_dimension.h>
@@ -523,6 +530,20 @@ int request_count = get_request_count(request_label_list);
     * store(bvar)
     * return bvar
 
+### delete_stats
+
+根据指定label删除对应的单维度统计项bvar。
+
+bvar::MultiDimension的模板参数Shared，默认为false：
+1. 如果Shared等于false，get_stats返回的是模板参数T的指针，delete_stats无法保证没有使用者，所以无法安全删除bvar。
+2. 如果Shared等于true，get_stats返回的是模板参数T的shared_ptr，delete_stats可以安全删除bvar。
+
+### clear_stats
+
+清理所有单维度统计项bvar。
+
+安全性同样受bvar::MultiDimension的模板参数Shared的影响，见delete_stats一节说明。
+
 **bvar的生命周期**
 
 label对应的单维度统计项bvar存储在多维度统计项(mbvar)中，当mbvar析构的时候会释放自身所有bvar，所以用户必须保证在mbvar的生命周期之内操作bvar，在mbvar生命周期外访问bvar的行为未定义，极有可能出core。

src/bvar/detail/combiner.h

@@ -205,12 +205,10 @@ friend class GlobalValue<self_type>;
         // 
         // NOTE: Only available to non-atomic types.
         template <typename Op>
-        void merge_global(const Op &op, self_shared_type c = NULL) {
-            if (NULL == c) {
-                c = combiner.lock();
-            }
-            if (NULL != c) {
-                GlobalValue<self_type> g(this, c.get());
+        void merge_global(const Op &op, self_shared_type& c) {
+            const self_shared_type& c_ref = NULL != c ? c : combiner.lock();
+            if (NULL != c_ref) {
+                GlobalValue<self_type> g(this, c_ref.get());
                 element.merge_global(op, g);
             }
         }

src/bvar/multi_dimension.h

@@ -42,6 +42,7 @@ namespace bvar {
 // `delete_stats' and `clear_stats' are not thread safe.
 // If `Shared' is true, `get_stats` returns a shared_ptr,
 // `delete_stats' and `clear_stats' are thread safe.
+// Note: The shared mode may be less performant than the non-shared mode.
 template <typename T, typename KeyType = std::list<std::string>, bool Shared = false>
 class MultiDimension : public MVariable<KeyType> {
     typedef std::shared_ptr<T> shared_value_type;