6.5 Über diese Brücke musst du gehen

Core Foundation ist ein C-Framework, das die Grundlage für das Foundation-Framework bildet. Es stellt allerdings Funktionen und keine Objective-C-Klassen bereit, und so müssen Sie die Parameter und Rückgabewerte gegebenenfalls von den Klassen auf die entsprechenden Datentypen übertragen. Das ist jedoch glücklicherweise in den meisten Fällen nicht sehr schwer, da Apple hierfür einen speziellen Mechanismus – die Toll-Free Bridge – bereitstellt, der Klassen auf Datentypen und umgekehrt abbildet. Die Toll-Free Bridge funktioniert allerdings nur mit Datentypen und den zugehörigen Klassen von Apple; Sie können diesen Mechanismus leider nicht auf andere Klassen und Datentypen ausdehnen. [Zumindest nicht, wenn Sie Ihre App durch den Review-Prozess in den App-Store bekommen möchten.]

Beim manuellen Referenzenzählen besteht die Brücke einfach aus einem Cast. Sie können also beispielsweise ein Objekt der Klasse NSString auf eine Referenz des Typs CFStringRef und umgekehrt abbilden:

CFStringRef theReference = (CFStringRef)theString;
NSString *theValue = (NSString *)theReference;

Listing 6.93 Toll-Free Bridge

6.5.1 Toll-Free Bridging und ARC

Beim automatischen Referenzenzählen müssen Sie dem Compiler hingegen noch einen zusätzlich Hinweis für die Speicherverwaltung geben. In Core Foundation erfolgt die Speicherverwaltung ja nach wie vor explizit durch Aufrufe der Funktionen CFRetain und CFRelease, und deshalb müssen Sie dem Compiler mitteilen, wie Sie das Core-Foundation-Objekt verwalten möchten.

Im einfachsten Fall wollen Sie die Eigentümerschaft nicht übertragen, und die Speicherverwaltung bleibt beim Ursprungsobjekt. Dafür nehmen Sie das Schlüsselwort __bridge in den Cast mit auf.

CFStringRef *theReference = CFStringCreateCopy(...);
NSString *theString = (__bridge NSString *)theReference;
...
CFRelease(theReference);

Listing 6.94 Cast ohne Übertragung der Eigentümerschaft

Listing 6.94 überträgt die Core-Foundation-Referenz theReference ohne die Eigentümerschaft auf eine Referenz von NSString. Dadurch erzeugt der ARC-Compiler keinen Code, um die Zeichenkette, auf die theString verweist, freizugeben. Damit kein Speicherleck entsteht, müssen Sie also die Core-Foundation-Referenz durch CFRelease freigeben. Auch bei dem umgekehrten Cast in Listing 6.95 überträgt der ARC-Compiler nicht die Eigentümerschaft. Dadurch sorgt er für die Freigabe der Zeichenkette, auf die theString verweist. Ein Aufruf von CFRelease für theReference würde bei diesem Beispiel wahrscheinlich zu einem Speicherzugriffsfehler führen.

NSString *theString = ...;
CFStringRef theReference = (__bridge CFStringRef)theString;

Listing 6.95 Umgekehrter Cast ohne Übertragung der Eigentümerschaft

Listing 6.56 enthält einen solchen Cast: (__bridge CFURLRef)theURL Hier soll die Verwaltung der Eigentümerschaft von theURL beim ARC-Compiler bleiben, da sie ja die Funktion CGImageSourceCreateWithURL nicht übernimmt. Die Funktion CGImageSourceCreateImageAtIndex liefert hingegen ein Core-Graphics-Bild zurück, dessen Eigentümer die Methode ist. Sie muss nun das Bild in das Array einfügen und dabei die Eigentümerschaft abgeben. Das können Sie über das Schlüsselwort __bridge_transfer erreichen. Der Cast (__bridge_transfer id)theImage wandelt das Bild in ein Objekt um und teilt dem ARC-Compiler mit, dass er die Verwaltung der Eigentümerschaft übernehmen soll.

Der Modifizierer __bridge_retained dient für den entgegengesetzten Fall, wenn Sie ein Objekt in ein Core-Foundation-Objekt umwandeln und der ARC-Compiler die Verwaltung der Eigentümerschaft dabei abgeben soll. Dieser Fall tritt beispielsweise bei Erzeugungs- und Kopierfunktionen auf:

CFStringRef CreateStringWithInteger(NSInteger inValue) {
    NSString *theValue = 
        [[NSString alloc] initWithFormat:@"%d", inValue];

    return (__bridge_retained CFStringRef)theValue;
}

Listing 6.96 Übergabe der Eigentümerschaft an Core Foundation

Durch das __bridge_retained erzeugt der ARC-Compiler nicht den Code für die Freigabe der Zeichenkette, auf die theValue verweist, und somit hält der Aufrufer der Funktion CreateStringWithInteger die Zeichenkette.

6.5.2 C-Frameworks und ARC

Das Toll-Free Bridging funktioniert sogar, wenn es für einen Typ keine entsprechende Klasse gibt oder umgekehrt. Dieser Fall tritt auch schon in Listing 6.56 auf; der Cast (__bridge_transfer id)theImage funktioniert, obwohl es keine Klasse (inklusive UIImage) in Cocoa Touch gibt, die dem Datentyp CGImage entspricht.

Dass der Cast dennoch funktioniert, liegt daran, dass auch viele Datentypen in den C-Frameworks sich in einer Typhierarchie mit einer gemeinsamen Menge von Funktionen befinden. Diese gemeinsamen Funktionen bilden dabei genau die Methoden ab, die eine Objective-C-Klasse implementieren muss, die das Protokoll NSObject implementiert.

Das bedeutet, dass Sie sowohl alle Referenzen aus Core Foundation als auch aus den anderen C-Frameworks (wie Core Graphics, ImageIO, Address Book und andere) zumindest wie Referenzen auf NSObject behandeln können. Beim manuellen Referenzenzählen entspricht also beispielsweise die Anweisung CFRetain(theImage) der Anweisung [(id)theImage retain]. Diese transparente Abbildung der C-Datentypen auf Objective-C-Klassen hat nun auch den schönen Nebeneffekt, dass Sie, wie in Listing 6.56 gezeigt, Core-Graphics-Objekte in einem Foundation-Array sammeln können.

Ihr Kommentar

Wie hat Ihnen das <openbook> gefallen? Wir freuen uns immer über Ihre freundlichen und kritischen Rückmeldungen.