2021-12-15 04:49:03 -05:00
|
|
|
package bitmask
|
|
|
|
|
2022-02-01 18:26:26 -05:00
|
|
|
import (
|
|
|
|
"bytes"
|
|
|
|
"encoding/binary"
|
2024-04-14 01:54:59 -04:00
|
|
|
"errors"
|
2022-02-01 18:26:26 -05:00
|
|
|
"math/bits"
|
|
|
|
)
|
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
// MaskBit is a flag container.
|
2022-02-01 15:36:56 -05:00
|
|
|
type MaskBit uint
|
2021-12-15 04:49:03 -05:00
|
|
|
|
|
|
|
/*
|
|
|
|
NewMaskBit is a convenience function.
|
|
|
|
It will return a MaskBit with a (referenced) value of 0, so set your consts up accordingly.
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
It is highly recommended to set this default as a "None" flag (separate from your iotas!)
|
|
|
|
as shown in the example.
|
|
|
|
*/
|
|
|
|
func NewMaskBit() (m *MaskBit) {
|
|
|
|
|
|
|
|
m = new(MaskBit)
|
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2022-02-01 15:36:56 -05:00
|
|
|
// NewMaskBitExplicit is like NewMaskBit, but allows you to specify a non-zero (0x0) value.
|
|
|
|
func NewMaskBitExplicit(value uint) (m *MaskBit) {
|
|
|
|
|
|
|
|
var v MaskBit = MaskBit(value)
|
|
|
|
|
|
|
|
m = &v
|
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
// HasFlag is true if m has MaskBit flag set/enabled.
|
|
|
|
func (m *MaskBit) HasFlag(flag MaskBit) (r bool) {
|
|
|
|
|
|
|
|
var b MaskBit = *m
|
|
|
|
|
|
|
|
if b&flag != 0 {
|
|
|
|
r = true
|
|
|
|
}
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// AddFlag adds MaskBit flag to m.
|
|
|
|
func (m *MaskBit) AddFlag(flag MaskBit) {
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
*m |= flag
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// ClearFlag removes MaskBit flag from m.
|
|
|
|
func (m *MaskBit) ClearFlag(flag MaskBit) {
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
*m &= flag
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// ToggleFlag switches MaskBit flag in m to its inverse; if true, it is now false and vice versa.
|
|
|
|
func (m *MaskBit) ToggleFlag(flag MaskBit) {
|
2022-02-01 15:36:56 -05:00
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
*m ^= flag
|
2022-02-01 15:36:56 -05:00
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2022-02-01 18:26:26 -05:00
|
|
|
/*
|
|
|
|
Bytes returns the current value of a MasBit as a byte slice (big-endian).
|
|
|
|
|
|
|
|
If trim is false, b will (probably) be 4 bytes long if you're on a 32-bit size system,
|
|
|
|
and b will (probably) be 8 bytes long if you're on a 64-bit size system. You can determine
|
|
|
|
the size of the resulting slice via (math/)bits.UintSize / 8.
|
|
|
|
|
|
|
|
If trim is true, it will trim leading null bytes (if any). This will lead to an unpredictable
|
|
|
|
byte slice length in b, but is most likely preferred for byte operations.
|
|
|
|
|
|
|
|
*/
|
|
|
|
func (m *MaskBit) Bytes(trim bool) (b []byte) {
|
|
|
|
|
|
|
|
var b2 []byte
|
|
|
|
var size int = bits.UintSize / 8
|
|
|
|
var err error
|
|
|
|
|
|
|
|
b2 = make([]byte, size)
|
|
|
|
|
|
|
|
switch s := bits.UintSize; s {
|
|
|
|
case 32:
|
|
|
|
binary.BigEndian.PutUint32(b2[:], uint32(*m))
|
|
|
|
case 64:
|
|
|
|
binary.BigEndian.PutUint64(b2[:], uint64(*m))
|
|
|
|
default:
|
|
|
|
err = errors.New("unsupported Uint/system bit size")
|
|
|
|
panic(err)
|
|
|
|
}
|
|
|
|
|
|
|
|
if trim {
|
|
|
|
b = bytes.TrimLeft(b2, "\x00")
|
|
|
|
return
|
|
|
|
} else {
|
|
|
|
b = b2
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2024-04-14 01:54:59 -04:00
|
|
|
// Copy returns a pointer to a (new) copy of a MaskBit.
|
|
|
|
func (m *MaskBit) Copy() (newM *MaskBit) {
|
|
|
|
|
|
|
|
newM = new(MaskBit)
|
|
|
|
*newM = *m
|
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
2022-02-01 15:36:56 -05:00
|
|
|
// Value returns the current raw uint value of a MaskBit.
|
|
|
|
func (m *MaskBit) Value() (v uint) {
|
|
|
|
|
|
|
|
v = uint(*m)
|
|
|
|
|
2021-12-15 04:49:03 -05:00
|
|
|
return
|
|
|
|
}
|