#enums #index #macro #macro-derive

enum_index

Trait and macros for extracting Enum variant index

3 unstable releases

Uses old Rust 2015

0.2.0 May 23, 2017
0.1.1 Apr 30, 2017
0.1.0 Apr 30, 2017

#1021 in Rust patterns

Download history 9860/week @ 2023-12-14 4907/week @ 2023-12-21 3360/week @ 2023-12-28 6025/week @ 2024-01-04 7547/week @ 2024-01-11 9550/week @ 2024-01-18 5965/week @ 2024-01-25 6093/week @ 2024-02-01 14214/week @ 2024-02-08 10149/week @ 2024-02-15 6313/week @ 2024-02-22 7106/week @ 2024-02-29 6167/week @ 2024-03-07 7547/week @ 2024-03-14 9787/week @ 2024-03-21 5422/week @ 2024-03-28

29,647 downloads per month
Used in 49 crates (5 directly)

MIT license

1KB

EnumIndex

EnumIndex is a trait to extract variant index from enums in Rust.
IndexEnum is a trait that allows you to get an enum variant by indexing. It only works if all parameters of Enum implement Default

The main case is implementation of your own enum serialization.

pub trait EnumIndex {
    fn enum_index(&self) -> usize;
}

pub trait IndexEnum {
    fn index_enum(index: usize) -> Option<Self> where Self: Sized;
}

Example

// Contains needed traits
extern crate enum_index;
// Contains derives
#[macro_use]
extern crate enum_index_derive;
use enum_index::{EnumIndex, IndexEnum};

// IndexEnum can only be derived for enums with parameters implementing Default
// In this example Default is checked for String, f32 and u64.
#[derive(EnumIndex, IndexEnum, Debug)]
enum OpCode {
    Disconnect,                       // 0
    SendData(String),                 // 1
    SomethingElse { a: f32, b: u64 }  // 2
}

fn main() {
    let first = OpCode::Disconnect;
    let second = OpCode::SendData("hello");
    let third = OpCode::SomethingElse {a: 1f32, b: 2u64};
    println!("{}", first.enum_index()); // prints 0
    println!("{}", second.enum_index()); // prints 1
    println!("{}", third.enum_index()); // prints 2

    let opcode_variant = OpCode::index_enum(2).unwrap();
    println!("{:?}", opcode_variant); // prints SomethingElse{a: 0f32, b: 0u64}
}

Using in your project

Add the following in your Cargo.toml file

[dependencies]
enum_index = "0.2.0"
enum_index_derive = "0.2.0"

Then import needed trait and macro

extern crate enum_index;
#[macro_use]
extern crate enum_index_derive;

No runtime deps