Macro bitfield::bitfield_fields

macro_rules! bitfield_fields {
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, _, $setter:ident: $msb:expr, $lsb:expr,
     $count:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, _, $setter:ident: $msb:expr, $lsb:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, _, $setter:ident: $bit:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, $getter:ident, _: $msb:expr, $lsb:expr,
     $count:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, $getter:ident, _: $msb:expr, $lsb:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, $getter:ident, _: $bit:expr) => { ... };
    (@field $(#[$attribute:meta])* ($($vis:tt)*) $t:ty, $getter:ident, $setter:ident:
     $($exprs:expr),*) => { ... };
    ($t:ty;) => { ... };
    ($default_ty:ty; pub $($rest:tt)*) => { ... };
    ($default_ty:ty; #[$attribute:meta] $($rest:tt)*) => { ... };
    ($default_ty:ty; ($(#[$attributes:meta])*) #[$attribute:meta] $($rest:tt)*) => { ... };
    ($default_ty:ty; ($(#[$attribute:meta])*) pub $t:ty, $getter:tt, $setter:tt:  $($exprs:expr),*;
     $($rest:tt)*) => { ... };
    ($default_ty:ty; ($(#[$attribute:meta])*) pub $getter:tt, $setter:tt:  $($exprs:expr),*;
     $($rest:tt)*) => { ... };
    ($default_ty:ty; ($(#[$attribute:meta])*) $t:ty, $getter:tt, $setter:tt:  $($exprs:expr),*;
     $($rest:tt)*) => { ... };
    ($default_ty:ty; ($(#[$attribute:meta])*) $getter:tt, $setter:tt:  $($exprs:expr),*;
     $($rest:tt)*) => { ... };
    ($previous_default_ty:ty; $default_ty:ty; $($rest:tt)*) => { ... };
    ($default_ty:ty; $($rest:tt)*) => { ... };
    ($($rest:tt)*) => { ... };
}

Declares the fields of struct.

This macro will generate the methods to access the fields of a bitfield. It must be called from an impl block for a type that implements the BitRange and/or the Bit traits (which traits are required depending on what type of fields are used).

The syntax of this macro is composed of declarations ended by semicolons. There are two types of delcarations: default type, and fields.

A default type is just a type followed by a semicolon. This will affect all the following field declarations.

A field declaration is composed of the following:

• Optional attributes (#[...]), documentation comments (///) are attributes;
• An optional pub keyword to make the methods public
• An optional type
• The getter and setter idents, separated by a comma
• A colon
• One to three expressions of type usize

The attributes and pub will be applied to the two methods generated.

The getter and setter idents can be _ to not generate one of the two. For example, if the setter is _, the field will be read-only.

The expressions at the end are the bit positions. Their meaning depends on the number of expressions:

• One expression: the field is a single bit. The type is ignored and bool is used. The trait Bit is used.
• Two expressions: msb, lsb, the field is composed of the bits from msb to lsb, included.
• Three expressions: msb, lsb, count, the field is an array. The first element is composed of the bits from msb to lsb. The following elements are consecutive bits range of the same size.

Example

bitfield_fields!{
    // The default type will be `u64
    u64;
    // filed1 is read-write, public, the methods are inline
    #[inline]
    pub field1, set_field1: 10, 0;
    // `field2` is  read-only, private, and of type bool.
    field2, _ : 0;
}