Determines the type of relationship that exists between a system directory and the specified item.
- iOS 8.0+
- macOS 10.10+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
A pointer to a variable in which to put the relationship between
other. For a list of possible values, see
The search path directory. For a list of possible values, see
The file system domain to search. Specify
0for this parameter if you want the file manager to choose the domain that is most appropriate for the specified
The URL of the file or directory whose relationship to
directoryis being tested. This parameter must not be
On input, a pointer to an error object. If an error occurs, this pointer is set to an actual error object containing the error information. You may specify
nilfor this parameter if you do not want the error information.
YES if the relationship between the items was successfully determined, or
NO if an error occurred.
Use this method to determine the relationship between an item and one of the system-specific directories. For example, you might use this method to determine if the specified item is in the user’s
Documents directory or is in the trash. If the relationship between the items is determined successfully, this method sets the value of the
out parameter to an appropriate value and returns
YES. The directory may contain the item, it may be the same as the item, or it may not have a direct relationship to the item.