Add json_location free function remove

Author: danielaparker

doc/ref/jsonpath/basic_json_location.md

@@ -204,6 +204,7 @@ $['books'][0]
 #include <jsoncons/json.hpp>
 #include <jsoncons_ext/jsonpath/jsonpath.hpp>
 #include <fstream>
+#include <cassert>
 
 using jsoncons::json; 
 namespace jsonpath = jsoncons::jsonpath;
@@ -213,18 +214,16 @@ int main()
     std::ifstream is(/*path_to_books_file*/);
     json doc = json::parse(is);
 
-    std::size_t n = jsonpath::remove(doc, "$.books[?(@.category == 'fiction')]");
+    std::size_t n = jsoncons::jsonpath::remove(doc, "$.books[1,1,3,3,0,0]");
 
-    std::cout << "Number of nodes removed: " << n << "\n\n";
+    assert(n == 3);
 
     std::cout << jsoncons::pretty_print(doc) << "\n\n";
 ```
 
 Output:
 
 ```
-Number of nodes removed: 3
-
 {
     "books": [
         {
@@ -244,15 +243,6 @@ loc.append("store").append("book").append(1);
 
 json* ptr = jsonpath::get(doc, loc);    
 ```
-
-#### Remove the book at index 2
-
-```
-jsonpath::json_location loc;
-loc.append("store").append("book").append(2);
-
-jsonpath::remove(doc, loc);    
-```
                         
 #### Convert a JSONPath normalized path into a JSONPointer                        
 

test/jsonpath/src/jsonpath_expression_tests.cpp

@@ -355,4 +355,49 @@ TEST_CASE("jsonpath_expression::update tests")
     }
 }
 
+TEST_CASE("jsonpath_expression remove")
+{
+    std::string input = R"(
+    {
+        "books":
+        [
+            {
+                "category": "fiction",
+                "title" : "A Wild Sheep Chase",
+                "author" : "Haruki Murakami",
+                "price" : 22.72
+            },
+            {
+                "category": "fiction",
+                "title" : "The Night Watch",
+                "author" : "Sergei Lukyanenko",
+                "price" : 23.58
+            },
+            {
+                "category": "fiction",
+                "title" : "The Comedians",
+                "author" : "Graham Greene",
+                "price" : 21.99
+            },
+            {
+                "category": "memoir",
+                "title" : "The Night Watch",
+                "author" : "Phillips, David Atlee"
+            }
+        ]
+    }
+    )";
+
+    SECTION("test 1")
+    {
+        json doc = json::parse(input);
 
+        std::size_t n = jsoncons::jsonpath::remove(doc, "$.books[1,1,3,3,0,0]");
+
+        CHECK(n == 3);
+        REQUIRE(doc.at("books").size() == 1);
+        CHECK(doc.at("books")[0].at("title").as<std::string>() == "The Comedians");
+
+        std::cout << doc.at("books") << "\n";
+    }
+}