public class AtomicLong extends Number implements Serializable
long
value that may be updated atomically. See the
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()
Returns the value of the specified number as a
double . |
float |
floatValue()
Returns the value of the specified number as a
float . |
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()
Returns the value of the specified number as an
int . |
void |
lazySet(long newValue)
Eventually sets to the given value.
|
long |
longValue()
Returns the value of the specified number as a
long . |
void |
set(long newValue)
Sets to the given value.
|
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. |
byteValue, shortValue
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 String toString()
public int intValue()
Number
int
.
This may involve rounding or truncation.public long longValue()
Number
long
.
This may involve rounding or truncation.public float floatValue()
Number
float
.
This may involve rounding.floatValue
in class Number
float
.public double doubleValue()
Number
double
.
This may involve rounding.doubleValue
in class Number
double
. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2012, Oracle and/or its affiliates. All rights reserved.