4 releases

Uses old Rust 2015

0.1.1 Jul 22, 2018
0.1.0 Mar 20, 2016
0.0.2 Sep 3, 2015
0.0.1 May 2, 2015

#159 in macOS and iOS APIs

Download history 64761/week @ 2023-11-04 76140/week @ 2023-11-11 61636/week @ 2023-11-18 58495/week @ 2023-11-25 60352/week @ 2023-12-02 58161/week @ 2023-12-09 52164/week @ 2023-12-16 37942/week @ 2023-12-23 50778/week @ 2023-12-30 58217/week @ 2024-01-06 62104/week @ 2024-01-13 63808/week @ 2024-01-20 68698/week @ 2024-01-27 62100/week @ 2024-02-03 73395/week @ 2024-02-10 59225/week @ 2024-02-17

273,181 downloads per month
Used in 1,259 crates (45 directly)

MIT license

11KB
151 lines

Rust smart pointers for Objective-C reference counting.

To ensure that Objective-C objects are retained and released at the proper times, we can use the Id struct.

To enforce aliasing rules, an Id can be either owned or shared; if it is owned, meaning the Id is the only reference to the object, it can be mutably dereferenced. An owned Id can be downgraded to a ShareId which can be cloned to allow multiple references.

Weak references may be created using the WeakId struct.

use objc::runtime::{Class, Object};
use objc_id::{Id, WeakId};

let cls = Class::get("NSObject").unwrap();
let obj: Id<Object> = unsafe {
    Id::from_retained_ptr(msg_send![cls, new])
};
// obj will be released when it goes out of scope

// share the object so we can clone it
let obj = obj.share();
let another_ref = obj.clone();
// dropping our other reference will decrement the retain count
drop(another_ref);

let weak = WeakId::new(&obj);
assert!(weak.load().is_some());
// After the object is deallocated, our weak pointer returns none
drop(obj);
assert!(weak.load().is_none());

Dependencies

~130KB