Atomic
Atomic is a fast, safe class for making values thread-safe in Swift. It is backed by pthread_mutex_lock which is the fastest, most-efficient locking mechanism available.
Installation
- Using CocoaPods by adding
pod Atomicto your Podfile - Using Carthage by adding
github "Adlai-Holler/Atomic"to your Cartfile.
How to Use
/// This class is completely thread-safe (yay!).
final class MyCache<Value> {
private let entries: Atomic<[String: Value]> = Atomic([:])
func valueForKey(key: String) -> Value? {
return entries.withValue { $0[key] }
}
func setValue(value: Value, forKey: Key) {
entries.modify { (var dict) in
dict[key] = value
return dict
}
}
func clear() {
entries.value = [:]
}
func copy() -> [String: Value] {
return entries.value
}
}
Another Example
/// Thread-safe manager for the `networkActivityIndicator` on iOS.
final class NetworkActivityIndicatorManager {
static let shared = NetworkActivityIndicatorManager()
private let count = Atomic(0)
func incrementActivityCount() {
let oldValue = count.modify { $0 + 1 }
if oldValue == 0 {
updateUI(true)
}
}
func decrementActivityCount() {
let oldValue = count.modify { $0 - 1 }
if oldValue == 1 {
updateUI(false)
}
}
private func updateUI(on: Bool) {
dispatch_async(dispatch_get_main_queue()) {
UIApplication.sharedApplication().networkActivityIndicatorVisible = true
}
}
}
Features
- Safe. No need to remember to unlock.
- Fast.
pthread_mutex_lockis faster thanNSLockand more efficient thanOSSpinLock. - Modern. You can safely
throwerrors inside its methods, uses@noescapeand generics to make your code as clean as possible. - Tested. This thing is tested like crazy, including accessing it concurrently from 100,000 operations!
Attribution
The original version of Atomic.swift was written by the ReactiveCocoa contributors.
183 Sep 9, 2022
1.8k Jan 7, 2023
317 Dec 6, 2022
109 Jan 29, 2022
75 May 19, 2022
31 Jul 1, 2019
23 Oct 14, 2022
9 Jul 7, 2022
42 Oct 5, 2022
156 Aug 31, 2022
60 Aug 11, 2022
2k Dec 24, 2022
173 Apr 11, 2022
808 Dec 1, 2022
1.5k Dec 22, 2022
4.6k Dec 27, 2022
752 Dec 5, 2022
764 Dec 29, 2022