objc2-foundation 0.3.0

Bindings to the Foundation framework
Documentation 
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

#![cfg(feature = "NSString")]
use alloc::format;
use alloc::string::{String, ToString};
use core::fmt::Write;
use objc2::runtime::NSObject;

use crate::{NSMutableString, NSString};

#[test]
fn display_debug() {
    let s = NSMutableString::from_str("test\"123");
    assert_eq!(format!("{s}"), "test\"123");
    assert_eq!(format!("{s:?}"), r#""test\"123""#);
}

#[test]
fn test_from_nsstring() {
    let s = NSString::from_str("abc");
    let s = NSMutableString::stringWithString(&s);
    assert_eq!(&s.to_string(), "abc");
}

#[test]
#[allow(clippy::deref_addrof)]
fn test_append() {
    let s = NSMutableString::from_str("abc");
    s.appendString(&NSString::from_str("def"));
    *&mut &*s += &NSString::from_str("ghi");
    assert_eq!(&s.to_string(), "abcdefghi");
}

#[test]
fn test_set() {
    let s = NSMutableString::from_str("abc");
    s.setString(&NSString::from_str("def"));
    assert_eq!(&s.to_string(), "def");
}

#[test]
#[allow(clippy::deref_addrof)]
fn test_with_capacity() {
    let s = NSMutableString::stringWithCapacity(3);
    *&mut &*s += &NSString::from_str("abc");
    *&mut &*s += &NSString::from_str("def");
    assert_eq!(&s.to_string(), "abcdef");
}

#[test]
#[cfg(feature = "NSObject")]
fn test_copy() {
    use crate::{NSCopying, NSMutableCopying, NSObjectProtocol};
    use objc2::{rc::Retained, ClassType};

    let s1 = NSMutableString::from_str("abc");
    let s2 = s1.copy();
    assert_ne!(Retained::as_ptr(&s1), Retained::as_ptr(&s2).cast());
    assert!(s2.isKindOfClass(NSString::class()));

    let s3 = s1.mutableCopy();
    assert_ne!(Retained::as_ptr(&s1), Retained::as_ptr(&s3));
    assert!(s3.isKindOfClass(NSMutableString::class()));
}

#[test]
#[cfg(feature = "NSObject")]
fn counterpart() {
    use crate::{CopyingHelper, MutableCopyingHelper};
    use core::any::TypeId;
    assert_eq!(
        TypeId::of::<<NSString as CopyingHelper>::Result>(),
        TypeId::of::<NSString>(),
    );
    assert_eq!(
        TypeId::of::<<NSString as MutableCopyingHelper>::Result>(),
        TypeId::of::<NSMutableString>(),
    );

    assert_eq!(
        TypeId::of::<<NSMutableString as CopyingHelper>::Result>(),
        TypeId::of::<NSString>(),
    );
    assert_eq!(
        TypeId::of::<<NSMutableString as MutableCopyingHelper>::Result>(),
        TypeId::of::<NSMutableString>(),
    );
}

#[test]
#[cfg(all(feature = "NSObject", feature = "NSZone"))]
fn test_copy_with_zone() {
    use crate::{NSCopying, NSMutableCopying, NSObjectProtocol};
    use objc2::{rc::Retained, ClassType};

    let s1 = NSString::from_str("abc");
    let s2 = unsafe { s1.copyWithZone(core::ptr::null_mut()) };
    assert_eq!(Retained::as_ptr(&s1), Retained::as_ptr(&s2));
    assert!(s2.isKindOfClass(NSString::class()));

    let s3 = unsafe { s1.mutableCopyWithZone(core::ptr::null_mut()) };
    assert_ne!(
        Retained::as_ptr(&s1).cast::<NSMutableString>(),
        Retained::as_ptr(&s3)
    );
    assert!(s3.isKindOfClass(NSMutableString::class()));
}

/// Test that writing a NSMutableString to itself works (i.e. ensure that
/// `NSString`'s `Debug` implementation is correct).
#[test]
fn write_same_string() {
    let string = NSMutableString::from_str("foo");
    let mut expected = String::from("foo");

    for i in 0..3 {
        write!(&string, "{string}").unwrap();
        write!(&string, "{string:?}").unwrap();
        // Test `NSObject`'s Debug impl as well.
        let object: &NSObject = &string;
        write!(&string, "{object:?}").unwrap();

        let expected_clone = expected.clone();
        write!(&mut expected, "{expected_clone}").unwrap();
        let expected_clone = expected.clone();
        write!(&mut expected, "{expected_clone:?}").unwrap();
        let expected_clone = expected.clone();
        write!(&mut expected, "{expected_clone}").unwrap();

        assert_eq!(string.to_string(), expected, "failed at iteration {i}");
    }
}

/// Test that appending a NSMutableString to itself works (i.e. ensure that
/// `appendString` is sound).
#[test]
fn append_same_string() {
    let string = NSMutableString::from_str("foo");
    let mut expected = String::from("foo");
    for i in 0..3 {
        string.appendString(&string);
        expected += &*expected.clone();

        assert_eq!(string.to_string(), expected, "failed at iteration {i}");
    }
}