Konflikt zwischen Funktionsdeklaration und Parameterbeschreibung für captureStillImageAsynchronouslyFromConnection?

Question

Gemäß der Klassenreferenz akzeptiert der Beendigungshandler für captureStillImageAsynchronouslyFromConnection ein NSError-Objekt, ist jedoch nicht optional.

Funktion Deklaration:

func captureStillImageAsynchronouslyFromConnection(connection: AVCaptureConnection!, completionHandler handler: ((CMSampleBuffer!, NSError!) -> Void)!) 

Doch in der Beschreibung für die Parameter, heißt es null in den Abschluss-Handler anstelle des NSError Objekts zurückgegeben werden, wenn die Anforderung erfüllt wurde.

Parameter Beschreibung:

If the request could not be completed, an NSError object that describes the problem; otherwise nil. 

Die Beschreibung schlägt vor, die Erklärung eine optionale für das NSError Objekt enthalten soll, oder nicht? Sind die Parameter Beschreibung und Funktionsdeklaration nicht widersprüchlich?

Answer 1

Solange Sie nicht auspacken und ein optionales verwenden, das null ist, geht es Ihnen gut.

Hier ist ein Beispielcode, um die Variationen zu zeigen. Beachten Sie, dass die Callback-Signatur implizite, unverpackte Optionale verwendet, während die übergebenen Parameter null sein können.

import Foundation 

struct Buffer { 
} 

func foo(callback: (buffer: Buffer!, error: NSError!) -> Void) { 
    print("#1: buffer and error are nil") 
    callback(buffer: nil, error: nil) 
    print("#2: buffer not nil, error is nil") 
    callback(buffer: Buffer(), error: nil) 
    print("#3: buffer is nil, error is not nil") 
    callback(buffer: nil, error: NSError(domain: "domain", code: 123, userInfo: nil)) 
    print("#4: both buffer and error are not nil") 
    callback(buffer: Buffer(), error: NSError(domain: "domain", code: 123, userInfo: nil)) 
} 

func cb(buffer: Buffer!, error: NSError!) { 
    if let buffer = buffer { 
     print(buffer) 
    } 
    else { 
     print("buffer is nil") 
    } 

    if let error = error { 
     print(error) 
    } 
    else { 
     print("error is nil") 
    } 
} 

foo(cb) 

Wie aus diesem Beispiel ersichtlich, kann ein implizites, nicht aufgewickeltes optionales Nil sein. Das ist, was die Beschreibung für NSError angibt.