zhangyiss/toml11
1
0
Fork 0
mirror of https://github.com/ToruNiina/toml11.git synced 2025-12-16 03:08:52 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: update serialization section #73

Browse Source
This commit is contained in:
ToruNiina
2019-07-10 09:12:38 +09:00
parent c3653b85f1
commit 24a05c7c93
1 changed files with 10 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
README.md
View File

@@ -1240,7 +1240,7 @@ const toml::source_location loc = v.location();
toml11 enables you to serialize data into toml format. toml11 enables you to serialize data into toml format.
```cpp ```cpp
const auto data = toml::table{{"foo", 42}, {"bar", "baz"}}; const toml::value data{{"foo", 42}, {"bar", "baz"}};
std::cout << data << std::endl; std::cout << data << std::endl;
// bar = "baz" // bar = "baz"
// foo = 42 // foo = 42
@@ -1250,11 +1250,11 @@ toml11 automatically makes a small table and small array inline.
You can specify the width to make them inline by `std::setw` for streams. You can specify the width to make them inline by `std::setw` for streams.
```cpp ```cpp
const auto data = toml::table{ const toml::value data{
{"qux", toml::table{{"foo", 42}, {"bar", "baz"}}}, {"qux", {{"foo", 42}, {"bar", "baz"}}},
{"quux", toml::array{"small", "array", "of", "strings"}}, {"quux", {"small", "array", "of", "strings"}},
{"foobar", toml::array{"this", "array", "of", "strings", "is", "too", "long", {"foobar", {"this", "array", "of", "strings", "is", "too", "long",
"to", "print", "into", "single", "line", "isn't", "it?"}}, "to", "print", "into", "single", "line", "isn't", "it?"}},
}; };
// the threshold becomes 80. // the threshold becomes 80.
@@ -1293,7 +1293,7 @@ To control the precision of floating point numbers, you need to pass
`std::setprecision` to stream. `std::setprecision` to stream.
```cpp ```cpp
const auto data = toml::table{ const toml::value data{
{"pi", 3.141592653589793}, {"pi", 3.141592653589793},
{"e", 2.718281828459045} {"e", 2.718281828459045}
}; };
@@ -1392,6 +1392,9 @@ Between v2 and v3, those interfaces are rearranged.
- Because type conversion between a table and a value causes ambiguity while overload resolution - Because type conversion between a table and a value causes ambiguity while overload resolution
- Also because `toml::table` is a normal STL container, implementing utility function is easy. - Also because `toml::table` is a normal STL container, implementing utility function is easy.
- See [Finding a toml::value](#finding-a-tomlvalue) for detail. - See [Finding a toml::value](#finding-a-tomlvalue) for detail.
- An overload of `operator<<` and `toml::format` for `toml::table`s are dropped.
- Use `toml::value` instead.
- See [Serializing TOML data](#serializing-toml-data) for detail.
- Interface around comments. - Interface around comments.
- See [Preserving Comments](#preserving-comments) for detail. - See [Preserving Comments](#preserving-comments) for detail.
- An ancient `from_toml/into_toml` has been removed. Use arbitrary type conversion support. - An ancient `from_toml/into_toml` has been removed. Use arbitrary type conversion support.