tuple.dart: A Versatile Tuple Data Structure for Dart

The tuple.dart library provides a powerful and convenient tuple data structure for Dart, allowing you to group multiple values of different types into a single entity. This library is particularly useful when working with data that has a fixed number of components, such as coordinates or tabular data.

Features

• Supports tuples with any number of elements (Tuples1 to Tuples12).
• Immutable and structurally typed, ensuring data integrity.
• Provides convenient methods for accessing and modifying elements.
• Facilitates comparisons and hash table operations.
• Supports serialization and deserialization to/from JSON.

Usage

Creating a tuple is straightforward:

const tuple = Tuple2('Hello', 10);

You can access individual elements using their index-based properties:

print(tuple.item1); // Output: 'Hello'
print(tuple.item2); // Output: 10

Tuples can be compared for equality using the == operator, and can be hashed for use in hash tables.

Modifying a tuple is as simple as creating a new one with the desired changes:

const modifiedTuple = tuple.withItem1('World');

Examples

Consider a scenario where you want to represent a point in 2D space:

const point = Tuple2(10.0, 20.0);
print(point.item1); // Output: 10.0 (x-coordinate)
print(point.item2); // Output: 20.0 (y-coordinate)

Or, if you have a list of names and corresponding ages:

const data = [
  Tuple2('John', 30),
  Tuple2('Jane', 25),
];
for (var tuple in data) {
  print('Name: ${tuple.item1}, Age: ${tuple.item2}');
}

Conclusion

The tuple.dart library provides a comprehensive and versatile tuple data structure for Dart, offering a convenient and efficient way to handle data with multiple components. Its simplicity and flexibility make it an essential tool for a wide range of applications.