objc2-foundation

Rust bindings to Apple's framework Foundation.

This README is kept intentionally small to consolidate the documentation, see the Rust docs for more details on this crate.

This crate is part of the objc2 project, see that for related crates.

lib.rs:

Bindings to the Foundation framework

See Apple's docs and the general docs on framework crates for more information.

This is the [std] equivalent for Objective-C, containing essential data types, collections, and operating-system services.

Rust vs. Objective-C types

A quick overview of some types you will encounter often in Objective-C, and their approximate Rust equivalent.

Note, in particular, that all "Mutable" variants use interior mutability, and that some things are thread-safe (Arc), while others are not (Rc).

Examples

Basic usage of a few Foundation types.

$ cargo add objc2-foundation

use objc2_foundation::{ns_string, NSCopying, NSArray};

let string = ns_string!("world");
println!("hello {string}");

let array = NSArray::from_slice(&[string]);
println!("{array:?}");

An example showing how to define your own interfaces to parts that may be missing in the autogenerated interface.