public class AtomicLong
extends java.lang.Number
implements java.io.Serializable
long
value that may be updated atomically. See the
edu.emory.mathcs.backport.java.util.concurrent.atomic
package specification for
description of the properties of atomic variables. An
AtomicLong
is used in applications such as atomically
incremented sequence numbers, and cannot be used as a replacement
for a Long
. However, this class does extend
Number
to allow uniform access by tools and utilities that
deal with numerically-based classes.Constructor and Description |
---|
AtomicLong()
Creates a new AtomicLong with initial value
0 . |
AtomicLong(long initialValue)
Creates a new AtomicLong with the given initial value.
|
Modifier and Type | Method and Description |
---|---|
long |
addAndGet(long delta)
Atomically adds the given value to the current value.
|
boolean |
compareAndSet(long expect,
long update)
Atomically sets the value to the given updated value
if the current value
== the expected value. |
long |
decrementAndGet()
Atomically decrements by one the current value.
|
double |
doubleValue() |
float |
floatValue() |
long |
get()
Gets the current value.
|
long |
getAndAdd(long delta)
Atomically adds the given value to the current value.
|
long |
getAndDecrement()
Atomically decrements by one the current value.
|
long |
getAndIncrement()
Atomically increments by one the current value.
|
long |
getAndSet(long newValue)
Atomically sets to the given value and returns the old value.
|
long |
incrementAndGet()
Atomically increments by one the current value.
|
int |
intValue() |
void |
lazySet(long newValue)
Eventually sets to the given value.
|
long |
longValue() |
void |
set(long newValue)
Sets to the given value.
|
java.lang.String |
toString()
Returns the String representation of the current value.
|
boolean |
weakCompareAndSet(long expect,
long update)
Atomically sets the value to the given updated value
if the current value
== the expected value. |
public AtomicLong(long initialValue)
initialValue
- the initial valuepublic AtomicLong()
0
.public final long get()
public final void set(long newValue)
newValue
- the new valuepublic final void lazySet(long newValue)
newValue
- the new valuepublic final long getAndSet(long newValue)
newValue
- the new valuepublic final boolean compareAndSet(long expect, long update)
==
the expected value.expect
- the expected valueupdate
- the new valuepublic final boolean weakCompareAndSet(long expect, long update)
==
the expected value.
May fail spuriously
and does not provide ordering guarantees, so is only rarely an
appropriate alternative to compareAndSet
.
expect
- the expected valueupdate
- the new valuepublic final long getAndIncrement()
public final long getAndDecrement()
public final long getAndAdd(long delta)
delta
- the value to addpublic final long incrementAndGet()
public final long decrementAndGet()
public final long addAndGet(long delta)
delta
- the value to addpublic java.lang.String toString()
toString
in class java.lang.Object
public int intValue()
intValue
in class java.lang.Number
public long longValue()
longValue
in class java.lang.Number
public float floatValue()
floatValue
in class java.lang.Number
public double doubleValue()
doubleValue
in class java.lang.Number