NSFileManager

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

NSObject
NSFileManager

NSObject
NSFileManager

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

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

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

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

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

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

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

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

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

- 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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 4.0 и позже.

См. также

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

Доступность

Доступный в iOS 4.0 и позже.

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

containerURLForSecurityApplicationGroupIdentifier (_:) - containerURLForSecurityApplicationGroupIdentifier:

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

Объявление

Swift

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

Objective C

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

Обсуждение

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

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

Важный

Ваше приложение должно иметь a com.apple.security.application-groups право для указанной группы приложений.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 7.0 и позже.

Обнаружение содержания каталога


    
    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

Доступность

Доступный в iOS 4.0 и позже.

См. также

– 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 параметр

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

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

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


      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

Доступность

Доступный в iOS 4.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 4.0 и позже.


    
    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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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` для этого параметра, если Вы не хотите информации об ошибке.

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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.

Обсуждение

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.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

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

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

Доступность

Доступный в iOS 4.0 и позже.

См. также

– removeItemAtPath: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

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

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

Обсуждение

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    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

Доступность

Доступный в iOS 4.0 и позже.

Перемещение и копирование элементов


    
    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

Доступность

Доступный в iOS 4.0 и позже.


    
    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` для этого параметра, если Вы не хотите информации об ошибке.

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

Обсуждение

При копировании элементов текущий процесс должен иметь разрешение считать файл или каталог в 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

Доступность

Доступный в iOS 2.0 и позже.


    
    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

Доступность

Доступный в iOS 4.0 и позже.

См. также

– 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` для этого параметра, если Вы не хотите информации об ошибке.

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

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

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

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

Доступность

Доступный в iOS 6.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 5.0 и позже.

См. также

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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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 если это успешно. Вызов этого метода также уведомляет Вашего предъявителя файла нового расположения файла так, чтобы Ваше приложение могло продолжать воздействовать на него.

Важный

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

После вызова этого метода необходимо ожидать файла, который будет полностью загружен на iCloud прежде, чем попытаться совместно использовать файл с помощью URLForPublishingUbiquitousItemAtURL:expirationDate:error: метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 5.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 4.0 и позже.


    
    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 (или содержит), символьная ссылка, символьная ссылка копируется в новое расположение и не преобразовывается в жесткую ссылку.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.


    
    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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.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 если Вам не нужна эта информация.

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

Обсуждение

Если необходимо далее определить ли 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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.0 и позже.
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

Доступность

Доступный в iOS 2.0 и позже.


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

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

Объявление

Swift

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

Objective C

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

Параметры


      path

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


      error

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

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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– 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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 8.0 и позже.


    
    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

Доступность

Доступный в iOS 8.0 и позже.

Преобразование путей к файлам к строкам


    
    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

Доступность

Доступный в iOS 2.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

Доступность

Доступный в iOS 2.0 и позже.

См. также

– fileSystemRepresentationWithPath:

Управление делегатом

delegate Свойство

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

Объявление

Swift

unowned(unsafe) var delegate: NSFileManagerDelegate?

Objective C

@property(assign) id< NSFileManagerDelegate > delegate

Обсуждение

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

Управление текущим каталогом

changeCurrentDirectoryPath (_:) - changeCurrentDirectoryPath:

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

Объявление

Swift

func changeCurrentDirectoryPath(_ path: String) -> Bool

Objective C

- (BOOL)changeCurrentDirectoryPath:(NSString *)path

Параметры

path

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 2.0 и позже.

См. также

currentDirectoryPath
– fileExistsAtPath:isDirectory:
– contentsOfDirectoryAtPath:error:
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

Доступность

Доступный в iOS 2.0 и позже.

См. также

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

Устаревшие методы


    
    - changeFileAttributes:atPath:

(iOS 2.0)

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

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

Использовать 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

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

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

Обсуждение

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

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 2.0.

См. также

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


    
    - fileAttributesAtPath:traverseLink:

(iOS 2.0)

Возвращает словарь, описывающий атрибуты 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;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 2.0.

См. также

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

- fileSystemAttributesAtPath: (iOS 2.0)

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

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

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

Объявление

Objective C

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

Параметры

path

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

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

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

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

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– attributesOfFileSystemForPath:error:
– attributesOfItemAtPath:error:
– setAttributes:ofItemAtPath:error:
- directoryContentsAtPath: (iOS 2.0)

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

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

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

Объявление

Objective C

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

Параметры

path

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

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

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

Обсуждение

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

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

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

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


    
    - createDirectoryAtPath:attributes:

(iOS 2.0)

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

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

Использовать 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;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 2.0.

См. также

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


    
    - createSymbolicLinkAtPath:pathContent:

(iOS 2.0)

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

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

Использовать 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;

Доступность

Доступный в iOS 2.0 и позже.

Осуждаемый в iOS 2.0.

См. также

– createSymbolicLinkAtPath:withDestinationPath:error:
– destinationOfSymbolicLinkAtPath:error:
– removeItemAtPath:error:

- pathContentOfSymbolicLinkAtPath: (iOS 2.0)

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

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

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

Объявление

Objective C

- (NSString *)pathContentOfSymbolicLinkAtPath:(NSString *)path

Параметры

path

Путь символьной ссылки.

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

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

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

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

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– destinationOfSymbolicLinkAtPath:error:
– createSymbolicLinkAtPath:withDestinationPath:error:
fileManager:shouldProceedAfterError: (iOS 2.0)

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;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

См. также

– fileManager:willProcessPath:
fileManager:willProcessPath: (iOS 2.0)

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

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

Посмотрите методы делегата для копии, переместите, соедините и удалите методы.

Объявление

Objective C

- (void)fileManager:(NSFileManager *)manager willProcessPath:(NSString *)path

Обсуждение

Можно реализовать этот метод в обработчике для контроля операций файла.

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

Objective C

@import Foundation;

Доступность

Доступный в iOS 2.0 и позже.
Осуждаемый в iOS 2.0.

Константы

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
  
  Перечисление пропускает скрытые объемы.
  
  Доступный в iOS 4.0 и позже.
- ProduceFileReferenceURLs
  
  NSVolumeEnumerationProduceFileReferenceURLs
  
  Перечисление производит ссылку на файл URLs, а не находящийся на пути URLs.
  
  Доступный в iOS 4.0 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.
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
  
  Выполните мелкое перечисление; не убывайте в каталоги.
  
  Доступный в iOS 4.0 и позже.
- SkipsPackageDescendants
  
  NSDirectoryEnumerationSkipsPackageDescendants
  
  Не убывайте в пакеты.
  
  Доступный в iOS 4.0 и позже.
- SkipsHiddenFiles
  
  NSDirectoryEnumerationSkipsHiddenFiles
  
  Не перечисляйте скрытые файлы.
  
  Доступный в iOS 4.0 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.
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: использовать метаданные от нового элемента только а не попытаться сохранить метаданные от исходного элемента.
  
  Доступный в iOS 4.0 и позже.
- WithoutDeletingBackupItem
  
  NSFileManagerItemReplacementWithoutDeletingBackupItem
  
  Причины replaceItemAtURL:withItemAtURL:backupItemName:options:resultingItemURL:error: оставить резервный элемент на месте после успешной замены. Поведение по умолчанию состоит в том, чтобы удалить элемент.
  
  Доступный в iOS 4.0 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 4.0 и позже.
Ключи атрибута файла
Эти ключевые значения атрибута доступа к файлу, содержавшиеся в NSDictionary объекты, используемые setAttributes:ofItemAtPath:error:, attributesOfItemAtPath:error:, createDirectoryAtPath:withIntermediateDirectories:attributes:error:, и createFileAtPath:contents:attributes:.

Объявление

Swift

let NSFileAppendOnly: String let NSFileBusy: String let NSFileCreationDate: String let NSFileOwnerAccountName: String let NSFileGroupOwnerAccountName: String let NSFileDeviceIdentifier: String let NSFileExtensionHidden: String let NSFileGroupOwnerAccountID: String let NSFileHFSCreatorCode: String let NSFileHFSTypeCode: String let NSFileImmutable: String let NSFileModificationDate: String let NSFileOwnerAccountID: String let NSFilePosixPermissions: String let NSFileReferenceCount: String let NSFileSize: String let NSFileSystemFileNumber: String let NSFileType: String let NSFileProtectionKey: String

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; NSString* const NSFileProtectionKey;

Константы
- NSFileAppendOnly
  
  Ключ в словаре атрибута файла, значение которого указывает, только ли файл для чтения.
  
  Соответствующее значение NSNumber объект, содержащий булево значение.
  
  Доступный в iOS 2.0 и позже.
- NSFileBusy
  
  Ключ в словаре атрибута файла, значение которого указывает, занят ли файл.
  
  Соответствующее значение NSNumber объект, содержащий булево значение.
  
  Доступный в iOS 2.0 и позже.
- NSFileCreationDate
  
  Ключ в словаре атрибута файла, значение которого указывает дату создания файла.
  
  Соответствующее значение NSDate объект.
  
  Доступный в iOS 2.0 и позже.
- NSFileOwnerAccountName
  
  Ключ в словаре атрибута файла, значение которого указывает имя владельца файла.
  
  Соответствующее значение NSString объект.
  
  Доступный в iOS 2.0 и позже.
- NSFileGroupOwnerAccountName
  
  Ключ в словаре атрибута файла, значение которого указывает название группы владельца файла.
  
  Соответствующее значение NSString объект.
  
  Доступный в iOS 2.0 и позже.
- NSFileDeviceIdentifier
  
  Ключ в словаре атрибута файла, значение которого указывает идентификатор для устройства, на котором находится файл.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long.
  
  Доступный в iOS 2.0 и позже.
- NSFileExtensionHidden
  
  Ключ в словаре атрибута файла, значение которого указывает, скрыто ли расширение файла.
  
  Соответствующее значение NSNumber объект, содержащий булево значение.
  
  Доступный в iOS 2.0 и позже.
- NSFileGroupOwnerAccountID
  
  Ключ в словаре атрибута файла, значение которого указывает группу файла ID.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long.
  
  Доступный в iOS 2.0 и позже.
- NSFileHFSCreatorCode
  
  Ключ в словаре атрибута файла, значение которого указывает код создателя файла HFS.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long. См. Типы файлов HFS для возможных значений.
  
  Доступный в iOS 2.0 и позже.
- NSFileHFSTypeCode
  
  Ключ в словаре атрибута файла, значение которого указывает код типа HFS файла.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long. См. Типы файлов HFS для возможных значений.
  
  Доступный в iOS 2.0 и позже.
- NSFileImmutable
  
  Ключ в словаре атрибута файла, значение которого указывает, является ли файл непостоянным.
  
  Соответствующее значение NSNumber объект, содержащий булево значение.
  
  Доступный в iOS 2.0 и позже.
- NSFileModificationDate
  
  Ключ в словаре атрибута файла, значение которого указывает последнюю измененную дату файла.
  
  Соответствующее значение NSDate объект.
  
  Доступный в iOS 2.0 и позже.
- NSFileOwnerAccountID
  
  Ключ в словаре атрибута файла, значение которого указывает идентификатор счета владельца файла.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long.
  
  Доступный в iOS 2.0 и позже.
- NSFilePosixPermissions
  
  Ключ в словаре атрибута файла, значение которого указывает полномочия Posix файла.
  
  Соответствующее значение NSNumber объект. Используйте shortValue метод для получения целочисленного значения для полномочий.
  
  Доступный в iOS 2.0 и позже.
- NSFileReferenceCount
  
  Ключ в словаре атрибута файла, значение которого указывает подсчет ссылок файла.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long.
  
  Число указывает число жестких ссылок на файл.
  
  Доступный в iOS 2.0 и позже.
- NSFileSize
  
  Ключ в словаре атрибута файла, значение которого указывает размер файла в байтах.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long long.
  
  Важный
  
  Если файл имеет ветвь ресурсов, возвращенное значение не включает размер ветви ресурсов.
  
  Доступный в iOS 2.0 и позже.
- NSFileSystemFileNumber
  
  Ключ в словаре атрибута файла, значение которого указывает номер документа файловой системы файла.
  
  Соответствующее значение NSNumber объект, содержащий unsigned long. Значение соответствует значению st_ino, как возвращено stat(2).
  
  Доступный в iOS 2.0 и позже.
- NSFileType
  
  Ключ в словаре атрибута файла, значение которого указывает тип файла.
  
  Соответствующее значение NSString объект (см. Значения атрибута NSFileType для возможных значений).
  
  Доступный в iOS 2.0 и позже.
- NSFileProtectionKey
  
  Расширенный ключ атрибута, идентифицирующий уровень защиты для этого файла. Соответствующее значение NSString значение. Для списка возможных значений посмотрите Значения Защиты Файла.
  
  Доступный в iOS 4.0 и позже.
Обсуждение

NSFileDeviceIdentifier используется для доступа к идентификатору удаленного устройства.
Значения атрибута NSFileType
Эти строки являются возможными значениями для NSFileType припишите ключ, содержавшийся в объекте словаря, возвращенном attributesOfItemAtPath:error:.

Объявление

Swift

let NSFileTypeDirectory: String let NSFileTypeRegular: String let NSFileTypeSymbolicLink: String let NSFileTypeSocket: String let NSFileTypeCharacterSpecial: String let NSFileTypeBlockSpecial: String let NSFileTypeUnknown: String

Objective C

NSString * const NSFileTypeDirectory; NSString * const NSFileTypeRegular; NSString * const NSFileTypeSymbolicLink; NSString * const NSFileTypeSocket; NSString * const NSFileTypeCharacterSpecial; NSString * const NSFileTypeBlockSpecial; NSString * const NSFileTypeUnknown;

Константы
- NSFileTypeDirectory
  
  Каталог
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeRegular
  
  Регулярный файл
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeSymbolicLink
  
  Символьная ссылка
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeSocket
  
  Сокет
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeCharacterSpecial
  
  Символьный специальный файл
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeBlockSpecial
  
  Блокируйте специальный файл
  
  Доступный в iOS 2.0 и позже.
- NSFileTypeUnknown
  
  Неизвестный
  
  Доступный в iOS 2.0 и позже.
Ключи атрибута файловой системы
Ключи для доступа к значениям атрибута файла, содержавшимся в объекте словаря, возвратились из attributesOfFileSystemForPath:error: метод.

Объявление

Swift

let NSFileSystemSize: String let NSFileSystemFreeSize: String let NSFileSystemNodes: String let NSFileSystemFreeNodes: String let NSFileSystemNumber: String

Objective C

extern NSString *NSFileSystemSize; extern NSString *NSFileSystemFreeSize; extern NSString *NSFileSystemNodes; extern NSString *NSFileSystemFreeNodes; extern NSString *NSFileSystemNumber;

Константы
- NSFileSystemSize
  
  Ключ в файловой системе приписывает словарь, значение которого указывает размер файловой системы.
  
  Соответствующее значение NSNumber объект, указывающий размер файловой системы в байтах. Значение определяется statfs().
  
  Доступный в iOS 2.0 и позже.
- NSFileSystemFreeSize
  
  Ключ в файловой системе приписывает словарь, значение которого указывает сумму свободного пространства в файловой системе.
  
  Соответствующее значение NSNumber объект, указывающий сумму свободного пространства в файловой системе в байтах. Значение определяется statfs().
  
  Доступный в iOS 2.0 и позже.
- NSFileSystemNodes
  
  Ключ в файловой системе приписывает словарь, значение которого указывает число узлов в файловой системе.
  
  Соответствующее значение NSNumber объект, указывающий число узлов в файловой системе.
  
  Доступный в iOS 2.0 и позже.
- NSFileSystemFreeNodes
  
  Ключ в файловой системе приписывает словарь словаря, значение которого указывает число свободных узлов в файловой системе.
  
  Соответствующее значение NSNumber объект, указывающий число свободных узлов в файловой системе.
  
  Доступный в iOS 2.0 и позже.
- NSFileSystemNumber
  
  Ключ в файловой системе приписывает словарь словаря, значение которого указывает число файловой системы файловой системы.
  
  Соответствующее значение NSNumber объект, указывающий число файловой системы файловой системы. Значение соответствует значению st_dev, как возвращено stat(2).
  
  Доступный в iOS 2.0 и позже.
Значения защиты файла
Указывает значения, которые могут быть связаны с NSFileProtectionKey ключ.

Объявление

Swift

let NSFileProtectionNone: String let NSFileProtectionComplete: String let NSFileProtectionCompleteUnlessOpen: String let NSFileProtectionCompleteUntilFirstUserAuthentication: String

Objective C

extern NSString* const NSFileProtectionNone; extern NSString* const NSFileProtectionComplete; extern NSString* const NSFileProtectionCompleteUnlessOpen; extern NSString* const NSFileProtectionCompleteUntilFirstUserAuthentication;

Константы
- NSFileProtectionNone
  
  Файл не имеет никакой специальной защиты, связанной с ним. Это может быть считано из или записано в в любое время.
  
  Доступный в iOS 4.0 и позже.
- NSFileProtectionComplete
  
  Файл хранится в зашифрованном формате на диске и не может быть считан из или записан в то, в то время как устройство заблокировано или начальная загрузка.
  
  Доступный в iOS 4.0 и позже.
- NSFileProtectionCompleteUnlessOpen
  
  Файл хранится в зашифрованном формате на диске. Файлы могут быть созданы, в то время как устройство заблокировано, но когда-то закрыто, не может быть открыт снова, пока не разблокировано устройство. Если файл открыт, когда разблокировано, можно продолжать получать доступ к файлу обычно, даже если пользователь блокирует устройство. Существует маленькая потеря производительности, когда файл создан и открыт, хотя не, будучи записанным в или читают из. Это может быть смягчено путем изменения защиты файла на NSFileProtectionComplete когда разблокировано устройство.
  
  Доступный в iOS 5.0 и позже.
- NSFileProtectionCompleteUntilFirstUserAuthentication
  
  Файл хранится в зашифрованном формате на диске и не может быть получен доступ, пока устройство не загрузилось. После того, как пользователь разблокировал устройство впервые, Ваше приложение может получить доступ к файлу и продолжать получать доступ к нему, даже если пользователь впоследствии блокирует устройство.
  
  Доступный в iOS 5.0 и позже.
NSURLRelationship
Константы, указывающие отношение между каталогом и элементом.

Объявление

Swift

enum NSURLRelationship : Int { case Contains case Same case Other }

Objective C

typedef enum NSURLRelationship : NSInteger { NSURLRelationshipContains, NSURLRelationshipSame, NSURLRelationshipOther } NSURLRelationship;

Константы
- Contains
  
  NSURLRelationshipContains
  
  Каталог содержит указанный элемент.
  
  Доступный в iOS 8.0 и позже.
- Same
  
  NSURLRelationshipSame
  
  Каталог и элемент являются тем же. Это отношение происходит когда значение NSURLFileResourceIdentifierKey то же для каталога и элемента.
  
  Доступный в iOS 8.0 и позже.
- Other
  
  NSURLRelationshipOther
  
  Каталог не содержит элемент и не является тем же как элементом.
  
  Доступный в iOS 8.0 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 8.0 и позже.
Поддержка ветви ресурсов
Указывает версию платформы Основы в который NSFileManager сначала поддерживаемые ветви ресурсов.

Объявление

Swift

var NSFoundationVersionWithFileManagerResourceForkSupport: Int32 { get }

Objective C

#define NSFoundationVersionWithFileManagerResourceForkSupport 412

Константы
- NSFoundationVersionWithFileManagerResourceForkSupport
  
  Версия та, платформы Основы, в который NSFileManager сначала поддерживаемые ветви ресурсов.
  
  Доступный в iOS 2.0 и позже.

Уведомления

NSUbiquityIdentityDidChangeNotification NSUbiquityIdentityDidChangeNotification

Отправленный после iCloud («повсеместность») идентификационные данные изменились.
Когда Ваше приложение получит это уведомление, получите новый маркер от NSURLRelationship свойство. Значение того маркера nil если пользователь отключил iCloud. Существует нет userInfo словарь.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в iOS 6.0 и позже.