Wrong output examples in HashMap section of the Flutter documentation

[LaPyaeOo]

Page URL

https://api.flutter.dev/flutter/dart-collection/HashMap-class.html#:~:text=A%20hash%2Dtable%20based%20implementation,();%20//%20Is%20a%20HashMap

Page source

Example code snippet is wrong

Describe the problem

I found two examples are shown in the HashMap section of the documentation.

1st
Adding data to HashMap with addEntries() method. Actually addEntries() method adds a pair of map values from the last of Map.
But in example add from the first.

Error in documentation

planets[3] = 'Earth';
planets.addAll({4: 'Mars'});
final gasGiants = {6: 'Jupiter', 5: 'Saturn'};
planets.addEntries(gasGiants.entries);
print(planets); // fx {5: Saturn, 6: Jupiter, 3: Earth, 4: Mars}

---

2nd
In this code removing the key from HashMap is 5 but in the example output, the value of the plants still contains a pair of 5.

Error in documentation

final removeValue = planets.remove(5);
print(removeValue); // Jupiter
print(planets); // fx {4: Mars, 3: Earth, 5: Saturn}

Expected fix

Expected result for bug - 1

import 'dart:collection';

void main() {
  final Map<int, String> planets = HashMap();
  planets[3] = 'Earth';
  planets.addAll({4: 'Mars'});
  final gasGiants = {6: 'Jupiter', 5: 'Saturn'};
  planets.addEntries(gasGiants.entries);
  print(planets); // {3: Earth, 4: Mars, 6: Jupiter, 5: Saturn}
}

---

Expected result for bug - 2

final removeValue = planets.remove(5);
print(removeValue); // Jupiter
print(planets); // fx {4: Mars, 3: Earth}

Additional context

No response

I would like to fix this problem.

• I will try and fix this problem on docs.flutter.dev.

[piedcipher]

Issues is in dart-lang/SDK repo - https://github.com/dart-lang/sdk/blob/main/sdk/lib/collection/hash_map.dart

[piedcipher]

Expected result for second should be - {3: Earth, 4: Mars, 6: Jupiter}