Thursday, September 11, 2025
HomeiOS DevelopmentSwift actors tutorial - a newbie's information to string secure concurrency

Swift actors tutorial – a newbie’s information to string secure concurrency


Thread security & knowledge races

Earlier than we dive in to Swift actors, let’s have a simplified recap of pc principle first.

An occasion of a pc program is named course of). A course of accommodates smaller directions which might be going to be executed in some unspecified time in the future in time. These instruction duties may be carried out one after one other in a serial order or concurrently. The working system is utilizing a number of threads) to execute duties in parallel, additionally schedules the order of execution with the assistance of a scheduler). 🕣

After a process is being accomplished on a given thread), the CPU can to maneuver ahead with the execution circulation. If the brand new process is related to a distinct thread, the CPU has to carry out a context swap. That is fairly an costly operation, as a result of the state of the previous thread must be saved, the brand new one ought to be restored earlier than we will carry out our precise process.

Throughout this context switching a bunch of different oprations can occur on totally different threads. Since trendy CPU architectures have a number of cores, they’ll deal with a number of threads on the similar time. Issues can occur if the identical useful resource is being modified on the similar time on a number of threads. Let me present you a fast instance that produces an unsafe output. 🙉

var unsafeNumber: Int = 0
DispatchQueue.concurrentPerform(iterations: 100) { i in
    print(Thread.present)
    unsafeNumber = i
}

print(unsafeNumber)

When you run the code above a number of occasions, it is potential to have a distinct output every time. It is because the concurrentPerform methodology runs the block on totally different threads, some threads have larger priorities than others so the execution order will not be assured. You’ll be able to see this for your self, by printing the present thread in every block. Among the quantity modifications occur on the primary thread, however others occur on a background thread. 🧵

The principle thread is a particular one, all of the person interface associated updates ought to occur on this one. In case you are making an attempt to replace a view from a background thread in an iOS software you may might get an warning / error or perhaps a crash. In case you are blocking the primary thread with an extended operating software your total UI can turn out to be unresponsive, that is why it’s good to have a number of threads, so you’ll be able to transfer your computation-heavy operations into background threads.

It is a quite common strategy to work with a number of threads, however this may result in undesirable knowledge races, knowledge corruption or crashes resulting from reminiscence points. Sadly many of the Swift knowledge sorts aren’t thread secure by default, so if you wish to obtain thread-safety you often needed to work with serial queues or locks to ensure the mutual exclusivity of a given variable.

var threads: [Int: String] = [:]
DispatchQueue.concurrentPerform(iterations: 100) { i in
    threads[i] = "(Thread.present)"
}
print(threads)

The snippet above will crash for positive, since we’re making an attempt to switch the identical dictionary from a number of threads. That is referred to as a data-race. You’ll be able to detect these type of points by enabling the Thread Sanitizer underneath the Scheme > Run > Diagnostics tab in Xcode. 🔨

Now that we all know what’s a knowledge race, let’s repair that through the use of a daily Grand Central Dispatch based mostly strategy. We will create a brand new serial dispatch queue to forestall concurrent writes, this can syncronize all of the write operations, however after all it has a hidden price of switching the context each time we replace the dictionary.

var threads: [Int: String] = [:]
let lockQueue = DispatchQueue(label: "my.serial.lock.queue")
DispatchQueue.concurrentPerform(iterations: 100) { i in
    lockQueue.sync {
        threads[i] = "(Thread.present)"
    }
}
print(threads)

This synchronization method is a fairly fashionable resolution, we might create a generic class that hides the interior personal storage and the lock queue, so we will have a pleasant public interface that you need to use safely with out coping with the interior safety mechanism. For the sake of simplicity we’re not going to introduce generics this time, however I will present you a easy AtomicStorage implementation that makes use of a serial queue as a lock system. 🔒

import Basis
import Dispatch

class AtomicStorage {

    personal let lockQueue = DispatchQueue(label: "my.serial.lock.queue")
    personal var storage: [Int: String]
    
    init() {
        self.storage = [:]
    }
        
    func get(_ key: Int) -> String? {
        lockQueue.sync {
            storage[key]
        }
    }
    
    func set(_ key: Int, worth: String) {
        lockQueue.sync {
            storage[key] = worth
        }
    }

    var allValues: [Int: String] {
        lockQueue.sync {
            storage
        }
    }
}

let storage = AtomicStorage()
DispatchQueue.concurrentPerform(iterations: 100) { i in
    storage.set(i, worth: "(Thread.present)")
}
print(storage.allValues)

Since each learn and write operations are sync, this code may be fairly sluggish because the total queue has to attend for each the learn and write operations. Let’s repair this actual fast by altering the serial queue to a concurrent one, and marking the write perform with a barrier flag. This fashion customers can learn a lot sooner (concurrently), however writes might be nonetheless synchronized via these barrier factors.

import Basis
import Dispatch

class AtomicStorage {

    personal let lockQueue = DispatchQueue(label: "my.concurrent.lock.queue", attributes: .concurrent)
    personal var storage: [Int: String]
    
    init() {
        self.storage = [:]
    }
        
    func get(_ key: Int) -> String? {
        lockQueue.sync {
            storage[key]
        }
    }
    
    func set(_ key: Int, worth: String) {
        lockQueue.async(flags: .barrier) { [unowned self] in
            storage[key] = worth
        }
    }

    var allValues: [Int: String] {
        lockQueue.sync {
            storage
        }
    }
}

let storage = AtomicStorage()
DispatchQueue.concurrentPerform(iterations: 100) { i in
    storage.set(i, worth: "(Thread.present)")
}
print(storage.allValues)

After all we might pace up the mechanism with dispatch obstacles, alternatively we might use an os_unfair_lock, NSLock or a dispatch semaphore to create comparable thread-safe atomic objects.

One essential takeaway is that even when we try to pick the most effective accessible possibility through the use of sync we’ll all the time block the calling thread too. Because of this nothing else can run on the thread that calls synchronized features from this class till the interior closure completes. Since we’re synchronously ready for the thread to return we will not make the most of the CPU for different work. ⏳

We are able to say that there are numerous issues with this strategy:

  • Context switches are costly operations
  • Spawning a number of threads can result in thread explosions
  • You’ll be able to (by accident) block threads and stop additional code execution
  • You’ll be able to create a impasse if a number of duties are ready for one another
  • Coping with (completion) blocks and reminiscence references are error susceptible
  • It is very easy to overlook to name the right synchronization block

That is numerous code simply to supply thread-safe atomic entry to a property. Even if we’re utilizing a concurrent queue with obstacles (locks have issues too), the CPU wants to change context each time we’re calling these features from a distinct thread. Because of the synchronous nature we’re blocking threads, so this code will not be probably the most environment friendly.

Luckily Swift 5.5 presents a secure, trendy and total significantly better different. 🥳

Introducing Swift actors

Now let’s refactor this code utilizing the new Actor kind launched in Swift 5.5. Actors can shield inner state via knowledge isolation making certain that solely a single thread could have entry to the underlying knowledge construction at a given time. Lengthy story quick, all the things inside an actor might be thread-safe by default. First I will present you the code, then we’ll discuss it. 😅

import Basis

actor AtomicStorage {

    personal var storage: [Int: String]
    
    init() {
        self.storage = [:]
    }
        
    func get(_ key: Int) -> String? {
        storage[key]
    }
    
    func set(_ key: Int, worth: String) {
        storage[key] = worth
    }

    var allValues: [Int: String] {
        storage
    }
}

Activity {
    let storage = AtomicStorage()
    await withTaskGroup(of: Void.self) { group in
        for i in 0..<100 {
            group.async {
                await storage.set(i, worth: "(Thread.present)")
            }
        }
    }
    print(await storage.allValues)
}

To start with, actors are reference sorts, identical to courses. They’ll have strategies, properties, they’ll implement protocols, however they do not assist inheritance.

Since actors are intently associated to the newly launched async/await concurrency APIs in Swift you have to be acquainted with that idea too if you wish to perceive how they work.

The very first huge distinction is that we needn’t present a lock mechanism anymore with the intention to present learn or write entry to our personal storage property. Because of this we will safely entry actor properties inside the actor utilizing a synchronous approach. Members are remoted by default, so there’s a assure (by the compiler) that we will solely entry them utilizing the identical context.

What is going on on with the brand new Activity API and all of the await key phrases? 🤔

Properly, the Dispatch.concurrentPerform name is a part of a parallelism API and Swift 5.5 launched concurrency as a substitute of parallelism, we now have to maneuver away from common queues and use structured concurrency to carry out duties in parallel. Additionally the concurrentPerform perform will not be an asynchronous operation, it’s going to block the caller thread till all of the work is completed inside the block.

Working with async/await signifies that the CPU can work on a distinct process when awaits for a given operation. Each await name is a possible suspension level, the place the perform can provide up the thread and the CPU can carry out different duties till the awaited perform resumes & returns with the mandatory worth. The new Swift concurrency APIs are constructed on high a cooperative thread pool, the place every CPU core has simply the correct quantity of threads and the suspension & continuation occurs “nearly” with the assistance of the language runtime. That is way more environment friendly than precise context switching, and in addition signifies that whenever you work together with async features and await for a perform the CPU can work on different duties as a substitute of blocking the thread on the decision aspect.

So again to the instance code, since actors have to guard their inner states, they solely permits us to entry members asynchronously whenever you reference from async features or outdoors the actor. That is similar to the case once we had to make use of the lockQueue.sync to guard our learn / write features, however as a substitute of giving the power to the system to carry out different duties on the thread, we have totally blocked it with the sync name. Now with await we can provide up the thread and permit others to carry out operations utilizing it and when the time comes the perform can resume.

Inside the duty group we will carry out our duties asynchronously, however since we’re accessing the actor perform (from an async context / outdoors the actor) we now have to make use of the await key phrase earlier than the set name, even when the perform will not be marked with the async key phrase.

The system is aware of that we’re referencing the actor’s property utilizing a distinct context and we now have to carry out this operation all the time remoted to remove knowledge races. By changing the perform to an async name we give the system an opportunity to carry out the operation on the actor’s executor. In a while we’ll be capable of outline customized executors for our actors, however this function will not be accessible but.

At the moment there’s a international executor implementation (related to every actor) that enqueues the duties and runs them one-by-one, if a process will not be operating (no rivalry) it’s going to be scheduled for execution (based mostly on the precedence) in any other case (if the duty is already operating / underneath rivalry) the system will simply pick-up the message with out blocking.

The humorous factor is that this doesn’t crucial signifies that the very same thread… 😅

import Basis

extension Thread {
    var quantity: String {
        "(worth(forKeyPath: "personal.seqNum")!)"
    }
}

actor AtomicStorage {

    personal var storage: [Int: String]
    
    init() {
        print("init actor thread: (Thread.present.quantity)")
        self.storage = [:]
    }
        
    func get(_ key: Int) -> String? {
        storage[key]
    }
    
    func set(_ key: Int, worth: String) {
        storage[key] = worth + ", actor thread: (Thread.present.quantity)"
    }

    var allValues: [Int: String] {
        print("allValues actor thread: (Thread.present.quantity)")
        return storage
    }
}


Activity {
    let storage = AtomicStorage()
    await withTaskGroup(of: Void.self) { group in
        for i in 0..<100 {
            group.async {
                await storage.set(i, worth: "caller thread: (Thread.present.quantity)")
            }
        }
    }    
    for (okay, v) in await storage.allValues {
        print(okay, v)
    }
}

Multi-threading is tough, anyway similar factor applies to the storage.allValues assertion. Since we’re accessing this member from outdoors the actor, we now have to await till the “synchronization occurs”, however with the await key phrase we can provide up the present thread, wait till the actor returns again the underlying storage object utilizing the related thread, and voilá we will proceed simply the place we left off work. After all you’ll be able to create async features inside actors, whenever you name these strategies you may all the time have to make use of await, irrespective of in case you are calling them from the actor or outdoors.

There may be nonetheless quite a bit to cowl, however I do not need to bloat this text with extra superior particulars. I do know I am simply scratching the floor and we might discuss non-isolated features, actor reentrancy, international actors and plenty of extra. I will positively create extra articles about actors in Swift and canopy these matters within the close to future, I promise. Swift 5.5 goes to be an incredible launch. 👍

Hopefully this tutorial will assist you to to start out working with actors in Swift. I am nonetheless studying quite a bit in regards to the new concurrency APIs and nothing is written in stone but, the core group remains to be altering names and APIs, there are some proposals on the Swift evolution dashboard that also must be reviewed, however I feel the Swift group did a tremendous job. Thanks everybody. 🙏

Truthfully actors appears like magic and I already love them. 😍

RELATED ARTICLES

LEAVE A REPLY

Please enter your comment!
Please enter your name here

Most Popular

Recent Comments