24 releases (8 breaking)

new 0.9.0 Apr 26, 2024
0.8.1 Mar 5, 2024

#417 in Data structures

Download history 1504/week @ 2024-02-24 566/week @ 2024-03-02 78/week @ 2024-03-09 1/week @ 2024-03-16 98/week @ 2024-03-30 567/week @ 2024-04-13 277/week @ 2024-04-20

942 downloads per month
Used in 2 crates

MIT/Apache

190KB
2K SLoC

tuplez

This crate introduces a tuple type represented in recursive form rather than parallel form.

Motivation

The primitive tuple types are represented in parallel form, like:

(a, b, c, d ...)

Since Rust doesn't support variadic generics, we cannot add methods to primitive tuples with any number of elements.

Currently, most tuple crates use declarative macros to implement methods for tuples whose number of elements is less than a certain limit (usually 32).

To solve this, tuplez introduces a Tuple type represented in recursive form, like:

Tuple(a, Tuple(b, Tuple(c, Tuple(d, ...))))

The advantage of this representation is that you can implement methods recursively for all tuples, and there is no longer a limit on the number of tuple's elements. And, in almost all cases, the Tuple takes no more memory than the primitive tuples.

Functionality

  • Create tuples with any number of elements.
  • Access elements in a tuple at any index, or by their types.
  • Push element to a tuple or pop element from a tuple.
  • Join two tuples or split a tuple into two parts.
  • Rich tuple operations, e.g.: reverse, left rotate, zip.
  • If all element types implement a Trait (e.g. Eq, Add), then the Tuple also implement that Trait.
  • Traverse all elements of a tuple, or fold a tuple.
  • When the number of elements of a tuple doesn't exceed 32, then it can be converted from/to a primitive tuple or a primitive array.

Please check the documentation for details.

Dependencies

~0.3–0.9MB
~20K SLoC