Struct std::sync::atomic::AtomicIsize
[−]
[src]
pub struct AtomicIsize { // some fields omitted }
A signed integer type which can be safely shared between threads.
Methods
impl AtomicIsize
fn new(v: isize) -> AtomicIsize
Creates a new AtomicIsize
.
Examples
fn main() { use std::sync::atomic::AtomicIsize; let atomic_forty_two = AtomicIsize::new(42); }use std::sync::atomic::AtomicIsize; let atomic_forty_two = AtomicIsize::new(42);
fn load(&self, order: Ordering) -> isize
Loads a value from the isize.
load
takes an Ordering
argument which describes the memory ordering of this operation.
Panics
Panics if order
is Release
or AcqRel
.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.load(Ordering::Relaxed); }use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.load(Ordering::Relaxed);
fn store(&self, val: isize, order: Ordering)
Stores a value into the isize.
store
takes an Ordering
argument which describes the memory ordering of this operation.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); some_isize.store(10, Ordering::Relaxed); }use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); some_isize.store(10, Ordering::Relaxed);
Panics
Panics if order
is Acquire
or AcqRel
.
fn swap(&self, val: isize, order: Ordering) -> isize
Stores a value into the isize, returning the old value.
swap
takes an Ordering
argument which describes the memory ordering of this operation.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.swap(10, Ordering::Relaxed); }use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.swap(10, Ordering::Relaxed);
fn compare_and_swap(&self, old: isize, new: isize, order: Ordering) -> isize
Stores a value into the isize if the current value is the same as the expected value.
The return value is always the previous value. If it is equal to old
, then the value was
updated.
compare_and_swap
also takes an Ordering
argument which describes the memory ordering of
this operation.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.compare_and_swap(5, 10, Ordering::Relaxed); }use std::sync::atomic::{AtomicIsize, Ordering}; let some_isize = AtomicIsize::new(5); let value = some_isize.compare_and_swap(5, 10, Ordering::Relaxed);
fn fetch_add(&self, val: isize, order: Ordering) -> isize
Add an isize to the current value, returning the previous value.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0); assert_eq!(0, foo.fetch_add(10, Ordering::SeqCst)); assert_eq!(10, foo.load(Ordering::SeqCst)); }use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0); assert_eq!(0, foo.fetch_add(10, Ordering::SeqCst)); assert_eq!(10, foo.load(Ordering::SeqCst));
fn fetch_sub(&self, val: isize, order: Ordering) -> isize
Subtract an isize from the current value, returning the previous value.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0); assert_eq!(0, foo.fetch_sub(10, Ordering::SeqCst)); assert_eq!(-10, foo.load(Ordering::SeqCst)); }use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0); assert_eq!(0, foo.fetch_sub(10, Ordering::SeqCst)); assert_eq!(-10, foo.load(Ordering::SeqCst));
fn fetch_and(&self, val: isize, order: Ordering) -> isize
Bitwise and with the current isize, returning the previous value.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_and(0b110011, Ordering::SeqCst)); assert_eq!(0b100001, foo.load(Ordering::SeqCst)); }use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_and(0b110011, Ordering::SeqCst)); assert_eq!(0b100001, foo.load(Ordering::SeqCst));
fn fetch_or(&self, val: isize, order: Ordering) -> isize
Bitwise or with the current isize, returning the previous value.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_or(0b110011, Ordering::SeqCst)); assert_eq!(0b111111, foo.load(Ordering::SeqCst)); }use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_or(0b110011, Ordering::SeqCst)); assert_eq!(0b111111, foo.load(Ordering::SeqCst));
fn fetch_xor(&self, val: isize, order: Ordering) -> isize
Bitwise xor with the current isize, returning the previous value.
Examples
fn main() { use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_xor(0b110011, Ordering::SeqCst)); assert_eq!(0b011110, foo.load(Ordering::SeqCst)); }use std::sync::atomic::{AtomicIsize, Ordering}; let foo = AtomicIsize::new(0b101101); assert_eq!(0b101101, foo.fetch_xor(0b110011, Ordering::SeqCst)); assert_eq!(0b011110, foo.load(Ordering::SeqCst));