Struct NSURL

#[repr(C)]
pub struct NSURL { /* private fields */ }

Available on crate feature NSURL only.

Apple’s documentation

Implementations

impl NSURL

pub unsafe fn initWithScheme_host_path( this: Allocated<Self>, scheme: &NSString, host: Option<&NSString>, path: &NSString, ) -> Option<Retained<Self>>

👎Deprecated: Use NSURLComponents instead, which lets you create a valid URL with any valid combination of URL components and subcomponents (not just scheme, host and path), and lets you set components and subcomponents with either percent-encoded or un-percent-encoded strings.

Available on crate feature NSString only.

pub unsafe fn initFileURLWithPath_isDirectory_relativeToURL( this: Allocated<Self>, path: &NSString, is_dir: bool, base_url: Option<&NSURL>, ) -> Retained<Self>

Available on crate feature NSString only.

pub unsafe fn initFileURLWithPath_relativeToURL( this: Allocated<Self>, path: &NSString, base_url: Option<&NSURL>, ) -> Retained<Self>

Available on crate feature NSString only.

pub unsafe fn initFileURLWithPath_isDirectory( this: Allocated<Self>, path: &NSString, is_dir: bool, ) -> Retained<Self>

Available on crate feature NSString only.

pub unsafe fn initFileURLWithPath( this: Allocated<Self>, path: &NSString, ) -> Retained<Self>

Available on crate feature NSString only.

pub unsafe fn fileURLWithPath_isDirectory_relativeToURL( path: &NSString, is_dir: bool, base_url: Option<&NSURL>, ) -> Retained<NSURL>

Available on crate feature NSString only.

pub unsafe fn fileURLWithPath_relativeToURL( path: &NSString, base_url: Option<&NSURL>, ) -> Retained<NSURL>

Available on crate feature NSString only.

pub unsafe fn fileURLWithPath_isDirectory( path: &NSString, is_dir: bool, ) -> Retained<NSURL>

Available on crate feature NSString only.

pub unsafe fn fileURLWithPath(path: &NSString) -> Retained<NSURL>

Available on crate feature NSString only.

pub unsafe fn initFileURLWithFileSystemRepresentation_isDirectory_relativeToURL( this: Allocated<Self>, path: NonNull<c_char>, is_dir: bool, base_url: Option<&NSURL>, ) -> Retained<Self>

pub unsafe fn fileURLWithFileSystemRepresentation_isDirectory_relativeToURL( path: NonNull<c_char>, is_dir: bool, base_url: Option<&NSURL>, ) -> Retained<NSURL>

pub unsafe fn initWithString( this: Allocated<Self>, url_string: &NSString, ) -> Option<Retained<Self>>

Available on crate feature NSString only.

pub unsafe fn initWithString_relativeToURL( this: Allocated<Self>, url_string: &NSString, base_url: Option<&NSURL>, ) -> Option<Retained<Self>>

Available on crate feature NSString only.

pub unsafe fn URLWithString(url_string: &NSString) -> Option<Retained<Self>>

Available on crate feature NSString only.

pub unsafe fn URLWithString_relativeToURL( url_string: &NSString, base_url: Option<&NSURL>, ) -> Option<Retained<Self>>

Available on crate feature NSString only.

pub unsafe fn initWithString_encodingInvalidCharacters( this: Allocated<Self>, url_string: &NSString, encoding_invalid_characters: bool, ) -> Option<Retained<Self>>

Available on crate feature NSString only.

Initializes an NSURL with a URL string and the option to add (or skip) IDNA- and percent-encoding of invalid characters. If encodingInvalidCharacters is false, and the URL string is invalid according to RFC 3986, nil is returned. If encodingInvalidCharacters is true, NSURL will try to encode the string to create a valid URL. If the URL string is still invalid after encoding, nil is returned.

• Parameter URLString: The URL string.
• Parameter encodingInvalidCharacters: True if NSURL should try to encode an invalid URL string, false otherwise.
• Returns: An NSURL instance for a valid URL, or nil if the URL is invalid.

pub unsafe fn URLWithString_encodingInvalidCharacters( url_string: &NSString, encoding_invalid_characters: bool, ) -> Option<Retained<Self>>

Available on crate feature NSString only.

Initializes and returns a newly created NSURL with a URL string and the option to add (or skip) IDNA- and percent-encoding of invalid characters. If encodingInvalidCharacters is false, and the URL string is invalid according to RFC 3986, nil is returned. If encodingInvalidCharacters is true, NSURL will try to encode the string to create a valid URL. If the URL string is still invalid after encoding, nil is returned.

• Parameter URLString: The URL string.
• Parameter encodingInvalidCharacters: True if NSURL should try to encode an invalid URL string, false otherwise.
• Returns: An NSURL instance for a valid URL, or nil if the URL is invalid.

pub unsafe fn initWithDataRepresentation_relativeToURL( this: Allocated<Self>, data: &NSData, base_url: Option<&NSURL>, ) -> Retained<Self>

Available on crate feature NSData only.

pub unsafe fn URLWithDataRepresentation_relativeToURL( data: &NSData, base_url: Option<&NSURL>, ) -> Retained<NSURL>

Available on crate feature NSData only.

pub unsafe fn initAbsoluteURLWithDataRepresentation_relativeToURL( this: Allocated<Self>, data: &NSData, base_url: Option<&NSURL>, ) -> Retained<Self>

Available on crate feature NSData only.

pub unsafe fn absoluteURLWithDataRepresentation_relativeToURL( data: &NSData, base_url: Option<&NSURL>, ) -> Retained<NSURL>

Available on crate feature NSData only.

pub unsafe fn dataRepresentation(&self) -> Retained<NSData>

Available on crate feature NSData only.

pub unsafe fn absoluteString(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn relativeString(&self) -> Retained<NSString>

Available on crate feature NSString only.

pub unsafe fn baseURL(&self) -> Option<Retained<NSURL>>

pub unsafe fn absoluteURL(&self) -> Option<Retained<NSURL>>

pub unsafe fn scheme(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn resourceSpecifier(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn host(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn port(&self) -> Option<Retained<NSNumber>>

Available on crate feature NSValue only.

pub unsafe fn user(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn password(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn path(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn fragment(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn parameterString(&self) -> Option<Retained<NSString>>

👎Deprecated: The parameterString method is deprecated. Post deprecation for applications linked with or after the macOS 10.15, and for all iOS, watchOS, and tvOS applications, parameterString will always return nil, and the path method will return the complete path including the semicolon separator and params component if the URL string contains them.

Available on crate feature NSString only.

pub unsafe fn query(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn relativePath(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn hasDirectoryPath(&self) -> bool

pub unsafe fn getFileSystemRepresentation_maxLength( &self, buffer: NonNull<c_char>, max_buffer_length: NSUInteger, ) -> bool

pub unsafe fn fileSystemRepresentation(&self) -> NonNull<c_char>

pub unsafe fn isFileURL(&self) -> bool

pub unsafe fn standardizedURL(&self) -> Option<Retained<NSURL>>

pub unsafe fn isFileReferenceURL(&self) -> bool

pub unsafe fn fileReferenceURL(&self) -> Option<Retained<NSURL>>

pub unsafe fn filePathURL(&self) -> Option<Retained<NSURL>>

pub unsafe fn getResourceValue_forKey_error( &self, value: &mut Option<Retained<AnyObject>>, key: &NSURLResourceKey, ) -> Result<(), Retained<NSError>>

Available on crate features NSError and NSString only.

pub unsafe fn resourceValuesForKeys_error( &self, keys: &NSArray<NSURLResourceKey>, ) -> Result<Retained<NSDictionary<NSURLResourceKey, AnyObject>>, Retained<NSError>>

Available on crate features NSArray and NSDictionary and NSError and NSString only.

pub unsafe fn setResourceValue_forKey_error( &self, value: Option<&AnyObject>, key: &NSURLResourceKey, ) -> Result<(), Retained<NSError>>

Available on crate features NSError and NSString only.

pub unsafe fn setResourceValues_error( &self, keyed_values: &NSDictionary<NSURLResourceKey, AnyObject>, ) -> Result<(), Retained<NSError>>

Available on crate features NSDictionary and NSError and NSString only.

pub unsafe fn removeCachedResourceValueForKey(&self, key: &NSURLResourceKey)

Available on crate feature NSString only.

pub unsafe fn removeAllCachedResourceValues(&self)

pub unsafe fn setTemporaryResourceValue_forKey( &self, value: Option<&AnyObject>, key: &NSURLResourceKey, )

Available on crate feature NSString only.

pub unsafe fn bookmarkDataWithOptions_includingResourceValuesForKeys_relativeToURL_error( &self, options: NSURLBookmarkCreationOptions, keys: Option<&NSArray<NSURLResourceKey>>, relative_url: Option<&NSURL>, ) -> Result<Retained<NSData>, Retained<NSError>>

Available on crate features NSArray and NSData and NSError and NSString only.

pub unsafe fn initByResolvingBookmarkData_options_relativeToURL_bookmarkDataIsStale_error( this: Allocated<Self>, bookmark_data: &NSData, options: NSURLBookmarkResolutionOptions, relative_url: Option<&NSURL>, is_stale: *mut Bool, ) -> Result<Retained<Self>, Retained<NSError>>

Available on crate features NSData and NSError only.

pub unsafe fn URLByResolvingBookmarkData_options_relativeToURL_bookmarkDataIsStale_error( bookmark_data: &NSData, options: NSURLBookmarkResolutionOptions, relative_url: Option<&NSURL>, is_stale: *mut Bool, ) -> Result<Retained<Self>, Retained<NSError>>

Available on crate features NSData and NSError only.

pub unsafe fn resourceValuesForKeys_fromBookmarkData( keys: &NSArray<NSURLResourceKey>, bookmark_data: &NSData, ) -> Option<Retained<NSDictionary<NSURLResourceKey, AnyObject>>>

Available on crate features NSArray and NSData and NSDictionary and NSString only.

pub unsafe fn writeBookmarkData_toURL_options_error( bookmark_data: &NSData, bookmark_file_url: &NSURL, options: NSURLBookmarkFileCreationOptions, ) -> Result<(), Retained<NSError>>

Available on crate features NSData and NSError only.

pub unsafe fn bookmarkDataWithContentsOfURL_error( bookmark_file_url: &NSURL, ) -> Result<Retained<NSData>, Retained<NSError>>

Available on crate features NSData and NSError only.

pub unsafe fn URLByResolvingAliasFileAtURL_options_error( url: &NSURL, options: NSURLBookmarkResolutionOptions, ) -> Result<Retained<Self>, Retained<NSError>>

Available on crate feature NSError only.

pub unsafe fn startAccessingSecurityScopedResource(&self) -> bool

pub unsafe fn stopAccessingSecurityScopedResource(&self)

impl NSURL

Methods declared on superclass NSObject.

pub unsafe fn init(this: Allocated<Self>) -> Retained<Self>

pub unsafe fn new() -> Retained<Self>

impl NSURL

NSPromisedItems.

pub unsafe fn getPromisedItemResourceValue_forKey_error( &self, value: &mut Option<Retained<AnyObject>>, key: &NSURLResourceKey, ) -> Result<(), Retained<NSError>>

Available on crate features NSError and NSString only.

pub unsafe fn promisedItemResourceValuesForKeys_error( &self, keys: &NSArray<NSURLResourceKey>, ) -> Result<Retained<NSDictionary<NSURLResourceKey, AnyObject>>, Retained<NSError>>

Available on crate features NSArray and NSDictionary and NSError and NSString only.

pub unsafe fn checkPromisedItemIsReachableAndReturnError( &self, ) -> Result<(), Retained<NSError>>

Available on crate feature NSError only.

impl NSURL

NSItemProvider.

This impl block contains no items.

impl NSURL

NSURLPathUtilities.

pub unsafe fn fileURLWithPathComponents( components: &NSArray<NSString>, ) -> Option<Retained<NSURL>>

Available on crate features NSArray and NSString only.

pub unsafe fn pathComponents(&self) -> Option<Retained<NSArray<NSString>>>

Available on crate features NSArray and NSString only.

pub unsafe fn lastPathComponent(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn pathExtension(&self) -> Option<Retained<NSString>>

Available on crate feature NSString only.

pub unsafe fn URLByAppendingPathComponent( &self, path_component: &NSString, ) -> Option<Retained<NSURL>>

Available on crate feature NSString only.

pub unsafe fn URLByAppendingPathComponent_isDirectory( &self, path_component: &NSString, is_directory: bool, ) -> Option<Retained<NSURL>>

Available on crate feature NSString only.

pub unsafe fn URLByDeletingLastPathComponent(&self) -> Option<Retained<NSURL>>

pub unsafe fn URLByAppendingPathExtension( &self, path_extension: &NSString, ) -> Option<Retained<NSURL>>

Available on crate feature NSString only.

pub unsafe fn URLByDeletingPathExtension(&self) -> Option<Retained<NSURL>>

pub unsafe fn checkResourceIsReachableAndReturnError( &self, ) -> Result<(), Retained<NSError>>

Available on crate feature NSError only.

pub unsafe fn URLByStandardizingPath(&self) -> Option<Retained<NSURL>>

pub unsafe fn URLByResolvingSymlinksInPath(&self) -> Option<Retained<NSURL>>

impl NSURL

NSURLLoading.

pub unsafe fn resourceDataUsingCache( &self, should_use_cache: bool, ) -> Option<Retained<NSData>>

👎Deprecated: Use NSURLConnection instead

Available on crate feature NSData only.

pub unsafe fn loadResourceDataNotifyingClient_usingCache( &self, client: &AnyObject, should_use_cache: bool, )

👎Deprecated: Use NSURLConnection instead

pub unsafe fn propertyForKey( &self, property_key: &NSString, ) -> Option<Retained<AnyObject>>

👎Deprecated: Use NSURLConnection instead

Available on crate feature NSString only.

pub unsafe fn setResourceData(&self, data: &NSData) -> bool

👎Deprecated: Use NSURLConnection instead

Available on crate feature NSData only.

pub unsafe fn setProperty_forKey( &self, property: &AnyObject, property_key: &NSString, ) -> bool

👎Deprecated: Use NSURLConnection instead

Available on crate feature NSString only.

pub unsafe fn URLHandleUsingCache( &self, should_use_cache: bool, ) -> Option<Retained<NSURLHandle>>

👎Deprecated: Use NSURLConnection instead

Available on crate feature NSURLHandle only.

impl NSURL

Path conversion.

pub fn from_path( path: &Path, is_directory: bool, base_url: Option<&NSURL>, ) -> Option<Retained<Self>>

Available on crate feature std and Unix and non-crate feature gnustep-1-7 only.

pub fn from_file_path<P: AsRef<Path>>(path: P) -> Option<Retained<Self>>

Available on crate feature std and Unix and non-crate feature gnustep-1-7 only.

Create a file url from a Path.

If the path is relative, it will be considered relative to the current directory.

Returns None when given an invalid path (such as a path containing interior NUL bytes). The exact checks are not guaranteed.

Non-unicode and HFS+ support

Modern Apple disk drives use APFS nowadays, which forces all paths to be valid unicode. The URL standard also uses unicode, and non-unicode parts of the URL will be percent-encoded, and the url will be given the scheme file://. All of this is as it should be.

Unfortunately, a lot of Foundation APIs (including the NSFileManager and NSData APIs) currently assume that they can always get unicode paths back by calling NSURL::path internally, which is not true.

If you need to support non-unicode paths in HFS+ with these APIs, you can work around this issue by percent-encoding any non-unicode parts of the path yourself beforehand, similar to what’s done in the trash-rs crate. (this function cannot do that for you, since it relies on a quirk of HFS+ that b“\xf8“ and b“%F8“ refer to the same file).

Examples

use std::path::Path;
use objc2_foundation::NSURL;

// Absolute paths work as you'd expect.
let url = NSURL::from_file_path("/tmp/file.txt").unwrap();
assert_eq!(url.to_file_path().unwrap(), Path::new("/tmp/file.txt"));

// Relative paths are relative to the current directory.
let url = NSURL::from_file_path("foo.txt").unwrap();
assert_eq!(url.to_file_path().unwrap(), std::env::current_dir().unwrap().join("foo.txt"));

// Some invalid paths return `None`.
assert!(NSURL::from_file_path("").is_none());
// Another example of an invalid path containing interior NUL bytes.
assert!(NSURL::from_file_path("/a/\0a").is_none());

pub fn from_directory_path<P: AsRef<Path>>(path: P) -> Option<Retained<Self>>

Available on crate feature std and Unix and non-crate feature gnustep-1-7 only.

Create a directory url from a Path.

This differs from from_file_path in that the path is treated as a directory, which means that other normalization rules are applied to it (to make it end with a /).

Examples

use std::path::Path;
use objc2_foundation::NSURL;

// Directory paths get trailing slashes appended
let url = NSURL::from_directory_path("/Library").unwrap();
assert_eq!(url.to_file_path().unwrap(), Path::new("/Library/"));

// Unless they already have them.
let url = NSURL::from_directory_path("/Library/").unwrap();
assert_eq!(url.to_file_path().unwrap(), Path::new("/Library/"));

// Similarly for relative paths.
let url = NSURL::from_directory_path("foo").unwrap();
assert_eq!(url.to_file_path().unwrap(), std::env::current_dir().unwrap().join("foo/"));

// Various dots may be stripped.
let url = NSURL::from_directory_path("/Library/././.").unwrap();
assert_eq!(url.to_file_path().unwrap(), Path::new("/Library/"));

// Though of course not if they have semantic meaning.
let url = NSURL::from_directory_path("/Library/..").unwrap();
assert_eq!(url.to_file_path().unwrap(), Path::new("/Library/.."));

pub fn to_file_path(&self) -> Option<PathBuf>

Available on crate feature std and Unix and non-crate feature gnustep-1-7 only.

Extract the path part of the URL as a PathBuf.

This will return a path regardless of isFileURL. It is the responsibility of the caller to ensure that the URL is valid to use as a file URL.

Compatibility note

This currently does not work for non-unicode paths (which are fairly rare on macOS since HFS+ was been superseded by APFS).

This also currently always returns absolute paths (it converts relative URL paths to absolute), but that may change in the future.

Examples

use std::path::Path;
use objc2_foundation::{NSURL, NSString};

let url = unsafe { NSURL::URLWithString(&NSString::from_str("file:///tmp/foo.txt")).unwrap() };
assert_eq!(url.to_file_path().unwrap(), Path::new("/tmp/foo.txt"));

See also the examples in from_file_path.

Methods from Deref<Target = NSObject>

pub fn doesNotRecognizeSelector(&self, sel: Sel) -> !

Handle messages the object doesn’t recognize.

See Apple’s documentation for details.

Methods from Deref<Target = AnyObject>

pub fn class(&self) -> &'static AnyClass

Dynamically find the class of this object.

Panics

May panic if the object is invalid (which may be the case for objects returned from unavailable init/new methods).

Example

Check that an instance of NSObject has the precise class NSObject.

use objc2::ClassType;
use objc2::runtime::NSObject;

let obj = NSObject::new();
assert_eq!(obj.class(), NSObject::class());

pub unsafe fn get_ivar<T>(&self, name: &str) -> &T

where T: Encode,

👎Deprecated: this is difficult to use correctly, use Ivar::load instead.

Use Ivar::load instead.

Safety

The object must have an instance variable with the given name, and it must be of type T.

See Ivar::load_ptr for details surrounding this.

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: DowncastTarget,

Attempt to downcast the object to a class of type T.

This is the reference-variant. Use Retained::downcast if you want to convert a retained object to another type.

Mutable classes

Some classes have immutable and mutable variants, such as NSString and NSMutableString.

When some Objective-C API signature says it gives you an immutable class, it generally expects you to not mutate that, even though it may technically be mutable “under the hood”.

So using this method to convert a NSString to a NSMutableString, while not unsound, is generally frowned upon unless you created the string yourself, or the API explicitly documents the string to be mutable.

See Apple’s documentation on mutability and on isKindOfClass: for more details.

Generic classes

Objective-C generics are called “lightweight generics”, and that’s because they aren’t exposed in the runtime. This makes it impossible to safely downcast to generic collections, so this is disallowed by this method.

You can, however, safely downcast to generic collections where all the type-parameters are AnyObject.

Panics

This works internally by calling isKindOfClass:. That means that the object must have the instance method of that name, and an exception will be thrown (if CoreFoundation is linked) or the process will abort if that is not the case. In the vast majority of cases, you don’t need to worry about this, since both root objects NSObject and NSProxy implement this method.

Examples

Cast an NSString back and forth from NSObject.

use objc2::rc::Retained;
use objc2_foundation::{NSObject, NSString};

let obj: Retained<NSObject> = NSString::new().into_super();
let string = obj.downcast_ref::<NSString>().unwrap();
// Or with `downcast`, if we do not need the object afterwards
let string = obj.downcast::<NSString>().unwrap();

Try (and fail) to cast an NSObject to an NSString.

use objc2_foundation::{NSObject, NSString};

let obj = NSObject::new();
assert!(obj.downcast_ref::<NSString>().is_none());

Try to cast to an array of strings.

use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);
// This is invalid and doesn't type check.
let arr = arr.downcast_ref::<NSArray<NSString>>();

This fails to compile, since it would require enumerating over the array to ensure that each element is of the desired type, which is a performance pitfall.

Downcast when processing each element instead.

use objc2_foundation::{NSArray, NSObject, NSString};

let arr = NSArray::from_retained_slice(&[NSObject::new()]);

for elem in arr {
    if let Some(data) = elem.downcast_ref::<NSString>() {
        // handle `data`
    }
}

Trait Implementations

impl AsRef<AnyObject> for NSURL

fn as_ref(&self) -> &AnyObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<NSObject> for NSURL

fn as_ref(&self) -> &NSObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<NSURL> for NSURL

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<AnyObject> for NSURL

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<NSObject> for NSURL

fn borrow(&self) -> &NSObject

Immutably borrows from an owned value.

impl ClassType for NSURL

const NAME: &'static str = "NSURL"

The name of the Objective-C class that this type represents.

type Super = NSObject

The superclass of this class.

type ThreadKind = <<NSURL as ClassType>::Super as ClassType>::ThreadKind

Whether the type can be used from any thread, or from only the main thread.

fn class() -> &'static AnyClass

Get a reference to the Objective-C class that this type represents.

fn as_super(&self) -> &Self::Super

Get an immutable reference to the superclass.

impl CopyingHelper for NSURL

Available on crate feature NSObject only.

type Result = NSURL

The immutable counterpart of the type, or Self if the type has no immutable counterpart.

impl Debug for NSURL

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for NSURL

type Target = NSObject

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Hash for NSURL

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for NSURL

fn retain(&self) -> Retained<Self>

where Self: Sized,

Increment the reference count of the receiver.

impl NSCoding for NSURL

unsafe fn encodeWithCoder(&self, coder: &NSCoder)

where Self: Sized + Message,

Available on crate features NSObject and NSCoder only.

unsafe fn initWithCoder( this: Allocated<Self>, coder: &NSCoder, ) -> Option<Retained<Self>>

where Self: Sized + Message,

Available on crate features NSObject and NSCoder only.

impl NSCopying for NSURL

fn copy(&self) -> Retained<Self::Result>

where Self: Sized + Message + CopyingHelper,

Available on crate feature NSObject only.

Returns a new instance that’s a copy of the receiver.

unsafe fn copyWithZone(&self, zone: *mut NSZone) -> Retained<Self::Result>

where Self: Sized + Message + CopyingHelper,

Available on crate feature NSObject only.

Returns a new instance that’s a copy of the receiver.

impl NSItemProviderReading for NSURL

unsafe fn readableTypeIdentifiersForItemProvider() -> Retained<NSArray<NSString>>

where Self: Sized + ClassType,

Available on crate features NSArray and NSString and NSItemProvider only.

unsafe fn objectWithItemProviderData_typeIdentifier_error( data: &NSData, type_identifier: &NSString, ) -> Result<Retained<Self>, Retained<NSError>>

where Self: Sized + ClassType,

Available on crate features NSData and NSError and NSString and NSItemProvider only.

impl NSItemProviderWriting for NSURL

unsafe fn writableTypeIdentifiersForItemProvider_class() -> Retained<NSArray<NSString>>

where Self: Sized + ClassType,

Available on crate features NSArray and NSString and NSItemProvider only.

unsafe fn writableTypeIdentifiersForItemProvider( &self, ) -> Retained<NSArray<NSString>>

where Self: Sized + Message,

Available on crate features NSArray and NSString and NSItemProvider only.

unsafe fn itemProviderVisibilityForRepresentationWithTypeIdentifier_class( type_identifier: &NSString, ) -> NSItemProviderRepresentationVisibility

where Self: Sized + ClassType,

Available on crate features NSItemProvider and NSString only.

unsafe fn itemProviderVisibilityForRepresentationWithTypeIdentifier( &self, type_identifier: &NSString, ) -> NSItemProviderRepresentationVisibility

where Self: Sized + Message,

Available on crate features NSItemProvider and NSString only.

unsafe fn loadDataWithTypeIdentifier_forItemProviderCompletionHandler( &self, type_identifier: &NSString, completion_handler: &DynBlock<dyn Fn(*mut NSData, *mut NSError)>, ) -> Option<Retained<NSProgress>>

where Self: Sized + Message,

Available on crate features NSData and NSError and NSProgress and NSString and block2 and NSItemProvider only.

impl NSObjectProtocol for NSURL

fn isEqual(&self, other: Option<&AnyObject>) -> bool

where Self: Sized + Message,

Check whether the object is equal to an arbitrary other object.

fn hash(&self) -> usize

where Self: Sized + Message,

An integer that can be used as a table address in a hash table structure.

fn isKindOfClass(&self, cls: &AnyClass) -> bool

where Self: Sized + Message,

Check if the object is an instance of the class, or one of its subclasses.

fn is_kind_of<T>(&self) -> bool

where T: ClassType, Self: Sized + Message,

👎Deprecated: use isKindOfClass directly, or cast your objects with AnyObject::downcast_ref

Check if the object is an instance of the class type, or one of its subclasses.

fn isMemberOfClass(&self, cls: &AnyClass) -> bool

where Self: Sized + Message,

Check if the object is an instance of a specific class, without checking subclasses.

fn respondsToSelector(&self, aSelector: Sel) -> bool

where Self: Sized + Message,

Check whether the object implements or inherits a method with the given selector.

fn conformsToProtocol(&self, aProtocol: &AnyProtocol) -> bool

where Self: Sized + Message,

Check whether the object conforms to a given protocol.

fn description(&self) -> Retained<NSObject>

where Self: Sized + Message,

A textual representation of the object.

fn debugDescription(&self) -> Retained<NSObject>

where Self: Sized + Message,

A textual representation of the object to use when debugging.

fn isProxy(&self) -> bool

where Self: Sized + Message,

Check whether the receiver is a subclass of the NSProxy root class instead of the usual NSObject.

fn retainCount(&self) -> usize

where Self: Sized + Message,

The reference count of the object.

impl NSSecureCoding for NSURL

unsafe fn supportsSecureCoding() -> bool

where Self: Sized + ClassType,

Available on crate feature NSObject only.

impl PartialEq for NSURL

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RefEncode for NSURL

const ENCODING_REF: Encoding = <NSObject as ::objc2::RefEncode>::ENCODING_REF

The Objective-C type-encoding for a reference of this type.

impl DowncastTarget for NSURL

impl Eq for NSURL

impl Send for NSURL

impl Sync for NSURL