In Swift, what does the ! symbol mean in a function signature?

by

This isn’t quite a duplicate — there’s some subtlety to implicitly unwrapped optionals in function signatures beyond their usage elsewhere.

You see implicitly unwrapped optionals in API imported from ObjC because that’s the closest Swift approximation of an object that’s expected to be there but which can be nil. It’s a compromise for imported API — you can address these variables directly like in ObjC, and you can test them for nil using Swift optional syntax. (There’s more about Apple’s rationale for this in the Advanced Interoperability talk from WWDC14.) This pattern also applies to the IBAction declarations inserted by Interface Builder, since those methods are in effect getting called from ObjC code, too.

As you seem to have suspected, Swift wraps the possible nil in an optional when bridging from ObjC, but the ! in your function implementation’s declaration unwraps the value so you can use it directly. (At your own risk.)

Since Swift 1.2 (Xcode 6.2 in Spring 2015), ObjC APIs can be annotated with nonnull and nullable, in which case the Swift interface to those APIs uses either a non-optional type or a fully optional type. (And since Swift 2.0 / Xcode 7.0, nearly all of Apple’s APIs are audited to use nullability annotations, so their Swift signatures don’t use much ! anymore.)

What’s less well-known about this is that you’re free to change the optionality of parameters when you implement your own Swift functions that get called by ObjC. If you want the compiler to enforce that sender in your action method can never be nil, you can take the ! off the parameter type. If you want the compiler to make sure you always test the parameter, change the ! to a ?.

More Related Contents:

  1. How to seed the Int.random method call in Swift?
  2. Migrating Swift code to Swift 3.0 LOADS of errors
  3. Overriding methods in Swift extensions
  4. Alternative to performSelector in Swift?
  5. NSObject subclass in Swift: hash vs hashValue, isEqual vs ==
  6. creating custom tableview cells in swift
  7. Return instancetype in Swift
  8. Swift protocol extension method is called instead of method implemented in subclass
  9. NSURLSession concurrent requests with Alamofire
  10. Does Swift have documentation generation support?
  11. Get integer value from string in swift
  12. Why constant constraints the property from a structure instance but not the class instance?
  13. == overload for custom class is not always called
  14. Is it possible to replicate Swifts automatic numeric value bridging to Foundation (NSNumber) for (U)Int8/16/32/64 types?
  15. Sheet inside ForEach doesn’t loop over items SwiftUI
  16. Cannot invoke initializer for type ‘Range’ with an argument list of type ‘(Range)’
  17. UIBezierPath: How to add a border around a view with rounded corners?
  18. In SwiftUI, How do I increase the height of a button?
  19. Segue from modal view to tab bar view controller and not lose tab bar
  20. What’s the difference between using ARAnchor to insert a node and directly insert a node?
  21. How String Comparison happens in Swift
  22. Why convenience keyword is even needed in Swift?
  23. @noescape attribute in Swift 1.2
  24. Xcode: Using custom fonts inside Dynamic framework
  25. Separating multiple if conditions with commas in Swift
  26. Swift alternative to performSelectorOnMainThread
  27. Using Codable on a dynamic type/object
  28. AVAudioEngine downsample issue
  29. swift sphere combine star data
  30. Class ‘ViewController’ has no initializers in swift

Leave a Comment