deploy: a47170346a

api/basic_json_view/get.md

@@ -7,26 +7,26 @@ T get() const;
 
 Converts the value to `T`.
 
-For the types below, the conversion works directly on the flat index -- no `BasicJsonType` value is built for it:
+For the types below, the conversion works directly on the flat index — no `BasicJsonType` value is built for it:
 
 - `#!cpp bool`
 - arithmetic types other than `#!cpp bool` (for a boolean, `#!cpp 0`/`#!cpp 1`, exactly as for
   [`BasicJsonType::get<T>()`](../basic_json/get.md))
 - `#!cpp std::nullptr_t`
-- `#!cpp std::basic_string<char, Traits, Alloc>` (including `string_t`) -- a copy of the string
-- [`string_view_t`](index.md#member-types) -- **no copy**: the returned view points into the document's
+- `#!cpp std::basic_string<char, Traits, Alloc>` (including `string_t`) — a copy of the string
+- [`string_view_t`](index.md#member-types) — **no copy**: the returned view points into the document's
   [`source()`](../basic_json_document/source.md) text, or, for a string that contains escape sequences, into the
   document's own buffer of decoded strings (see [`get_string()`](get_string.md))
-- `BasicJsonType` -- equivalent to [`materialize()`](materialize.md)
-- `basic_json_view` -- returns `#!cpp *this`
-- `#!cpp std::vector<U, A>` of the types above -- from an array, element by element, each converted with
+- `BasicJsonType` — equivalent to [`materialize()`](materialize.md)
+- `basic_json_view` — returns `#!cpp *this`
+- `#!cpp std::vector<U, A>` of the types above — from an array, element by element, each converted with
   `#!cpp get<U>()`; `#!cpp std::vector<basic_json_view>` keeps a view of every element instead of a value
 - `#!cpp std::map<K, basic_json_view, C, A>` and `#!cpp std::unordered_map<K, basic_json_view, H, E, A>`, if `K` is
-  constructible from a `#!cpp (const char*, std::size_t)` pair -- views of the members of an object; with a repeated
+  constructible from a `#!cpp (const char*, std::size_t)` pair — views of the members of an object; with a repeated
   key, the view of the *last* member is kept, as [`BasicJsonType::parse()`](../basic_json/parse.md) keeps its value
 
 A default-constructible `T` whose `from_json()` accepts views reads the view directly as well, without building a
-`BasicJsonType` value. This covers the library's own conversions of the standard library types -- all other
+`BasicJsonType` value. This covers the library's own conversions of the standard library types — all other
 `#!cpp std::vector`s, `#!cpp std::map`/`#!cpp std::unordered_map` (also with other key types), `#!cpp std::list`,
 `#!cpp std::deque`, `#!cpp std::set`, `#!cpp std::forward_list`, `#!cpp std::valarray`, `#!cpp std::array`, C arrays,
 `#!cpp std::pair`, `#!cpp std::tuple`, `#!cpp std::optional`, enumerations, `#!cpp std::filesystem::path`, ... --
@@ -47,8 +47,8 @@ T&)` of [arbitrary type conversions](../../features/arbitrary_types.md), is not
     keeps it: for `#!cpp {"x":1,"x":2}`, `#!cpp get<point>()` reads `#!cpp x == 1`. See
     [Duplicate keys](../../features/json_view.md#duplicate-keys).
 
-Every other `T` -- user types whose `from_json()` is written for `BasicJsonType` only, types without a default
-constructor, `#!cpp std::tuple`s holding references, ... -- is converted by `#!cpp materialize().get<T>()`: the subtree is built into a real `BasicJsonType`
+Every other `T` — user types whose `from_json()` is written for `BasicJsonType` only, types without a default
+constructor, `#!cpp std::tuple`s holding references, ... — is converted by `#!cpp materialize().get<T>()`: the subtree is built into a real `BasicJsonType`
 value first (as [`BasicJsonType::parse()`](../basic_json/parse.md) would), and converted from there exactly as
 [`BasicJsonType::get<T>()`](../basic_json/get.md) would convert it.
 
@@ -69,7 +69,7 @@ Strong guarantee: there are no changes to the view or the document it refers to.
 
 - For the directly-converted types listed above (other than `BasicJsonType` and `basic_json_view`, which never
   throw): throws [`type_error.302`](../../home/exceptions.md#jsonexceptiontype_error302) if the value's type does not
-  match `T` -- the same exception, with the same message, that [`BasicJsonType::get<T>()`](../basic_json/get.md)
+  match `T` — the same exception, with the same message, that [`BasicJsonType::get<T>()`](../basic_json/get.md)
   throws for the same JSON type and `T`.
 - For `#!cpp std::vector<U, A>`: throws `type_error.302` if the value is not an array; otherwise, whatever converting
   an element to `U` throws.
@@ -77,7 +77,7 @@ Strong guarantee: there are no changes to the view or the document it refers to.
 - For a `T` whose `from_json()` reads the view: whatever that `from_json()` throws; for the library's conversions and
   the macros, the same exceptions with the same messages as [`BasicJsonType::get<T>()`](../basic_json/get.md) of the
   same value.
-- For every other `T`: whatever [`materialize().get<T>()`](../basic_json/get.md) throws -- typically `type_error.302`,
+- For every other `T`: whatever [`materialize().get<T>()`](../basic_json/get.md) throws — typically `type_error.302`,
   or whatever a user-provided `from_json()` throws.
 
 None of the exceptions thrown directly by this function or by a `from_json()` that reads the view (the first four
@@ -132,7 +132,7 @@ document.
 
     The example below reads typed fields straight into C++ variables, collects a view of every array element with
     `#!cpp get<std::vector<basic_json_view>>()` instead of a value, and converts a nested object into a user type
-    through its `from_json()` -- which runs on a `BasicJsonType` value `materialize()` builds for just that one
+    through its `from_json()` — which runs on a `BasicJsonType` value `materialize()` builds for just that one
     member.
 
     ```cpp
@@ -205,11 +205,12 @@ document.
 
 ## See also
 
-- [get_to](get_to.md) - convert and write into a passed value
-- [get_string](get_string.md) - the string, without a copy
-- [number_token](number_token.md) - a number's token text, without a copy
-- [materialize](materialize.md) - build the `BasicJsonType` value of this subtree
+- [`get_to`](get_to.md) - convert and write into a passed value
+- [`get_string`](get_string.md) - the string, without a copy
+- [`number_token`](number_token.md) - a number's token text, without a copy
+- [`materialize`](materialize.md) - build the `BasicJsonType` value of this subtree
 - [`BasicJsonType::get`](../basic_json/get.md) - the corresponding function of `basic_json`
+- [Zero-copy JSON views](../../features/json_view.md#getting-values-out-without-copying) - which conversions avoid building a basic_json value
 
 ## Version history