Asks the receiver to provide the object that corresponds to the specified identifier information.
- iOS 7.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
An array of
NSStringobjects corresponding to the restoration identifiers of the desired object and all of its ancestors in the restoration hierarchy. The last value in the array is the restoration identifier of the desired object. Earlier entries represent the restoration identifiers of its ancestors.
The keyed archiver containing the app’s saved state information.
The object to use or
nil if you do not want to restore this object now.
Your implementation of this method should create (or find) the corresponding object and return it. If your restoration class determines that the object should not be restored, it may return
nil from this method.
You use the strings in the
identifier parameter to identify the object being requested. The object may be at the end of a restoration hierarchy containing your app’s view controllers and other objects. The strings in the
identifier array identify the path through this hierarchy to the desired object.
It is not always necessary to create a new object in your implementation of this method. You can also return an existing object that was created by another means. For example, if the object had already been created by your app delegate at initialization time, you would return that object rather than create a new one.
Your implementation of this method may use any data in the provided
coder to assist in the restoration process. However, you do not need to restore the entire state of the object at this point. During a later pass, objects that define a
decode method are given a chance to restore their state from the same coder object.