1 package org.djutils.base;
2
3 import java.util.Objects;
4
5 /**
6 * A simple version of a mutable long with get() and set(long) functions.
7 * <p>
8 * Copyright (c) 2023-2024 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See
9 * for project information <a href="https://djutils.org" target="_blank"> https://djutils.org</a>. The DJUTILS project is
10 * distributed under a three-clause BSD-style license, which can be found at
11 * <a href="https://djutils.org/docs/license.html" target="_blank"> https://djutils.org/docs/license.html</a>.
12 * </p>
13 * @author <a href="https://www.tudelft.nl/averbraeck">Alexander Verbraeck</a>
14 */
15 public class MutableLong
16 {
17 /** the current value of the mutable long. */
18 private long value;
19
20 /**
21 * Initialize the mutable long with a value.
22 * @param value long; the initial value of the mutable long
23 */
24 public MutableLong(final long value)
25 {
26 set(value);
27 }
28
29 /**
30 * set the mutable long to a new value.
31 * @param newValue long; the new value of the mutable long
32 */
33 public void set(final long newValue)
34 {
35 this.value = newValue;
36 }
37
38 /**
39 * @return long; the current value of the mutable long
40 */
41 public long get()
42 {
43 return this.value;
44 }
45
46 /**
47 * Increment the modifiable long with a value.
48 * @param increment long; the value to increment the modifiable long with
49 */
50 public void inc(final long increment)
51 {
52 this.value += increment;
53 }
54
55 /**
56 * Increment the modifiable long with 1.
57 */
58 public void inc()
59 {
60 inc(1);
61 }
62
63 /**
64 * Decrement the modifiable long with a value.
65 * @param decrement long; the value to decrement the modifiable long with
66 */
67 public void dec(final long decrement)
68 {
69 this.value -= decrement;
70 }
71
72 /**
73 * Decrement the modifiable long with 1.
74 */
75 public void dec()
76 {
77 dec(1);
78 }
79
80 /**
81 * Increment the modifiable long with a value.
82 * @param multiplier long; the value to multiply the modifiable long with
83 */
84 public void mul(final long multiplier)
85 {
86 this.value *= multiplier;
87 }
88
89 /**
90 * Divide the modifiable long by a value.
91 * @param divisor long; the value to divide the modifiable long by
92 */
93 public void div(final long divisor)
94 {
95 this.value /= divisor;
96 }
97
98 @Override
99 public int hashCode()
100 {
101 return Objects.hash(this.value);
102 }
103
104 @Override
105 @SuppressWarnings("checkstyle:needbraces")
106 public boolean equals(final Object obj)
107 {
108 if (this == obj)
109 return true;
110 if (obj == null)
111 return false;
112 if (getClass() != obj.getClass())
113 return false;
114 MutableLong other = (MutableLong) obj;
115 return this.value == other.value;
116 }
117
118 @Override
119 public String toString()
120 {
121 return "MutableLong [value=" + this.value + "]";
122 }
123
124 }