#97 Extensions: Where()

Author: neomasterhub

Neomaster.JsonToLinq/Application/JsonLinq.cs

@@ -8,6 +8,48 @@ namespace Neomaster.JsonToLinq;
 /// </summary>
 public static class JsonLinq
 {
+  /// <summary>
+  /// Filters a sequence of values based on a JSON filter definition.
+  /// </summary>
+  /// <typeparam name="TElement">Type of elements to filter.</typeparam>
+  /// <param name="elements">An System.Collections.Generic.IEnumerable`1 to filter.</param>
+  /// <param name="json">JSON filter definition.</param>
+  /// <param name="fieldMapper">Maps JSON field names to <see cref="ExpressionField"/> definitions.</param>
+  /// <param name="options">Optional parser settings. Uses defaults if null.</param>
+  /// <returns>
+  /// An System.Collections.Generic.IEnumerable`1
+  /// that contains elements from the input sequence that satisfy the condition.
+  /// </returns>
+  public static IEnumerable<TElement> Where<TElement>(
+    this IEnumerable<TElement> elements,
+    string json,
+    ExpressionFieldMapper fieldMapper = null,
+    ExpressionParsingOptions options = null)
+  {
+    return elements.Where(JsonDocument.Parse(json), fieldMapper, options);
+  }
+
+  /// <summary>
+  /// Filters a sequence of values based on a JSON filter definition.
+  /// </summary>
+  /// <typeparam name="TElement">Type of elements to filter.</typeparam>
+  /// <param name="elements">An System.Collections.Generic.IEnumerable`1 to filter.</param>
+  /// <param name="doc">JSON filter definition.</param>
+  /// <param name="fieldMapper">Maps JSON field names to <see cref="ExpressionField"/> definitions.</param>
+  /// <param name="options">Optional parser settings. Uses defaults if null.</param>
+  /// <returns>
+  /// An System.Collections.Generic.IEnumerable`1
+  /// that contains elements from the input sequence that satisfy the condition.
+  /// </returns>
+  public static IEnumerable<TElement> Where<TElement>(
+    this IEnumerable<TElement> elements,
+    JsonDocument doc,
+    ExpressionFieldMapper fieldMapper = null,
+    ExpressionParsingOptions options = null)
+  {
+    return elements.Where(ParseToFilterExpression<TElement>(doc, fieldMapper, options).Compile());
+  }
+
   /// <summary>
   /// Parses a JSON document into a LINQ expression filter for <typeparamref name="T"/>.
   /// </summary>

Neomaster.JsonToLinq/Neomaster.JsonToLinq.csproj

@@ -9,7 +9,7 @@
     <NoWarn>$(NoWarn);IDE0079</NoWarn>
     <PackageId>JsonToLinq</PackageId>
     <PackageIcon>logo.png</PackageIcon>
-    <Version>1.0.0-rc903</Version>
+    <Version>1.0.0-rc904</Version>
     <Authors>Neomaster</Authors>
     <Company>Neomaster</Company>
     <Copyright>Copyright © 2025 Neomaster</Copyright>