Returns a Boolean value that indicates whether a file or directory exists at a specified path.
SDKs
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- watchOS 2.0+
Framework
- Foundation
Declaration
- (BOOL)fileExistsAtPath:(NSString *)path isDirectory:(BOOL *)isDirectory;
Parameters
pathThe path of a file or directory. If
pathbegins with a tilde (~), it must first be expanded withstring, or this method will returnBy Expanding Tilde In Path NO.isDirectoryUpon return, contains
YESifpathis a directory or if the final path element is a symbolic link that points to a directory; otherwise, containsNO. Ifpathdoesn’t exist, this value is undefined upon return. PassNULLif you do not need this information.
Return Value
YES if a file at the specified path exists, or NO if the file’s does not exist or its existence could not be determined.
Discussion
If the file at path is inaccessible to your app, perhaps because one or more parent directories are inaccessible, this method returns NO. If the final element in path specifies a symbolic link, this method traverses the link and returns YES or NO based on the existence of the file at the link destination.
If you need to further determine whether path is a package, use the is method of NSWorkspace.
Listing 1 gets an array that identifies the fonts in the user's fonts directory:
NSArray *subpaths;
BOOL isDir;
NSArray *paths = NSSearchPathForDirectoriesInDomains
(NSLibraryDirectory, NSUserDomainMask, YES);
if ([paths count] == 1) {
NSFileManager *fileManager = [[NSFileManager alloc] init];
NSString *fontPath = [[paths objectAtIndex:0] stringByAppendingPathComponent:@"Fonts"];
if ([fileManager fileExistsAtPath:fontPath isDirectory:&isDir] && isDir) {
subpaths = [fileManager subpathsAtPath:fontPath];
// ...