tuplez-macros

Crates.iotuplez-macros
lib.rstuplez-macros
version0.7.0
sourcesrc
created_at2024-02-24 09:11:45.439173
updated_at2024-05-27 05:04:58.832048
descriptionProcedural macros implementation of tuplez
homepage
repositoryhttps://github.com/NichtsHsu/tuplez
max_upload_size
id1151495
size34,880
Nihil (NichtsHsu)

documentation

https://docs.rs/tuplez

README

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.
  • Get subsequences.
  • 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.

Commit count: 157

cargo fmt