mirrors/phobos
1
0
Fork 0
mirror of https://github.com/dlang/phobos.git synced 2025-04-30 07:00:37 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

std.json: Document opEquals (#8975)

Browse source 
Co-authored-by: Dennis Korpel <dennis@sarc.nl>
This commit is contained in:
Dennis 2024-07-19 09:52:14 +02:00 • committed by GitHub
parent 82b745d217
commit d5780aa8f5
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 23 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

27
std/json.d
View file

@ -804,7 +804,22 @@ struct JSONValue
assert(j["author"].str == "Walter"); assert(j["author"].str == "Walter");
} }
/// /**
* Compare two JSONValues for equality
*
* JSON arrays and objects are compared deeply. The order of object keys does not matter.
*
* Floating point numbers are compared for exact equality, not approximal equality.
*
* Different number types (unsigned, signed, and floating) will be compared by converting
* them to a common type, in the same way that comparison of built-in D `int`, `uint` and
* `float` works.
*
* Other than that, types must match exactly.
* Empty arrays are not equal to empty objects, and booleans are never equal to integers.
*
* Returns: whether this `JSONValue` is equal to `rhs`
*/
bool opEquals(const JSONValue rhs) const @nogc nothrow pure @safe bool opEquals(const JSONValue rhs) const @nogc nothrow pure @safe
{ {
return opEquals(rhs); return opEquals(rhs);
@ -871,9 +886,13 @@ struct JSONValue
/// ///
@safe unittest @safe unittest
{ {
assert(JSONValue(0u) == JSONValue(0)); assert(JSONValue(10).opEquals(JSONValue(10.0)));
assert(JSONValue(0u) == JSONValue(0.0)); assert(JSONValue(10) != (JSONValue(10.5)));
assert(JSONValue(0) == JSONValue(0.0));
assert(JSONValue(1) != JSONValue(true));
assert(JSONValue.emptyArray != JSONValue.emptyObject);
assert(parseJSON(`{"a": 1, "b": 2}`).opEquals(parseJSON(`{"b": 2, "a": 1}`)));
} }
/// Implements the foreach `opApply` interface for json arrays. /// Implements the foreach `opApply` interface for json arrays.