Adjust JSON Pointer examples (#3622)

* 📝 adjust JSON Pointer examples

* 👷 add test for documentation

* 📝 note platform-dependent output on some examples

docs/examples/json_pointer__back.cpp

@@ -10,6 +10,6 @@ int main()
     json::json_pointer ptr2("/foo/0");
 
     // call empty()
-    std::cout << "last reference token of " << ptr1 << " is " << ptr1.back() << '\n'
-              << "last reference token of " << ptr2 << " is " << ptr2.back() << std::endl;
+    std::cout << "last reference token of \"" << ptr1 << "\" is \"" << ptr1.back() << "\"\n"
+              << "last reference token of \"" << ptr2 << "\" is \"" << ptr2.back() << "\"" << std::endl;
 }

docs/examples/json_pointer__back.output

@@ -1,2 +1,2 @@
-last reference token of "/foo" is foo
-last reference token of "/foo/0" is 0
+last reference token of "/foo" is "foo"
+last reference token of "/foo/0" is "0"

docs/examples/json_pointer__empty.cpp

@@ -13,8 +13,8 @@ int main()
 
     // call empty()
     std::cout << std::boolalpha
-              << ptr0 << ": " << ptr0.empty() << '\n'
-              << ptr1 << ": " << ptr1.empty() << '\n'
-              << ptr2 << ": " << ptr2.empty() << '\n'
-              << ptr3 << ": " << ptr3.empty() << std::endl;
+              << "\"" << ptr0 << "\": " << ptr0.empty() << '\n'
+              << "\"" << ptr1 << "\": " << ptr1.empty() << '\n'
+              << "\"" << ptr2 << "\": " << ptr2.empty() << '\n'
+              << "\"" << ptr3 << "\": " << ptr3.empty() << std::endl;
 }

docs/examples/json_pointer__operator_add.cpp

@@ -7,17 +7,17 @@ int main()
 {
     // create a JSON pointer
     json::json_pointer ptr("/foo");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append a JSON Pointer
     ptr /= json::json_pointer("/bar/baz");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append a string
     ptr /= "fob";
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // append an array index
     ptr /= 42;
-    std::cout << ptr << std::endl;
+    std::cout << "\"" << ptr << "\"" << std::endl;
 }

docs/examples/json_pointer__operator_add_binary.cpp

@@ -9,11 +9,11 @@ int main()
     json::json_pointer ptr("/foo");
 
     // append a JSON Pointer
-    std::cout << ptr / json::json_pointer("/bar/baz") << '\n';
+    std::cout << "\"" << ptr / json::json_pointer("/bar/baz") << "\"\n";
 
     // append a string
-    std::cout << ptr / "fob" << '\n';
+    std::cout << "\"" << ptr / "fob" << "\"\n";
 
     // append an array index
-    std::cout << ptr / 42 << std::endl;
+    std::cout << "\"" << ptr / 42 << "\"" << std::endl;
 }

docs/examples/json_pointer__parent_pointer.cpp

@@ -12,7 +12,7 @@ int main()
 
     // call parent_pointer()
     std::cout << std::boolalpha
-              << "parent of " << ptr1 << " is " << ptr1.parent_pointer() << '\n'
-              << "parent of " << ptr2 << " is " << ptr2.parent_pointer() << '\n'
-              << "parent of " << ptr3 << " is " << ptr3.parent_pointer() << std::endl;
+              << "parent of \"" << ptr1 << "\" is \"" << ptr1.parent_pointer() << "\"\n"
+              << "parent of \"" << ptr2 << "\" is \"" << ptr2.parent_pointer() << "\"\n"
+              << "parent of \"" << ptr3 << "\" is \"" << ptr3.parent_pointer() << "\"" << std::endl;
 }

docs/examples/json_pointer__pop_back.cpp

@@ -7,15 +7,15 @@ int main()
 {
     // create empty JSON Pointer
     json::json_pointer ptr("/foo/bar/baz");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // call pop_back()
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.pop_back();
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 }

docs/examples/json_pointer__push_back.cpp

@@ -7,15 +7,15 @@ int main()
 {
     // create empty JSON Pointer
     json::json_pointer ptr;
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     // call push_back()
     ptr.push_back("foo");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.push_back("0");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 
     ptr.push_back("bar");
-    std::cout << ptr << '\n';
+    std::cout << "\"" << ptr << "\"\n";
 }

docs/examples/json_pointer__to_string.cpp

@@ -19,16 +19,16 @@ int main()
     json::json_pointer ptr11("/ ");
     json::json_pointer ptr12("/m~0n");
 
-    std::cout << ptr1.to_string() << '\n'
-              << ptr2.to_string() << '\n'
-              << ptr3.to_string() << '\n'
-              << ptr4.to_string() << '\n'
-              << ptr5.to_string() << '\n'
-              << ptr6.to_string() << '\n'
-              << ptr7.to_string() << '\n'
-              << ptr8.to_string() << '\n'
-              << ptr9.to_string() << '\n'
-              << ptr10.to_string() << '\n'
-              << ptr11.to_string() << '\n'
-              << ptr12.to_string() << std::endl;
+    std::cout << "\"" << ptr1.to_string() << "\"\n"
+              << "\"" << ptr2.to_string() << "\"\n"
+              << "\"" << ptr3.to_string() << "\"\n"
+              << "\"" << ptr4.to_string() << "\"\n"
+              << "\"" << ptr5.to_string() << "\"\n"
+              << "\"" << ptr6.to_string() << "\"\n"
+              << "\"" << ptr7.to_string() << "\"\n"
+              << "\"" << ptr8.to_string() << "\"\n"
+              << "\"" << ptr9.to_string() << "\"\n"
+              << "\"" << ptr10.to_string() << "\"\n"
+              << "\"" << ptr11.to_string() << "\"\n"
+              << "\"" << ptr12.to_string() << "\"" << std::endl;
 }

docs/examples/json_pointer__to_string.output

@@ -1,12 +1,12 @@
-
-/foo
-/foo/0
-/
-/a~1b
-/c%d
-/e^f
-/g|h
-/i\j
-/k"l
-/ 
-/m~0n
+""
+"/foo"
+"/foo/0"
+"/"
+"/a~1b"
+"/c%d"
+"/e^f"
+"/g|h"
+"/i\j"
+"/k"l"
+"/ "
+"/m~0n"

docs/examples/patch_inplace.cpp

@@ -30,5 +30,5 @@ int main()
     doc.patch_inplace(patch);
 
     // output patched document
-    std::cout << "After\n" << std::setw(4) << doc << std::endl;
+    std::cout << "\nAfter\n" << std::setw(4) << doc << std::endl;
 }