The protocol to which all classes implicitly conform.
SDK
- Xcode 9.0+
Framework
- Swift Standard Library
Declaration
typealias AnyObject
Discussion
You use Any when you need the flexibility of an untyped object or when you use bridged Objective-C methods and properties that return an untyped result. Any can be used as the concrete type for an instance of any class, class type, or class-only protocol. For example:
class FloatRef {
let value: Float
init(_ value: Float) {
self.value = value
}
}
let x = FloatRef(2.3)
let y: AnyObject = x
let z: AnyObject = FloatRef.self
Any can also be used as the concrete type for an instance of a type that bridges to an Objective-C class. Many value types in Swift bridge to Objective-C counterparts, like String and Int.
let s: AnyObject = "This is a bridged string." as NSString
print(s is NSString)
// Prints "true"
let v: AnyObject = 100 as NSNumber
print(type(of: v))
// Prints "__NSCFNumber"
The flexible behavior of the Any protocol is similar to Objective-C’s id type. For this reason, imported Objective-C types frequently use Any as the type for properties, method parameters, and return values.
Casting AnyObject Instances to a Known Type
Objects with a concrete type of Any maintain a specific dynamic type and can be cast to that type using one of the type-cast operators (as, as?, or as!).
This example uses the conditional downcast operator (as?) to conditionally cast the s constant declared above to an instance of Swift’s String type.
if let message = s as? String {
print("Successful cast to String: \(message)")
}
// Prints "Successful cast to String: This is a bridged string."
If you have prior knowledge that an Any instance has a particular type, you can use the unconditional downcast operator (as!). Performing an invalid cast triggers a runtime error.
let message = s as! String
print("Successful cast to String: \(message)")
// Prints "Successful cast to String: This is a bridged string."
let badCase = v as! String
// Runtime error
Casting is always safe in the context of a switch statement.
let mixedArray: [AnyObject] = [s, v]
for object in mixedArray {
switch object {
case let x as String:
print("'\(x)' is a String")
default:
print("'\(object)' is not a String")
}
}
// Prints "'This is a bridged string.' is a String"
// Prints "'100' is not a String"
Accessing Objective-C Methods and Properties
When you use Any as a concrete type, you have at your disposal every @objc method and property—that is, methods and properties imported from Objective-C or marked with the @objc attribute. Because Swift can’t guarantee at compile time that these methods and properties are actually available on an Any instance’s underlying type, these @objc symbols are available as implicitly unwrapped optional methods and properties, respectively.
This example defines an Integer type with an @objc method named get.
class IntegerRef {
let value: Int
init(_ value: Int) {
self.value = value
}
@objc func getIntegerValue() -> Int {
return value
}
}
func getObject() -> AnyObject {
return IntegerRef(100)
}
let obj: AnyObject = getObject()
In the example, obj has a static type of Any and a dynamic type of Integer. You can use optional chaining to call the @objc method get on obj safely. If you’re sure of the dynamic type of obj, you can call get directly.
let possibleValue = obj.getIntegerValue?()
print(possibleValue)
// Prints "Optional(100)"
let certainValue = obj.getIntegerValue()
print(certainValue)
// Prints "100"
If the dynamic type of obj doesn’t implement a get method, the system returns a runtime error when you initialize certain.
Alternatively, if you need to test whether obj exists, use optional binding before calling the method.
if let f = obj.getIntegerValue {
print("The value of 'obj' is \(f())")
} else {
print("'obj' does not have a 'getIntegerValue()' method")
}
// Prints "The value of 'obj' is 100"