commit | 0129f24cba99e23f7b74ece094fc86b5e663ab78 | [log] [tgz] |
---|---|---|
author | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Wed Feb 28 21:07:09 2024 +0000 |
committer | Android Build Coastguard Worker <android-build-coastguard-worker@google.com> | Wed Feb 28 21:07:09 2024 +0000 |
tree | e86ae9407a1113bf9f979973c7a3972979b34358 | |
parent | 0f7a9a8e1d84314c24bc04c9b88675a0f06f56cf [diff] | |
parent | 5fc2b79734e6fc752f56f55e79a4158513ab8846 [diff] |
Snap for 11510257 from 5fc2b79734e6fc752f56f55e79a4158513ab8846 to simpleperf-release Change-Id: I89cb4aa4f7eeeedfee7bb5886cfa3adb837d727a
bitflags
generates flags enums with well-defined semantics and ergonomic end-user APIs.
You can use bitflags
to:
You can't use bitflags
to:
guarantee only bits corresponding to defined flags will ever be set. bitflags
allows access to the underlying bits type so arbitrary bits may be set.
define bitfields. bitflags
only generates types where set bits denote the presence of some combination of flags.
Add this to your Cargo.toml
:
[dependencies] bitflags = "2.4.2"
and this to your source code:
use bitflags::bitflags;
Generate a flags structure:
use bitflags::bitflags; // The `bitflags!` macro generates `struct`s that manage a set of flags. bitflags! { /// Represents a set of flags. #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)] struct Flags: u32 { /// The value `A`, at bit position `0`. const A = 0b00000001; /// The value `B`, at bit position `1`. const B = 0b00000010; /// The value `C`, at bit position `2`. const C = 0b00000100; /// The combination of `A`, `B`, and `C`. const ABC = Self::A.bits() | Self::B.bits() | Self::C.bits(); } } fn main() { let e1 = Flags::A | Flags::C; let e2 = Flags::B | Flags::C; assert_eq!((e1 | e2), Flags::ABC); // union assert_eq!((e1 & e2), Flags::C); // intersection assert_eq!((e1 - e2), Flags::A); // set difference assert_eq!(!e2, Flags::A); // set complement }
The minimum supported Rust version is documented in the Cargo.toml
file. This may be bumped in minor releases as necessary.