objc2-contacts 0.3.2

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

use crate::*;

extern_class!(
    /// Contact vCard support.
    ///
    ///
    /// This converts between a contact and its vCard representation.
    ///
    /// See also [Apple's documentation](https://developer.apple.com/documentation/contacts/cncontactvcardserialization?language=objc)
    #[unsafe(super(NSObject))]
    #[derive(Debug, PartialEq, Eq, Hash)]
    pub struct CNContactVCardSerialization;
);

extern_conformance!(
    unsafe impl NSObjectProtocol for CNContactVCardSerialization {}
);

impl CNContactVCardSerialization {
    extern_methods!(
        #[cfg(feature = "CNContact")]
        /// Descriptor for all contact keys required by vCard serialization
        ///
        ///
        /// This descriptor must be passed to the fetch request if the returned
        /// contacts are to be serialized with dataWithContacts:error:.
        #[unsafe(method(descriptorForRequiredKeys))]
        #[unsafe(method_family = none)]
        pub unsafe fn descriptorForRequiredKeys() -> Retained<ProtocolObject<dyn CNKeyDescriptor>>;

        #[cfg(feature = "CNContact")]
        /// Serialize contacts to data.
        ///
        ///
        /// The contacts to be serialized must have been fetched with
        /// `+descriptorForRequiredKeys.`
        ///
        /// Parameter `contacts`: The contacts to serialize.
        ///
        ///
        /// Parameter `error`: An optional outparameter. If the serialization fails, this will be set.
        ///
        ///
        /// Returns: The encoded data. If the serialization fails, this will be
        /// `nil.`
        #[unsafe(method(dataWithContacts:error:_))]
        #[unsafe(method_family = none)]
        pub unsafe fn dataWithContacts_error(
            contacts: &NSArray<CNContact>,
        ) -> Result<Retained<NSData>, Retained<NSError>>;

        #[cfg(feature = "CNContact")]
        /// Parse data into contacts.
        ///
        ///
        /// Parameter `data`: The data to parse.
        ///
        ///
        /// Parameter `error`: An optional outparameter. If the parsing fails, this will be set.
        ///
        ///
        /// Returns: The parsed contacts. If the parsing fails, this will be
        /// `nil.`
        #[unsafe(method(contactsWithData:error:_))]
        #[unsafe(method_family = none)]
        pub unsafe fn contactsWithData_error(
            data: &NSData,
        ) -> Result<Retained<NSArray<CNContact>>, Retained<NSError>>;
    );
}

/// Methods declared on superclass `NSObject`.
impl CNContactVCardSerialization {
    extern_methods!(
        #[unsafe(method(init))]
        #[unsafe(method_family = init)]
        pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>;

        #[unsafe(method(new))]
        #[unsafe(method_family = new)]
        pub unsafe fn new() -> Retained<Self>;
    );
}