Add ShouldInclude and ShouldDescend functions

Author: Marek Dalewski

value.go

@@ -50,6 +50,16 @@ const (
 	skipMask          FilterResult = 0b10
 )
 
+// ShouldInclude informs if the provided filter result indicates that the given flag value should be included.
+func ShouldInclude(r FilterResult) bool {
+	return r&skipMask == 0
+}
+
+// ShouldDescend informs if the provided filter result indicates that the further recursive values finding should descend into sub-values.
+func ShouldDescend(r FilterResult) bool {
+	return r&noDescendMask == 0
+}
+
 // Filter applies all filter function to the provided flag value and returns filtering decision.
 func Filter(val *Value, filters ...FilterFunc) (r FilterResult) {
 	if val == nil {