Add new runtime functions

Author: madsmtm

crates/objc-sys/CHANGELOG.md

@@ -6,6 +6,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## Unreleased - YYYY-MM-DD
 
+### Added
+* Added `objc_terminate`, `object_isClass`, `objc_alloc` and
+  `objc_allocWithZone` now that Rust's macOS deployment target is 10.12.
+
 
 ## 0.3.1 - 2023-06-20
 

crates/objc-sys/src/exception.rs

@@ -44,12 +44,15 @@ extern_c_unwind! {
     /// See [`objc-exception.h`].
     ///
     /// [`objc-exception.h`]: https://github.com/apple-oss-distributions/objc4/blob/objc4-818.2/runtime/objc-exception.h
+    #[cold]
     pub fn objc_exception_throw(exception: *mut objc_object) -> !;
 
     #[cfg(apple_new)]
+    #[cold]
     pub fn objc_exception_rethrow() -> !;
 
     #[cfg(gnustep)]
+    #[cold]
     pub fn objc_exception_rethrow(exc_buf: *mut c_void) -> !;
 }
 
@@ -91,6 +94,10 @@ extern_c! {
     //
     // #[cfg(any(doc, gnustep))]
     // pub fn objc_set_apple_compatible_objcxx_exceptions(newValue: c_int) -> c_int;
+
+    #[cold]
+    #[cfg(any(doc, apple_new))]
+    pub fn objc_terminate() -> !;
 }
 
 extern "C" {

crates/objc-sys/src/object.rs

@@ -4,6 +4,8 @@ use std::os::raw::c_char;
 
 #[cfg(any(doc, not(objfw)))]
 use crate::objc_ivar;
+#[cfg(any(doc, apple))]
+use crate::BOOL;
 use crate::{objc_class, OpaqueData};
 
 /// An opaque type that represents an object / an instance of a class.
@@ -23,6 +25,8 @@ extern_c! {
     pub fn object_getClass(obj: *const objc_object) -> *const objc_class;
     pub fn object_getClassName(obj: *const objc_object) -> *const c_char;
     pub fn object_setClass(obj: *mut objc_object, cls: *const objc_class) -> *const objc_class;
+    #[cfg(any(doc, apple))]
+    pub fn object_isClass(obj: *const objc_object) -> BOOL;
 
     #[cfg(any(doc, not(objfw)))]
     pub fn object_getIndexedIvars(obj: *const objc_object) -> *const c_void;
@@ -90,6 +94,8 @@ extern_c! {
     //     atomic: BOOL,
     //     shouldCopy: i8,
     // );
+    // + the atomic versions
+
     // This is generated in setters to struct properties.
     // pub fn objc_copyStruct(
     //     dest: *mut c_void,

crates/objc-sys/src/rc.rs

@@ -1,17 +1,18 @@
 //! ARC functions.
 //!
-//! Is available in Clang's [documentation][ARC] so these are safe to rely on.
-//!
-//! All available since macOS `10.7`.
+//! These are documented in Clang's [documentation][ARC], and available since
+//! macOS `10.7` unless otherwise noted, so they are safe to rely on.
 //!
 //! Defined in:
 //! - Apple: `objc-internal.h`
 //! - GNUStep: `objc-arc.h`
 //! - ObjFW: `runtime/arc.m`
 //!
-//! [ARC]: https://clang.llvm.org/docs/AutomaticReferenceCounting.html#runtime-support>
+//! [ARC]: https://clang.llvm.org/docs/AutomaticReferenceCounting.html#runtime-support
 use core::ffi::c_void;
 
+#[cfg(any(doc, apple_new))]
+use crate::objc_class;
 use crate::objc_object;
 
 // All of these very rarely unwind, but may if the user defined methods
@@ -60,4 +61,25 @@ extern_c_unwind! {
     // TODO: Decide about nonstandard extensions like these:
     // #[cfg(any(doc, gnustep))]
     // pub fn objc_delete_weak_refs(obj: *mut objc_object) -> BOOL;
+
+    // Fast paths for certain selectors.
+    //
+    // These are not defined in the ARC documentation, but are emitted by
+    // `clang` and included (and intended to be included) in the final
+    // binary, so very likely safe to use.
+    //
+    // TODO: Unsure why these are not available in the old fragile runtime,
+    // the headers seem to indicate that they are.
+    //
+    // <https://github.com/llvm/llvm-project/blob/llvmorg-17.0.5/clang/include/clang/Basic/ObjCRuntime.h#L229>
+
+    // Available since macOS 10.9.
+    #[cfg(any(doc, apple_new))]
+    pub fn objc_alloc(value: *const objc_class) -> *mut objc_object;
+
+    // Available since macOS 10.9.
+    #[cfg(any(doc, apple_new))]
+    pub fn objc_allocWithZone(value: *const objc_class) -> *mut objc_object;
+
+    // TODO: objc_alloc_init once supported
 }

helper-scripts/gen-git.fish

@@ -61,12 +61,6 @@ function bty
 end
 
 function blocklisted
-    # Added in 10.8
-    bfn objc_terminate
-
-    # Added in 10.10
-    bfn object_isClass
-
     # Removed in 10.11
     bfn objc_setFutureClass