AtomicInteger Class

Definition

Namespace:: Java.Util.Concurrent.Atomic

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

An int value that may be updated atomically.

[Android.Runtime.Register("java/util/concurrent/atomic/AtomicInteger", DoNotGenerateAcw=true)]
public class AtomicInteger : Java.Lang.Number, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/util/concurrent/atomic/AtomicInteger", DoNotGenerateAcw=true)>]
type AtomicInteger = class
    inherit Number
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Inheritance: Object

Object

Number
AtomicInteger

Attributes: RegisterAttribute

Implements: IJavaObject IJavaPeerable ISerializable IDisposable

Remarks

An int value that may be updated atomically. See the VarHandle specification for descriptions of the properties of atomic accesses. An AtomicInteger is used in applications such as atomically incremented counters, and cannot be used as a replacement for an java.lang.Integer. However, this class does extend Number to allow uniform access by tools and utilities that deal with numerically-based classes.

Added in 1.5.

Java documentation for java.util.concurrent.atomic.AtomicInteger.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

Name	Description
AtomicInteger()	Creates a new AtomicInteger with initial value `0`.
AtomicInteger(Int32)	Creates a new AtomicInteger with the given initial value.
AtomicInteger(IntPtr, JniHandleOwnership)	A constructor used when creating managed representations of JNI objects; called by the runtime.

Properties

Name	Description
Acquire	Returns the current value, with memory effects as specified by `VarHandle#getAcquire`.
AndDecrement	Obsolete. Atomically decrements by one the current value.
AndIncrement	Obsolete. Atomically increments by one the current value.
Class	Returns the runtime class of this `Object`. (Inherited from Object)
Handle	The handle to the underlying Android instance. (Inherited from Object)
JniIdentityHashCode	Gets the identity hash code assigned to this Java peer by the interop runtime. (Inherited from Object)
JniPeerMembers
Opaque	Returns the current value, with memory effects as specified by `VarHandle#getOpaque`. -or- Sets the value to `newValue`, with memory effects as specified by `VarHandle#setOpaque`.
PeerReference	Gets the JNI object reference for this Java peer. (Inherited from Object)
Plain	Returns the current value, with memory semantics of reading as if the variable was declared non-`volatile`. -or- Sets the value to `newValue`, with memory semantics of setting as if the variable was declared non-`volatile` and non-`final`.
ThresholdClass	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.
ThresholdType	This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

Methods

Name	Description
AccumulateAndGet(Int32, IIntBinaryOperator)	Atomically updates (with memory effects as specified by `VarHandle#compareAndSet`) the current value with the results of applying the given function to the current and given values, returning the updated value.
AddAndGet(Int32)	Atomically adds the given value to the current value, with memory effects as specified by `VarHandle#getAndAdd`.
ByteValue()	Returns the value of the specified number as a `byte`. (Inherited from Number)
Clone()	Creates and returns a copy of this object. (Inherited from Object)
CompareAndExchange(Int32, Int32)	Atomically sets the value to `newValue` if the current value, referred to as the <em>witness value</em>, `== expectedValue`, with memory effects as specified by `VarHandle#compareAndExchange`.
CompareAndExchangeAcquire(Int32, Int32)	Atomically sets the value to `newValue` if the current value, referred to as the <em>witness value</em>, `== expectedValue`, with memory effects as specified by `VarHandle#compareAndExchangeAcquire`.
CompareAndExchangeRelease(Int32, Int32)	Atomically sets the value to `newValue` if the current value, referred to as the <em>witness value</em>, `== expectedValue`, with memory effects as specified by `VarHandle#compareAndExchangeRelease`.
CompareAndSet(Int32, Int32)	Atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#compareAndSet`.
DecrementAndGet()	Atomically decrements the current value, with memory effects as specified by `VarHandle#getAndAdd`.
Dispose()	Releases the resources held by this Java peer. (Inherited from Object)
Dispose(Boolean)	Releases the resources held by this Java peer. (Inherited from Object)
DoubleValue()	Returns the current value of this `AtomicInteger` as a `double` after a widening primitive conversion, with memory effects as specified by `VarHandle#getVolatile`.
Equals(Object)	Indicates whether some other object is "equal to" this one. (Inherited from Object)
FloatValue()	Returns the current value of this `AtomicInteger` as a `float` after a widening primitive conversion, with memory effects as specified by `VarHandle#getVolatile`.
Get()	Returns the current value, with memory effects as specified by `VarHandle#getVolatile`.
GetAndAccumulate(Int32, IIntBinaryOperator)	Atomically updates (with memory effects as specified by `VarHandle#compareAndSet`) the current value with the results of applying the given function to the current and given values, returning the previous value.
GetAndAdd(Int32)	Atomically adds the given value to the current value, with memory effects as specified by `VarHandle#getAndAdd`.
GetAndDecrement()	Atomically decrements the current value, with memory effects as specified by `VarHandle#getAndAdd`.
GetAndIncrement()	Atomically increments the current value, with memory effects as specified by `VarHandle#getAndAdd`.
GetAndSet(Int32)	Atomically sets the value to `newValue` and returns the old value, with memory effects as specified by `VarHandle#getAndSet`.
GetAndUpdate(IIntUnaryOperator)	Atomically updates (with memory effects as specified by `VarHandle#compareAndSet`) the current value with the results of applying the given function, returning the previous value.
GetHashCode()	Returns a hash code value for the object. (Inherited from Object)
IncrementAndGet()	Atomically increments the current value, with memory effects as specified by `VarHandle#getAndAdd`.
IntValue()	Returns the current value of this `AtomicInteger` as an `int`, with memory effects as specified by `VarHandle#getVolatile`.
JavaFinalize()	Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object)
LazySet(Int32)	Sets the value to `newValue`, with memory effects as specified by `VarHandle#setRelease`.
LongValue()	Returns the current value of this `AtomicInteger` as a `long` after a widening primitive conversion, with memory effects as specified by `VarHandle#getVolatile`.
Notify()	Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object)
NotifyAll()	Wakes up all threads that are waiting on this object's monitor. (Inherited from Object)
Set(Int32)	Sets the value to `newValue`, with memory effects as specified by `VarHandle#setVolatile`.
SetHandle(IntPtr, JniHandleOwnership)	Sets the Handle property. (Inherited from Object)
SetRelease(Int32)	Sets the value to `newValue`, with memory effects as specified by `VarHandle#setRelease`.
ShortValue()	Returns the value of the specified number as a `short`. (Inherited from Number)
ToArray<T>()	Creates a managed array from this Java array wrapper. (Inherited from Object)
ToString()	Returns a string representation of the object. (Inherited from Object)
UnregisterFromRuntime()	Unregisters this Java peer from the interop runtime. (Inherited from Object)
UpdateAndGet(IIntUnaryOperator)	Atomically updates (with memory effects as specified by `VarHandle#compareAndSet`) the current value with the results of applying the given function, returning the updated value.
Wait()	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object)
Wait(Int64, Int32)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)
Wait(Int64)	Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object)
WeakCompareAndSet(Int32, Int32)	Possibly atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#weakCompareAndSetPlain`.
WeakCompareAndSetAcquire(Int32, Int32)	Possibly atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#weakCompareAndSetAcquire`.
WeakCompareAndSetPlain(Int32, Int32)	Possibly atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#weakCompareAndSetPlain`.
WeakCompareAndSetRelease(Int32, Int32)	Possibly atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#weakCompareAndSetRelease`.
WeakCompareAndSetVolatile(Int32, Int32)	Possibly atomically sets the value to `newValue` if the current value `== expectedValue`, with memory effects as specified by `VarHandle#weakCompareAndSet`.

Explicit Interface Implementations

Name	Description
IJavaPeerable.Disposed()	Notifies the interop runtime that this managed peer has been disposed. (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced()	Releases this Java peer unless it is retained by another managed reference. (Inherited from Object)
IJavaPeerable.Finalized()	Notifies the interop runtime that this managed peer has been finalized. (Inherited from Object)
IJavaPeerable.JniManagedPeerState	Gets the state that describes the relationship between this managed peer and its JNI reference. (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Sets the interop identity hash code for this Java peer. (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Sets the managed and JNI peer state for this Java peer. (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	Sets the JNI object reference used by this managed peer. (Inherited from Object)

Extension Methods

Name	Description
GetJniTypeName(IJavaPeerable)	Gets the JNI name of the type of the instance `self`.
JavaAs<TResult>(IJavaPeerable)	Try to coerce `self` to type `TResult`, checking that the coercion is valid on the Java side.
JavaCast<TResult>(IJavaObject)	Performs an Android runtime-checked type conversion.
JavaCast<TResult>(IJavaObject)
TryJavaCast<TResult>(IJavaPeerable, TResult)	Try to coerce `self` to type `TResult`, checking that the coercion is valid on the Java side.

Applies to