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

use std::os::raw::c_char;
#[cfg(any(doc, not(objfw)))]
use std::os::raw::c_uint;

#[cfg(any(doc, not(objfw)))]
use crate::{objc_method_description, objc_property, objc_property_attribute_t, objc_selector};
use crate::{OpaqueData, BOOL};

/// Opaque type for Objective-C protocols.
///
/// Note that, although protocols are objects, sending messages to them is
/// deprecated and may not work in the future.
///
/// The naming of this follows GNUStep; this does not exist in Apple's
/// original, there `Protocol` is just a type alias of `objc_object`.
#[repr(C)]
pub struct objc_protocol {
    _priv: [u8; 0],
    _p: OpaqueData,
}

extern_c! {
    #[cfg(any(doc, not(objfw)))]
    pub fn objc_getProtocol(name: *const c_char) -> *const objc_protocol;
    #[cfg(any(doc, not(objfw)))]
    pub fn objc_copyProtocolList(out_len: *mut c_uint) -> *mut *const objc_protocol;

    #[cfg(any(doc, not(objfw)))]
    pub fn objc_allocateProtocol(name: *const c_char) -> *mut objc_protocol;
    #[cfg(any(doc, not(objfw)))]
    pub fn objc_registerProtocol(proto: *mut objc_protocol);

    // TODO: Verify unwinding
    pub fn protocol_conformsToProtocol(
        proto: *const objc_protocol,
        other: *const objc_protocol,
    ) -> BOOL;
    // TODO: Verify unwinding
    pub fn protocol_isEqual(proto: *const objc_protocol, other: *const objc_protocol) -> BOOL;
    pub fn protocol_getName(proto: *const objc_protocol) -> *const c_char;

    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_addMethodDescription(
        proto: *mut objc_protocol,
        name: *const objc_selector,
        types: *const c_char,
        is_required_method: BOOL,
        is_instance_method: BOOL,
    );
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_addProperty(
        proto: *mut objc_protocol,
        name: *const c_char,
        attributes: *const objc_property_attribute_t,
        attributes_len: c_uint,
        is_required_property: BOOL,
        is_instance_property: BOOL,
    );
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_addProtocol(proto: *mut objc_protocol, addition: *const objc_protocol);
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_copyMethodDescriptionList(
        proto: *const objc_protocol,
        is_required_method: BOOL,
        is_instance_method: BOOL,
        out_len: *mut c_uint,
    ) -> *mut objc_method_description;
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_copyPropertyList(
        proto: *const objc_protocol,
        out_len: *mut c_uint,
    ) -> *mut *const objc_property;
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_copyProtocolList(
        proto: *const objc_protocol,
        out_len: *mut c_uint,
    ) -> *mut *const objc_protocol;
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_getMethodDescription(
        proto: *const objc_protocol,
        sel: *const objc_selector,
        is_required_method: BOOL,
        is_instance_method: BOOL,
    ) -> objc_method_description;
    #[cfg(any(doc, not(objfw)))]
    pub fn protocol_getProperty(
        proto: *const objc_protocol,
        name: *const c_char,
        is_required_property: BOOL,
        is_instance_property: BOOL,
    ) -> *const objc_property;

    // #[cfg(any(doc, macos >= 10.12))]
    // protocol_copyPropertyList2

    // #[cfg(any(doc, gnustep))]
    // _protocol_getMethodTypeEncoding
}