objc2-foundation 0.3.2

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

//! This file has been automatically generated by `objc2`'s `header-translator`.
//! DO NOT EDIT
use core::ptr::NonNull;
use objc2::__framework_prelude::*;

use crate::*;

/// [Apple's documentation](https://developer.apple.com/documentation/foundation/nsrangepointer?language=objc)
pub type NSRangePointer = *mut NSRange;

// TODO: pub fn NSMakeRange(loc: NSUInteger,len: NSUInteger,) -> NSRange;

// TODO: pub fn NSMaxRange(range: NSRange,) -> NSUInteger;

// TODO: pub fn NSLocationInRange(loc: NSUInteger,range: NSRange,) -> Bool;

// TODO: pub fn NSEqualRanges(range1: NSRange,range2: NSRange,) -> Bool;

#[inline]
pub extern "C-unwind" fn NSUnionRange(range1: NSRange, range2: NSRange) -> NSRange {
    extern "C-unwind" {
        fn NSUnionRange(range1: NSRange, range2: NSRange) -> NSRange;
    }
    unsafe { NSUnionRange(range1, range2) }
}

#[inline]
pub extern "C-unwind" fn NSIntersectionRange(range1: NSRange, range2: NSRange) -> NSRange {
    extern "C-unwind" {
        fn NSIntersectionRange(range1: NSRange, range2: NSRange) -> NSRange;
    }
    unsafe { NSIntersectionRange(range1, range2) }
}

#[cfg(feature = "NSString")]
impl NSString {
    #[doc(alias = "NSStringFromRange")]
    #[cfg(feature = "NSString")]
    #[inline]
    pub fn from_range(range: NSRange) -> Retained<NSString> {
        extern "C-unwind" {
            fn NSStringFromRange(range: NSRange) -> *mut NSString;
        }
        let ret = unsafe { NSStringFromRange(range) };
        unsafe { Retained::retain_autoreleased(ret) }
            .expect("function was marked as returning non-null, but actually returned NULL")
    }
}

#[cfg(feature = "NSString")]
#[inline]
pub extern "C-unwind" fn NSRangeFromString(a_string: &NSString) -> NSRange {
    extern "C-unwind" {
        fn NSRangeFromString(a_string: &NSString) -> NSRange;
    }
    unsafe { NSRangeFromString(a_string) }
}

/// NSValueRangeExtensions.
#[cfg(feature = "NSValue")]
impl NSValue {
    extern_methods!(
        #[unsafe(method(valueWithRange:))]
        #[unsafe(method_family = none)]
        pub unsafe fn valueWithRange(range: NSRange) -> Retained<NSValue>;

        #[unsafe(method(rangeValue))]
        #[unsafe(method_family = none)]
        pub unsafe fn rangeValue(&self) -> NSRange;
    );
}

#[cfg(feature = "NSString")]
#[deprecated = "renamed to `NSString::from_range`"]
#[inline]
pub extern "C-unwind" fn NSStringFromRange(range: NSRange) -> Retained<NSString> {
    extern "C-unwind" {
        fn NSStringFromRange(range: NSRange) -> *mut NSString;
    }
    let ret = unsafe { NSStringFromRange(range) };
    unsafe { Retained::retain_autoreleased(ret) }
        .expect("function was marked as returning non-null, but actually returned NULL")
}