public class AtomicInteger extends Number implements Serializable
int
value that may be updated atomically. See the
java.util.concurrent.atomic
package specification for
description of the properties of atomic variables. An
AtomicInteger
is used in applications such as atomically
incremented counters, and cannot be used as a replacement for an
Integer
. However, this class does extend
Number
to allow uniform access by tools and utilities that
deal with numerically-based classes.Constructor and Description |
---|
AtomicInteger()
Creates a new AtomicInteger with initial value
0 . |
AtomicInteger(int initialValue)
Creates a new AtomicInteger with the given initial value.
|
Modifier and Type | Method and Description |
---|---|
int |
addAndGet(int delta)
Atomically adds the given value to the current value.
|
boolean |
compareAndSet(int expect,
int update)
Atomically sets the value to the given updated value
if the current value
== the expected value. |
int |
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 . |
int |
get()
Gets the current value.
|
int |
getAndAdd(int delta)
Atomically adds the given value to the current value.
|
int |
getAndDecrement()
Atomically decrements by one the current value.
|
int |
getAndIncrement()
Atomically increments by one the current value.
|
int |
getAndSet(int newValue)
Atomically sets to the given value and returns the old value.
|
int |
incrementAndGet()
Atomically increments by one the current value.
|
int |
intValue()
Returns the value of the specified number as an
int . |
void |
lazySet(int newValue)
Eventually sets to the given value.
|
long |
longValue()
Returns the value of the specified number as a
long . |
void |
set(int newValue)
Sets to the given value.
|
String |
toString()
Returns the String representation of the current value.
|
boolean |
weakCompareAndSet(int expect,
int update)
Atomically sets the value to the given updated value
if the current value
== the expected value. |
byteValue, shortValue
public AtomicInteger(int initialValue)
initialValue
- the initial valuepublic AtomicInteger()
0
.public final int get()
public final void set(int newValue)
newValue
- the new valuepublic final void lazySet(int newValue)
newValue
- the new valuepublic final int getAndSet(int newValue)
newValue
- the new valuepublic final boolean compareAndSet(int expect, int update)
==
the expected value.expect
- the expected valueupdate
- the new valuepublic final boolean weakCompareAndSet(int expect, int 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 int getAndIncrement()
public final int getAndDecrement()
public final int getAndAdd(int delta)
delta
- the value to addpublic final int incrementAndGet()
public final int decrementAndGet()
public final int addAndGet(int 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, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.