Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы основы ссылка класса NSFileManager

Опции
Развертывание Target:

На этой странице
Язык:

NSFileManager

NSFileManager объект позволяет Вам исследовать содержание файловой системы и внести изменения в него. Объект файлового менеджера обычно является Вашим первым взаимодействием с файловой системой. Вы используете его, чтобы определить местоположение, создать, скопировать, и переместить файлы и каталоги. Вы также используете его, чтобы получить информацию о файле или каталоге или изменить некоторые его атрибуты.

NSFileManager класс обеспечивает удобный доступ к менеджеру по совместно используемому файлу объект, подходящий для большинства типов связанных с файлом манипуляций. Если Вы планируете использовать объект файлового менеджера в интерактивном режиме — например, если Вы планируете присвоиться, объект делегата к нему — создают Ваш собственный экземпляр класса.

При указании расположения файлов можно использовать также NSURL или NSString объекты. Использование NSURL класс обычно предпочитается для указания элементов файловой системы, потому что они могут преобразовать информацию о пути в более эффективное представление внутренне. Можно также получить закладку из NSURL объект, который подобен псевдониму и предлагает более верный способ определить местоположение файла или каталога позже.

Если Вы перемещаетесь, копирование, соединение или удаление файлов или каталогов, можно использовать делегата в сочетании с объектом файлового менеджера управлять теми операциями. Роль делегата должна подтвердить работу и решить, продолжить ли, когда происходят ошибки. В OS X v10.7 и позже, делегат должен соответствовать NSFileManagerDelegate протокол.

В iOS 5.0 и позже и в OS X v10.7 и позже, NSFileManager включает методы для управления элементами, сохраненными в iCloud. Файлы и каталоги, тегированные для «облачного» хранилища, синхронизируются к iCloud так, чтобы они могли быть сделаны доступными для устройств на iOS пользователя и компьютеров Macintosh. Изменения в элементе в одном расположении распространены ко всем другим расположениям, чтобы гарантировать, чтобы элементы остались в синхронизации.

Поточная обработка соображений

Методы совместно используемого NSFileManager объект можно вызвать от многократных потоков безопасно. Однако при использовании делегата, чтобы получить уведомления о состоянии перемещения, скопировать, удалить, и операции ссылки, необходимо создать уникальный экземпляр объекта файлового менеджера, присвоить делегата в том объекте и использовать тот файловый менеджер для инициирования операций.

Наследование

Соответствует

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.0 и позже.

Создание файлового менеджера
  • init - init

    Возвращает инициализированный NSFileManager экземпляр.

    Объявление

    Objective C

    - init

    Возвращаемое значение

    Инициализированный NSFileManager экземпляр.

    Обсуждение

    В iOS и в OS X 10.5 и позже можно использовать этот метод для создания определенного экземпляра файлового менеджера. Вы могли бы сделать это в ситуациях, где Вы хотите связать делегата с файловым менеджером для получения уведомлений о состоянии связанных с файлом операций.

  • defaultManager () + defaultManager

    Возвращает менеджера по совместно используемому файлу объект для процесса.

    Объявление

    Swift

    class func defaultManager() -> NSFileManager

    Objective C

    + (NSFileManager *)defaultManager

    Возвращаемое значение

    Значение по умолчанию NSFileManager объект для файловой системы.

    Обсуждение

    Этот метод всегда возвращает тот же объект файлового менеджера. Если Вы планируете использовать делегата с файловым менеджером для получения уведомлений о завершении основанных на файле операций, необходимо создать новый экземпляр NSFileManager (использование init метод) вместо того, чтобы использовать общий объект.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

Определение местоположения системных каталогов
  • URLForDirectory (_: inDomain:appropriateForURL:create:error:) - URLForDirectory:inDomain:appropriateForURL:create:error:

    Определяет местоположение и дополнительно создает указанный общий каталог в домене.

    Объявление

    Swift

    func URLForDirectory(_ directory: NSSearchPathDirectory, inDomain domain: NSSearchPathDomainMask, appropriateForURL url: NSURL?, create shouldCreate: Bool, error error: NSErrorPointer) -> NSURL?

    Objective C

    - (NSURL *)URLForDirectory:(NSSearchPathDirectory)directory inDomain:(NSSearchPathDomainMask)domain appropriateForURL:(NSURL *)url create:(BOOL)shouldCreate error:(NSError **)error

    Параметры

    directory

    Каталог пути поиска. Поддерживаемые значения описаны в NSSearchPathDirectory.

    domain

    Домен файловой системы для поиска. Значение для этого параметра является одной из констант, описанных в NSSearchPathDomainMask. Необходимо указать только один домен для поиска, и Вы не можете указать NSAllDomainsMask постоянный для этого параметра.

    url

    Имя каталога, в котором Вы хотите создать уникальный временный каталог для автоматического сохранения документов или некоторого другого использования. Этот параметр проигнорирован если directory параметр содержит значение NSItemReplacementDirectory и domain параметр содержит значение NSUserDomainMask. При создании временного каталога, shouldCreate параметр проигнорирован, и каталог всегда создается.

    shouldCreate

    Указать YEStrue если Вы хотите, чтобы каталог был создан, если он не существует.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    NSURL для требуемого каталога или nil если произошла ошибка.

    Обсуждение

    Вы обычно используете этот метод для определения местоположения одного из стандартных системных каталогов, такой как Documents, Application Support или Caches каталоги. Можно также использовать этот метод для создания нового временного каталога для хранения вещей как файлы автосохранения; для этого укажите NSItemReplacementDirectory для directory параметр, NSUserDomainMask для domain параметр и допустимый родительский каталог для url параметр. После определения местоположения (или создание) желаемый каталог, этот метод возвращает URL для того каталога. Если больше чем один надлежащий каталог существует в указанном домене, этот метод возвращает только первый, который это находит.

    Передача каталога и доменной пары, не имеющей никакого смысла (например, NSDesktopDirectory и NSNetworkDomainMask) повышает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    NSSearchPathForDirectoriesInDomains

  • URLsForDirectory (_: inDomains:) - URLsForDirectory:inDomains:

    Возвращает массив URLs для указанного общего каталога в требуемых доменах.

    Объявление

    Swift

    func URLsForDirectory(_ directory: NSSearchPathDirectory, inDomains domainMask: NSSearchPathDomainMask) -> [AnyObject]

    Objective C

    - (NSArray *)URLsForDirectory:(NSSearchPathDirectory)directory inDomains:(NSSearchPathDomainMask)domainMask

    Параметры

    directory

    Каталог пути поиска. Поддерживаемые значения описаны в NSSearchPathDirectory.

    domainMask

    Домен файловой системы для поиска. Значение для этого параметра один или больше констант, описанных в NSSearchPathDomainMask.

    Возвращаемое значение

    Массив NSURL объекты, идентифицирующие требуемые каталоги. Каталоги упорядочиваются согласно порядку доменных констант маски с элементами в пользовательском домене сначала и элементами в системном домене в последний раз.

    Обсуждение

    Этот метод предназначается для определения местоположения известных и общих каталогов в системе. Например, устанавливая каталог в NSApplicationDirectory, возвратит Каталоги приложений в требуемом домене. Существует много общих каталогов, доступных в NSSearchPathDirectory, включая: NSDesktopDirectory, NSApplicationSupportDirectory, и еще много.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

Определение местоположения каталогов контейнера группы приложений
  • containerURLForSecurityApplicationGroupIdentifier (_:) - containerURLForSecurityApplicationGroupIdentifier:

    Возвращает контейнерный каталог, связанный с указанной группой приложения защиты ID.

    Объявление

    Swift

    func containerURLForSecurityApplicationGroupIdentifier(_ groupIdentifier: String) -> NSURL?

    Objective C

    - (NSURL *)containerURLForSecurityApplicationGroupIdentifier:(NSString *)groupIdentifier

    Обсуждение

    Как объяснено в Руководстве по проектированию Тестовой среды приложения, группы поигравших в песочнице приложений, которые должны совместно использовать файлы и другую информацию, могут запросить контейнерный каталог как часть их прав. Эти каталоги сохранены в ~/Library/Group Containers/.

    Когда вызвано с допустимым идентификатором группы, этот метод возвращает расположение того каталога как NSURL объект. Этот метод также создает каталог, если это еще не существует.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.8 и позже.

Обнаружение содержания каталога
  • contentsOfDirectoryAtURL (_: includingPropertiesForKeys:options:error:) - contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error:

    Выполняет мелкий поиск указанного каталога и возвращает URLs для содержавших элементов.

    Объявление

    Swift

    func contentsOfDirectoryAtURL(_ url: NSURL, includingPropertiesForKeys keys: [AnyObject]?, options mask: NSDirectoryEnumerationOptions, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)contentsOfDirectoryAtURL:(NSURL *)url includingPropertiesForKeys:(NSArray *)keys options:(NSDirectoryEnumerationOptions)mask error:(NSError **)error

    Параметры

    url

    URL для каталога, содержание которого Вы хотите перечислить.

    keys

    Массив ключей, идентифицирующих свойства файла, которые Вы хотите выбранный с упреждением для каждого элемента в каталоге. Поскольку каждый возвратил URL, указанные свойства выбираются и кэшируются в NSURL объект. Для списка ключей можно указать, видеть Common File System Resource Keys.

    mask

    Опции для перечисления. Поскольку этот метод выполняет только мелкие перечисления, опции, предотвращающие убывание в подкаталоги, или пакеты не позволяются; единственная поддерживаемая опция NSDirectoryEnumerationSkipsHiddenFiles.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    Массив NSURL объекты, каждый из которых идентифицирует файл, каталог или символьную ссылку, содержавшую в url. Если каталог не содержит записей, этот метод возвращает пустой массив. Если ошибка происходит, этот метод возвраты nil и присваивает надлежащий ошибочный объект error параметр.

    Обсуждение

    Этот метод выполняет мелкий поиск каталога и поэтому не пересекает символьные ссылки или возвращает содержание любых подкаталогов. Этот метод также не возвращает URLs для текущего каталога (“.”), родительский каталог (“..”), или ветви ресурсов (файлы, начинающиеся “._”), но это действительно возвращает другие скрытые файлы (файлы, начинающиеся с символа точки). Если необходимо выполнить глубокое перечисление, используйте enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: метод вместо этого.

    Порядок файлов в возвращенном массиве не определен.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – contentsOfDirectoryAtPath:error:

  • contentsOfDirectoryAtPath (_: ошибка:) - contentsOfDirectoryAtPath:error:

    Выполняет мелкий поиск указанного каталога и возвращает пути любых содержавших элементов.

    Объявление

    Swift

    func contentsOfDirectoryAtPath(_ path: String, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)contentsOfDirectoryAtPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Путь к каталогу, содержание которого Вы хотите перечислить.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    Массив NSString объекты, каждый из которых идентифицирует файл, каталог или символьную ссылку, содержавшую в path. Если каталог существует, но не имеет никакого содержания, возвращает пустой массив. Если ошибка происходит, этот метод возвраты nil и присваивает надлежащий ошибочный объект error параметр

    Обсуждение

    Этот метод выполняет мелкий поиск каталога и поэтому не пересекает символьные ссылки или возвращает содержание любых подкаталогов. Этот метод также не возвращает URLs для текущего каталога (“.”), родительский каталог (“..”), или ветви ресурсов (файлы, начинающиеся “._”), но это действительно возвращает другие скрытые файлы (файлы, начинающиеся с символа точки). Если необходимо выполнить глубокое перечисление, используйте enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: метод вместо этого.

    Порядок файлов в возвращенном массиве не определен.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    currentDirectoryPath
    – fileExistsAtPath:isDirectory:
    – enumeratorAtPath:
    – subpathsAtPath:

  • enumeratorAtURL (_: includingPropertiesForKeys:options:errorHandler:) - enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

    Возвращает объект перечислителя каталога, который может использоваться для выполнения глубокого перечисления каталога в указанном URL.

    Объявление

    Swift

    func enumeratorAtURL(_ url: NSURL, includingPropertiesForKeys keys: [AnyObject]?, options mask: NSDirectoryEnumerationOptions, errorHandler handler: ((NSURL!, NSError!) -> Bool)?) -> NSDirectoryEnumerator?

    Objective C

    - (NSDirectoryEnumerator *)enumeratorAtURL:(NSURL *)url includingPropertiesForKeys:(NSArray *)keys options:(NSDirectoryEnumerationOptions)mask errorHandler:(BOOL (^)(NSURL *url, NSError *error))handler

    Параметры

    url

    Расположение каталога, для которого Вы хотите перечисление. Этот URL не должен быть символьной ссылкой, указывающей на желаемый каталог. Можно использовать URLByResolvingSymlinksInPath метод для разрешения любых символьных ссылок в URL.

    keys

    Массив ключей, идентифицирующих свойства, которые Вы хотите выбранный с упреждением для каждого элемента в перечислении. Значения для этих ключей кэшируются в соответствии NSURL объекты. Можно указать nil для этого параметра. Для списка ключей можно указать, видеть Common File System Resource Keys.

    mask

    Опции для перечисления. Для списка допустимых опций посмотрите Опции Перечисления Каталога.

    handler

    Когда ошибка происходит, дополнительный обработчик ошибок блокирует для файлового менеджера для вызова. Блок обработчика должен возвратиться YEStrue если Вы хотите, чтобы перечисление продолжалось или NOfalse если Вы хотите, чтобы остановилось перечисление. Блок берет следующие параметры:

    url

    NSURL объект, идентифицирующий элемент, для которого произошла ошибка.

    error

    NSError объект, содержащий информацию об ошибке.

    Если Вы указываете nil для этого параметра объект перечислителя продолжается к элементам перечислителя, как будто Вы указали возвратившийся блок YEStrue.

    Возвращаемое значение

    NSDirectoryEnumerator объект, перечисляющий содержание каталога в url. Если url имя файла, метод возвращает объект перечислителя, не перечисляющий файлов — первый вызов к nextObject возвраты nil.

    Обсуждение

    Поскольку перечисление глубоко — т.е. оно перечисляет содержание всех подкаталогов — этот объект перечислителя полезен для выполнения действий, включающих большие поддеревья файловой системы. Если метод передается каталог, на котором смонтирована другая файловая система (точка монтирования), это пересекает точку монтирования. Этот метод не разрешает символьные ссылки или точки монтирования, с которыми встречаются в процессе перечисления, и при этом это не рекурсивно вызывает через них, если они указывают на каталог.

    Например, если Вы передаете URL, указывающий на /Volumes/MyMountedFileSystem, возвращенный перечислитель будет включать всю структуру каталогов для файловой системы, смонтированной в том расположении. Если с другой стороны Вы передаете /Volumes, возвращенный перечислитель будет включать /Volumes/MyMountedFileSystem как один из его результатов, но не пересечет в файловую систему, смонтированную там.

    NSDirectoryEnumerator класс имеет методы для пропуска потомков существующего пути и для возврата числа уровней глубоко, текущий объект находится в перечисляемой иерархии каталогов (куда каталог передал enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: считается уровнем 0).

    Этот фрагмент кода перечисляет URL и его подкаталоги, собирая URLs файлов (пропускает каталоги). Это также демонстрирует, как проигнорировать содержание указанных каталогов в этом случае каталоги, названные «_extras».

    • -(void)scanURLIgnoringExtras:(NSURL *)directoryToScan
    • {
    • // Create a local file manager instance
    • NSFileManager *localFileManager=[[NSFileManager alloc] init];
    • // Enumerate the directory (specified elsewhere in your code)
    • // Request the two properties the method uses, name and isDirectory
    • // Ignore hidden files
    • // The errorHandler: parameter is set to nil. Typically you'd want to present a panel
    • NSDirectoryEnumerator *dirEnumerator = [localFileManager enumeratorAtURL:directoryToScan
    • includingPropertiesForKeys:[NSArray arrayWithObjects:NSURLNameKey,
    • NSURLIsDirectoryKey,nil]
    • options:NSDirectoryEnumerationSkipsHiddenFiles
    • errorHandler:nil];
    • // An array to store the all the enumerated file names in
    • NSMutableArray *theArray=[NSMutableArray array];
    • // Enumerate the dirEnumerator results, each value is stored in allURLs
    • for (NSURL *theURL in dirEnumerator) {
    • // Retrieve the file name. From NSURLNameKey, cached during the enumeration.
    • NSString *fileName;
    • [theURL getResourceValue:&fileName forKey:NSURLNameKey error:NULL];
    • // Retrieve whether a directory. From NSURLIsDirectoryKey, also
    • // cached during the enumeration.
    • NSNumber *isDirectory;
    • [theURL getResourceValue:&isDirectory forKey:NSURLIsDirectoryKey error:NULL];
    • // Ignore files under the _extras directory
    • if (([fileName caseInsensitiveCompare:@"_extras"]==NSOrderedSame) &&
    • ([isDirectory boolValue]==YES))
    • {
    • [dirEnumerator skipDescendants];
    • }
    • else
    • {
    • // Add full path for non directories
    • if ([isDirectory boolValue]==NO)
    • [theArray addObject:theURL];
    • }
    • }
    • // Do something with the path URLs.
    • NSLog(@"theArray - %@",theArray);
    • }

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – enumeratorAtPath:

  • enumeratorAtPath (_:) - enumeratorAtPath:

    Возвращает объект перечислителя каталога, который может использоваться для выполнения глубокого перечисления каталога в указанном пути.

    Объявление

    Swift

    func enumeratorAtPath(_ path: String) -> NSDirectoryEnumerator?

    Objective C

    - (NSDirectoryEnumerator *)enumeratorAtPath:(NSString *)path

    Параметры

    path

    Путь каталога для перечисления.

    Возвращаемое значение

    NSDirectoryEnumerator объект, перечисляющий содержание каталога в path.

    Если path имя файла, метод возвращает объект перечислителя, не перечисляющий файлов — первый вызов к nextObject возвратится nil.

    Обсуждение

    Поскольку перечисление глубоко — т.е. оно перечисляет содержание всех подкаталогов — этот объект перечислителя полезен для выполнения действий, включающих большие поддеревья файловой системы. Этот метод не разрешает символьные ссылки, с которыми встречаются в пересекающемся процессе, и при этом это не рекурсивно вызывает через них, если они указывают на каталог.

    Этот фрагмент кода перечисляет подкаталоги и файлы при пользователе Documents каталог и процессы все файлы с расширением .doc:

    • NSString *docsDir = [NSHomeDirectory() stringByAppendingPathComponent: @"Documents"];
    • NSFileManager *localFileManager=[[NSFileManager alloc] init];
    • NSDirectoryEnumerator *dirEnum =
    •     [localFileManager enumeratorAtPath:docsDir];
    • NSString *file;
    • while ((file = [dirEnum nextObject])) {
    •     if ([[file pathExtension] isEqualToString: @"doc"]) {
    • // process the document
    •         [self scanDocument: [docsDir stringByAppendingPathComponent:file]];
    •     }
    • }

    NSDirectoryEnumerator класс имеет методы для получения атрибутов существующего пути и родительского каталога и для пропуска потомков существующего пути.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    currentDirectoryPath
    – attributesOfItemAtPath:error:
    – contentsOfDirectoryAtPath:error:
    – subpathsAtPath:
    – enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:

  • mountedVolumeURLsIncludingResourceValuesForKeys (_: опции:) - mountedVolumeURLsIncludingResourceValuesForKeys:options:

    Возвращает массив URLs, идентифицирующего смонтированные объемы, доступные на компьютере.

    Объявление

    Swift

    func mountedVolumeURLsIncludingResourceValuesForKeys(_ propertyKeys: [AnyObject]?, options options: NSVolumeEnumerationOptions) -> [AnyObject]?

    Objective C

    - (NSArray *)mountedVolumeURLsIncludingResourceValuesForKeys:(NSArray *)propertyKeys options:(NSVolumeEnumerationOptions)options

    Параметры

    propertyKeys

    Массив ключей, идентифицирующих свойства файла, которые Вы хотите выбранный с упреждением для каждого объема. Поскольку каждый возвратил URL, значения для этих ключей кэшируются в соответствии NSURL объекты. Можно указать nil для этого параметра. Для списка ключей можно указать, видеть Common File System Resource Keys.

    options

    Опция отмечает для перечисления. Для списка возможных значений посмотрите NSVolumeEnumerationOptions.

    Возвращаемое значение

    Массив NSURL объекты, идентифицирующие смонтированные объемы.

    Обсуждение

    Если I/O требуется, чтобы определять значения для требуемого, этот вызов может блокировать propertyKeys.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • subpathsOfDirectoryAtPath (_: ошибка:) - subpathsOfDirectoryAtPath:error:

    Выполняет глубокое перечисление указанного каталога и возвращает пути всех содержавших подкаталогов.

    Объявление

    Swift

    func subpathsOfDirectoryAtPath(_ path: String, error error: NSErrorPointer) -> [AnyObject]?

    Objective C

    - (NSArray *)subpathsOfDirectoryAtPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Путь каталога для перечисления.

    error

    Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему. Передача NULL если Вы не хотите информации об ошибке.

    Возвращаемое значение

    Массив NSString объекты, каждый из которых содержит путь элемента в каталоге, указанном path. Если path символьная ссылка, этот метод пересекает ссылку. Этот метод возвраты nil если это не может получить устройство соединенного - к файлу.

    Обсуждение

    Этот метод рекурсивно вызывает указанный каталог и его подкаталоги. Метод пропускает “.” и “..” каталоги на каждом уровне рекурсии.

    Поскольку этот метод рекурсивно вызывает содержание каталога, Вы не могли бы хотеть использовать его в критическом по отношению к производительности коде. Вместо этого рассмотрите использование enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: или enumeratorAtPath: метод для перечисления содержания каталога самостоятельно. Выполнение так дает Вам больше контроля извлечением элементов и большего количества возможностей прервать перечисление или выполнить другие задачи одновременно.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – enumeratorAtURL:includingPropertiesForKeys:options:errorHandler:
    – enumeratorAtPath:
    – contentsOfDirectoryAtPath:error:

  • subpathsAtPath (_:) - subpathsAtPath:

    Возвращает массив строк, идентифицирующих пути для всех элементов в указанном каталоге.

    Объявление

    Swift

    func subpathsAtPath(_ path: String) -> [AnyObject]?

    Objective C

    - (NSArray *)subpathsAtPath:(NSString *)path

    Параметры

    path

    Путь каталога для перечисления.

    Возвращаемое значение

    Массив NSString объекты, каждый из которых содержит путь элемента в каталоге, указанном path. Если path символьная ссылка, этот метод пересекает ссылку. Этот метод возвраты nil если это не может получить устройство соединенного - к файлу.

    Обсуждение

    Этот метод рекурсивно вызывает указанный каталог и его подкаталоги. Метод пропускает “.” и “..” каталоги на каждом уровне рекурсии.

    Этот метод показывает каждый элемент поддерева в path, включая содержание пакетов файла (такое как приложения, файлы пера и файлы RTFD). Этот фрагмент кода получает содержание /System/Library/Fonts после проверки, что существует каталог:

    • BOOL isDir=NO;
    • NSArray *subpaths;
    • NSString *fontPath = @"/System/Library/Fonts";
    • NSFileManager *fileManager = [[NSFileManager alloc] init];
    • if ([fileManager fileExistsAtPath:fontPath isDirectory:&isDir] && isDir)
    • subpaths = [fileManager subpathsAtPath:fontPath];

    Специальные замечания

    На OS X v10.5 и позже, использовать subpathsOfDirectoryAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – subpathsOfDirectoryAtPath:error:
    – contentsOfDirectoryAtPath:error:
    – enumeratorAtPath:

Создание и удаление элементов
  • createDirectoryAtURL (_: withIntermediateDirectories:attributes:error:) - createDirectoryAtURL:withIntermediateDirectories:attributes:error:

    Создает каталог с данными атрибутами в указанном URL.

    Объявление

    Swift

    func createDirectoryAtURL(_ url: NSURL, withIntermediateDirectories createIntermediates: Bool, attributes attributes: [NSObject : AnyObject]?, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)createDirectoryAtURL:(NSURL *)url withIntermediateDirectories:(BOOL)createIntermediates attributes:(NSDictionary *)attributes error:(NSError **)error

    Параметры

    url

    URL файла, указывающий каталог для создания. Если Вы хотите указать относительный путь, необходимо установить текущий рабочий каталог прежде, чем создать соответствие NSURL объект. Этот параметр не должен быть nil.

    createIntermediates

    Если YEStrue, этот метод создает любые несуществующие родительские каталоги как часть создания каталога в url. Если NOfalse, если какой-либо из промежуточных родительских каталогов не существует, этот метод перестал работать.

    attributes

    Атрибуты файла для нового каталога. Можно установить владельца и числа группы, полномочия файла и дату модификации. Если Вы указываете nil для этого параметра каталог создается согласно umask(2) Mac OS X Developer Tools Manual Page из процесса. Раздел Constants перечисляет глобальные константы, используемые в качестве ключей attributes словарь. Некоторые ключи, такой как NSFileHFSCreatorCode и NSFileHFSTypeCode, не применяйтесь к каталогам.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если каталог создавался, YEStrue если createIntermediates установлен и каталог уже существует), или NOfalse если произошла ошибка.

    Обсуждение

    Если Вы указываете nil для attributes параметр, этот метод использует набор по умолчанию значений для владельца, группы и полномочий любых недавно создаваемых каталогов по пути. Точно так же при исключении определенного атрибута значение по умолчанию используется. Значения по умолчанию для недавно создаваемых каталогов следующие:

    • Полномочия установлены согласно umask текущего процесса. Для получения дополнительной информации посмотрите umask.

    • Владелец ID установлен в эффективный идентификатор пользователя процесса.

    • Группа ID установлена в тот из родительского каталога.

    Если Вы хотите указать относительный путь для URL, необходимо установить текущий рабочий каталог прежде, чем создать соответствие NSURL объект.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – createDirectoryAtPath:withIntermediateDirectories:attributes:error:
    – setAttributes:ofItemAtPath:error:

  • createDirectoryAtPath (_: withIntermediateDirectories:attributes:error:) - createDirectoryAtPath:withIntermediateDirectories:attributes:error:

    Создает каталог с данными атрибутами в указанном пути.

    Объявление

    Swift

    func createDirectoryAtPath(_ path: String, withIntermediateDirectories createIntermediates: Bool, attributes attributes: [NSObject : AnyObject]?, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)createDirectoryAtPath:(NSString *)path withIntermediateDirectories:(BOOL)createIntermediates attributes:(NSDictionary *)attributes error:(NSError **)error

    Параметры

    path

    Строка пути, идентифицирующая каталог для создания. Можно указать полный путь или путь, который является относительно текущего рабочего каталога. Этот параметр не должен быть nil.

    createIntermediates

    Если YEStrue, этот метод создает любые несуществующие родительские каталоги как часть создания каталога в path. Если NOfalse, если какой-либо из промежуточных родительских каталогов не существует, этот метод перестал работать. Если какой-либо из промежуточных элементов пути соответствует файлу и не каталогу, этот метод также перестал работать.

    attributes

    Атрибуты файла для нового каталога и любых недавно создаваемых промежуточных каталогов. Можно установить владельца и числа группы, полномочия файла и дату модификации. Если Вы указываете nil для этого параметра или опускают определенное значение, одно или более значений по умолчанию используются, как описано в обсуждении. Для списка ключей можно включать в этот словарь, видеть, что раздел Constants перечисляет глобальные константы, используемые в качестве ключей attributes словарь. Некоторые ключи, такой как NSFileHFSCreatorCode и NSFileHFSTypeCode, не применяйтесь к каталогам.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если каталог создавался, YEStrue если createIntermediates установлен и каталог уже существует), или NOfalse если произошла ошибка.

    Обсуждение

    Если Вы указываете nil для attributes параметр, этот метод использует набор по умолчанию значений для владельца, группы и полномочий любых недавно создаваемых каталогов по пути. Точно так же при исключении определенного атрибута значение по умолчанию используется. Значения по умолчанию для недавно создаваемых каталогов следующие:

    • Полномочия установлены согласно umask текущего процесса. Для получения дополнительной информации посмотрите umask.

    • Владелец ID установлен в эффективный идентификатор пользователя процесса.

    • Группа ID установлена в тот из родительского каталога.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – createDirectoryAtURL:withIntermediateDirectories:attributes:error:
    – setAttributes:ofItemAtPath:error:

  • createFileAtPath (_: contents:attributes:) - createFileAtPath:contents:attributes:

    Создает файл с указанным содержанием и атрибутами в данном расположении.

    Объявление

    Swift

    func createFileAtPath(_ path: String, contents contents: NSData?, attributes attributes: [NSObject : AnyObject]?) -> Bool

    Objective C

    - (BOOL)createFileAtPath:(NSString *)path contents:(NSData *)contents attributes:(NSDictionary *)attributes

    Параметры

    path

    Путь для нового файла.

    contents

    Объект данных, содержащий содержание нового файла.

    attributes

    Словарь, содержащий атрибуты для соединения с новым файлом. Можно использовать эти атрибуты для установки владельца и чисел группы, полномочий файла и даты модификации. Для списка ключей посмотрите Ключи Атрибута файла. Если Вы указываете nil для attributes, файл создается с рядом атрибутов по умолчанию.

    Возвращаемое значение

    YEStrue если элемент уже существует, иначе, если работа была успешна или NOfalse.

    Обсуждение

    Если Вы указываете nil для attributes параметр, этот метод использует набор по умолчанию значений для владельца, группы и полномочий любых недавно создаваемых каталогов по пути. Точно так же при исключении определенного атрибута значение по умолчанию используется. Значения по умолчанию для недавно создаваемых файлов следующие:

    • Полномочия установлены согласно umask текущего процесса. Для получения дополнительной информации посмотрите umask.

    • Владелец ID установлен в эффективный идентификатор пользователя процесса.

    • Группа ID установлена в тот из родительского каталога.

    Если файл уже существует в path, если текущий процесс имеет надлежащие полномочия сделать так, этот метод перезаписывает содержание того файла.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – contentsAtPath:
    – setAttributes:ofItemAtPath:error:
    – setAttributes:ofItemAtPath:error:
    – attributesOfItemAtPath:error:

  • removeItemAtURL (_: ошибка:) - removeItemAtURL:error:

    Удаляет файл или каталог в указанном URL.

    Объявление

    Swift

    func removeItemAtURL(_ URL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeItemAtURL:(NSURL *)URL error:(NSError **)error

    Параметры

    URL

    Файл URL, указывающий файл или каталог для удаления. Если URL указывает каталог, содержание того каталога рекурсивно удалено. Можно указать nil для этого параметра.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был удален успешно или если URL был nil. Возвраты NOfalse если произошла ошибка. Если делегат прерывает работу для файла, этот метод возвраты YEStrue. Однако, если делегат прерывает работу для каталога, этот метод возвраты NOfalse.

    Обсуждение

    До удаления каждого элемента файловый менеджер спрашивает своего делегата, если это должно фактически сделать так. Это делает это путем вызова fileManager:shouldRemoveItemAtURL: метод; если тот метод не реализован (или процесс работает в OS X 10.5 или ранее), это вызывает fileManager:shouldRemoveItemAtPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, доходы файлового менеджера для удаления файла или каталога. Если существует ошибка при удалении элемента, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:removingItemAtURL: или fileManager:shouldProceedAfterError:removingItemAtPath: метод, чтобы определить, как продолжить.

    Удаление и элемент также удаляет все старые версии того элемента, лишая законной силы любой URLs, возвращенный URLForPublishingUbiquitousItemAtURL:expirationDate:error: метод к старым версиям.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – removeItemAtPath:error:
    – trashItemAtURL:resultingItemURL:error:

  • removeItemAtPath (_: ошибка:) - removeItemAtPath:error:

    Удаляет файл или каталог в указанном пути.

    Объявление

    Swift

    func removeItemAtPath(_ path: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeItemAtPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Строка пути, указывающая файл или каталог для удаления. Если путь указывает каталог, содержание того каталога рекурсивно удалено. Можно указать nil для этого параметра.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был удален успешно или если path был nil. Возвраты NOfalse если произошла ошибка. Если делегат прерывает работу для файла, этот метод возвраты YEStrue. Однако, если делегат прерывает работу для каталога, этот метод возвраты NOfalse.

    Обсуждение

    До удаления каждого элемента файловый менеджер спрашивает своего делегата, если это должно фактически сделать так. Это делает это путем вызова fileManager:shouldRemoveItemAtURL: метод; если тот метод не реализован (или процесс работает в OS X 10.5 или ранее), это вызывает fileManager:shouldRemoveItemAtPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, доходы файлового менеджера для удаления файла или каталога. Если существует ошибка при удалении элемента, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:removingItemAtURL: или fileManager:shouldProceedAfterError:removingItemAtPath: метод, чтобы определить, как продолжить.

    Удаление и элемент также удаляет все старые версии того элемента, лишая законной силы любой URLs, возвращенный URLForPublishingUbiquitousItemAtURL:expirationDate:error: метод к старым версиям.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

  • replaceItemAtURL (_: withItemAtURL:backupItemName:options:resultingItemURL:error:) - replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:

    Заменяет содержание элемента в указанном URL способом, обеспечивающим, чтобы не происходила никакая потеря данных.

    Объявление

    Swift

    func replaceItemAtURL(_ originalItemURL: NSURL, withItemAtURL newItemURL: NSURL, backupItemName backupItemName: String?, options options: NSFileManagerItemReplacementOptions, resultingItemURL resultingURL: AutoreleasingUnsafeMutablePointer<NSURL?>, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)replaceItemAtURL:(NSURL *)originalItemURL withItemAtURL:(NSURL *)newItemURL backupItemName:(NSString *)backupItemName options:(NSFileManagerItemReplacementOptions)options resultingItemURL:(NSURL **)resultingURL error:(NSError **)error

    Параметры

    originalItemURL

    Элемент, содержание которого Вы хотите заменить.

    newItemURL

    Элемент, содержащий новое содержание для originalItemURL. Рекомендуется поместить этот элемент во временный каталог в соответствии с OS. Если временный каталог не доступен, поместите этот элемент в уникально именованный каталог, который находится в том же каталоге как исходный элемент.

    backupItemName

    Дополнительный. Если предоставленный, это имя используется для создания резервного копирования исходного элемента.

    Резервное копирование помещается в тот же каталог как исходный элемент. Если ошибка произойдет во время создания резервного элемента, то работа перестанет работать. Если уже будет элемент с тем же именем как резервный элемент, то тот элемент будет удален.

    Резервный элемент будет удален в случае успеха если NSFileManagerItemReplacementWithoutDeletingBackupItem возможность предоставляется в options.

    options

    Указывает опции использовать во время замены. Как правило, Вы передаете NSFileManagerItemReplacementUsingNewMetadataOnly для этого параметра, использующего только метаданные от нового элемента. Можно также объединить опции, описанные в NSFileManagerItemReplacementOptions с помощью оператора C-битового-«ИЛИ».

    resultingURL

    На вводе, указателе для объекта URL. Когда элемент заменяется, этот указатель установлен в URL нового элемента. Если никакой новый объект файловой системы не требуется, объект URL в этом параметре может быть тем же, переданным originalItemURL параметр. Однако, если новый объект файловой системы требуется, объект URL может отличаться. Например, замена документа RTF с документом RTFD требует создания нового файла.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если замена была успешна или NOfalse если произошла ошибка.

    Обсуждение

    По умолчанию дата создания, полномочия, метка Средства поиска и цвет и комментарии Центра внимания исходного элемента будут сохранены на получающемся элементе.

    Если ошибка происходит, и исходный элемент не находится в исходном расположении или временном расположении, возвращенный ошибочный объект содержит пользовательский информационный словарь с NSFileOriginalItemLocationKey ключ. Значение, присвоенное тому ключу, NSURL объект с расположением элемента. Код ошибки является одной из связанных с файлом ошибок, описанных в NSError Codes.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • trashItemAtURL (_: resultingItemURL:error:) - trashItemAtURL:resultingItemURL:error:

    Перемещает элемент в мусор.

    Объявление

    Swift

    func trashItemAtURL(_ url: NSURL, resultingItemURL outResultingURL: AutoreleasingUnsafeMutablePointer<NSURL?>, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)trashItemAtURL:(NSURL *)url resultingItemURL:(NSURL **)outResultingURL error:(NSError **)error

    Параметры

    url

    Элемент для перемещения в мусор.

    outResultingURL

    На вводе, указателе на объект URL. На выводе этот указатель установлен в расположение элемента в мусоре. Подлинное имя элемента может быть изменено при перемещении его в мусор, так используйте этот URL для доступа к нему. Можно указать nil для этого параметра, если Вы не хотите информации.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент в url был успешно перемещен в мусор, или NOfalse если элемент не был перемещен в мусор.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.8 и позже.

    См. также

    – removeItemAtPath:error:
    – removeItemAtURL:error:

Перемещение и копирование элементов
  • copyItemAtURL (_: toURL:error:) - copyItemAtURL:toURL:error:

    Копирует файл в указанном URL к новому расположению синхронно.

    Объявление

    Swift

    func copyItemAtURL(_ srcURL: NSURL, toURL dstURL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)copyItemAtURL:(NSURL *)srcURL toURL:(NSURL *)dstURL error:(NSError **)error

    Параметры

    srcURL

    URL файла, идентифицирующий файл, который Вы хотите скопировать. URL в этом параметре не должен быть ссылкой на файл URL. Этот параметр не должен быть nil.

    dstURL

    URL, в котором можно поместить копию srcURL. URL в этом параметре не должен быть ссылкой на файл URL и должен включать имя файла в его новом расположении. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был скопирован успешно, или делегат файлового менеджера прервал работу сознательно. Возвраты NOfalse если произошла ошибка.

    Обсуждение

    При копировании элементов текущий процесс должен иметь разрешение считать файл или каталог в srcURL и запишите родительский каталог dstURL. Если элемент в srcURL каталог, этот метод копирует каталог и все его содержание, включая любые скрытые файлы. Если файл с тем же именем уже существует в dstURL, этот метод прерывает попытку копии и возвращает надлежащую ошибку. Если последний компонент srcURL символьная ссылка, только ссылка копируется в новый путь.

    До копирования каждого элемента файловый менеджер спрашивает своего делегата, если это должно фактически сделать так. Это делает это путем вызова fileManager:shouldCopyItemAtURL:toURL: метод; если тот метод не реализован (или процесс работает в OS X 10.5 или ранее), это вызывает fileManager:shouldCopyItemAtPath:toPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, доходы файлового менеджера для копирования файла или каталога. Если существует ошибка при копировании элемента, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:copyingItemAtURL:toURL: или fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • copyItemAtPath (_: toPath:error:) - copyItemAtPath:toPath:error:

    Копирует элемент в указанном пути к новому расположению синхронно.

    Объявление

    Swift

    func copyItemAtPath(_ srcPath: String, toPath dstPath: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)copyItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error

    Параметры

    srcPath

    Путь к файлу или каталогу Вы хотите переместиться. Этот параметр не должен быть nil.

    dstPath

    Путь, в котором можно поместить копию srcPath. Этот путь должен включать имя файла или каталога в его новом расположении. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был скопирован успешно, или делегат файлового менеджера прервал работу сознательно. Возвраты NOfalse если произошла ошибка.

    Обсуждение

    При копировании элементов текущий процесс должен иметь разрешение считать файл или каталог в srcPath и запишите родительский каталог dstPath. Если элемент в srcPath каталог, этот метод копирует каталог и все его содержание, включая любые скрытые файлы. Если файл с тем же именем уже существует в dstPath, этот метод прерывает попытку копии и возвращает надлежащую ошибку. Если последний компонент srcPath символьная ссылка, только ссылка копируется в новый путь.

    До копирования элемента файловый менеджер спрашивает своего делегата, если это должно фактически сделать так для каждого элемента. Это делает это путем вызова fileManager:shouldCopyItemAtURL:toURL: метод; если тот метод не реализован, он вызывает fileManager:shouldCopyItemAtPath:toPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, файловый менеджер копирует данный файл или каталог. Если существует ошибка при копировании элемента, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:copyingItemAtURL:toURL: или fileManager:shouldProceedAfterError:copyingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

  • moveItemAtURL (_: toURL:error:) - moveItemAtURL:toURL:error:

    Перемещает файл или каталог в указанный URL к новому расположению синхронно.

    Объявление

    Swift

    func moveItemAtURL(_ srcURL: NSURL, toURL dstURL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)moveItemAtURL:(NSURL *)srcURL toURL:(NSURL *)dstURL error:(NSError **)error

    Параметры

    srcURL

    URL файла, идентифицирующий файл или каталог, который Вы хотите переместить. URL в этом параметре не должен быть ссылкой на файл URL. Этот параметр не должен быть nil.

    dstURL

    Новое расположение для элемента в srcURL. URL в этом параметре не должен быть ссылкой на файл URL и должен включать имя файла или каталога в его новом расположении. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был перемещен успешно, или делегат файлового менеджера прервал работу сознательно. Возвраты NOfalse если произошла ошибка.

    Обсуждение

    Когда движущиеся элементы, текущий процесс должен иметь разрешение считать элемент в srcURL и запишите родительский каталог dstURL. Если элемент в srcURL каталог, этот метод перемещает каталог и все его содержание, включая любые скрытые файлы. Если элемент с тем же именем уже существует в dstURL, этот метод прерывает попытку перемещения и возвращает надлежащую ошибку. Если последний компонент srcURL символьная ссылка, только ссылка перемещена в новый путь; элемент, на который указывает ссылка, остается в ее текущем расположении.

    До перемещения элемента файловый менеджер спрашивает своего делегата, если это должно фактически переместить его. Это делает это путем вызова fileManager:shouldMoveItemAtURL:toURL: метод; если тот метод не реализован, он вызывает fileManager:shouldMoveItemAtPath:toPath: метод вместо этого. Если перемещаемый элемент является каталогом, файловый менеджер уведомляет делегата только к самому каталогу а не к любому его содержанию. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, файловый менеджер перемещает файл. Если существует ошибка при перемещении один из нескольких элементов, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:movingItemAtURL:toURL: или fileManager:shouldProceedAfterError:movingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Если источник и место назначения операции пересылки не находятся на том же объеме, этот метод копирует элемент сначала и затем удаляет его из его текущего расположения. Это поведение может инициировать дополнительные уведомления делегата, связанные с копированием и удалением отдельных элементов.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

    См. также

    – moveItemAtPath:toPath:error:
    – copyItemAtURL:toURL:error:
    – removeItemAtURL:error:

  • moveItemAtPath (_: toPath:error:) - moveItemAtPath:toPath:error:

    Перемещает файл или каталог в указанный путь к новому расположению синхронно.

    Объявление

    Swift

    func moveItemAtPath(_ srcPath: String, toPath dstPath: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)moveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error

    Параметры

    srcPath

    Путь к файлу или каталогу Вы хотите переместиться. Этот параметр не должен быть nil.

    dstPath

    Новый путь для элемента в srcPath. Этот путь должен включать имя файла или каталога в его новом расположении. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если элемент был перемещен успешно, или делегат файлового менеджера прервал работу сознательно. Возвраты NOfalse если произошла ошибка.

    Обсуждение

    Когда движущиеся элементы, текущий процесс должен иметь разрешение считать элемент в srcPath и запишите родительский каталог dstPath. Если элемент в srcPath каталог, этот метод перемещает каталог и все его содержание, включая любые скрытые файлы. Если элемент с тем же именем уже существует в dstPath, этот метод прерывает попытку перемещения и возвращает надлежащую ошибку. Если последний компонент srcPath символьная ссылка, только ссылка перемещена в новый путь; элемент, на который указывает ссылка, остается в ее текущем расположении.

    До перемещения элемента файловый менеджер спрашивает своего делегата, если это должно фактически переместить его. Это делает это путем вызова fileManager:shouldMoveItemAtURL:toURL: метод; если тот метод не реализован, он вызывает fileManager:shouldMoveItemAtPath:toPath: метод вместо этого. Если перемещаемый элемент является каталогом, файловый менеджер уведомляет делегата только к самому каталогу а не к любому его содержанию. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, файловый менеджер перемещает файл. Если существует ошибка при перемещении один из нескольких элементов, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:movingItemAtURL:toURL: или fileManager:shouldProceedAfterError:movingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Если источник и место назначения операции пересылки не находятся на том же объеме, этот метод копирует элемент сначала и затем удаляет его из его текущего расположения. Это поведение может инициировать дополнительные уведомления делегата, связанные с копированием и удалением отдельных элементов.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – moveItemAtURL:toURL:error:
    – copyItemAtPath:toPath:error:
    – removeItemAtPath:error:

Управление основанными на iCloud Элементами
  • ubiquityIdentityToken ubiquityIdentityToken Свойство

    Непрозрачный маркер, представляющий идентификационные данные iCloud текущего пользователя (только для чтения)

    Объявление

    Swift

    @NSCopying var ubiquityIdentityToken: protocol<NSCoding, NSCopying, NSObjectProtocol>? { get }

    Objective C

    @property(readonly, copy) id<NSObject, NSCopying, NSCoding> ubiquityIdentityToken

    Обсуждение

    Когда iCloud в настоящее время доступен, это свойство содержит непрозрачный объект, представляющий идентификационные данные текущего пользователя. Если iCloud недоступен по какой-либо причине или существует, не вошел в систему пользователь, значение этого свойства nil. Доступ к значению этого свойства относительно быстр, таким образом, можно проверить значение во время запуска от основного потока приложения.

    Можно использовать маркер в этом свойстве, вместе с NSUbiquityIdentityDidChangeNotification уведомление, для обнаружения, когда пользователь входит в систему или из iCloud и обнаружить изменения в активной учетной записи iCloud. Когда пользователь входит в систему с различной учетной записью iCloud, маркерные изменения идентификационных данных и система отправляет уведомление. Если Вы сохранили или заархивировали предыдущий маркер, сравните тот маркер с недавно полученным с помощью isEqual: метод, чтобы определить, являются ли пользователи тем же или отличающийся.

    Доступ к маркеру в этом свойстве не подключает Ваше приложение к своим контейнерам повсеместности. Для установления доступа к контейнеру повсеместности вызовите URLForUbiquityContainerIdentifier: метод. В OS X можно вместо этого использовать NSDocument объект, устанавливающий доступ автоматически.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.8 и позже.

    См. также

    – URLForUbiquityContainerIdentifier:

  • URLForUbiquityContainerIdentifier (_:) - URLForUbiquityContainerIdentifier:

    Возвращает URL для контейнера iCloud, связанного с указанным идентификатором, и устанавливает доступ к тому контейнеру.

    Объявление

    Swift

    func URLForUbiquityContainerIdentifier(_ containerID: String?) -> NSURL?

    Objective C

    - (NSURL *)URLForUbiquityContainerIdentifier:(NSString *)containerID

    Параметры

    containerID

    Полностью определенный контейнерный идентификатор для каталога контейнера iCloud. Строка, которую Вы указываете, не должна содержать подстановочные знаки и должна иметь форму <TEAMID>.<CONTAINER>, где <TEAMID> Ваша группа разработчиков ID и <CONTAINER>, является идентификатором пакета контейнера, к которому Вы хотите получить доступ.

    Контейнерные идентификаторы для Вашего приложения должны быть объявлены в com.apple.developer.ubiquity-container-identifiers массив .entitlements файл списка свойств в Вашем проекте XCode.

    Если Вы указываете nil для этого параметра этот метод возвращает первый контейнер, перечисленный в com.apple.developer.ubiquity-container-identifiers дающий право массив.

    Возвращаемое значение

    URL, указывающий на указанный контейнер повсеместности, или nil если хранение iCloud недоступно текущему пользователю или устройству, если контейнер не мог бы быть расположен или.

    Обсуждение

    Вы используете этот метод, чтобы определить расположение каталогов контейнера повсеместности Вашего приложения и сконфигурировать начальный доступ iCloud Вашего приложения. В первый раз, когда Вы вызываете этот метод для данного контейнера повсеместности, система расширяет песочницу Вашего приложения для включения того контейнера. В iOS необходимо вызвать этот метод, по крайней мере, однажды пытающийся искать основанные на облачных вычислениях файлы в контейнере повсеместности. Если Ваши доступы приложения многократные контейнеры повсеместности, вызовите этот метод один раз для каждого контейнера. Если Вы используете, в OS X Вы не должны вызывать этот метод NSDocument- основанные объекты, потому что система тогда вызывает этот метод автоматически.

    Можно использовать URL, возвращенный этим методом для создания путей к файлам и каталогам в контейнере повсеместности приложения. Каждое приложение, синхронизирующее документы облаку, должно иметь по крайней мере один связанный контейнер повсеместности, в который можно поместить те файлы. Этот контейнер может быть уникален для приложения или совместно использованный многократными приложениями.

    В дополнение к записи в его собственный контейнер повсеместности приложение может записать в любой контейнерный каталог, для которого это имеет надлежащее разрешение. Каждый дополнительный контейнер повсеместности должен быть перечислен как дополнительная стоимость в com.apple.developer.ubiquity-container-identifiers дающий право массив.

    Чтобы изучить, как просмотреть Вашу группу разработчиков, уникальную <TEAM_ID> значение, считайте представление To команда ID в Руководстве по Потоку операций Инструментов для Mac.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    ubiquityIdentityToken
    – URLForPublishingUbiquitousItemAtURL:expirationDate:error:

  • isUbiquitousItemAtURL (_:) - isUbiquitousItemAtURL:

    Возвращает булевскую переменную, указывающую, предназначен ли элемент для хранения в iCloud.

    Объявление

    Swift

    func isUbiquitousItemAtURL(_ url: NSURL) -> Bool

    Objective C

    - (BOOL)isUbiquitousItemAtURL:(NSURL *)url

    Параметры

    url

    Укажите URL для файла или каталога, состояние которого Вы хотите проверить.

    Возвращаемое значение

    YEStrue если элемент предназначен для хранения iCloud или NOfalse если это не. Этот метод также возвращается NOfalse если никакой элемент не существует в url.

    Обсуждение

    Этот метод отражается только, должен ли элемент быть сохранен в iCloud, потому что вызов был выполнен к setUbiquitous:itemAtURL:destinationURL:error: метод со значением YEStrue для flag параметр. Этот метод не отражается, был ли файл фактически загружен на какие-либо серверы iCloud. Для определения состояния загрузки файла проверьте NSURLUbiquitousItemIsUploadedKey атрибут соответствия NSURL объект.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – setUbiquitous:itemAtURL:destinationURL:error:

  • setUbiquitous (_: itemAtURL:destinationURL:error:) - setUbiquitous:itemAtURL:destinationURL:error:

    Наборы, должен ли элемент в указанном URL быть сохранен в облаке.

    Объявление

    Swift

    func setUbiquitous(_ flag: Bool, itemAtURL url: NSURL, destinationURL destinationURL: NSURL, error errorOut: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)setUbiquitous:(BOOL)flag itemAtURL:(NSURL *)url destinationURL:(NSURL *)destinationURL error:(NSError **)errorOut

    Параметры

    flag

    Указать YEStrue перемещать элемент в iCloud или NOfalse удалить его из iCloud (если это там в настоящее время).

    url

    Укажите URL элемента (файл или каталог), который Вы хотите сохранить в iCloud.

    destinationURL

    Перемещение файла в iCloud Указывает расположение в iCloud, в котором можно сохранить файл или каталог. Этот URL должен быть создан из URL, возвращенного URLForUbiquityContainerIdentifier: метод, который Вы используете для получения желаемого каталога контейнера iCloud. URL, который Вы указываете, может содержать дополнительные подкаталоги так, чтобы можно было организовать файлы иерархически в iCloud. Однако Вы ответственны за создание тех промежуточных подкаталогов (использующий NSFileManager класс) в Вашем каталоге контейнера iCloud.

    Перемещение файла из iCloud Указывает расположение на локальном устройстве.

    errorOut

    На вводе, указателе на переменную для NSError объект. Если ошибка происходит, этот указатель установлен в NSError объект, содержащий информацию об ошибке. Можно указать nil проигнорировать информацию об ошибке.

    Возвращаемое значение

    YEStrue если состояние элемента было обновлено успешно или NOfalse если произошла ошибка. Если возвращается этот метод NOfalse и Вы указали значение для errorOut параметр, этот метод возвращает ошибочный объект в предоставленном указателе.

    Обсуждение

    Используйте этот метод для перемещения файла от его текущего расположения до iCloud. Для файлов, расположенных в песочнице приложения, это включает физически удаление файла от контейнера песочницы. (Система расширяет полномочия песочницы Вашего приложения предоставить ему доступ к файлам, которые это перемещает в iCloud.) Можно также использовать этот метод для перемещения файлов из iCloud и назад в локальный каталог.

    Если Ваше приложение представляет содержание файла пользователю, оно должно иметь активный объект предъявителя файла, сконфигурированный для контроля указанного файла или каталога прежде, чем вызвать этот метод. Когда Вы указываете YEStrue для flag параметр, этот метод пытается переместить файл или каталог в облако и возвраты YEStrue если это успешно. Вызов этого метода также уведомляет Вашего предъявителя файла нового расположения файла так, чтобы Ваше приложение могло продолжать воздействовать на него.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – startDownloadingUbiquitousItemAtURL:error:
    – isUbiquitousItemAtURL:

  • startDownloadingUbiquitousItemAtURL (_: ошибка:) - startDownloadingUbiquitousItemAtURL:error:

    Начинает загружать (если необходимый) указанный элемент к локальной системе.

    Объявление

    Swift

    func startDownloadingUbiquitousItemAtURL(_ url: NSURL, error errorOut: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)startDownloadingUbiquitousItemAtURL:(NSURL *)url error:(NSError **)errorOut

    Параметры

    url

    Укажите URL для файла или каталога в облаке, которое Вы хотите загрузить.

    errorOut

    На вводе, указателе на переменную для NSError объект. Если ошибка происходит, этот указатель установлен в NSError объект, содержащий информацию об ошибке. Можно указать nil проигнорировать информацию об ошибке.

    Возвращаемое значение

    YEStrue если загрузка запустилась успешно или не была необходима, иначе NOfalse. Если NOfalse возвращается и errorOut не nil, NSError объект, описывающий ошибку, возвращается в том параметре.

    Обсуждение

    Если основанный на облачных вычислениях файл или каталог еще не был загружен, вызывание этого метода запускает процесс загрузки. Если элемент существует локально, вызывание этого метода синхронизирует локальную копию с версией в облаке.

    Для данного URL можно определить, загружается ли файл путем получения значения NSMetadataUbiquitousItemIsDownloadedKey ключ. Можно также использовать связанные ключи для определения текущего прогресса загрузки файла.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – setUbiquitous:itemAtURL:destinationURL:error:

  • evictUbiquitousItemAtURL (_: ошибка:) - evictUbiquitousItemAtURL:error:

    Удаляет локальную копию указанного основанного на облачных вычислениях элемента.

    Объявление

    Swift

    func evictUbiquitousItemAtURL(_ url: NSURL, error errorOut: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)evictUbiquitousItemAtURL:(NSURL *)url error:(NSError **)errorOut

    Параметры

    url

    Укажите URL к файлу или каталогу в хранении iCloud.

    errorOut

    На вводе, указателе на переменную для NSError объект. Если ошибка происходит, этот указатель установлен в NSError объект, содержащий информацию об ошибке. Можно указать nil проигнорировать информацию об ошибке.

    Возвращаемое значение

    YEStrue если локальный элемент был удален успешно или НЕ если это не было. Если NOfalse возвращается и errorOut не nil, NSError объект, описывающий ошибку, возвращается в том параметре.

    Обсуждение

    Не используйте скоординированную запись для выполнения этой работы. На OS X v10.7 или ранее, платформа берет скоординированную запись в своей реализации этого метода, таким образом брать один в Вашем приложении вызывает мертвую блокировку. На OS X v10.8 и позже, платформа обнаруживает координацию, сделанную Вашим приложением на том же потоке как вызов к этому методу, чтобы избежать заходить в тупик.

    Этот метод не удаляет элемент из облака. Это удаляет только локальную версию. Можно использовать этот метод, чтобы вынудить iCloud загрузить новую версию файла или каталога от сервера.

    Для удаления файла постоянно из хранения iCloud пользователя используйте постоянного клиента NSFileManager подпрограммы для удаления файлов и каталогов. Помните, что не может быть отменено удаление элементов от iCloud. После того, как удаленный, элемента не стало навсегда.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – setUbiquitous:itemAtURL:destinationURL:error:
    – removeItemAtURL:error:

  • URLForPublishingUbiquitousItemAtURL (_: expirationDate:error:) - URLForPublishingUbiquitousItemAtURL:expirationDate:error:

    Возвращает URL, который может быть послан по электронной почте пользователям, чтобы позволить им загружать копию основанного на облачных вычислениях элемента.

    Объявление

    Swift

    func URLForPublishingUbiquitousItemAtURL(_ url: NSURL, expirationDate outDate: AutoreleasingUnsafeMutablePointer<NSDate?>, error error: NSErrorPointer) -> NSURL?

    Objective C

    - (NSURL *)URLForPublishingUbiquitousItemAtURL:(NSURL *)url expirationDate:(NSDate **)outDate error:(NSError **)error

    Параметры

    url

    Укажите URL элемента в облаке, которое Вы хотите совместно использовать. URL должен быть снабжен префиксом базовый URL, возвращенный из URLForUbiquityContainerIdentifier: метод, соответствующий расположению элемента. Файл в указанном URL должен уже быть загружен на iCloud при вызове этого метода.

    outDate

    На вводе, указателе на переменную для объекта даты. На выводе этот параметр содержит дату, после которой элемент больше не доступен в возвращенном URL. Можно указать nil для этого параметра, если Вы не интересуетесь датой.

    error

    На вводе, указателе на переменную для NSError объект. Если ошибка происходит, этот указатель установлен в NSError объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    URL, которым пользователи могут загрузить копию элемента в url. Возвраты nil если URL не мог бы быть создан ни по какой причине.

    Обсуждение

    Этот метод создает снимок указанного файла и мест, копирующих во временном расположении iCloud, где к этому могут получить доступ другие пользователи, использующие возвращенный URL. Снимок отражает содержание файла в то время, когда URL был сгенерирован и не обновляется, когда последующие изменения внесены в исходный файл в хранении iCloud пользователя. Файл моментального снимка остается доступным в указанном URL, пока дата не указала в outDate параметр, после которого это автоматически удалено. Явно удаляя элемент путем вызова removeItemAtURL:error: или removeItemAtPath:error: метод также удаляет все старые версии элемента, лишая законной силы URLs к тем версиям, возвращенным этим методом.

    Ваше приложение должно иметь доступ к сети для этого вызова для следования. Если указанный файл находится в процессе того, чтобы быть загруженным на iCloud, Вы не должны вызывать этот метод, пока не закончилась загрузка.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – URLForUbiquityContainerIdentifier:

Создание символьных и жестких ссылок
  • createSymbolicLinkAtURL (_: withDestinationURL:error:) - createSymbolicLinkAtURL:withDestinationURL:error:

    Создает символьную ссылку в указанном URL, указывающем на элемент в данном URL.

    Объявление

    Swift

    func createSymbolicLinkAtURL(_ url: NSURL, withDestinationURL destURL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)createSymbolicLinkAtURL:(NSURL *)url withDestinationURL:(NSURL *)destURL error:(NSError **)error

    Параметры

    url

    URL файла, в котором можно создать новую символьную ссылку. Последний компонент контура URL вышел как имя ссылки.

    destURL

    URL файла, содержащий элемент, на который укажет ссылка. Другими словами, это - место назначения ссылки.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если символьная ссылка создавалась или NOfalse если произошла ошибка. Этот метод также возвращается NOfalse если файл, каталог или ссылка уже существуют в url.

    Обсуждение

    Этот метод не пересекает символьные ссылки, содержавшие в destURL, позволение создать символьные ссылки на еще не существующие расположения. Кроме того, если заключительный компонент контура в url символьная ссылка, по той ссылке не идут.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – createSymbolicLinkAtPath:withDestinationPath:error:

  • createSymbolicLinkAtPath (_: withDestinationPath:error:) - createSymbolicLinkAtPath:withDestinationPath:error:

    Создает символьную ссылку, указывающую указанному месту назначения.

    Объявление

    Swift

    func createSymbolicLinkAtPath(_ path: String, withDestinationPath destPath: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)createSymbolicLinkAtPath:(NSString *)path withDestinationPath:(NSString *)destPath error:(NSError **)error

    Параметры

    path

    Путь, в котором можно создать новую символьную ссылку. Последний компонент контура используется в качестве имени ссылки.

    destPath

    Путь, содержащий элемент, на который укажет ссылка. Другими словами, это - место назначения ссылки.

    error

    Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему. Передача NULL если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если символьная ссылка создавалась или NOfalse если произошла ошибка. Этот метод также возвращается NOfalse если файл, каталог или ссылка уже существуют в path.

    Обсуждение

    Этот метод не пересекает символьные ссылки, содержавшие в destPath, позволение создать символьные ссылки на еще не существующие расположения. Кроме того, если заключительный компонент контура в path символьная ссылка, по той ссылке не идут.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – destinationOfSymbolicLinkAtPath:error:
    – removeItemAtPath:error:

  • linkItemAtURL (_: toURL:error:) - linkItemAtURL:toURL:error:

    Создает жесткую ссылку между элементами в указанном URLs.

    Объявление

    Swift

    func linkItemAtURL(_ srcURL: NSURL, toURL dstURL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)linkItemAtURL:(NSURL *)srcURL toURL:(NSURL *)dstURL error:(NSError **)error

    Параметры

    srcURL

    URL файла, идентифицирующий источник ссылки. URL в этом параметре не должен быть ссылкой на файл URL; это должно указать фактический путь к элементу. Значение в этом параметре не должно быть nil.

    dstURL

    URL файла, указывающий, где Вы хотите создать жесткую ссылку. URL в этом параметре не должен быть ссылкой на файл URL; это должно указать фактический путь к элементу. Значение в этом параметре не должно быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если жесткая ссылка создавалась или NOfalse если произошла ошибка. Этот метод также возвращается NOfalse если файл, каталог или ссылка уже существуют в dstURL.

    Обсуждение

    Используйте этот метод для создания жестких ссылок между файлами в текущей файловой системе. Если srcURL каталог, этот метод создает новый каталог в dstURL и затем создает жесткие ссылки для элементов в том каталоге. Если srcURL (или содержит), символьная ссылка, символьная ссылка копируется и не преобразовывается в жесткую ссылку в dstURL.

    До соединения каждого элемента файловый менеджер спрашивает своего делегата, если это должно фактически создать ссылку. Это делает это путем вызова fileManager:shouldLinkItemAtURL:toURL: метод; если тот метод не реализован, он вызывает fileManager:shouldLinkItemAtPath:toPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, файловый менеджер создает жесткую ссылку. Если существует ошибка при перемещении один из нескольких элементов, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:linkingItemAtURL:toURL: или fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • linkItemAtPath (_: toPath:error:) - linkItemAtPath:toPath:error:

    Создает жесткую ссылку между элементами в указанных путях.

    Объявление

    Swift

    func linkItemAtPath(_ srcPath: String, toPath dstPath: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)linkItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error

    Параметры

    srcPath

    Путь, указывающий элемент, с которым Вы хотите соединиться. Значение в этом параметре не должно быть nil.

    dstPath

    Путь, идентифицирующий расположение, где будет создаваться ссылка. Значение в этом параметре не должно быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если жесткая ссылка создавалась или NOfalse если произошла ошибка. Этот метод также возвращается NOfalse если файл, каталог или ссылка уже существуют в dstPath.

    Обсуждение

    Используйте этот метод для создания жестких ссылок между файлами в текущей файловой системе. Если srcPath каталог, этот метод создает новый каталог в dstPath и затем создает жесткие ссылки для элементов в том каталоге. Если srcPath (или содержит), символьная ссылка, символьная ссылка копируется в новое расположение и не преобразовывается в жесткую ссылку.

    До соединения каждого элемента файловый менеджер спрашивает своего делегата, если это должно фактически создать ссылку. Это делает это путем вызова fileManager:shouldLinkItemAtURL:toURL: метод; если тот метод не реализован, он вызывает fileManager:shouldLinkItemAtPath:toPath: метод вместо этого. Если возвращается метод делегата YEStrue, или если делегат не реализует надлежащие методы, файловый менеджер создает жесткую ссылку. Если существует ошибка при перемещении один из нескольких элементов, файловый менеджер может также вызвать делегата fileManager:shouldProceedAfterError:linkingItemAtURL:toURL: или fileManager:shouldProceedAfterError:linkingItemAtPath:toPath: метод, чтобы определить, как продолжить.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

  • destinationOfSymbolicLinkAtPath (_: ошибка:) - destinationOfSymbolicLinkAtPath:error:

    Возвращает путь элемента, на который указывает символьная ссылка.

    Объявление

    Swift

    func destinationOfSymbolicLinkAtPath(_ path: String, error error: NSErrorPointer) -> String?

    Objective C

    - (NSString *)destinationOfSymbolicLinkAtPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Путь файла или каталога.

    error

    Если ошибка происходит, по возврату содержит NSError объект, описывающий проблему. Передача NULL если Вы не хотите информации об ошибке.

    Возвращаемое значение

    NSString объект тот, содержащий путь каталога или файла, к который символьная ссылка path относится, или nil на отказ. Если символьная ссылка указана как относительный путь, тот относительный путь возвращается.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – createSymbolicLinkAtPath:withDestinationPath:error:

Определение доступа к файлам
  • fileExistsAtPath (_:) - fileExistsAtPath:

    Возвращает булево значение, указывающее, существует ли файл или каталог в указанном пути.

    Объявление

    Swift

    func fileExistsAtPath(_ path: String) -> Bool

    Objective C

    - (BOOL)fileExistsAtPath:(NSString *)path

    Параметры

    path

    Путь файла или каталога. Если path начинается с тильды (~), это должно сначала быть расширено с stringByExpandingTildeInPath; иначе, этот метод возвраты NOfalse.

    Возвращаемое значение

    YEStrue если файл в указанном пути существует, или NOfalse если файл не существует, или его существование не могло бы быть определено.

    Обсуждение

    Если файл в path недоступно Вашему приложению, возможно потому что один или несколько родительских каталогов недоступны, этот метод возвраты NOfalse. Если заключительный элемент в path указывает символьную ссылку, этот метод пересекает ссылку и возвраты YEStrue или NOfalse на основе существования файла в месте назначения ссылки.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – fileExistsAtPath:isDirectory:
    – checkResourceIsReachableAndReturnError:

  • fileExistsAtPath (_: isDirectory:) - fileExistsAtPath:isDirectory:

    Возвращает булево значение, указывающее, существует ли файл или каталог в указанном пути. isDirectory параметр указывает ли точки контура к каталогу или регулярному файлу.

    Объявление

    Swift

    func fileExistsAtPath(_ path: String, isDirectory isDirectory: UnsafeMutablePointer<ObjCBool>) -> Bool

    Objective C

    - (BOOL)fileExistsAtPath:(NSString *)path isDirectory:(BOOL *)isDirectory

    Параметры

    path

    Путь файла или каталога. Если path начинается с тильды (~), это должно сначала быть расширено с stringByExpandingTildeInPath, или этот метод возвратится NOfalse.

    isDirectory

    По возврату, содержит YEStrue если path каталог или если заключительный элемент пути является символьной ссылкой, указывающей на каталог; иначе, содержит NOfalse. Если path не существует, это значение не определено по возврату. Передача NULL если Вам не нужна эта информация.

    Возвращаемое значение

    YEStrue если файл в указанном пути существует, или NOfalse если файл не существует, или его существование не могло бы быть определено.

    Обсуждение

    Если файл в path недоступно Вашему приложению, возможно потому что один или несколько родительских каталогов недоступны, этот метод возвраты NOfalse. Если заключительный элемент в path указывает символьную ссылку, этот метод пересекает ссылку и возвраты YEStrue или NOfalse на основе существования файла в месте назначения ссылки.

    Если необходимо далее определить ли path пакет, используйте isFilePackageAtPath: метод NSWorkspace.

    Этот пример получает массив, идентифицирующий шрифты в каталоге шрифтов пользователя:

    • 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];
    • // ...

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – fileExistsAtPath:
    – checkResourceIsReachableAndReturnError:

  • isReadableFileAtPath (_:) - isReadableFileAtPath:

    Возвращает булево значение, указывающее, кажется ли объект вызова способным считать указанный файл.

    Объявление

    Swift

    func isReadableFileAtPath(_ path: String) -> Bool

    Objective C

    - (BOOL)isReadableFileAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу.

    Возвращаемое значение

    YEStrue если текущий процесс считал полномочия для файла в path; иначе NOfalse если процесс не имеет полномочий чтения, или существование файла не могло бы быть определено.

    Обсуждение

    Если файл в path недоступно Вашему приложению, возможно потому что оно не имеет поисковых полномочий для одного или более родительских каталогов, этот метод возвраты NOfalse. Этот метод пересекает символьные ссылки по пути. Этот метод также использует реального пользователя ID и группа ID, в противоположность эффективному пользователю и группе IDs, чтобы определить, читаем ли файл.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • isWritableFileAtPath (_:) - isWritableFileAtPath:

    Возвращает булево значение, указывающее, кажется ли объект вызова способным записать в указанный файл.

    Объявление

    Swift

    func isWritableFileAtPath(_ path: String) -> Bool

    Objective C

    - (BOOL)isWritableFileAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу.

    Возвращаемое значение

    YEStrue если текущий процесс имеет полномочия записи для файла в path; иначе NOfalse если процесс не имеет полномочий записи, или существование файла не могло бы быть определено.

    Обсуждение

    Если файл в path недоступно Вашему приложению, возможно потому что оно не имеет поисковых полномочий для одного или более родительских каталогов, этот метод возвраты NOfalse. Этот метод пересекает символьные ссылки по пути. Этот метод также использует реального пользователя ID и группа ID, в противоположность эффективному пользователю и группе IDs, чтобы определить, перезаписываем ли файл.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • isExecutableFileAtPath (_:) - isExecutableFileAtPath:

    Возвращает булево значение, указывающее, кажется ли операционная система способной выполнить указанный файл.

    Объявление

    Swift

    func isExecutableFileAtPath(_ path: String) -> Bool

    Objective C

    - (BOOL)isExecutableFileAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу.

    Возвращаемое значение

    YEStrue если текущий процесс имеет, выполняют полномочия для файла в path; иначе NOfalse если процесс не имеет, выполняют полномочия, или существование файла не могло бы быть определено.

    Обсуждение

    Если файл в path недоступно Вашему приложению, возможно потому что оно не имеет поисковых полномочий для одного или более родительских каталогов, этот метод возвраты NOfalse. Этот метод пересекает символьные ссылки по пути. Этот метод также использует реального пользователя ID и группа ID, в противоположность эффективному пользователю и группе IDs, чтобы определить, является ли файл исполнимой программой.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

  • isDeletableFileAtPath (_:) - isDeletableFileAtPath:

    Возвращает булево значение, указывающее, кажется ли объект вызова способным удалить указанный файл.

    Объявление

    Swift

    func isDeletableFileAtPath(_ path: String) -> Bool

    Objective C

    - (BOOL)isDeletableFileAtPath:(NSString *)path

    Параметры

    path

    Путь к файлу.

    Возвращаемое значение

    YEStrue если текущий процесс имеет, удаляют полномочия для файла в path; иначе NOfalse если процесс не имеет, удаляют полномочия, или существование файла не могло бы быть определено.

    Обсуждение

    Для каталога или файла, чтобы быть удаляемым, текущий процесс должен или быть в состоянии записать в родительский каталог path или это должно иметь того же владельца как элемент в path. Если path каталог, каждый элемент, содержавшийся в path должно быть удаляемым текущим процессом.

    Если файл в path недоступно Вашему приложению, возможно потому что оно не имеет поисковых полномочий для одного или более родительских каталогов, этот метод возвраты NOfalse. Если элемент в path символьная ссылка, она не пересечена.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

Получение и установка атрибутов
  • componentsToDisplayForPath (_:) - componentsToDisplayForPath:

    Возвращает массив строк, представляющих видимые пользователем компоненты данного пути.

    Объявление

    Swift

    func componentsToDisplayForPath(_ path: String) -> [AnyObject]?

    Objective C

    - (NSArray *)componentsToDisplayForPath:(NSString *)path

    Параметры

    path

    Путь.

    Возвращаемое значение

    Массив NSString объекты, представляющие видимое пользователем (для Средства поиска, панелей Open и Save, и т.д.) компоненты path. Возвраты nil если не существует путь.

    Обсуждение

    Эти компоненты не могут использоваться для операций пути и только подходят для дисплея для пользователя.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.2 и позже.

  • displayNameAtPath (_:) - displayNameAtPath:

    Возвращает имя дисплея файла или каталога в указанном пути.

    Объявление

    Swift

    func displayNameAtPath(_ path: String) -> String

    Objective C

    - (NSString *)displayNameAtPath:(NSString *)path

    Параметры

    path

    Путь файла или каталога.

    Возвращаемое значение

    Имя файла или каталога в path в локализованной форме, подходящей для представления пользователю. Если нет никакого файла или каталога в path, или если ошибка происходит, возвраты path как.

    Обсуждение

    Имена дисплея являются удобными для пользователя именами для файлов. Они обычно используются для локализации стандартного файла и имен каталогов согласно настройкам языка пользователя. Они могут также отразить другие модификации, такие как удаление расширений файла. Такие модификации используются только при отображении файла или каталога пользователю и не отражают фактический путь к элементу в файловой системе. Например, если предпочтительный язык текущего пользователя является французским, следующий фрагмент кода регистрирует имя Bibliothèque а не имя Library, который является подлинным именем каталога.

    • NSArray *paths = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES);
    • if ([paths count] > 0)
    • {
    • NSString *documentsDirectory = [paths objectAtIndex:0];
    • NSFileManager *fileManager = [[NSFileManager alloc] init];
    • NSString *displayNameAtPath = [fileManager displayNameAtPath:documentsDirectory];
    • NSLog(@"%@", displayNameAtPath);
    • }

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.1 и позже.

  • attributesOfItemAtPath (_: ошибка:) - attributesOfItemAtPath:error:

    Возвращает атрибуты элемента в данном пути.

    Объявление

    Swift

    func attributesOfItemAtPath(_ path: String, error error: NSErrorPointer) -> [NSObject : AnyObject]?

    Objective C

    - (NSDictionary *)attributesOfItemAtPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Путь файла или каталога.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    NSDictionary объект, описывающий атрибуты (файл, каталог, символьная ссылка, и т.д.) файла, указанного path, или nil если произошла ошибка. Ключи в словаре описаны в “File Attribute Keys”.

    Специальные замечания

    Если элемент в пути является символьной ссылкой — т.е. значение NSFileType введите словарь атрибутов, NSFileTypeSymbolicLink— можно использовать destinationOfSymbolicLinkAtPath:error: метод для получения пути элемента, на который указывает ссылка. Можно также использовать stringByResolvingSymlinksInPath метод NSString разрешить ссылки по пути прежде, чем получить атрибуты элемента.

    Как удобство, NSDictionary обеспечивает ряд методов (объявленный как категория на NSDictionary) для быстро и эффективно получение информации атрибута из возвращенного словаря: fileGroupOwnerAccountName, fileModificationDate, fileOwnerAccountName, filePosixPermissions, fileSize, fileSystemFileNumber, fileSystemNumber, и fileType.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – setAttributes:ofItemAtPath:error:

  • attributesOfFileSystemForPath (_: ошибка:) - attributesOfFileSystemForPath:error:

    Возвращает словарь, описывающий атрибуты смонтированной файловой системы, в которой находится данный путь.

    Объявление

    Swift

    func attributesOfFileSystemForPath(_ path: String, error error: NSErrorPointer) -> [NSObject : AnyObject]?

    Objective C

    - (NSDictionary *)attributesOfFileSystemForPath:(NSString *)path error:(NSError **)error

    Параметры

    path

    Любой путь в смонтированной файловой системе.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    NSDictionary объект, описывающий атрибуты смонтированной файловой системы на который path находится. Посмотрите Ключи Атрибута Файловой системы для описания ключей, доступных в словаре.

    Обсуждение

    Этот метод не пересекает терминальную символьную ссылку.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – attributesOfItemAtPath:error:
    – setAttributes:ofItemAtPath:error:

  • setAttributes (_: ofItemAtPath:error:) - setAttributes:ofItemAtPath:error:

    Устанавливает атрибуты указанного файла или каталога.

    Объявление

    Swift

    func setAttributes(_ attributes: [NSObject : AnyObject], ofItemAtPath path: String, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)setAttributes:(NSDictionary *)attributes ofItemAtPath:(NSString *)path error:(NSError **)error

    Параметры

    attributes

    Словарь, содержащий, как включает атрибуты для установки для path и как значения соответствующее значение для атрибута. Можно установить следующие атрибуты: NSFileBusy, NSFileCreationDate, NSFileExtensionHidden, NSFileGroupOwnerAccountID, NSFileGroupOwnerAccountName, NSFileHFSCreatorCode, NSFileHFSTypeCode, NSFileImmutable, NSFileModificationDate, NSFileOwnerAccountID, NSFileOwnerAccountName, NSFilePosixPermissions. Можно изменить единственные атрибуты или любую комбинацию атрибутов; Вы не должны указывать ключи для всех атрибутов.

    path

    Путь файла или каталога.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если успешно выполняются все изменения. Если какое-либо изменение перестало работать, возвраты NOfalse, но это не определено, произошли ли фактически какие-либо изменения.

    Обсуждение

    Как в стандарте POSIX, приложение или должно владеть файлом или каталогом или должно работать, когда суперпользователь для атрибута изменяется для вступления в силу. Метод пытается делать все изменения указанными в атрибутах и игнорирует любое отклонение опробованной модификации. Если последний компонент пути является символьной ссылкой, это пересечено.

    NSFilePosixPermissions значение должно быть инициализировано с кодом, представляющим образец бита полномочий файла POSIX. NSFileHFSCreatorCode и NSFileHFSTypeCode будет только учтен когда path указывает файл.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

    См. также

    – attributesOfItemAtPath:error:

Получение и сравнение содержания файла
  • contentsAtPath (_:) - contentsAtPath:

    Возвращает содержание файла в указанном пути.

    Объявление

    Swift

    func contentsAtPath(_ path: String) -> NSData?

    Objective C

    - (NSData *)contentsAtPath:(NSString *)path

    Параметры

    path

    Путь файла, содержание которого Вы хотите.

    Возвращаемое значение

    NSData объект с содержанием файла. Если path если некоторая другая ошибка происходит, этот метод возвраты, указывает каталог, или nil.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – contentsEqualAtPath:andPath:
    – createFileAtPath:contents:attributes:

  • contentsEqualAtPath (_: andPath:) - contentsEqualAtPath:andPath:

    Возвращает булево значение, указывающее, имеют ли файлы или каталоги по указанным путям то же содержание.

    Объявление

    Swift

    func contentsEqualAtPath(_ path1: String, andPath path2: String) -> Bool

    Objective C

    - (BOOL)contentsEqualAtPath:(NSString *)path1 andPath:(NSString *)path2

    Параметры

    path1

    Путь файла или каталога для сравнения содержанию path2.

    path2

    Путь файла или каталога для сравнения содержанию path1.

    Возвращаемое значение

    YEStrue если файл или каталог, указанный в path1 имеет то же содержание как указанный в path2, иначе NOfalse.

    Обсуждение

    Если path1 и path2 каталоги, содержание является списком файлов и подкаталогов, которые каждый содержит — содержание подкаталогов также сравнено. Для файлов этот метод проверяет, чтобы видеть, являются ли они тем же файлом, затем сравнивает их размер, и наконец сравнивает их содержание. Этот метод не пересекает символьные ссылки, но сравнивает сами ссылки.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – contentsAtPath:

Получение отношения между элементами
  • getRelationship (_: ofDirectoryAtURL:toItemAtURL:error:) - getRelationship:ofDirectoryAtURL:toItemAtURL:error:

    Определяет тип отношения, существующего между каталогом и элементом.

    Объявление

    Swift

    func getRelationship(_ outRelationship: UnsafeMutablePointer<NSURLRelationship>, ofDirectoryAtURL directoryURL: NSURL, toItemAtURL otherURL: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)getRelationship:(NSURLRelationship *)outRelationship ofDirectoryAtURL:(NSURL *)directoryURL toItemAtURL:(NSURL *)otherURL error:(NSError **)error

    Параметры

    outRelationship

    Указатель на переменную, в которую можно поместить отношение между directoryURL и otherURL. Для списка возможных значений посмотрите NSURLRelationship.

    directoryURL

    URL каталога, потенциально содержащего элемент в otherURL. URL в этом параметре должен указать каталог. Этот параметр не должен быть nil.

    otherURL

    URL файла или каталога, чье отношение к directoryURL тестируется. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если отношение между элементами было успешно определено, или NOfalse если произошла ошибка.

    Обсуждение

    Используйте этот метод для определения отношения между элементом и каталогом, расположение которого Вы уже знаете. Если отношение между элементами определяется успешно, этот метод устанавливает значение outRelationship параметр к надлежащему значению и возвратам YEStrue. Каталог может содержать элемент, он может совпасть с элементом, или он может не иметь непосредственной связи к элементу.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.10 и позже.

  • getRelationship (_: ofDirectory:inDomain:toItemAtURL:error:) - getRelationship:ofDirectory:inDomain:toItemAtURL:error:

    Определяет тип отношения, существующего между системным каталогом и указанным элементом.

    Объявление

    Swift

    func getRelationship(_ outRelationship: UnsafeMutablePointer<NSURLRelationship>, ofDirectory directory: NSSearchPathDirectory, inDomain domainMask: NSSearchPathDomainMask, toItemAtURL url: NSURL, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)getRelationship:(NSURLRelationship *)outRelationship ofDirectory:(NSSearchPathDirectory)directory inDomain:(NSSearchPathDomainMask)domainMask toItemAtURL:(NSURL *)url error:(NSError **)error

    Параметры

    outRelationship

    Указатель на переменную, в которую можно поместить отношение между directoryURL и otherURL. Для списка возможных значений посмотрите NSURLRelationship.

    directory

    Каталог пути поиска. Для списка возможных значений посмотрите NSSearchPathDirectory.

    domainMask

    Домен файловой системы для поиска. Указать 0 для этого параметра, если Вы хотите, чтобы файловый менеджер выбрал домен, который является самым подходящим для указанного url.

    url

    URL файла или каталога, чье отношение к directoryURL тестируется. Этот параметр не должен быть nil.

    error

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот указатель установлен в фактический ошибочный объект, содержащий информацию об ошибке. Можно указать nil для этого параметра, если Вы не хотите информации об ошибке.

    Возвращаемое значение

    YEStrue если отношение между элементами было успешно определено, или NOfalse если произошла ошибка.

    Обсуждение

    Используйте этот метод для определения отношения между элементом и одним из специфичных для системы каталогов. Например, Вы могли бы использовать этот метод, чтобы определить, находится ли указанный элемент в пользователе Documents каталог или находится в мусоре. Если отношение между элементами определяется успешно, этот метод устанавливает значение outRelationship параметр к надлежащему значению и возвратам YEStrue. Каталог может содержать элемент, он может совпасть с элементом, или он может не иметь непосредственной связи к элементу.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.10 и позже.

Преобразование путей к файлам к строкам
  • fileSystemRepresentationWithPath (_:) - fileSystemRepresentationWithPath:

    Возвращает представление струны до данного пути, должным образом кодирующего строки Unicode для использования файловой системой.

    Объявление

    Swift

    func fileSystemRepresentationWithPath(_ path: String) -> UnsafePointer<Int8>

    Objective C

    - (const char *)fileSystemRepresentationWithPath:(NSString *)path

    Параметры

    path

    Строковый объект, содержащий путь к файлу. Этот параметр не должен быть nil или содержите пустую строку.

    Возвращаемое значение

    Представление струны до path это должным образом кодирует строки Unicode для использования файловой системой.

    Обсуждение

    Используйте этот метод, если Ваш код вызывает системные подпрограммы, ожидающие параметры пути струны до. При использовании струны до вне объема текущего пула автовыпуска необходимо скопировать его.

    Этот метод повышает исключение если path nil или содержит пустую строку. Если преобразование строки перестало работать, этот метод также выдает исключение.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – stringWithFileSystemRepresentation:length:

  • stringWithFileSystemRepresentation (_: длина:) - stringWithFileSystemRepresentation:length:

    Возвраты NSString возразите, чье содержание получено из указанного пути струны до.

    Объявление

    Swift

    func stringWithFileSystemRepresentation(_ string: UnsafePointer<Int8>, length len: Int) -> String

    Objective C

    - (NSString *)stringWithFileSystemRepresentation:(const char *)string length:(NSUInteger)len

    Параметры

    string

    Представление струны до пути.

    len

    Число символов в string.

    Возвращаемое значение

    NSString объект преобразовывается из представления струны до string с длиной len из пути в текущей файловой системе.

    Обсуждение

    Используйте этот метод, если Ваш код получает пути как струны до от системных подпрограмм.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – fileSystemRepresentationWithPath:

Управление делегатом
  • делегат делегат Свойство

    Делегат объекта файлового менеджера.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSFileManagerDelegate?

    Objective C

    @property(assign) id< NSFileManagerDelegate > delegate

    Обсуждение

    Рекомендуется присвоить делегата в объекте файлового менеджера, только если Вы выделили и инициализировали объект сами. Избегите присваивать делегата в менеджере по совместно используемому файлу, полученном из defaultManager метод.

    Значение по умолчанию этого свойства nil. При присвоении делегата в этом свойстве объект должен соответствовать NSFileManagerDelegate протокол.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.5 и позже.

Управление текущим каталогом
  • changeCurrentDirectoryPath (_:) - changeCurrentDirectoryPath:

    Изменяет путь текущего рабочего каталога к указанному пути.

    Объявление

    Swift

    func changeCurrentDirectoryPath(_ path: String) -> Bool

    Objective C

    - (BOOL)changeCurrentDirectoryPath:(NSString *)path

    Параметры

    path

    Путь каталога, на который можно измениться.

    Возвращаемое значение

    YEStrue в случае успеха, иначе NOfalse.

    Обсуждение

    Все относительные пути обращаются неявно к текущему рабочему каталогу. Изменение текущего рабочего каталога влияет только на пути, создаваемые в текущем процессе.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    currentDirectoryPath
    – fileExistsAtPath:isDirectory:
    – contentsOfDirectoryAtPath:error:

  • currentDirectoryPath currentDirectoryPath Свойство

    Путь к текущему каталогу программы. (только для чтения)

    Объявление

    Swift

    var currentDirectoryPath: String { get }

    Objective C

    @property(readonly, copy) NSString *currentDirectoryPath

    Обсуждение

    Путь текущего каталога является начальной точкой для любых относительных путей, которые Вы указываете. Например, если текущий каталог /tmp и Вы указываете относительный путь reports/info.txt, получающийся полный путь для элемента /tmp/reports/info.txt.

    Когда приложение запускается, это свойство первоначально установлено в текущий рабочий каталог приложения. Если текущий рабочий каталог не доступен ни по какой причине, значение этого свойства nil. Можно изменить значение этого свойства путем вызова changeCurrentDirectoryPath: метод.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.0 и позже.

    См. также

    – changeCurrentDirectoryPath:
    – createDirectoryAtPath:withIntermediateDirectories:attributes:error:

Устаревшие методы
  • copyPath:toPath:handler: - copyPath:toPath:handler: (OS X v10.5)

    Копирует каталог или файл, указанный по данному пути к различному расположению в файловой системе, идентифицированной другим путем.

    Оператор осуждения

    Использовать copyItemAtURL:toURL:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)copyPath:(NSString *)source toPath:(NSString *)destination handler:(id)handler

    Параметры

    source

    Расположение исходного файла.

    destination

    Расположение, в которое можно скопировать файл, указанный source.

    handler

    Объект, реагирующий на сообщения об обратном вызове fileManager:willProcessPath: и fileManager:shouldProceedAfterError:. Можно указать nil для handler; если Вы делаете так, и ошибка происходит, метод автоматически возвращается NOfalse.

    Возвращаемое значение

    YEStrue если работа копии успешна. Если работа не успешна, но обработчик обратного вызова fileManager:shouldProceedAfterError: возвраты YEStrue, copyPath:toPath:handler: также возвраты YEStrue. Иначе этот метод возвраты NOfalse. Метод также пытается сделать атрибуты каталога или файла в destination идентичный source, но игнорирует любой отказ при этой попытке.

    Обсуждение

    Если source файл, метод создает файл в destination это содержит точное содержание исходного файла (это включает BSD специальные файлы). Если source каталог, метод создает новый каталог в destination и рекурсивно заполняет его с копиями файлов и каталогов, содержавшихся в source, сохранение всех ссылок. Файл, указанный в source должен существовать, в то время как destination не должен существовать до работы. Когда файл копируется, целевой путь должен закончиться в имени файла — нет никакого неявного принятия исходного имени файла. Символьные ссылки не пересечены, но самостоятельно копируются. Атрибуты файла или каталога — т.е. метаданные, такие как владелец и числа группы, полномочия файла и дата модификации — также копируются.

    Механизм обратного вызова обработчика подобен делегации. NSFileManager отправляет fileManager:willProcessPath: когда это начнет копию, переместите, удалите, или работа ссылки. Это отправляет fileManager:shouldProceedAfterError: когда это встречается с любой ошибкой в обработке.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать moveItemAtPath:toPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – removeItemAtPath:error:
    – copyItemAtPath:toPath:error:
    – fileManager:shouldProceedAfterError:
    – linkItemAtURL:toURL:error:
    – fileManager:willProcessPath:

  • movePath:toPath:handler: - movePath:toPath:handler: (OS X v10.5)

    Перемещает каталог или файл, указанный данным путем к различному расположению в файловой системе, идентифицированной другим путем.

    Оператор осуждения

    Использовать moveItemAtURL:toURL:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)movePath:(NSString *)source toPath:(NSString *)destination handler:(id)handler

    Параметры

    source

    Путь файла или каталога для перемещения. source должен существовать.

    destination

    Путь тот, к который source перемещен. destination еще не должен существовать. Целевой путь должен закончиться в имени файла; нет никакого неявного принятия исходного имени файла.

    handler

    Объект, реагирующий на сообщения об обратном вызове fileManager:willProcessPath: и fileManager:shouldProceedAfterError:. Можно указать nil для handler; если Вы делаете так, и ошибка происходит, метод автоматически возвращается NOfalse.

    Возвращаемое значение

    YEStrue если операция пересылки успешна. Если работа не успешна, но метод обработчиков fileManager:shouldProceedAfterError: возвраты YEStrue, movePath:toPath:handler: также возвраты YEStrue; иначе возвраты NOfalse.

    Обсуждение

    Если source файл, метод создает файл в destination это содержит точное содержание исходного файла и затем удаляет исходный файл. Если source каталог, movePath:toPath:handler: создает новый каталог в destination и рекурсивно заполняет его с копиями файлов и каталогов, содержавшихся в source. Это тогда удаляет старый каталог и его содержание. Символьные ссылки не пересечены, однако ссылки сохраняются. Атрибуты файла или каталога — т.е. метаданные, такие как владелец и числа группы, полномочия файла и дата модификации — также перемещены.

    Механизм обратного вызова обработчика подобен делегации. NSFileManager отправляет fileManager:willProcessPath: когда это начнет копию, переместите, удалите, или работа ссылки. Это отправляет fileManager:shouldProceedAfterError: когда это встречается с любой ошибкой в обработке.

    Если отказ в операции пересылки происходит, или существующий ранее путь или новый путь остаются неповрежденными, но не оба.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать copyItemAtPath:toPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – copyItemAtPath:toPath:error:
    – moveItemAtPath:toPath:error:
    – removeItemAtPath:error:
    – linkItemAtURL:toURL:error:
    – fileManager:shouldProceedAfterError:
    – fileManager:willProcessPath:

  • removeFileAtPath:handler: - removeFileAtPath:handler: (OS X v10.5)

    Удаляет файл, ссылку или каталог (включая, рекурсивно, все подкаталоги, файлы, и соединяется в каталоге), идентифицированный данным путем.

    Оператор осуждения

    Использовать removeItemAtURL:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)removeFileAtPath:(NSString *)path handler:(id)handler

    Параметры

    path

    Путь файла, ссылки или каталога для удаления. Значение не должно быть».«или»..".

    handler

    Объект, реагирующий на сообщения об обратном вызове fileManager:willProcessPath: и fileManager:shouldProceedAfterError:. Можно указать nil для handler; если Вы делаете так, и ошибка происходит, остановки удаления и метод автоматически возвращается NOfalse.

    Возвращаемое значение

    YEStrue если работа удаления успешна. Если работа не успешна, но метод обработчиков fileManager:shouldProceedAfterError: возвраты YEStrue, также возвраты YEStrue; иначе возвраты NOfalse.

    Обсуждение

    Этот механизм обратного вызова, предоставленный handler подобно делегации. NSFileManager отправляет fileManager:willProcessPath: когда это начнет копию, переместите, удалите, или работа ссылки. Это отправляет fileManager:shouldProceedAfterError: когда это встречается с любой ошибкой в обработке.

    Так как удаление содержания каталога является настолько полным и окончательным, быть тщательным при использовании этого метода. Если Вы указываете».«или»..«для path NSInvalidArgumentException исключение повышено. Этот метод не пересекает символьные ссылки.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать removeItemAtURL:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – linkItemAtURL:toURL:error:
    – moveItemAtPath:toPath:error:
    – removeItemAtPath:error:
    – copyItemAtPath:toPath:error:
    – fileManager:shouldProceedAfterError:
    – fileManager:willProcessPath:

  • changeFileAttributes:atPath: - changeFileAttributes:atPath: (OS X v10.5)

    Изменяет атрибуты данного файла или каталога.

    Оператор осуждения

    Использовать setAttributes:ofItemAtPath:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)changeFileAttributes:(NSDictionary *)attributes atPath:(NSString *)path

    Параметры

    attributes

    Словарь, содержащий, как включает атрибуты для установки для path и как значения соответствующее значение для атрибута. Можно установить следующее: NSFileBusy, NSFileCreationDate, NSFileExtensionHidden, NSFileGroupOwnerAccountID, NSFileGroupOwnerAccountName, NSFileHFSCreatorCode, NSFileHFSTypeCode, NSFileImmutable, NSFileModificationDate, NSFileOwnerAccountID, NSFileOwnerAccountName, NSFilePosixPermissions. Можно изменить единственные атрибуты или любую комбинацию атрибутов; Вы не должны указывать ключи для всех атрибутов.

    Для NSFilePosixPermissions оцените, укажите режим файла от масок бита полномочий OR’d, определенных в sys/stat.h. См. страницу справочника для chmod функция (man 2 chmod) для объяснения.

    path

    Путь к файлу или каталогу.

    Возвращаемое значение

    YEStrue если успешно выполняются все изменения. Если какое-либо изменение перестало работать, возвраты NOfalse, но это не определено, произошли ли фактически какие-либо изменения.

    Обсуждение

    Как в стандарте POSIX, приложение или должно владеть файлом или каталогом или должно работать, когда суперпользователь для атрибута изменяется для вступления в силу. Метод пытается делать все изменения указанными в атрибутах и игнорирует любое отклонение опробованной модификации.

    NSFilePosixPermissions значение должно быть инициализировано с кодом, представляющим образец бита полномочий файла POSIX. NSFileHFSCreatorCode и NSFileHFSTypeCode будет только учтен когда path указывает файл.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать setAttributes:ofItemAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – attributesOfItemAtPath:error:
    – setAttributes:ofItemAtPath:error:

  • fileAttributesAtPath:traverseLink: - fileAttributesAtPath:traverseLink: (OS X v10.5)

    Возвращает словарь, описывающий атрибуты POSIX файла, указанного в данном.

    Оператор осуждения

    Использовать attributesOfItemAtPath:error: вместо этого.

    Объявление

    Objective C

    - (NSDictionary *)fileAttributesAtPath:(NSString *)path traverseLink:(BOOL)flag

    Параметры

    path

    Путь к файлу.

    flag

    Если path не символьная ссылка, этот параметр не имеет никакого эффекта. Если path символьная ссылка, тогда:

    • Если YEStrue если ссылка указывает на несуществующий файл на возвраты метода, атрибуты соединенного - к файлу возвращаются, или nil.

    • Если NOfalse, атрибуты символьной ссылки возвращаются.

    Возвращаемое значение

    NSDictionary объект, описывающий атрибуты POSIX файла, указанного в path. Ключи в словаре описаны в “File Attribute Keys”. Если нет никакого элемента в path, возвраты nil.

    Обсуждение

    Этот пример кода получает несколько атрибутов файла и регистрирует их.

    • NSFileManager *fileManager = [[NSFileManager alloc] init];
    • NSString *path = @"/tmp/List";
    • NSDictionary *fileAttributes = [fileManager fileAttributesAtPath:path traverseLink:YES];
    • if (fileAttributes != nil) {
    • NSNumber *fileSize;
    • NSString *fileOwner;
    • NSDate *fileModDate;
    • if (fileSize = [fileAttributes objectForKey:NSFileSize]) {
    • NSLog(@"File size: %qi\n", [fileSize unsignedLongLongValue]);
    • }
    • if (fileOwner = [fileAttributes objectForKey:NSFileOwnerAccountName]) {
    • NSLog(@"Owner: %@\n", fileOwner);
    • }
    • if (fileModDate = [fileAttributes objectForKey:NSFileModificationDate]) {
    • NSLog(@"Modification date: %@\n", fileModDate);
    • }
    • }
    • else {
    • NSLog(@"Path (%@) is invalid.", path);
    • }

    Как удобство, NSDictionary обеспечивает ряд методов (объявленный как категория в NSFileManager.h) для быстро и эффективно получение информации атрибута из возвращенного словаря: fileGroupOwnerAccountName, fileModificationDate, fileOwnerAccountName, filePosixPermissions, fileSize, fileSystemFileNumber, fileSystemNumber, и fileType. Например, Вы могли переписать оператор модификации файла в примере кода выше как:

    • if (fileModDate = [fileAttributes fileModificationDate])
    • NSLog(@"Modification date: %@\n", fileModDate);

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать attributesOfItemAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – attributesOfItemAtPath:error:
    – setAttributes:ofItemAtPath:error:

  • fileSystemAttributesAtPath: - fileSystemAttributesAtPath: (OS X v10.5)

    Возвращает словарь, описывающий атрибуты смонтированной файловой системы, в которой находится данный путь.

    Оператор осуждения

    Использовать attributesOfFileSystemForPath:error: вместо этого.

    Объявление

    Objective C

    - (NSDictionary *)fileSystemAttributesAtPath:(NSString *)path

    Параметры

    path

    Любой путь в смонтированной файловой системе.

    Возвращаемое значение

    NSDictionary объект, описывающий атрибуты смонтированной файловой системы на который path находится. Посмотрите Ключи Атрибута Файловой системы для описания ключей, доступных в словаре.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать attributesOfFileSystemForPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – attributesOfFileSystemForPath:error:
    – attributesOfItemAtPath:error:
    – setAttributes:ofItemAtPath:error:

  • directoryContentsAtPath: - directoryContentsAtPath: (OS X v10.5)

    Возвращает каталоги и файлы (включая символьные ссылки) содержавшийся в данном каталоге.

    Оператор осуждения

    Использовать contentsOfDirectoryAtPath:error: вместо этого.

    Объявление

    Objective C

    - (NSArray *)directoryContentsAtPath:(NSString *)path

    Параметры

    path

    Путь к каталогу.

    Возвращаемое значение

    Массив NSString объекты, идентифицирующие каталоги и файлы (включая символьные ссылки) содержавшийся в path. Если каталог существует, но не имеет никакого содержания, возвращает пустой массив. Возвраты nil если каталог, указанный в path не существует или существует некоторая другая ошибка при доступе к нему.

    Обсуждение

    Поиск мелок, и поэтому не возвращает содержание никаких подкаталогов и не пересекает символьные ссылки в указанном каталоге. Этот возвращенный массив не содержит строки для текущего каталога (“.”), родительский каталог (“..”), или ветви ресурсов (начинаются “. _”).

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать contentsOfDirectoryAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – contentsOfDirectoryAtPath:error:
    currentDirectoryPath
    – fileExistsAtPath:isDirectory:
    – enumeratorAtPath:
    – subpathsAtPath:

  • createDirectoryAtPath:attributes: - createDirectoryAtPath:attributes: (OS X v10.5)

    Создает каталог (без содержания) в данном пути с данными атрибутами.

    Оператор осуждения

    Использовать createDirectoryAtURL:withIntermediateDirectories:attributes:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)createDirectoryAtPath:(NSString *)path attributes:(NSDictionary *)attributes

    Параметры

    path

    Путь, в котором можно создать новый каталог. Каталог, который будет создаваться, еще не должен существовать, но его родительский каталог должен существовать.

    attributes

    Атрибуты файла для нового каталога. Атрибуты, которые можно установить, являются владельцем и числами группы, полномочиями файла и датой модификации. Если Вы указываете nil для attributes, значения по умолчанию для этих атрибутов установлены (особенно доступ для записи для создателя и доступ для чтения для других). Раздел Constants перечисляет глобальные константы, используемые в качестве ключей attributes словарь. Некоторые ключи, такой как NSFileHFSCreatorCode и NSFileHFSTypeCode, не применяйтесь к каталогам.

    Возвращаемое значение

    YEStrue если работа была успешна, иначе NOfalse.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать createDirectoryAtPath:withIntermediateDirectories:attributes:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – createDirectoryAtPath:withIntermediateDirectories:attributes:error:
    – changeCurrentDirectoryPath:
    – setAttributes:ofItemAtPath:error:
    – createFileAtPath:contents:attributes:
    currentDirectoryPath

  • createSymbolicLinkAtPath:pathContent: - createSymbolicLinkAtPath:pathContent: (OS X v10.5)

    Создает символьную ссылку, идентифицированную данным путем, относящимся к данному расположению.

    Оператор осуждения

    Использовать createSymbolicLinkAtURL:withDestinationURL:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)createSymbolicLinkAtPath:(NSString *)path pathContent:(NSString *)otherPath

    Параметры

    path

    Путь для символьной ссылки.

    otherPath

    Путь тот, к который path должен относиться.

    Возвращаемое значение

    YEStrue если работа успешна, иначе NOfalse. Возвраты NOfalse если файл, каталог или символьная ссылка, идентичная path уже существует.

    Обсуждение

    Создает символьную ссылку, идентифицированную path это относится к расположению otherPath в файловой системе.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать createSymbolicLinkAtPath:withDestinationPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – createSymbolicLinkAtPath:withDestinationPath:error:
    – destinationOfSymbolicLinkAtPath:error:
    – removeItemAtPath:error:

  • pathContentOfSymbolicLinkAtPath: - pathContentOfSymbolicLinkAtPath: (OS X v10.5)

    Возвращает путь каталога или файла, к которому относится символьная ссылка в данном пути.

    Оператор осуждения

    Использовать destinationOfSymbolicLinkAtPath:error: вместо этого.

    Объявление

    Objective C

    - (NSString *)pathContentOfSymbolicLinkAtPath:(NSString *)path

    Параметры

    path

    Путь символьной ссылки.

    Возвращаемое значение

    Путь тот, каталога или файла, к который символьная ссылка path относится, или nil на отказ. Если символьная ссылка указана как относительный путь, тот относительный путь возвращается.

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать destinationOfSymbolicLinkAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – destinationOfSymbolicLinkAtPath:error:
    – createSymbolicLinkAtPath:withDestinationPath:error:

  • linkPath:toPath:handler: - linkPath:toPath:handler: (OS X v10.5)

    Создает ссылку от источника до места назначения.

    Оператор осуждения

    Использовать linkItemAtURL:toURL:error: вместо этого.

    Объявление

    Objective C

    - (BOOL)linkPath:(NSString *)source toPath:(NSString *)destination handler:(id)handler

    Параметры

    source

    Путь, идентифицирующий исходный файл или каталог.

    Файл, ссылка или каталог, указанный source должен существовать.

    destination

    Путь, идентифицирующий целевой файл или каталог.

    Место назначения еще не должно существовать. Целевой путь должен закончиться в имени файла; нет никакого неявного принятия исходного имени файла.

    handler

    Объект, реагирующий на сообщения об обратном вызове fileManager:willProcessPath: и fileManager:shouldProceedAfterError:. Можно указать nil для handler; если Вы делаете так, и ошибка происходит, метод автоматически возвращается NOfalse.

    Возвращаемое значение

    YEStrue если работа ссылки успешна. Если работа не успешна, но метод обработчиков fileManager:shouldProceedAfterError: возвраты YEStrue, также возвраты YEStrue. Иначе возвраты NOfalse.

    Обсуждение

    Механизм обратного вызова обработчика подобен делегации. NSFileManager отправляет fileManager:willProcessPath: когда это начнет копию, переместите, удалите, или работа ссылки. Это отправляет fileManager:shouldProceedAfterError: когда это встречается с любой ошибкой в обработке

    Специальные замечания

    Поскольку этот метод не возвращает информацию об ошибке, он был осужден с OS X v10.5. Использовать removeItemAtPath:error: вместо этого.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – removeItemAtPath:error:
    – moveItemAtPath:toPath:error:
    – createSymbolicLinkAtPath:withDestinationPath:error:
    – copyItemAtPath:toPath:error:
    – fileManager:shouldProceedAfterError:
    – linkItemAtURL:toURL:error:
    – fileManager:willProcessPath:

  • fileManager:shouldProceedAfterError: fileManager:shouldProceedAfterError: (OS X v10.5)

    NSFileManager объект отправляет это сообщение в свой обработчик для каждой ошибки, с которой это встречается при копировании, перемещаясь, удаляя или соединяя файлы или каталоги.

    Оператор осуждения

    Посмотрите методы делегата для копии, переместите, удалите, и методы ссылки.

    Объявление

    Objective C

    - (BOOL)fileManager:(NSFileManager *)manager shouldProceedAfterError:(NSDictionary *)errorInfo

    Обсуждение

    NSFileManager объект, manager, отправляет это сообщение за каждой ошибкой, с которой оно встречается при копировании, перемещаясь, удаляя или соединяя файлы или каталоги. Возвращаемое значение пасуется назад к invoker copyPath:toPath:handler:, movePath:toPath:handler:, removeFileAtPath:handler:, или linkPath:toPath:handler:. Если ошибка происходит, и Ваш обработчик не реализовал этот метод, метод вызова автоматически возвращается NOfalse.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

    См. также

    – fileManager:willProcessPath:

  • fileManager:willProcessPath: fileManager:willProcessPath: (OS X v10.5)

    NSFileManager объект отправляет это сообщение в обработчик сразу прежде, чем попытаться переместить, скопировать, переименуйте или удалите, или прежде, чем попытаться соединиться с данным путем.

    Оператор осуждения

    Посмотрите методы делегата для копии, переместите, соедините и удалите методы.

    Объявление

    Objective C

    - (void)fileManager:(NSFileManager *)manager willProcessPath:(NSString *)path

    Обсуждение

    Можно реализовать этот метод в обработчике для контроля операций файла.

    Оператор импорта

    Objective C

    @import Foundation;

    Доступность

    Доступный в OS X v10.0 и позже.

    Осуждаемый в OS X v10.5.

Константы
  • NSVolumeEnumerationOptions

    Опции для перечисления смонтированных объемов с mountedVolumeURLsIncludingResourceValuesForKeys:options: метод.

    Объявление

    Swift

    struct NSVolumeEnumerationOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var SkipHiddenVolumes: NSVolumeEnumerationOptions { get } static var ProduceFileReferenceURLs: NSVolumeEnumerationOptions { get } }

    Objective C

    typedef enum : NSUInteger { NSVolumeEnumerationSkipHiddenVolumes = 1L << 1, NSVolumeEnumerationProduceFileReferenceURLs = 1L << 2 } NSVolumeEnumerationOptions;

    Константы

    • SkipHiddenVolumes

      NSVolumeEnumerationSkipHiddenVolumes

      Перечисление пропускает скрытые объемы.

      Доступный в OS X v10.6 и позже.

    • ProduceFileReferenceURLs

      NSVolumeEnumerationProduceFileReferenceURLs

      Перечисление производит ссылку на файл URLs, а не находящийся на пути URLs.

      Доступный в OS X v10.6 и позже.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • NSDirectoryEnumerationOptions

    Опции для перечисления содержания каталогов с contentsOfDirectoryAtURL:includingPropertiesForKeys:options:error: метод.

    Объявление

    Swift

    struct NSDirectoryEnumerationOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var SkipsSubdirectoryDescendants: NSDirectoryEnumerationOptions { get } static var SkipsPackageDescendants: NSDirectoryEnumerationOptions { get } static var SkipsHiddenFiles: NSDirectoryEnumerationOptions { get } }

    Objective C

    typedef enum : NSUInteger { NSDirectoryEnumerationSkipsSubdirectoryDescendants = 1L << 0, NSDirectoryEnumerationSkipsPackageDescendants = 1L << 1, NSDirectoryEnumerationSkipsHiddenFiles = 1L << 2 } NSDirectoryEnumerationOptions;

    Константы

    • SkipsSubdirectoryDescendants

      NSDirectoryEnumerationSkipsSubdirectoryDescendants

      Выполните мелкое перечисление; не убывайте в каталоги.

      Доступный в OS X v10.6 и позже.

    • SkipsPackageDescendants

      NSDirectoryEnumerationSkipsPackageDescendants

      Не убывайте в пакеты.

      Доступный в OS X v10.6 и позже.

    • SkipsHiddenFiles

      NSDirectoryEnumerationSkipsHiddenFiles

      Не перечисляйте скрытые файлы.

      Доступный в OS X v10.6 и позже.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • NSFileManagerItemReplacementOptions

    Константы указывают заменяющее поведение в replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error:.

    Объявление

    Swift

    struct NSFileManagerItemReplacementOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var UsingNewMetadataOnly: NSFileManagerItemReplacementOptions { get } static var WithoutDeletingBackupItem: NSFileManagerItemReplacementOptions { get } }

    Objective C

    typedef enum : NSUInteger { NSFileManagerItemReplacementUsingNewMetadataOnly = 1UL << 0, NSFileManagerItemReplacementWithoutDeletingBackupItem = 1UL << 1 } NSFileManagerItemReplacementOptions;

    Константы

    • UsingNewMetadataOnly

      NSFileManagerItemReplacementUsingNewMetadataOnly

      Причины replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: использовать метаданные от нового элемента только а не попытаться сохранить метаданные от исходного элемента.

      Доступный в OS X v10.6 и позже.

    • WithoutDeletingBackupItem

      NSFileManagerItemReplacementWithoutDeletingBackupItem

      Причины replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: оставить резервный элемент на месте после успешной замены. Поведение по умолчанию состоит в том, чтобы удалить элемент.

      Доступный в OS X v10.6 и позже.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.6 и позже.

  • Ключи атрибута файла

    Эти ключевые значения атрибута доступа к файлу, содержавшиеся в NSDictionary объекты, используемые setAttributes:ofItemAtPath:error:, attributesOfItemAtPath:error:, createDirectoryAtPath:withIntermediateDirectories:attributes:error:, и createFileAtPath:contents:attributes:.

    Объявление

    Swift

    let NSFileAppendOnly: NSString! let NSFileBusy: NSString! let NSFileCreationDate: NSString! let NSFileOwnerAccountName: NSString! let NSFileGroupOwnerAccountName: NSString! let NSFileDeviceIdentifier: NSString! let NSFileExtensionHidden: NSString! let NSFileGroupOwnerAccountID: NSString! let NSFileHFSCreatorCode: NSString! let NSFileHFSTypeCode: NSString! let NSFileImmutable: NSString! let NSFileModificationDate: NSString! let NSFileOwnerAccountID: NSString! let NSFilePosixPermissions: NSString! let NSFileReferenceCount: NSString! let NSFileSize: NSString! let NSFileSystemFileNumber: NSString! let NSFileType: NSString!

    Objective C

    NSString * const NSFileType; NSString * const NSFileSize; NSString * const NSFileModificationDate; NSString * const NSFileReferenceCount; NSString * const NSFileDeviceIdentifier; NSString * const NSFileOwnerAccountName; NSString * const NSFileGroupOwnerAccountName; NSString * const NSFilePosixPermissions; NSString * const NSFileSystemNumber; NSString * const NSFileSystemFileNumber; NSString * const NSFileExtensionHidden; NSString * const NSFileHFSCreatorCode; NSString * const NSFileHFSTypeCode; NSString * const NSFileImmutable; NSString * const NSFileAppendOnly; NSString * const NSFileCreationDate; NSString * const NSFileOwnerAccountID; NSString * const NSFileGroupOwnerAccountID; NSString * const NSFileBusy;

    Константы

    • NSFileAppendOnly

      NSFileAppendOnly

      Ключ в словаре атрибута файла, значение которого указывает, только ли файл для чтения.

      Соответствующее значение NSNumber объект, содержащий булево значение.

      Доступный в OS X v10.2 и позже.

    • NSFileBusy

      NSFileBusy

      Ключ в словаре атрибута файла, значение которого указывает, занят ли файл.

      Соответствующее значение NSNumber объект, содержащий булево значение.

      Доступный в OS X v10.4 и позже.

    • NSFileCreationDate

      NSFileCreationDate

      Ключ в словаре атрибута файла, значение которого указывает дату создания файла.

      Соответствующее значение NSDate объект.

      Доступный в OS X v10.2 и позже.

    • NSFileOwnerAccountName

      NSFileOwnerAccountName

      Ключ в словаре атрибута файла, значение которого указывает имя владельца файла.

      Соответствующее значение NSString объект.

      Доступный в OS X v10.0 и позже.

    • NSFileGroupOwnerAccountName

      NSFileGroupOwnerAccountName

      Ключ в словаре атрибута файла, значение которого указывает название группы владельца файла.

      Соответствующее значение NSString объект.

      Доступный в OS X v10.0 и позже.

    • NSFileDeviceIdentifier

      NSFileDeviceIdentifier

      Ключ в словаре атрибута файла, значение которого указывает идентификатор для устройства, на котором находится файл.

      Соответствующее значение NSNumber объект, содержащий unsigned long.

      Доступный в OS X v10.0 и позже.

    • NSFileExtensionHidden

      NSFileExtensionHidden

      Ключ в словаре атрибута файла, значение которого указывает, скрыто ли расширение файла.

      Соответствующее значение NSNumber объект, содержащий булево значение.

      Доступный в OS X v10.1 и позже.

    • NSFileGroupOwnerAccountID

      NSFileGroupOwnerAccountID

      Ключ в словаре атрибута файла, значение которого указывает группу файла ID.

      Соответствующее значение NSNumber объект, содержащий unsigned long.

      Доступный в OS X v10.2 и позже.

    • NSFileHFSCreatorCode

      NSFileHFSCreatorCode

      Ключ в словаре атрибута файла, значение которого указывает код создателя файла HFS.

      Соответствующее значение NSNumber объект, содержащий unsigned long. См. Типы файлов HFS для возможных значений.

      Доступный в OS X v10.1 и позже.

    • NSFileHFSTypeCode

      NSFileHFSTypeCode

      Ключ в словаре атрибута файла, значение которого указывает код типа HFS файла.

      Соответствующее значение NSNumber объект, содержащий unsigned long. См. Типы файлов HFS для возможных значений.

      Доступный в OS X v10.1 и позже.

    • NSFileImmutable

      NSFileImmutable

      Ключ в словаре атрибута файла, значение которого указывает, является ли файл непостоянным.

      Соответствующее значение NSNumber объект, содержащий булево значение.

      Доступный в OS X v10.2 и позже.

    • NSFileModificationDate

      NSFileModificationDate

      Ключ в словаре атрибута файла, значение которого указывает последнюю измененную дату файла.

      Соответствующее значение NSDate объект.

      Доступный в OS X v10.0 и позже.

    • NSFileOwnerAccountID

      NSFileOwnerAccountID

      Ключ в словаре атрибута файла, значение которого указывает идентификатор счета владельца файла.

      Соответствующее значение NSNumber объект, содержащий unsigned long.

      Доступный в OS X v10.2 и позже.

    • NSFilePosixPermissions

      NSFilePosixPermissions

      Ключ в словаре атрибута файла, значение которого указывает полномочия Posix файла.

      Соответствующее значение NSNumber объект. Используйте shortValue метод для получения целочисленного значения для полномочий.

      Доступный в OS X v10.0 и позже.

    • NSFileReferenceCount

      NSFileReferenceCount

      Ключ в словаре атрибута файла, значение которого указывает подсчет ссылок файла.

      Соответствующее значение NSNumber объект, содержащий unsigned long.

      Число указывает число жестких ссылок на файл.

      Доступный в OS X v10.0 и позже.

    • NSFileSize

      NSFileSize

      Ключ в словаре атрибута файла, значение которого указывает размер файла в байтах.

      Соответствующее значение NSNumber объект, содержащий unsigned long long.

      Доступный в OS X v10.0 и позже.

    • NSFileSystemFileNumber

      NSFileSystemFileNumber

      Ключ в словаре атрибута файла, значение которого указывает номер документа файловой системы файла.

      Соответствующее значение NSNumber объект, содержащий unsigned long. Значение соответствует значению st_ino, как возвращено stat(2).

      Доступный в OS X v10.0 и позже.

    • NSFileType

      NSFileType

      Ключ в словаре атрибута файла, значение которого указывает тип файла.

      Соответствующее значение NSString объект (см. Значения атрибута NSFileType для возможных значений).

      Доступный в OS X v10.0 и позже.

    Обсуждение

    NSFileDeviceIdentifier используется для доступа к идентификатору удаленного устройства.

  • Значения атрибута NSFileType

    Эти строки являются возможными значениями для NSFileType припишите ключ, содержавшийся в объекте словаря, возвращенном attributesOfItemAtPath:error:.

    Объявление

    Swift

    let NSFileTypeDirectory: NSString! let NSFileTypeRegular: NSString! let NSFileTypeSymbolicLink: NSString! let NSFileTypeSocket: NSString! let NSFileTypeCharacterSpecial: NSString! let NSFileTypeBlockSpecial: NSString! let NSFileTypeUnknown: NSString!

    Objective C

    NSString * const NSFileTypeDirectory; NSString * const NSFileTypeRegular; NSString * const NSFileTypeSymbolicLink; NSString * const NSFileTypeSocket; NSString * const NSFileTypeCharacterSpecial; NSString * const NSFileTypeBlockSpecial; NSString * const NSFileTypeUnknown;

    Константы

    • NSFileTypeDirectory

      NSFileTypeDirectory

      Каталог

      Доступный в OS X v10.0 и позже.

    • NSFileTypeRegular

      NSFileTypeRegular

      Регулярный файл

      Доступный в OS X v10.0 и позже.

    • NSFileTypeSymbolicLink

      NSFileTypeSymbolicLink

      Символьная ссылка

      Доступный в OS X v10.0 и позже.

    • NSFileTypeSocket

      NSFileTypeSocket

      Сокет

      Доступный в OS X v10.0 и позже.

    • NSFileTypeCharacterSpecial

      NSFileTypeCharacterSpecial

      Символьный специальный файл

      Доступный в OS X v10.0 и позже.

    • NSFileTypeBlockSpecial

      NSFileTypeBlockSpecial

      Блокируйте специальный файл

      Доступный в OS X v10.0 и позже.

    • NSFileTypeUnknown

      NSFileTypeUnknown

      Неизвестный

      Доступный в OS X v10.0 и позже.

  • Ключи атрибута файловой системы

    Ключи для доступа к значениям атрибута файла, содержавшимся в объекте словаря, возвратились из attributesOfFileSystemForPath:error: метод.

    Объявление

    Swift

    let NSFileSystemSize: NSString! let NSFileSystemFreeSize: NSString! let NSFileSystemNodes: NSString! let NSFileSystemFreeNodes: NSString! let NSFileSystemNumber: NSString!

    Objective C

    extern NSString *NSFileSystemSize; extern NSString *NSFileSystemFreeSize; extern NSString *NSFileSystemNodes; extern NSString *NSFileSystemFreeNodes; extern NSString *NSFileSystemNumber;

    Константы

    • NSFileSystemSize

      NSFileSystemSize

      Ключ в файловой системе приписывает словарь, значение которого указывает размер файловой системы.

      Соответствующее значение NSNumber объект, указывающий размер файловой системы в байтах. Значение определяется statfs().

      Доступный в OS X v10.0 и позже.

    • NSFileSystemFreeSize

      NSFileSystemFreeSize

      Ключ в файловой системе приписывает словарь, значение которого указывает сумму свободного пространства в файловой системе.

      Соответствующее значение NSNumber объект, указывающий сумму свободного пространства в файловой системе в байтах. Значение определяется statfs().

      Доступный в OS X v10.0 и позже.

    • NSFileSystemNodes

      NSFileSystemNodes

      Ключ в файловой системе приписывает словарь, значение которого указывает число узлов в файловой системе.

      Соответствующее значение NSNumber объект, указывающий число узлов в файловой системе.

      Доступный в OS X v10.0 и позже.

    • NSFileSystemFreeNodes

      NSFileSystemFreeNodes

      Ключ в файловой системе приписывает словарь словаря, значение которого указывает число свободных узлов в файловой системе.

      Соответствующее значение NSNumber объект, указывающий число свободных узлов в файловой системе.

      Доступный в OS X v10.0 и позже.

    • NSFileSystemNumber

      NSFileSystemNumber

      Ключ в файловой системе приписывает словарь словаря, значение которого указывает число файловой системы файловой системы.

      Соответствующее значение NSNumber объект, указывающий число файловой системы файловой системы. Значение соответствует значению st_dev, как возвращено stat(2).

      Доступный в OS X v10.0 и позже.

  • NSURLRelationship

    Константы, указывающие отношение между каталогом и элементом.

    Объявление

    Swift

    enum NSURLRelationship : Int { case Contains case Same case Other }

    Objective C

    typedef enum NSURLRelationship : NSInteger { NSURLRelationshipContains, NSURLRelationshipSame, NSURLRelationshipOther } NSURLRelationship;

    Константы

    • Contains

      NSURLRelationshipContains

      Каталог содержит указанный элемент.

      Доступный в OS X v10.10 и позже.

    • Same

      NSURLRelationshipSame

      Каталог и элемент являются тем же. Это отношение происходит когда значение NSURLFileResourceIdentifierKey то же для каталога и элемента.

      Доступный в OS X v10.10 и позже.

    • Other

      NSURLRelationshipOther

      Каталог не содержит элемент и не является тем же как элементом.

      Доступный в OS X v10.10 и позже.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.10 и позже.

  • Поддержка ветви ресурсов

    Указывает версию платформы Основы в который NSFileManager сначала поддерживаемые ветви ресурсов.

    Объявление

    Swift

    var NSFoundationVersionWithFileManagerResourceForkSupport: Int32 { get }

    Objective C

    #define NSFoundationVersionWithFileManagerResourceForkSupport 412

    Константы

    • NSFoundationVersionWithFileManagerResourceForkSupport

      NSFoundationVersionWithFileManagerResourceForkSupport

      Версия та, платформы Основы, в который NSFileManager сначала поддерживаемые ветви ресурсов.

      Доступный в OS X v10.1 и позже.

Уведомления
  • NSUbiquityIdentityDidChangeNotification NSUbiquityIdentityDidChangeNotification

    Отправленный после iCloud («повсеместность») идентификационные данные изменились.

    Когда Ваше приложение получит это уведомление, получите новый маркер от ubiquityIdentityToken свойство. Значение того маркера nil если пользователь отключил iCloud. Существует нет userInfo словарь.

    Оператор импорта

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

    Доступный в OS X v10.8 и позже.