- Add README_zh_Hans.md

- Add more benchmark test

Author: newbe36524

README.md

@@ -1,8 +1,11 @@
 # Newbe.ObjectVisitor
 
+- [简体中文](README_zh_Hans.md)
+- [English](README.md)
+
 ![Banner](https://github.com/newbe36524/Newbe.ObjectVisitor/raw/docs/assets/banner.svg)
 
-You can visit all properties about your class or struct by this lib with high performance as you visit properties in hard coding way.
+You can visit all properties about your class by this lib with high performance as you visit properties in hard coding way.
 
 For example, here is object in your code.
 
@@ -41,9 +44,9 @@ order.FormatToString();
 
 ## Why do I need this?
 
-- It is faster. This lib is impletmented with [Expression Trees](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/expression-trees/) that cost 1/10 time as in Reflection way.
-- It is readable. This lib can generate a lambda func to handle the code flow you create that just as your hard coding without reflection.
-- It is extendable. If you can visit all properties of a object in easy way, you can validate them as you wish, change some value if there are something sensitive, creare a mapper like automapper, and etc.
+- **It is faster.** This lib is impletmented with [Expression Trees](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/concepts/expression-trees/) that cost 1/10 time as in Reflection way.
+- **It is readable.** This lib can generate a lambda func to handle the code flow you create that just as your hard coding without reflection.
+- **It is extendable.** If you can visit all properties of a object in easy way, you can validate them as you wish, change some value if there are something sensitive, creare a mapper like automapper, and etc.
 
 ## API
 
@@ -73,6 +76,11 @@ var visitor = typeof(Yueluo).V();
 o.V().ForEach((context)=>{}).Run();
 o.V().ForEach((name,value)=>{}).Run();
 
+// ✔️ from 0.2
+// multiple foreach
+o.V().ForEach((context)=>{}).ForEach((context)=>{}).Run();
+
+
 //✔️ from 0.1
 // create a visitor with extend object as parameter
 o.V().WithExtendObject<Yueluo, StringBuilder>()
@@ -99,7 +107,12 @@ cachedVisitor.Run(new Yueluo(), new StringBuilder());
 
 //✔️ from 0.2
 // you can modify value if return a new value
-o.V().ForEach((context)=>context.Value = context.Value.SubString(0,1)).Run();
+o.V().ForEach((context) => ModifyData（context）).Run();
+
+public static void ModifyData(IObjectVisitorContext<Yueluo,string> context)
+{
+    context.Value = context.Value.SubString(0,1)；
+}
 
 //✔️ from 0.1
 // get debug info about expression now
@@ -113,8 +126,17 @@ var code = o.V().ForEach((context)=>{}).GenerateCode();
 var func = o.V().ForEach((context)=>{}).GetLambda();
 
 
-//🚧 foreach properties with specified type
-o.V().ForEach<string>((context)=>{}).Run();
+//✔️ from 0.2
+// foreach properties with specified type
+o.V().ForEach<Yueluo, string>((context) => {});
+// the same as above
+o.V().ForEach<Yueluo, string>((context) => {}, x => x.PropertyType == typeof(string));
+// foreach properties with string type and marked with RequiredAttribute
+o.V().ForEach<Yueluo, string>((context) => {}, x => x.PropertyType == typeof(string) && x.GetCustomAttribute<RequiredAttribute>());
+// foreach properties that implemented IEnumerable<int> ,such as List<int>, int[], IEnumerable<int>, HashSet<int> and etc.
+o.V().ForEach<Yueluo, IEnumerable<int>>((context) => {}, x => x.IsOrImplOf<IEnumerable<int>>());
+// with extend object as parameter
+o.V().WithExtendObject<Yueluo, StringBuilder>().ForEach<Yueluo, StringBuilder, string>((context) => {});
 
 //🚧  using linq to filter
 o.V().AsEnumerable().Where((context)=>context.Name == "YueLuo").ForEach((context)=>{}).Run();
@@ -216,7 +238,6 @@ o.V().SuppendAttributeValidation()
 ).Run();
 
 // 🚧suppending sub-object validation
-// validate whole object
 o.V().SuppendSubObject()
     .SuppendAttributeValidation()
     .Validate(v=>
@@ -285,27 +306,27 @@ chart:
 
 data:
 
-| Method       | Job          | Runtime       |       Mean |    Error |   StdDev | Ratio | RatioSD | Rank |
-| ------------ | ------------ | ------------- | ---------: | -------: | -------: | ----: | ------: | ---: |
-| Directly     | net461       | .NET 4.6.1    |   758.7 ns |  4.60 ns |  4.30 ns |  1.00 |    0.00 |    1 |
-| CacheVisitor | net461       | .NET 4.6.1    |   810.3 ns |  3.26 ns |  2.89 ns |  1.07 |    0.01 |    2 |
-| QuickStyle   | net461       | .NET 4.6.1    | 1,095.6 ns | 16.86 ns | 15.77 ns |  1.44 |    0.02 |    3 |
-|              |              |               |            |          |          |       |         |      |
-| Directly     | net48        | .NET 4.8      |   760.5 ns |  2.79 ns |  2.61 ns |  1.00 |    0.00 |    1 |
-| CacheVisitor | net48        | .NET 4.8      |   814.3 ns |  5.11 ns |  4.53 ns |  1.07 |    0.01 |    2 |
-| QuickStyle   | net48        | .NET 4.8      | 1,079.0 ns |  5.98 ns |  5.30 ns |  1.42 |    0.01 |    3 |
-|              |              |               |            |          |          |       |         |      |
-| Directly     | netcoreapp21 | .NET Core 2.1 |   800.7 ns |  3.26 ns |  2.89 ns |  1.00 |    0.00 |    1 |
-| CacheVisitor | netcoreapp21 | .NET Core 2.1 |   809.7 ns |  3.65 ns |  3.04 ns |  1.01 |    0.00 |    1 |
-| QuickStyle   | netcoreapp21 | .NET Core 2.1 | 1,141.3 ns |  6.88 ns |  6.10 ns |  1.43 |    0.01 |    2 |
-|              |              |               |            |          |          |       |         |      |
-| Directly     | netcoreapp31 | .NET Core 3.1 |   679.0 ns |  2.53 ns |  1.97 ns |  1.00 |    0.00 |    1 |
-| CacheVisitor | netcoreapp31 | .NET Core 3.1 |   679.4 ns |  5.38 ns |  4.77 ns |  1.00 |    0.01 |    1 |
-| QuickStyle   | netcoreapp31 | .NET Core 3.1 |   936.2 ns |  6.09 ns |  5.40 ns |  1.38 |    0.01 |    2 |
-|              |              |               |            |          |          |       |         |      |
-| Directly     | netcoreapp5  | .NET Core 5.0 |   676.5 ns |  6.60 ns |  6.17 ns |  1.00 |    0.00 |    2 |
-| CacheVisitor | netcoreapp5  | .NET Core 5.0 |   654.2 ns |  4.07 ns |  3.61 ns |  0.97 |    0.01 |    1 |
-| QuickStyle   | netcoreapp5  | .NET Core 5.0 |   860.1 ns |  5.99 ns |  5.31 ns |  1.27 |    0.01 |    3 |
+| Method       | Job          | Runtime       |     Mean |    Error |   StdDev | Ratio | RatioSD | Rank |
+| ------------ | ------------ | ------------- | -------: | -------: | -------: | ----: | ------: | ---: |
+| Directly     | net461       | .NET 4.6.1    | 754.3 ns |  8.49 ns |  7.94 ns |  1.00 |    0.00 |    1 |
+| QuickStyle   | net461       | .NET 4.6.1    | 818.3 ns | 16.29 ns | 24.87 ns |  1.10 |    0.04 |    3 |
+| CacheVisitor | net461       | .NET 4.6.1    | 791.4 ns | 11.62 ns | 10.30 ns |  1.05 |    0.01 |    2 |
+|              |              |               |          |          |          |       |         |      |
+| Directly     | net48        | .NET 4.8      | 738.5 ns |  7.37 ns |  6.90 ns |  1.00 |    0.00 |    1 |
+| QuickStyle   | net48        | .NET 4.8      | 799.0 ns | 10.63 ns |  9.42 ns |  1.08 |    0.01 |    2 |
+| CacheVisitor | net48        | .NET 4.8      | 788.0 ns |  8.27 ns |  6.91 ns |  1.07 |    0.02 |    2 |
+|              |              |               |          |          |          |       |         |      |
+| Directly     | netcoreapp21 | .NET Core 2.1 | 768.6 ns |  9.63 ns |  9.01 ns |  1.00 |    0.00 |    1 |
+| QuickStyle   | netcoreapp21 | .NET Core 2.1 | 787.6 ns |  6.11 ns |  5.42 ns |  1.02 |    0.02 |    2 |
+| CacheVisitor | netcoreapp21 | .NET Core 2.1 | 768.6 ns |  5.30 ns |  4.96 ns |  1.00 |    0.01 |    1 |
+|              |              |               |          |          |          |       |         |      |
+| Directly     | netcoreapp31 | .NET Core 3.1 | 659.4 ns |  6.64 ns |  5.88 ns |  1.00 |    0.00 |    1 |
+| QuickStyle   | netcoreapp31 | .NET Core 3.1 | 685.1 ns |  8.25 ns |  7.72 ns |  1.04 |    0.01 |    2 |
+| CacheVisitor | netcoreapp31 | .NET Core 3.1 | 655.6 ns |  5.90 ns |  5.52 ns |  0.99 |    0.01 |    1 |
+|              |              |               |          |          |          |       |         |      |
+| Directly     | netcoreapp5  | .NET Core 5.0 | 624.2 ns |  3.59 ns |  3.00 ns |  1.00 |    0.00 |    2 |
+| QuickStyle   | netcoreapp5  | .NET Core 5.0 | 641.2 ns |  5.60 ns |  4.97 ns |  1.03 |    0.01 |    3 |
+| CacheVisitor | netcoreapp5  | .NET Core 5.0 | 604.2 ns |  8.19 ns |  7.66 ns |  0.97 |    0.01 |    1 |
 
 summary:
 
@@ -353,6 +374,42 @@ summary:
 1. It will cost much more time to build a ObjectVisitor, since it will take more time to build more object and reflection. So we suggest to use build ObjectVisitor and cache it. You can still create a un-cached object visitor in cold code path since it take less then 1 ms.
 2. A Cache visitor is faster than reflection way.
 
+### Modify Data with Condition
+
+Maybe you want to replace a property named Password with '\*\*\*' in you object. That string will be done by methods below:
+
+| Method       | Descrption                                                                                                          |
+| ------------ | ------------------------------------------------------------------------------------------------------------------- |
+| Directly     | Modify data directly with assign statement                                                                          |
+| UsingVisitor | Build a ObjectVisitor with Newbe.ObjectVisitor and cache it into a field. Using that cached visitor to modify info. |
+
+chart:
+
+![Newbe.ObjectVisitor.BenchmarkTest.ChangePasswordTest-barplot](https://github.com/newbe36524/Newbe.ObjectVisitor/raw/docs/assets/Newbe.ObjectVisitor.BenchmarkTest.ChangePasswordTest-barplot.png)
+
+data:
+
+| Method       | Job          | Runtime       |       Mean |    Error |   StdDev | Ratio | RatioSD | Rank |
+| ------------ | ------------ | ------------- | ---------: | -------: | -------: | ----: | ------: | ---: |
+| Directly     | net461       | .NET 4.6.1    | 1,205.4 ns |  8.90 ns |  7.44 ns |  1.00 |    0.00 |    1 |
+| UsingVisitor | net461       | .NET 4.6.1    | 3,807.0 ns | 68.28 ns | 63.87 ns |  3.15 |    0.04 |    2 |
+|              |              |               |            |          |          |       |         |      |
+| Directly     | net48        | .NET 4.8      | 1,205.9 ns |  5.74 ns |  5.08 ns |  1.00 |    0.00 |    1 |
+| UsingVisitor | net48        | .NET 4.8      | 3,743.3 ns | 18.51 ns | 15.46 ns |  3.11 |    0.02 |    2 |
+|              |              |               |            |          |          |       |         |      |
+| Directly     | netcoreapp21 | .NET Core 2.1 |   999.3 ns |  7.28 ns |  6.08 ns |  1.00 |    0.00 |    1 |
+| UsingVisitor | netcoreapp21 | .NET Core 2.1 | 2,882.4 ns |  9.58 ns |  8.96 ns |  2.89 |    0.02 |    2 |
+|              |              |               |            |          |          |       |         |      |
+| Directly     | netcoreapp31 | .NET Core 3.1 |   807.9 ns |  3.46 ns |  3.07 ns |  1.00 |    0.00 |    1 |
+| UsingVisitor | netcoreapp31 | .NET Core 3.1 | 2,614.1 ns | 13.79 ns | 12.90 ns |  3.24 |    0.02 |    2 |
+|              |              |               |            |          |          |       |         |      |
+| Directly     | netcoreapp5  | .NET Core 5.0 |   533.8 ns |  1.72 ns |  1.44 ns |  1.00 |    0.00 |    1 |
+| UsingVisitor | netcoreapp5  | .NET Core 5.0 | 1,398.0 ns |  9.24 ns |  8.19 ns |  2.62 |    0.02 |    2 |
+
+summary:
+
+1. It will take 1000-3000 ns more to modify data by visitor. So you can take this way if you think it is acceptable in your case.
+
 ### validate vs FluentValidation
 
 TODO