stringify<T>(value: T) -- 수신자
- 해당 없음
- 최소 인자 수
- 1
- 최대 인자 수
- 1
Declaration and parameters
링크사용 조건
기본 포함 · 미정
Import std.json in language mode 5.21.
The current compiler selects std/json.tpz for this language mode. Availability in other released editions and inclusion in each installed distribution are Pending.
수신자
매개변수 제약
stringify requires the JSON conformance of its input type. It calls JSON. once and writes the returned JSON tree. A type without that conformance is rejected during checking with TPZ5533. The protocol representation rules define records, enums, arrays, maps, options, results and custom codecs.
Successful output contains one compact JSON value with no leading whitespace or terminal newline. Object names follow the decoded key order. Arrays retain their element order. Map insertion order and record declaration order do not choose serialization order.
The writer escapes quotation marks and backslashes. It uses the short escapes for LF, CR and tab. Other controls below U+0020 use four digit lowercase Unicode escapes. Other scalar values are emitted unchanged. It does not escape a slash or normalize Unicode.
An existing JSONValue retains every accepted number lexeme. An int uses decimal digits and an optional minus. Float encoding follows JSON numeric conversion, including its shortest binary64 roundtrip spelling and negative zero. NaN and infinities return Err.
The depth and active value cycle rules of JSON conversion apply. A depth above 128 or a value cycle returns an error beginning JSON_. Other value failures return the selected codec error. Built in conversion errors identify the first failing child with a path rooted at $.
The input expression is evaluated before conversion. Built in conversions visit arrays in index order and objects in sorted key order. A custom encoder retains its ordinary evaluation and side effects. An encoder error prevents writing. This function returns text and performs no filesystem or stream write.
관련 규칙 · Serialize JSON in a deterministic order →결과
The declared result type is Result<string, string>.
효과
실패
Result and effects
링크Encode through the JSON protocol and return compact deterministic JSON text.
Related entries
링크Serialize JSON in a deterministic order
링크Serialize JSON in a deterministic order
stringify requires the JSON conformance of its input type. It calls JSON. once and writes the returned JSON tree. A type without that conformance is rejected during checking with TPZ5533. The protocol representation rules define records, enums, arrays, maps, options, results and custom codecs.
Successful output contains one compact JSON value with no leading whitespace or terminal newline. Object names follow the decoded key order. Arrays retain their element order. Map insertion order and record declaration order do not choose serialization order.
The writer escapes quotation marks and backslashes. It uses the short escapes for LF, CR and tab. Other controls below U+0020 use four digit lowercase Unicode escapes. Other scalar values are emitted unchanged. It does not escape a slash or normalize Unicode.
An existing JSONValue retains every accepted number lexeme. An int uses decimal digits and an optional minus. Float encoding follows JSON numeric conversion, including its shortest binary64 roundtrip spelling and negative zero. NaN and infinities return Err.
The depth and active value cycle rules of JSON conversion apply. A depth above 128 or a value cycle returns an error beginning JSON_. Other value failures return the selected codec error. Built in conversion errors identify the first failing child with a path rooted at $.
The input expression is evaluated before conversion. Built in conversions visit arrays in index order and objects in sorted key order. A custom encoder retains its ordinary evaluation and side effects. An encoder error prevents writing. This function returns text and performs no filesystem or stream write.
이유
Stable JSON bytes support fixtures and reproducible document inputs. The existing JSON conformance supplies one conversion path, while a Result distinguishes invalid values from successful text.
Write sorted objects and preserve a parsed number lexeme
링크import std.jsonimport std.testimport std.ioio.writeLine(test.assertOk(json.stringify(map { "z": 1, "a": 2 })))io.writeLine(test.assertOk(json.stringify(["a,b", "x\"y", "\n", "é"])))let number = test.assertOk(json.parse("1.2300e+03"))io.writeLine(test.assertOk(json.stringify(number)))let empty: Array<int> = []io.writeLine(test.assertOk(json.stringify(empty)))
{"a":2,"z":1}
["a,b","x\"y","\n","é"]
1.2300e+03
[]
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
{"a":2,"z":1}["a,b","x\"y","\n","é"]1.2300e+03[]
Write finite float values and reject a nonfinite value
링크import std.jsonimport std.iofor value in ([1.5, -0.0]) {match (json.stringify(value)) {case Ok(text) => io.writeLine(text)case Err(_) => io.writeLine("rejected")}}match (json.stringify(0.0 / 0.0)) {case Ok(_) => io.writeLine("accepted")case Err(_) => io.writeLine("nonfinite rejected")}
1.5
-0
nonfinite rejected
기대 결과
기대 결과
실행을 마칩니다. 종료 코드 0.
1.5-0nonfinite rejected