feat(macos): add a utility function to convert a CFString to a zig string

src/macos/utils.zig

@@ -0,0 +1,23 @@
+const std = @import("std");
+const c_iokit = @cImport(@cInclude("IOKit/IOKitLib.h"));
+
+/// Converts a CFString to a Zig string.
+pub fn cfStringToZigString(allocator: std.mem.Allocator, cf_string: c_iokit.CFStringRef) ![]u8 {
+    const length = c_iokit.CFStringGetLength(cf_string);
+    const max_size = c_iokit.CFStringGetMaximumSizeForEncoding(length, c_iokit.kCFStringEncodingUTF8) + 1;
+    const max_size_usize = @as(usize, @intCast(max_size));
+
+    const buffer = try allocator.alloc(u8, max_size_usize);
+    errdefer allocator.free(buffer);
+
+    if (c_iokit.CFStringGetCString(cf_string, buffer.ptr, @as(c_iokit.CFIndex, @intCast(buffer.len)), c_iokit.kCFStringEncodingUTF8) == c_iokit.FALSE) {
+        return error.StringConversionFailed;
+    }
+
+    var actual_len: usize = 0;
+    while (actual_len < buffer.len and buffer[actual_len] != 0) {
+        actual_len += 1;
+    }
+
+    return allocator.realloc(buffer, actual_len);
+}