Swift Package Index


Custom assign operator that safely unwraps and assigns non-nil optionals.


  • The latest stable release is 3.0.0. Released over 1 year ago.
  • The last commit to master was over 1 year ago.

Swift Version Compatibility

  • 3.0.0 and master
    5.3
    5.2
    5.1
    5.0
    4.2
Full build results

Platform Compatibility

  • 3.0.0 and master
    iOS
    macOS(Intel)
    macOS(ARM)
    Linux
    tvOS
    watchOS
Full build results

GitHub License GitHub Tag Swift Package Manager Compatible Carthage Compatible Written in Swift Supported platforms Build Status

OptionalAssign

Custom assign operator that safely unwraps optionals and preserves existing value of the receiver (expression on the left side) unchanged, if the optional on the right side does not have a value (i.e. equal to nil).

When to use

Use this operator in these cases:

  • to safely assign a regular optional value, only if it has non-nil value (otherwise operator will do nothing);
  • to safely assign an implicitly unwrapped optional value, only if it has non-nil value (otherwise operator will do nothing).

BONUS: the value on the right will be automatically converted to receiver type before assign, so no need to cast explicitly.

How to use

Imagine you have a property that is required to always have a value, so you star with default value:

var title = 'Default value'

... and later you got a dictionary, that might have new value for the title:

let aDict: [String: AnyObject] = ... // maybe got from network?

This is how we can try to get new title value from the dictionary using standard Swift syntax:

if let newTitleValue = aDict["title"] as? String
{
    // yes it has a non-nil value
    title = newTitleValue
}

With optional assign operator you do the same with just this:

title ?= aDict["title"]

See unit tests for more examples.