public class

AtomicBoolean

extends Object
implements Serializable
java.lang.Object
   ↳ java.util.concurrent.atomic.AtomicBoolean

Class Overview

A boolean value that may be updated atomically. See the java.util.concurrent.atomic package specification for description of the properties of atomic variables. An AtomicBoolean is used in applications such as atomically updated flags, and cannot be used as a replacement for a Boolean.

Summary

Public Constructors
AtomicBoolean(boolean initialValue)
Creates a new AtomicBoolean with the given initial value.
AtomicBoolean()
Creates a new AtomicBoolean with initial value false.
Public Methods
final boolean compareAndSet(boolean expect, boolean update)
Atomically sets the value to the given update value if the current value is equal to the expected value.
final boolean get()
Returns the current value.
final boolean getAndSet(boolean newValue)
Sets to the given value and returns the previous value.
final void set(boolean newValue)
Unconditionally sets to the given value.
String toString()
Returns the String representation of the current value.
boolean weakCompareAndSet(boolean expect, boolean update)
Atomically set the value to the given updated value if the current value == the expected value.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public AtomicBoolean (boolean initialValue)

Creates a new AtomicBoolean with the given initial value.

Parameters
initialValue the initial value

public AtomicBoolean ()

Creates a new AtomicBoolean with initial value false.

Public Methods

public final boolean compareAndSet (boolean expect, boolean update)

Atomically sets the value to the given update value if the current value is equal to the expected value. Any given invocation of this operation may fail (return false) spuriously, but repeated invocation when the current value holds the expected value and no other thread is also attempting to set the value will eventually succeed.

Parameters
expect the expected value
update the new value
Returns
  • true if successful

public final boolean get ()

Returns the current value.

Returns
  • the current value

public final boolean getAndSet (boolean newValue)

Sets to the given value and returns the previous value.

Parameters
newValue the new value
Returns
  • the previous value

public final void set (boolean newValue)

Unconditionally sets 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 boolean weakCompareAndSet (boolean expect, boolean 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.