set_at_pointer

Author: grisumbras

doc/qbk/dom/nested_access.qbk

@@ -1,10 +1,10 @@
 [/
-    Copyright (c) 2022 Dmitry Arkhipov (grisumbras@gmail.com)
+    Copyright (c) 2022 Dmitry Arkhipov (grisumbras@yandex.ru)
 
     Distributed under the Boost Software License, Version 1.0. (See accompanying
     file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
 
-    Official repository: https://github.com/cppalliance/json
+    Official repository: https://github.com/boostorg/json
 ]
 
 [/-----------------------------------------------------------------------------]
@@ -26,4 +26,18 @@ with
 
 [snippet_pointer_3]
 
+The library also allows changing and adding deeply nested elements. The
+function [link json.ref.boost__json__value.set_at_pointer `set_at_pointer`]
+traverses the value similarly to [link json.ref.boost__json__value.at_pointer
+`at_pointer`], but additionally, it can create missing elements in certain
+cases:
+
+[snippet_pointer_4]
+
+The specific behavior is controlled by an optional parameter of type [link
+json.ref.boost__json__set_pointer_options `set_pointer_options`]. For example,
+here's the same example with a different option:
+
+[snippet_pointer_5]
+
 [endsect]

doc/qbk/quickref.xml

@@ -28,6 +28,7 @@
           <member><link linkend="json.ref.boost__json__parser">parser</link></member>
           <member><link linkend="json.ref.boost__json__parse_options">parse_options</link></member>
           <member><link linkend="json.ref.boost__json__serializer">serializer</link></member>
+          <member><link linkend="json.ref.boost__json__set_pointer_options">set_pointer_options</link></member>
           <member><link linkend="json.ref.boost__json__static_resource">static_resource</link></member>
           <member><link linkend="json.ref.boost__json__storage_ptr">storage_ptr</link></member>
           <member><link linkend="json.ref.boost__json__stream_parser">stream_parser</link></member>

include/boost/json.hpp

@@ -28,6 +28,7 @@
 #include <boost/json/pilfer.hpp>
 #include <boost/json/serialize.hpp>
 #include <boost/json/serializer.hpp>
+#include <boost/json/set_pointer_options.hpp>
 #include <boost/json/static_resource.hpp>
 #include <boost/json/storage_ptr.hpp>
 #include <boost/json/stream_parser.hpp>