14 releases

0.1.13 Jan 2, 2024
0.1.12 Sep 2, 2023
0.1.11 Jul 21, 2023
0.1.8 Mar 18, 2023
0.1.0 Dec 6, 2018

#798 in Rust patterns

Download history 75691/week @ 2023-11-21 78539/week @ 2023-11-28 68227/week @ 2023-12-05 65933/week @ 2023-12-12 53213/week @ 2023-12-19 28231/week @ 2023-12-26 58014/week @ 2024-01-02 64362/week @ 2024-01-09 73668/week @ 2024-01-16 73663/week @ 2024-01-23 68625/week @ 2024-01-30 73922/week @ 2024-02-06 79370/week @ 2024-02-13 83190/week @ 2024-02-20 78533/week @ 2024-02-27 59449/week @ 2024-03-05

315,280 downloads per month
Used in 241 crates (18 directly)

MIT/Apache

11KB
90 lines

Convert number to enum

github crates.io docs.rs build status

This crate provides a derive macro to generate a function for converting a primitive integer into the corresponding variant of an enum.

The generated function is named n and has the following signature:

impl YourEnum {
    pub fn n(value: Repr) -> Option<Self>;
}

where Repr is an integer type of the right size as described in more detail below.

Example

use enumn::N;

#[derive(PartialEq, Debug, N)]
enum Status {
    LegendaryTriumph,
    QualifiedSuccess,
    FortuitousRevival,
    IndeterminateStalemate,
    RecoverableSetback,
    DireMisadventure,
    AbjectFailure,
}

fn main() {
    let s = Status::n(1);
    assert_eq!(s, Some(Status::QualifiedSuccess));

    let s = Status::n(9);
    assert_eq!(s, None);
}

Signature

The generated signature depends on whether the enum has a #[repr(..)] attribute. If a repr is specified, the input to n will be required to be of that type.

#[derive(enumn::N)]
#[repr(u8)]
enum E {
    /* ... */
}

// expands to:
impl E {
    pub fn n(value: u8) -> Option<Self> {
        /* ... */
    }
}

On the other hand if no repr is specified then we get a signature that is generic over a variety of possible types.

impl E {
    pub fn n<REPR: Into<i64>>(value: REPR) -> Option<Self> {
        /* ... */
    }
}

Discriminants

The conversion respects explictly specified enum discriminants. Consider this enum:

#[derive(enumn::N)]
enum Letter {
    A = 65,
    B = 66,
}

Here Letter::n(65) would return Some(Letter::A).


License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~300–750KB
~18K SLoC