1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
use core::fmt;
use core::panic::{RefUnwindSafe, UnwindSafe};
use objc2::encode::{Encode, Encoding, RefEncode};
use objc2::rc::{Allocated, Retained};
use objc2::runtime::NSObject;
use objc2::{extern_methods, msg_send, AllocAnyThread};
use crate::{util, NSUUID};
impl UnwindSafe for NSUUID {}
impl RefUnwindSafe for NSUUID {}
#[repr(transparent)]
struct UuidBytes([u8; 16]);
unsafe impl RefEncode for UuidBytes {
// Encoding actually depends on the instance class, `__NSConcreteUUID` has
// a different method encoding than `NSUUID`, the former takes a `char*`.
//
// This may also depend on the Foundation / OS version.
const ENCODING_REF: Encoding = Encoding::Array(16, &u8::ENCODING);
}
impl NSUUID {
extern_methods!(
#[unsafe(method(initWithUUIDBytes:))]
fn initWithUUIDBytes(this: Allocated<Self>, bytes: &UuidBytes) -> Retained<Self>;
#[unsafe(method(getUUIDBytes:))]
fn getUUIDBytes(&self, bytes: &mut UuidBytes);
);
}
impl NSUUID {
/// The 'nil UUID'.
pub fn nil() -> Retained<Self> {
Self::from_bytes([0; 16])
}
/// Create a new `NSUUID` from the given bytes.
///
/// NOTE: The headers describe `initWithUUIDBytes:` as taking `uuid_t`,
/// but their actual implementation may use something else.
///
/// Thus, to use this method, you must currently disable encoding
/// verification using the `"disable-encoding-assertions"` Cargo feature
/// in `objc2`.
///
///
/// # Example
///
/// Create a new `NSUUID` from the `uuid` crate.
///
/// ```ignore
/// use uuid::Uuid;
/// use objc2_foundation::NSUUID;
///
/// let uuid: Uuid;
/// # uuid = todo!();
/// let obj = NSUUID::from_bytes(uuid.into_bytes());
/// assert_eq!(obj.as_bytes(), uuid.into_bytes());
/// ```
pub fn from_bytes(bytes: [u8; 16]) -> Retained<Self> {
let bytes = UuidBytes(bytes);
Self::initWithUUIDBytes(Self::alloc(), &bytes)
}
#[cfg(feature = "NSString")]
pub fn from_string(string: &crate::NSString) -> Option<Retained<Self>> {
Self::initWithUUIDString(Self::alloc(), string)
}
/// Convert the UUID to an array.
///
/// NOTE: The headers describe `getUUIDBytes:` as taking `uuid_t`, but
/// their actual implementation may use something else.
///
/// Thus, to use this method, you must currently disable encoding
/// verification using the `"disable-encoding-assertions"` Cargo feature
/// in `objc2`.
pub fn as_bytes(&self) -> [u8; 16] {
let mut bytes = UuidBytes([0; 16]);
self.getUUIDBytes(&mut bytes);
bytes.0
}
}
impl fmt::Display for NSUUID {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
let string: Retained<NSObject> = unsafe { msg_send![self, UUIDString] };
// SAFETY: `UUIDString` returns `NSString`.
unsafe { util::display_string(&string, f) }
}
}
impl fmt::Debug for NSUUID {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
// The `uuid` crate does `Debug` and `Display` equally, and so do we.
let string: Retained<NSObject> = unsafe { msg_send![self, UUIDString] };
// SAFETY: `UUIDString` returns `NSString`.
unsafe { util::display_string(&string, f) }
}
}
// UUID `compare:` is broken for some reason?
// impl PartialOrd for NSUUID {
// #[inline]
// fn partial_cmp(&self, other: &Self) -> Option<cmp::Ordering> {
// Some(self.cmp(other))
// }
// }
// impl Ord for NSUUID {
// fn cmp(&self, other: &Self) -> cmp::Ordering {
// let res: NSComparisonResult = unsafe { msg_send![self, compare: other] };
// res.into()
// }
// }