-
Notifications
You must be signed in to change notification settings - Fork 0
/
t_uint32.go
138 lines (120 loc) · 5.11 KB
/
t_uint32.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
package interval
// Code generated by generate/generate.go. DO NOT EDIT
import (
"fmt"
"strconv"
)
// WrapUint32 normalizes the value that "wraps around" within the [min,max) range.
// WrapUint32 always assumes that `min` is [inclusive, and `max` is exclusive).
func WrapUint32(min, max, value uint32) uint32 {
min, max = MinMaxUint32(min, max)
var maxLessMin = max - min
for value < min {
value += maxLessMin
}
for value >= max {
value -= maxLessMin
}
return value
//Original implementation is not working well for unsigned types:
//return ((value-min)%maxLessMin+maxLessMin)%maxLessMin + min
}
// ClampUint32 returns value capped to [min,max] range. Both ends of this range are inclusive.
func ClampUint32(min, max, value uint32) uint32 {
min, max = MinMaxUint32(min, max)
return MaxUint32(min, MinUint32(max, value))
}
// ValidateUint32 tests whether the value is within [(min,max)] range (depending on minExclusive and maxExclusive).
// It returns the value if it is within the range, otherwise returns 0 and error.
func ValidateUint32(min, max, value uint32, minExclusive, maxExclusive bool) (uint32, error) {
min, max, minExclusive, maxExclusive = MinMaxExclusiveUint32(min, max, minExclusive, maxExclusive)
if !TestUint32(min, max, value, minExclusive, maxExclusive) {
return 0, fmt.Errorf("%v is outside of range %v", value, ToStringUint32(min, max, minExclusive, maxExclusive))
}
return value, nil
}
// TestUint32 returns true if the value is within [(min,max)] range (depending on minExclusive and maxExclusive).
func TestUint32(min, max, value uint32, minExclusive, maxExclusive bool) bool {
min, max, minExclusive, maxExclusive = MinMaxExclusiveUint32(min, max, minExclusive, maxExclusive)
return !(value < min || value > max || (maxExclusive && (value == max)) || (minExclusive && (value == min)))
}
// ToStringUint32 returns a string representation of the range using range notation
// (https://en.wikipedia.org/wiki/Interval_(mathematics)#Classification_of_intervals).
func ToStringUint32(min, max uint32, minExclusive, maxExclusive bool) string {
min, max, minExclusive, maxExclusive = MinMaxExclusiveUint32(min, max, minExclusive, maxExclusive)
var minBracket = "["
if minExclusive {
minBracket = "("
}
var maxBracket = "]"
if maxExclusive {
maxBracket = ")"
}
return minBracket + strconv.FormatUint(uint64(min), 10) + "," + strconv.FormatUint(uint64(max), 10) + maxBracket
}
// MaxUint32 returns the bigger of two numbers.
func MaxUint32(x, y uint32) uint32 {
if x < y {
return y
}
return x
}
// MinUint32 returns the smaller of two numbers.
func MinUint32(x, y uint32) uint32 {
if x > y {
return y
}
return x
}
// MinMaxUint32 swaps min and max to assure that min < max.
// It is automatically called for all the rest of the functions
// that do not expect minExclusive or maxExclusive.
func MinMaxUint32(min, max uint32) (uint32, uint32) {
if min > max {
return max, min
}
return min, max
}
// MinMaxExclusiveUint32 swaps min and max as well as minExclusive, maxExclusive correspondingly
// to assure that min < max together with the interval endings. It is automatically called for all
// the rest of the functions that expect minExclusive or maxExclusive.
func MinMaxExclusiveUint32(min, max uint32, minExclusive, maxExclusive bool) (uint32, uint32, bool, bool) {
if min > max {
return max, min, maxExclusive, minExclusive
}
return min, max, minExclusive, maxExclusive
}
// RangeUint32 represents a struct containing all the fields defining a range.
type RangeUint32 struct {
min uint32
max uint32
minExclusive bool
maxExclusive bool
}
// NewRangeUint32 makes a new Range and returns its pointer. RangeUint32 can also be created with a RangeUint32{...} literal or new(RangeUint32).
func NewRangeUint32(min uint32, max uint32, minExclusive bool, maxExclusive bool) *RangeUint32 {
return &RangeUint32{min: min, max: max, minExclusive: minExclusive, maxExclusive: maxExclusive}
}
// Wrap does not obey minExclusive and maxExclusive and always assumes [min,max) range.
func (v RangeUint32) Wrap(value uint32) uint32 {
return WrapUint32(v.min, v.max, value)
}
// Clamp does not obey minExclusive and maxExclusive and always assumes [min,max] range.
func (v RangeUint32) Clamp(value uint32) uint32 {
return ClampUint32(v.min, v.max, value)
}
// Validate tests whether the value is within [(min,max)] range (depending on minExclusive and maxExclusive).
// It returns the value if it is within the range, otherwise returns 0 and error.
func (v RangeUint32) Validate(value uint32) (uint32, error) {
return ValidateUint32(v.min, v.max, value, v.minExclusive, v.maxExclusive)
}
// Test returns true if the value is within [(min,max)] range (depending on minExclusive and maxExclusive).
func (v RangeUint32) Test(value uint32) bool {
return TestUint32(v.min, v.max, value, v.minExclusive, v.maxExclusive)
}
// String returns a string representation of the range using range notation
// (https://en.wikipedia.org/wiki/Interval_(mathematics)#Classification_of_intervals).
// String implements Stringer interface.
func (v RangeUint32) String() string {
return ToStringUint32(v.min, v.max, v.minExclusive, v.maxExclusive)
}