java.util.concurrent.atomic
public class
public class
java.util.concurrent.atomic.AtomicLong
| java.lang.Object | |||
| java.lang.Number | Serializable | ||
| java.util.concurrent.atomic.AtomicLong | Serializable | ||
A 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.
Summary
Public Constructors
| AtomicLong(long initialValue) | |||||
| Create a new AtomicLong with the given initial value. | |||||
| AtomicLong() | |||||
| Create a new AtomicLong with initial value 0. | |||||
Public Methods
| final | long | addAndGet(long delta) | |||
| Atomically add the given value to current value. | |||||
| final | boolean | compareAndSet(long expect, long update) | |||
| Atomically set the value to the given updated value if the current value == the expected value. | |||||
| final | long | decrementAndGet() | |||
| Atomically decrement by one the current value. | |||||
| double | doubleValue() | ||||
| Answers the double value which the receiver represents | |||||
| float | floatValue() | ||||
| Answers the float value which the receiver represents | |||||
| final | long | get() | |||
| Get the current value. | |||||
| final | long | getAndAdd(long delta) | |||
| Atomically add the given value to current value. | |||||
| final | long | getAndDecrement() | |||
| Atomically decrement by one the current value. | |||||
| final | long | getAndIncrement() | |||
| Atomically increment by one the current value. | |||||
| final | long | getAndSet(long newValue) | |||
| Set to the give value and return the old value. | |||||
| final | long | incrementAndGet() | |||
| Atomically increment by one the current value. | |||||
| int | intValue() | ||||
| Answers the int value which the receiver represents | |||||
| long | longValue() | ||||
| Answers the long value which the receiver represents | |||||
| final | void | set(long newValue) | |||
| Set to the given value. | |||||
| String | toString() | ||||
| Returns the String representation of the current value. | |||||
| final | boolean | weakCompareAndSet(long expect, long update) | |||
| Atomically set the value to the given updated value if the current value == the expected value. | |||||
Methods inherited
from class
java.lang.Number
Methods inherited
from class
java.lang.Object
Details
Public Constructors
public AtomicLong(long initialValue)
Create a new AtomicLong with the given initial value.
Parameters
| initialValue | the initial value |
|---|
public AtomicLong()
Create a new AtomicLong with initial value 0.
Public Methods
public final long addAndGet(long delta)
Atomically add the given value to current value.
Parameters
| delta | the value to add |
|---|
Returns
- the updated value
public final boolean compareAndSet(long expect, long update)
Atomically set the value to the given updated value
if the current value == the expected value.
Parameters
| expect | the expected value |
|---|---|
| update | the new value |
Returns
- true if successful. False return indicates that the actual value was not equal to the expected value.
public final long decrementAndGet()
Atomically decrement by one the current value.
Returns
- the updated value
public double doubleValue()
Answers the double value which the receiver represents
public float floatValue()
Answers the float value which the receiver represents
public final long get()
Get the current value.
Returns
- the current value
public final long getAndAdd(long delta)
Atomically add the given value to current value.
Parameters
| delta | the value to add |
|---|
Returns
- the previous value
public final long getAndDecrement()
Atomically decrement by one the current value.
Returns
- the previous value
public final long getAndIncrement()
Atomically increment by one the current value.
Returns
- the previous value
public final long getAndSet(long newValue)
Set to the give value and return the old value.
Parameters
| newValue | the new value |
|---|
Returns
- the previous value
public final long incrementAndGet()
Atomically increment by one the current value.
Returns
- the updated value
public int intValue()
Answers the int value which the receiver represents
public long longValue()
Answers the long value which the receiver represents
public final void set(long newValue)
Set to the given value.
Parameters
| newValue | the new value |
|---|
public String toString()
Returns the String representation of the current value.
Returns
- the String representation of the current value.
public final boolean weakCompareAndSet(long expect, long update)
Atomically set the value to the given updated value
if the current value == the expected value.
May fail spuriously.
Parameters
| expect | the expected value |
|---|---|
| update | the new value |
Returns
- true if successful.