Core Foundation String Manager

A utility module for NativeScript iOS applications that safely manages Core Foundation string objects returned from native APIs. The module must properly handle Core Foundation memory management semantics, particularly for strings that come with different ownership conventions.

Capabilities

String conversion with consumed ownership

When a Core Foundation API returns a string with a +1 retain count (meaning ownership is transferred), the system must properly consume that ownership and convert it to a JavaScript string without leaking memory.

• Given a Core Foundation string with +1 retain count, convert it to JavaScript string and properly release ownership @test
• Converting multiple retained strings in sequence should not leak memory @test

String conversion with borrowed ownership

When a Core Foundation API returns a string with +0 retain count (meaning the reference is borrowed), the system must access the value without affecting the retain count.

• Given a Core Foundation string with +0 retain count, convert it to JavaScript string without affecting ownership @test
• Converting the same unretained string multiple times should work correctly @test

Implementation

@generates

The implementation should use the appropriate NativeScript iOS interop mechanisms to handle unmanaged Core Foundation references. Consider the ownership semantics carefully to prevent memory leaks or premature releases.

API

/**
 * Converts a Core Foundation string that was returned with +1 retain count
 * (ownership transferred) to a JavaScript string. This function consumes
 * the ownership.
 *
 * @param cfStringRef - An unmanaged reference to a CFString with +1 retain
 * @returns The JavaScript string value
 */
export function convertRetainedString(cfStringRef: any): string;

/**
 * Converts a Core Foundation string that was returned with +0 retain count
 * (borrowed reference) to a JavaScript string. This function does not
 * affect the retain count.
 *
 * @param cfStringRef - An unmanaged reference to a CFString with +0 retain
 * @returns The JavaScript string value
 */
export function convertUnretainedString(cfStringRef: any): string;

Dependencies { .dependencies }

tns-platform-declarations { .dependency }

Provides iOS platform type definitions and interop utilities for NativeScript applications.