more documentation

Makefile

@@ -46,7 +46,7 @@ pretty:
 	   --indent-col1-comments --pad-oper --pad-header --align-pointer=type \
 	   --align-reference=type --add-brackets --convert-tabs --close-templates \
 	   --lineend=linux --preserve-date --suffix=none \
-	   src/json.hpp src/json.hpp.re2c test/unit.cpp benchmarks/benchmarks.cpp docs/examples/*.cpp
+	   src/json.hpp src/json.hpp.re2c test/unit.cpp benchmarks/benchmarks.cpp doc/examples/*.cpp
 
 
 ##########################################################################

doc/examples/basic_json__string_t.cpp

+#include <json.hpp>
+
+using namespace nlohmann;
+
+int main()
+{
+    // create an string_t value
+    json::string_t value = "The quick brown fox jumps over the lazy doc";
+
+    // create a JSON string from the value
+    json j(value);
+
+    // serialize the JSON array
+    std::cout << j << '\n';
+}

doc/examples/basic_json__string_t.output

+"The quick brown fox jumps over the lazy doc"

doc/examples/basic_json__string_t_value_type.cpp

+#include <json.hpp>
+
+using namespace nlohmann;
+
+int main()
+{
+    // create a JSON string directly from a string literal
+    json j("The quick brown fox jumps over the lazy doc");
+
+    // serialize the JSON array
+    std::cout << j << '\n';
+}

doc/examples/basic_json__string_t_value_type.output

+"The quick brown fox jumps over the lazy doc"

doc/examples/operator_serialize.cpp

+#include <json.hpp>
+
+using namespace nlohmann;
+
+int main()
+{
+    // create JSON values
+    json j_object = {{"one", 1}, {"two", 2}};
+    json j_array = {1, 2, 4, 8, 16};
+
+    // serialize without indentation
+    std::cout << j_object << "\n\n";
+    std::cout << j_array << "\n\n";
+
+    // serialize with indentation
+    std::cout << std::setw(4) << j_object << "\n\n";
+    std::cout << std::setw(2) << j_array << "\n\n";
+}

doc/examples/operator_serialize.output

+{"one":1,"two":2}
+
+[1,2,4,8,16]
+
+{
+    "one": 1,
+    "two": 2
+}
+
+[
+  1,
+  2,
+  4,
+  8,
+  16
+]
+