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

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

Разработчик

Ссылка платформы CoreFoundation ссылка CFURL

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

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

Ссылка CFURL

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


Не применимый

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


Не применимый

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


Swift

import CoreFoundation

Objective C

@import CoreFoundation;

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

A CFURL объект составлен из двух частей — базовый URL, который может быть NULL, и строка, разрешенная относительно базового URL. A CFURL возразите, чья строка полностью разрешена без базового URL, считается абсолютным; всех других считают относительными.

CFURL “бесплатный соединенный мостом” с его дубликатом Основы Какао, NSURL. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Другими словами, в методе, где Вы видите NSURL * параметр, можно передать в a CFURLRef, и в функции, где Вы видите a CFURLRef параметр, можно передать в NSURL экземпляр. Это также применяется к конкретным подклассам NSURL. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.

Запускаясь в OS X v10.6, CFURL непрозрачный тип предоставляет средство для создания и использования закладок. Закладка обеспечивает персистентную ссылку на ресурс файловой системы. При разрешении закладки Вы получаете URL к текущему расположению ресурса. Связь закладки с ресурсом файловой системы (обычно файл или папка) обычно продолжает работать, если пользователь перемещает или переименовывает ресурс, или если пользователь повторно запускает Ваше приложение или перезапускает систему.

В приложении OS X, принимающем Тестовую среду приложения, для получения персистентного доступа к ресурсу файловой системы, необходимо использовать ограниченную по объему безопасностью закладку. Такие заповедники закладки, через запуски приложения, намерение пользователя дать Ваш доступ к приложениям ресурсу. Для получения дополнительной информации о том, как это работает, включая информацию о правах, в которых Вы нуждаетесь в своем проекте XCode, считайте Ограниченные по объему безопасностью Закладки и Персистентный Доступ Ресурса в Руководстве по проектированию Тестовой среды приложения.

При разрешении ограниченной по объему безопасностью закладки Вы получаете ограниченный по объему безопасностью URL. Ресурс файловой системы, на который указывает URL, не доступен для использования в песочнице Вашего приложения, пока Вы не вызываете CFURLStartAccessingSecurityScopedResource функция (или ее эквивалентное Какао, startAccessingSecurityScopedResource метод) на URL.

Когда Вам больше не нужен доступ к ресурсу, что Вы получили объем безопасности использования (обычно после закрытия ресурса), необходимо вызвать CFURLStopAccessingSecurityScopedResource метод (или его эквивалентное Какао, stopAccessingSecurityScopedResource метод) на URL ресурса.

Функции для использования ограниченных по объему безопасностью закладок описаны в этом документе в Работе с Данными Закладки. Для общего введения в использование закладок в OS X считайте Располагающиеся Файлы Используя Закладки в Руководстве по программированию Файловой системы.

При копировании ограниченного по объему безопасностью URL (как получено из ограниченной по объему безопасностью закладки), копия имеет объем безопасности оригинала. Вы получаете доступ к ресурсу файловой системы (на который URL указывает на), как Вы были бы с исходным URL: путем вызова CFURLStartAccessingSecurityScopedResource функция (или ее эквивалентное Какао).

Если Вам нужен ограниченный по объему безопасностью путь URL’s как строковое значение (в соответствии с CFURLGetString функция), например, для обеспечения для API, требующего строкового значения, получают путь из URL по мере необходимости. Отметьте, однако, что основанный на операция со строками путь, полученный из ограниченного по объему безопасностью URL, не имеет объема безопасности, и Вы не можете использовать ту строку для получения, получают доступ к ограниченному по объему безопасностью ресурсу.

CFURL сбои для создания объекта, если строка передала, не правильно построены (т.е. если она не соответствует RFC 2396). Примерами случаев, которые не успешно выполнятся, являются строки, содержащие пробелы и высоко-разрядные символы. Если функции не удается создать a CFURL объект, это возвращается NULL, который Вы должны быть подготовлены обработать. Если Вы создаете CFURL объекты с помощью путей файловой системы, необходимо использовать CFURLCreateFromFileSystemRepresentation и CFURLCreateFromFileSystemRepresentationRelativeToBase функции, обрабатывающие тонкие различия между путями URL и путями файловой системы.

Для функций, читающих и пишущих данные из URL, посмотрите Базовую Ссылку Утилит Доступа через URL Основы

Функции

  • Создает новое CFURL объект путем разрешения относительной части URL против его основы.

    Объявление

    Swift

    func CFURLCopyAbsoluteURL(_ relativeURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCopyAbsoluteURL ( CFURLRef relativeURL );

    Параметры

    relativeURL

    CFURL возразите для разрешения.

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

    Новое CFURL объект, или NULL если relativeURL не может быть сделан абсолютным. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает новое CFURL объект путем разрешения относительной части URL, указанного как байты, против его данного базового URL.

    Объявление

    Swift

    func CFURLCreateAbsoluteURLWithBytes(_ allocator: CFAllocator!, _ relativeURLBytes: UnsafePointer<UInt8>, _ length: CFIndex, _ encoding: CFStringEncoding, _ baseURL: CFURL!, _ useCompatibilityMode: Boolean) -> CFURL!

    Objective C

    CFURLRef CFURLCreateAbsoluteURLWithBytes ( CFAllocatorRef alloc, const UInt8 *relativeURLBytes, CFIndex length, CFStringEncoding encoding, CFURLRef baseURL, Boolean useCompatibilityMode );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    relativeURLBytes

    Символьные байты, представляющие относительный URL для преобразования в a CFURL объект.

    length

    Число байтов в relativeURLBytes.

    encoding

    Строковое кодирование relativeURLBytes строка. Это кодирование также используется для интерпретации escape-последовательностей процента.

    baseURL

    URL ТО, к который relativeURLBytes относительно.

    useCompatibilityMode

    Если true, правила, исторически используемые в сети, используются для разрешения строки, указанной relativeURLBytes параметр против baseURL. Эти правила обычно перечисляются в RFC как дополнительные или альтернативные интерпретации. Иначе, строгие правила от RFC используются.

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

    Новое CFURL объект, или NULL если relativeURLBytes не может быть сделан абсолютным. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция интерпретирует предоставленные байты с помощью указанного строкового кодирования для создания относительной части адреса URL’s.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLCreateByResolvingBookmarkData(_ allocator: CFAllocator!, _ bookmark: CFData!, _ options: CFURLBookmarkResolutionOptions, _ relativeToURL: CFURL!, _ resourcePropertiesToInclude: CFArray!, _ isStale: UnsafeMutablePointer<Boolean>, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFURL>!

    Objective C

    CFURLRef CFURLCreateByResolvingBookmarkData ( CFAllocatorRef allocator, CFDataRef bookmark, CFURLBookmarkResolutionOptions options, CFURLRef relativeToURL, CFArrayRef resourcePropertiesToInclude, Boolean *isStale, CFErrorRef *error );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    bookmark

    Данные закладки URL получены из.

    options

    Опции, принятые во внимание при разрешении данных закладки.

    Для разрешения ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения необходимо включать (посредством поразрядно OR операторы с любыми другими опциями в этом параметре) kCFURLBookmarkResolutionWithSecurityScope опция.

    relativeToURL

    Базовый URL, относительно которого данные закладки. Может быть NULL.

    При разрешении ограниченной по объему безопасностью закладки для получения ограниченного по объему безопасностью URL, используйте этот параметр следующим образом:

    • Для разрешения ограниченной по объему приложением закладки используйте значение nil.

    • Для разрешения ограниченной по объему документом закладки используйте абсолютный путь (несмотря на имя этого параметра) к документу, из которого Вы получили закладку.

    resourcePropertiesToInclude

    Массив свойств ресурса для включения при создании URL. Может быть NULL.

    isStale

    Если YEStrue, данные закладки являются устаревшими.

    error

    Ошибка, произошедшая в случае, что не может быть создан URL.

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

    Новый URL сделан путем разрешения bookmark, или NULL если происходит ошибка.

    Обсуждение

    Для получения ограниченного по объему безопасностью URL из ограниченной по объему безопасностью закладки вызовите этот метод с помощью kCFURLBookmarkResolutionWithSecurityScope опция. Кроме того, для использования объема безопасности Вы, должно быть, сначала включили надлежащие права для своего приложения, как описано во Включении Ограниченной по объему безопасностью Закладки и Доступа через URL.

    Тогда получить доступ к ресурсу файловой системы, на который указывает ограниченный по объему безопасностью URL (другими словами, принести ресурс в песочницу Вашего приложения), вызов CFURLStartAccessingSecurityScopedResource функция (или ее эквивалентное Какао) на URL.

    Для ограниченной по объему приложением закладки никакое поигравшее в песочнице приложение кроме того, создавшего закладку, не может получить доступ к ресурсу файловой системы, на который указывает URL (полученный из закладки).

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFURLCreateBookmarkData

  • Создает копию данного URL и добавляет компонент контура.

    Объявление

    Swift

    func CFURLCreateCopyAppendingPathComponent(_ allocator: CFAllocator!, _ url: CFURL!, _ pathComponent: CFString!, _ isDirectory: Boolean) -> CFURL!

    Objective C

    CFURLRef CFURLCreateCopyAppendingPathComponent ( CFAllocatorRef allocator, CFURLRef url, CFStringRef pathComponent, Boolean isDirectory );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    CFURL возразите, к которому можно добавить компонент контура.

    pathComponent

    Компонент контура для добавления к url.

    isDirectory

    Булево значение, указывающее, обрабатывается ли строка как путь к каталогу при разрешении против компонентов относительного пути. Передача true если новый компонент указывает каталог, false иначе.

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

    Копия url добавленный с pathComponent. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    isDirectory параметр указывает, указывает ли новый компонент контура на файл или к каталогу. Обратите внимание на то, что синтаксис URL для каталога и для файла в иначе том же расположении немного отличается — каталог URLs должен закончиться в «/». Если у Вас есть URL http://www.apple.com/foo/ и Вы добавляете компонент контура bar, тогда, если isDirectory YEStrue тогда получающийся URL http://www.apple.com/foo/bar/, тогда как, если isDirectory NOfalse тогда получающийся URL http://www.apple.com/foo/bar. Это различие особенно важно при разрешении другого URL против этого нового URL. file.html относительно http://www.apple.com/foo/bar http://www.apple.com/foo/file.html, тогда как file.html относительно http://www.apple.com/foo/bar/ http://www.apple.com/foo/bar/file.html.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает копию данного URL и добавляет расширение пути.

    Объявление

    Swift

    func CFURLCreateCopyAppendingPathExtension(_ allocator: CFAllocator!, _ url: CFURL!, _ `extension`: CFString!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateCopyAppendingPathExtension ( CFAllocatorRef allocator, CFURLRef url, CFStringRef extension );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    CFURL возразите, которого можно добавить расширение пути.

    extension

    Расширение для добавления к url.

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

    Копия url добавленный с extension. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает копию данного URL с последним удаленным компонентом контура.

    Объявление

    Swift

    func CFURLCreateCopyDeletingLastPathComponent(_ allocator: CFAllocator!, _ url: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateCopyDeletingLastPathComponent ( CFAllocatorRef allocator, CFURLRef url );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    CFURL возразите, чей последний компонент контура Вы хотите удалить.

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

    Копия url с последним удаленным компонентом контура. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает копию данного URL с его последним удаленным расширением пути.

    Объявление

    Swift

    func CFURLCreateCopyDeletingPathExtension(_ allocator: CFAllocator!, _ url: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateCopyDeletingPathExtension ( CFAllocatorRef allocator, CFURLRef url );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    CFURL возразите, чье расширение пути Вы хотите удалить.

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

    Копия url с его последним удаленным расширением пути. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLCreateFilePathURL(_ allocator: CFAllocator!, _ url: CFURL!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFURL>!

    Objective C

    CFURLRef CFURLCreateFilePathURL ( CFAllocatorRef allocator, CFURLRef url, CFErrorRef *error );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    URL.

    error

    Ошибка, произошедшая, если не мог бы быть создан URL.

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

    Новый путь к файлу URL, или NULL если происходит ошибка

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает новую ссылку на файл URL, указывающий на тот же ресурс как указанный URL.

    Объявление

    Swift

    func CFURLCreateFileReferenceURL(_ allocator: CFAllocator!, _ url: CFURL!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFURL>!

    Objective C

    CFURLRef CFURLCreateFileReferenceURL ( CFAllocatorRef allocator, CFURLRef url, CFErrorRef *error );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    URL.

    error

    Ошибка, произошедшая, если не мог бы быть создан URL.

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

    Новая ссылка на файл URL, или NULL если происходит ошибка.

    Обсуждение

    URLs ссылки на файл использует синтаксис пути URL, идентифицирующий объект файловой системы ссылкой, не путем. Эта форма файла, URL остается допустимым, когда изменяется путь файловой системы URL’s, лежащего в основе ресурса.

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

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

    В некоторых областях иерархии файловой системы ссылка на файл URLs не может быть сгенерирован к вершине пути URL.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает новое CFURL объект для объекта файловой системы с помощью собственного представления.

    Объявление

    Swift

    func CFURLCreateFromFileSystemRepresentation(_ allocator: CFAllocator!, _ buffer: UnsafePointer<UInt8>, _ bufLen: CFIndex, _ isDirectory: Boolean) -> CFURL!

    Objective C

    CFURLRef CFURLCreateFromFileSystemRepresentation ( CFAllocatorRef allocator, const UInt8 *buffer, CFIndex bufLen, Boolean isDirectory );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    buffer

    Символьные байты для преобразования в a CFURL объект. Это должно быть путем, поскольку Вы использовали бы в вызовах функции POSIX.

    bufLen

    Число символьных байтов в буфере (обычно результат вызова к strlen(3) Mac OS X Developer Tools Manual Page), не включая любое нулевое завершение.

    isDirectory

    Булево значение, указывающее, обрабатывается ли строка как путь к каталогу при разрешении против компонентов относительного пути —true если путь указывает каталог, false иначе.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает a CFURL объект от собственной символьной строки соединяет каналом относительно базового URL.

    Объявление

    Swift

    func CFURLCreateFromFileSystemRepresentationRelativeToBase(_ allocator: CFAllocator!, _ buffer: UnsafePointer<UInt8>, _ bufLen: CFIndex, _ isDirectory: Boolean, _ baseURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateFromFileSystemRepresentationRelativeToBase ( CFAllocatorRef allocator, const UInt8 *buffer, CFIndex bufLen, Boolean isDirectory, CFURLRef baseURL );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    buffer

    Символьные байты для преобразования в a CFURL объект. Это должно быть путем, поскольку Вы использовали бы в вызовах функции POSIX.

    bufLen

    Число байтов в буфере.

    isDirectory

    Булево значение, указывающее, обрабатывается ли строка как путь к каталогу при разрешении против компонентов относительного пути. Передача true если путь указывает каталог, false иначе.

    baseURL

    URL, против которого можно разрешить путь.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция берет путь в форме собственной символьной строки, разрешает его против базового URL и возвращает новое CFURL объект, содержащий результат.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает URL из данного каталога или файла.

    Объявление

    Objective C

    CFURLRef CFURLCreateFromFSRef ( CFAllocatorRef allocator, const struct FSRef *fsRef );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    fsRef

    Файл или каталог, представляющий URL.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

  • Создает a CFURL объект с помощью данного символьные байты.

    Объявление

    Swift

    func CFURLCreateWithBytes(_ allocator: CFAllocator!, _ URLBytes: UnsafePointer<UInt8>, _ length: CFIndex, _ encoding: CFStringEncoding, _ baseURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateWithBytes ( CFAllocatorRef allocator, const UInt8 *URLBytes, CFIndex length, CFStringEncoding encoding, CFURLRef baseURL );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    URLBytes

    Символьные байты для преобразования в a CFURL объект.

    length

    Число байтов в URLBytes.

    encoding

    Строковое кодирование URLBytes строка. Это кодирование также используется для интерпретации escape-последовательностей процента.

    baseURL

    URL ТО, к который URLBytes относительно. Передача NULL если URLBytes если Вы хотите создать относительный URL, содержит абсолютный URL или. Если URLBytes содержит абсолютный URL, этот параметр проигнорирован.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Указанное строковое кодирование будет использоваться оба для интерпретации URLBytes, и интерпретировать любые Escape процента в строке.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает a CFURL объект с помощью локальной файловой системы соединяет строку каналом.

    Объявление

    Swift

    func CFURLCreateWithFileSystemPath(_ allocator: CFAllocator!, _ filePath: CFString!, _ pathStyle: CFURLPathStyle, _ isDirectory: Boolean) -> CFURL!

    Objective C

    CFURLRef CFURLCreateWithFileSystemPath ( CFAllocatorRef allocator, CFStringRef filePath, CFURLPathStyle pathStyle, Boolean isDirectory );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    filePath

    Строка пути для преобразования в a CFURL объект.

    pathStyle

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

    isDirectory

    Булево значение, указывающее ли filePath обрабатывается как путь к каталогу при разрешении против компонентов относительного пути. Передача true если путь указывает каталог, false иначе.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает a CFURL объект с помощью локальной файловой системы соединяет строку каналом относительно базового URL.

    Объявление

    Swift

    func CFURLCreateWithFileSystemPathRelativeToBase(_ allocator: CFAllocator!, _ filePath: CFString!, _ pathStyle: CFURLPathStyle, _ isDirectory: Boolean, _ baseURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateWithFileSystemPathRelativeToBase ( CFAllocatorRef allocator, CFStringRef filePath, CFURLPathStyle pathStyle, Boolean isDirectory, CFURLRef baseURL );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    filePath

    Строка пути для преобразования в a CFURL объект.

    pathStyle

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

    isDirectory

    Булево значение, указывающее ли filePath обрабатывается как путь к каталогу при разрешении против компонентов относительного пути. Передача true если путь указывает каталог, false иначе.

    baseURL

    Базовый URL, против которого можно решить filePath.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция берет путь в форме a CFString объект, разрешает его против базового URL и возвращает новое CFURL объект, содержащий результат.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает a CFURL объект с помощью данного CFString объект.

    Объявление

    Swift

    func CFURLCreateWithString(_ allocator: CFAllocator!, _ URLString: CFString!, _ baseURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLCreateWithString ( CFAllocatorRef allocator, CFStringRef URLString, CFURLRef baseURL );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    URLString

    CFString объект, содержащий строку URL.

    baseURL

    URL ТО, к который URLString относительно. Передача NULL если URLString если Вы хотите создать относительный URL, содержит абсолютный URL или. Если URLString содержит абсолютный URL, baseURL проигнорирован.

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

    Новое CFURL объект. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Любые escape-последовательности в URLString будет интерпретироваться с помощью UTF-8.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Определяет, приспосабливает ли данный URL RFC 1808 и поэтому может анализироваться.

    Объявление

    Swift

    func CFURLCanBeDecomposed(_ anURL: CFURL!) -> Boolean

    Objective C

    Boolean CFURLCanBeDecomposed ( CFURLRef anURL );

    Параметры

    anURL

    CFURL возразите для тестирования.

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

    true если anURL приспосабливает RFC 1808, false иначе.

    Обсуждение

    Если a CFURL объект может анализироваться, можно получить отдельно каждый из этих четырех компонентов (схема, сетевое расположение, путь и спецификатор ресурса), а также базовый URL.

    Относительному URLs разрешают иметь только пути (или множество других конфигураций); если их базовый URL является разложимым, их считают разложимыми. Если никакой базовый URL не присутствует, их считают разложимыми.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает часть пути данного URL.

    Объявление

    Swift

    func CFURLCopyFileSystemPath(_ anURL: CFURL!, _ pathStyle: CFURLPathStyle) -> CFString!

    Objective C

    CFStringRef CFURLCopyFileSystemPath ( CFURLRef anURL, CFURLPathStyle pathStyle );

    Параметры

    anURL

    CFURL возразите, чей путь Вы хотите получить.

    pathStyle

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

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

    URL's соединяет каналом в формате, указанном pathStyle. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает фрагмент из данного URL.

    Объявление

    Swift

    func CFURLCopyFragment(_ anURL: CFURL!, _ charactersToLeaveEscaped: CFString!) -> CFString!

    Objective C

    CFStringRef CFURLCopyFragment ( CFURLRef anURL, CFStringRef charactersToLeaveEscaped );

    Параметры

    anURL

    CFURL возразите, чей фрагмент Вы хотите получить.

    charactersToLeaveEscaped

    Символы, чьи escape-последовательности процента, такой как %20 для пробела Вы хотите оставить неповрежденным. Передача NULL указать, что никакой процент не выходит быть замененным, или пустая строка (CFSTR("")) указать что все быть замененным.

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

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

    Обсуждение

    Фрагмент является текстом после «#». Они обычно используются для указания расположений в единственном файле. Эта функция удаляет все escape-последовательности процента кроме тех для символов, указанных в charactersToLeaveEscaped.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает имя хоста данного URL.

    Объявление

    Swift

    func CFURLCopyHostName(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyHostName ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Имя хоста anURL. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLCopyLastPathComponent(_ url: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyLastPathComponent ( CFURLRef url );

    Параметры

    url

    CFURL объект исследовать.

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

    Последний компонент контура url. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Обратите внимание на то, что, если существует никакой последний компонент контура, эта функция возвращает пустую строку. В примере кода, показанном в Перечислении 1, lastPathComponent пустая строка.

    Выборка перечисления 1Code иллюстрирование CFURLCopyLastPathComponent
    • CFStringRef urlString = CFSTR("http://www.apple.com");
    • CFURLRef url = CFURLCreateWithString(NULL, urlString, NULL);
    • CFStringRef lastPathComponent = CFURLCopyLastPathComponent (url);

    Если urlString создавались с CFSTR("http://www.apple.com/"), тогда lastPathComponent был бы a CFString объект, содержащий символ “/“.

    См. также CFURLCopyPathExtension.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает сетевую часть расположения данного URL.

    Объявление

    Swift

    func CFURLCopyNetLocation(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyNetLocation ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Сетевое расположение anURL, или NULL если URL не может анализироваться (не приспосабливает RFC 1808). Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

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

    Эта функция оставляет любые escape-последовательности процента неповрежденными.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает строку параметров из данного URL.

    Объявление

    Swift

    func CFURLCopyParameterString(_ anURL: CFURL!, _ charactersToLeaveEscaped: CFString!) -> CFString!

    Objective C

    CFStringRef CFURLCopyParameterString ( CFURLRef anURL, CFStringRef charactersToLeaveEscaped );

    Параметры

    anURL

    CFURL объект исследовать.

    charactersToLeaveEscaped

    Символы, чьи escape-последовательности процента, такой как %20 для пробела Вы хотите оставить неповрежденным. Передача NULL указать, что никакой процент не выходит быть замененным, или пустая строка (CFSTR("")) указать что все быть замененным.

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

    Строка параметров (как определено в RFC 1738), или NULL если не существует никакая строка параметров. Например, в URL myproto://www.example.com/;command=laugh, строка параметров command=laugh. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция удаляет все escape-последовательности процента кроме тех для символов, указанных в charactersToLeaveEscaped.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает пароль данного URL.

    Объявление

    Swift

    func CFURLCopyPassword(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyPassword ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Пароль, или NULL если не существует никакой пароль. В некоторых случаях эта функция может также возвратить пустую строку (CFSTR("")) если не существует никакой пароль. Необходимо рассмотреть NULL и пустая строка для эквивалента. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает часть пути данного URL.

    Объявление

    Swift

    func CFURLCopyPath(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyPath ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Путь anURL, или NULL если URL не может анализироваться (не приспосабливает RFC 1808). Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция не разрешает URL против своей основы, и при этом она не заменяет escape-последовательности процента. Возвращаемое значение этой функции включает любую ведущую наклонную черту (предоставление пути нормальное появление POSIX), если существующий. Если это поведение не является надлежащим, использовать CFURLCopyStrictPath чье возвращаемое значение опускает любую ведущую наклонную черту. Можно также хотеть использовать функцию CFURLCopyFileSystemPath, который возвращает путь URL's как путь файловой системы для данного стиля пути. Если путь должен быть передан вызовам файловой системы, можно также хотеть использовать функцию CFURLGetFileSystemRepresentation, который возвращает струну до.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает расширение пути данного URL.

    Объявление

    Swift

    func CFURLCopyPathExtension(_ url: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyPathExtension ( CFURLRef url );

    Параметры

    url

    CFURL объект исследовать.

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

    Расширение пути url, или NULL если не существует никакое расширение. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Расширение пути является частью последнего компонента контура, следующего за заключительным периодом, если существует тот. Например, для http:/www.apple.com/developer/macosx.today.html, расширение html, и для http:/www.apple.com/developer, нет никакого расширения пути.

    См. также CFURLCopyLastPathComponent.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает строку запроса данного URL.

    Объявление

    Swift

    func CFURLCopyQueryString(_ anURL: CFURL!, _ charactersToLeaveEscaped: CFString!) -> CFString!

    Objective C

    CFStringRef CFURLCopyQueryString ( CFURLRef anURL, CFStringRef charactersToLeaveEscaped );

    Параметры

    anURL

    CFURL объект исследовать.

    charactersToLeaveEscaped

    Символы, чьи escape-последовательности процента, такой как %20 для пробела Вы хотите оставить неповрежденным. Передача NULL указать, что никакой процент не выходит быть замененным, или пустая строка (CFSTR("")) указать что все быть замененным.

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

    Строка запроса, или NULL если не существует никакая строка параметров. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция удаляет все escape-последовательности процента кроме тех для символов, указанных в charactersToLeaveEscaped.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвраты любые дополнительные спецификаторы ресурса после пути.

    Объявление

    Swift

    func CFURLCopyResourceSpecifier(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyResourceSpecifier ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Спецификаторы ресурса. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает часть схемы данного URL.

    Объявление

    Swift

    func CFURLCopyScheme(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyScheme ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Схема anURL. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Схема URL является частью URL, указывающего тип передачи. Например, http, ftp, и rtsp схемы. Эта функция оставляет любые escape-последовательности процента неповрежденными.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает часть пути данного URL.

    Объявление

    Swift

    func CFURLCopyStrictPath(_ anURL: CFURL!, _ isAbsolute: UnsafeMutablePointer<Boolean>) -> CFString!

    Objective C

    CFStringRef CFURLCopyStrictPath ( CFURLRef anURL, Boolean *isAbsolute );

    Параметры

    anURL

    CFURL объект исследовать.

    isAbsolute

    По возврату, указывает ли путь anURL является абсолютным.

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

    Путь anURL, или NULL если URL не может анализироваться (не приспосабливает RFC 1808). Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция не разрешает URL против своей основы, и при этом она не заменяет escape-последовательности процента. Возвращаемое значение этой функции не включает ведущую наклонную черту и использование isAbsolute сообщить, является ли путь URL's абсолютным. Если это поведение не является надлежащим, используйте CFURLCopyPath функционируйте, чье возвращаемое значение включает ведущую наклонную черту (предоставление пути нормальное появление POSIX). Можно также хотеть использовать CFURLCopyFileSystemPath функция, возвращающая путь URL's как путь файловой системы для данного стиля пути. Если путь должен быть передан вызовам файловой системы, можно также хотеть использовать функцию CFURLGetFileSystemRepresentation, который возвращает струну до.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает имя пользователя из данного URL.

    Объявление

    Swift

    func CFURLCopyUserName(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLCopyUserName ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Имя пользователя, или NULL если не существует никакое имя пользователя. В некоторых случаях эта функция может также возвратить пустую строку (CFSTR("")) если не существует никакое имя пользователя. Необходимо рассмотреть NULL и пустая строка для эквивалента. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает номер порта из данного URL.

    Объявление

    Swift

    func CFURLGetPortNumber(_ anURL: CFURL!) -> Int32

    Objective C

    SInt32 CFURLGetPortNumber ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    Номер порта anURL, или -1 если не существует никакой номер порта.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Определяет, представляет ли данный путь URL's каталог.

    Объявление

    Swift

    func CFURLHasDirectoryPath(_ anURL: CFURL!) -> Boolean

    Objective C

    Boolean CFURLHasDirectoryPath ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    true если anURL представляет каталог, false иначе.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает a CFData объект, содержащий содержание данного URL.

    Объявление

    Swift

    func CFURLCreateData(_ allocator: CFAllocator!, _ url: CFURL!, _ encoding: CFStringEncoding, _ escapeWhitespace: Boolean) -> CFData!

    Objective C

    CFDataRef CFURLCreateData ( CFAllocatorRef allocator, CFURLRef url, CFStringEncoding encoding, Boolean escapeWhitespace );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFData объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    URL для преобразования в a CFData объект.

    encoding

    Строковое кодирование для использования при преобразовании url в a CFData объект.

    escapeWhitespace

    true если Вы хотите выйти из пробельных символов в URL, false иначе.

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

    Новое CFData объект, содержащий содержание url. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Эта функция выходит из любого символа, который не является 7-разрядным ASCII с байт-кодом для данного кодирования. Если escapeWhitespace true, пробельных символов ('', '\t', '\r', '\n') оставят также. Если Вы хотите встроить URL в более крупный текстовый поток как HTML, это желательно.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает копию строки, заменяя определенные символы эквивалентной escape-последовательностью процента на основе указанного кодирования.

    Объявление

    Swift

    func CFURLCreateStringByAddingPercentEscapes(_ allocator: CFAllocator!, _ originalString: CFString!, _ charactersToLeaveUnescaped: CFString!, _ legalURLCharactersToBeEscaped: CFString!, _ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFURLCreateStringByAddingPercentEscapes ( CFAllocatorRef allocator, CFStringRef originalString, CFStringRef charactersToLeaveUnescaped, CFStringRef legalURLCharactersToBeEscaped, CFStringEncoding encoding );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFString объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    originalString

    CFString возразите для копирования.

    charactersToLeaveUnescaped

    Символы, escape-последовательности процента которых Вы хотите оставить неповрежденным. Передача NULL указать что все запрещенные символы быть оставленным.

    legalURLCharactersToBeEscaped

    Допустимые символы, которых оставят. Передача NULL указать что никакие допустимые символы быть замененным.

    encoding

    Кодирование для использования для перевода. Если Вы не уверены из корректного кодирования, необходимо использовать UTF-8 (kCFStringEncodingUTF8), который является кодированием, определяемым RFC 3986 как корректное кодирование для использования в URLs.

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

    Копия originalString замена определенных символов. Если это не должно быть изменено (никакие escape-последовательности процента не отсутствуют), эта функция может просто возвратиться originalString с его постепенно увеличенным подсчетом ссылок. Владение соблюдает создать правило. См. Создать Правило.

    Обсуждение

    Символы, которых оставляют, являются всеми символами, которые не являются юридическими символами URL (на основе RFC 3986) плюс никакие символы в legalURLCharactersToBeEscaped, меньше любых символов в charactersToLeaveUnescaped. Просто исправлять любые символы не-URL в иначе корректной строке URL, передаче NULL для allocator, charactersToLeaveEscaped, и legalURLCharactersToBeEscaped параметры, и kCFStringEncodingUTF8 как encoding параметр.

    Может быть трудно использовать эту функцию для «очищения» незавершенных или частично завершенных строк URL, где последовательности непредсказуемы, и Вы не можете указать charactersToLeaveUnescaped. Вместо этого можно «предварительно обработать» строковое использование URL, CFURLCreateStringByReplacingPercentEscapesUsingEncoding тогда добавляют использование символов ESC CFURLCreateStringByAddingPercentEscapes, как показано в следующем фрагменте кода.

    • CFStringRef originalURLString = CFSTR("http://online.store.com/storefront/?request=get-document&doi=10.1175%2F1520-0426(2005)014%3C1157:DODADSS%3E2.0.CO%3B2");
    • CFStringRef preprocessedString =
    •     CFURLCreateStringByReplacingPercentEscapesUsingEncoding(kCFAllocatorDefault, originalURLString, CFSTR(""), kCFStringEncodingUTF8);
    • CFStringRef urlString =
    •     CFURLCreateStringByAddingPercentEscapes(kCFAllocatorDefault, preprocessedString, NULL, NULL, kCFStringEncodingUTF8);
    • url = CFURLCreateWithString(kCFAllocatorDefault, urlString, NULL);

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает новую строку путем замены любых escape-последовательностей процента их эквивалентом символов.

    Объявление

    Swift

    func CFURLCreateStringByReplacingPercentEscapes(_ allocator: CFAllocator!, _ originalString: CFString!, _ charactersToLeaveEscaped: CFString!) -> CFString!

    Objective C

    CFStringRef CFURLCreateStringByReplacingPercentEscapes ( CFAllocatorRef allocator, CFStringRef originalString, CFStringRef charactersToLeaveEscaped );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFString объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    originalString

    CFString объект, который будет скопирован и изменен.

    charactersToLeaveEscaped

    Символы, чьи escape-последовательности процента, такой как %20 для пробела Вы хотите оставить неповрежденным. Передача NULL указать, что никакой процент не выходит быть замененным, или пустая строка (CFSTR("")) указать что все быть замененным.

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

    Новое CFString объект, или NULL если Escape процента не могут быть преобразованы в символы, приняв кодирование UTF-8. Если никакие символы не должны быть заменены, эта функция возвращает исходную строку со своим постепенно увеличенным подсчетом ссылок. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает новую строку путем замены любых escape-последовательностей процента их эквивалентом символов.

    Объявление

    Swift

    func CFURLCreateStringByReplacingPercentEscapesUsingEncoding(_ allocator: CFAllocator!, _ originalString: CFString!, _ charactersToLeaveEscaped: CFString!, _ encoding: CFStringEncoding) -> CFString!

    Objective C

    CFStringRef CFURLCreateStringByReplacingPercentEscapesUsingEncoding ( CFAllocatorRef allocator, CFStringRef origString, CFStringRef charsToLeaveEscaped, CFStringEncoding encoding );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFString объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    originalString

    CFString объект, который будет скопирован и изменен.

    charactersToLeaveEscaped

    Символы, чьи escape-последовательности процента, такой как %20 для пробела Вы хотите оставить неповрежденным. Передача NULL указать, что никакой процент не выходит быть замененным, или пустая строка (CFSTR("")) указать что все быть замененным.

    encoding

    Указывает кодирование для использования при интерпретации Escape процента. Если Вы не уверены из корректного кодирования, необходимо использовать UTF-8 (kCFStringEncodingUTF8), который является кодированием, определяемым RFC 3986 как корректное кодирование для использования в URLs.

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

    Новое CFString объект, или NULL если Escape процента не могут быть преобразованы в символы, приняв кодирование, данное encoding. Если никакие символы не должны быть заменены, эта функция возвращает исходную строку со своим постепенно увеличенным подсчетом ссылок. Владение соблюдает создать правило. См. Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Заполняет буфер собственным строковым представлением файловой системы данного пути URL's.

    Объявление

    Swift

    func CFURLGetFileSystemRepresentation(_ url: CFURL!, _ resolveAgainstBase: Boolean, _ buffer: UnsafeMutablePointer<UInt8>, _ maxBufLen: CFIndex) -> Boolean

    Objective C

    Boolean CFURLGetFileSystemRepresentation ( CFURLRef url, Boolean resolveAgainstBase, UInt8 *buffer, CFIndex maxBufLen );

    Параметры

    url

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

    resolveAgainstBase

    Передача true возвратить абсолютный путь.

    buffer

    Указатель на символьный буфер. По возврату буфер содержит представление собственной файловой системы url. Буфер завершается нулем. Этот параметр должен быть, по крайней мере, maxBufLen в размере для рассматриваемой файловой системы для предотвращения отказов для недостаточно больших буферов.

    maxBufLen

    Максимальное количество символов, которые могут быть записаны в buffer.

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

    true в случае успеха, false если произошла ошибка.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFURLGetFSRef (iOS 7.0)

    Преобразовывает данный URL в объект файла или каталога.

    Объявление

    Objective C

    Boolean CFURLGetFSRef ( CFURLRef url, struct FSRef *fsRef );

    Параметры

    url

    CFURL возразите для преобразования в объект файла или каталога.

    fsRef

    По возврату, содержит представление объекта файла или каталога url.

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

    true если преобразование было успешно, иначе false.

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

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

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

  • Возвращает URL как a CFString объект.

    Объявление

    Swift

    func CFURLGetString(_ anURL: CFURL!) -> CFString!

    Objective C

    CFStringRef CFURLGetString ( CFURLRef anURL );

    Параметры

    anURL

    CFURL возразите для преобразования в a CFString объект.

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

    Строковое представление anURL. Владение соблюдает получить правило. См. Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает базовый URL данного URL, если он существует.

    Объявление

    Swift

    func CFURLGetBaseURL(_ anURL: CFURL!) -> CFURL!

    Objective C

    CFURLRef CFURLGetBaseURL ( CFURLRef anURL );

    Параметры

    anURL

    CFURL объект исследовать.

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

    A CFURL объект, представляющий базовый URL anURL. Владение соблюдает получить правило. См. Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвраты ссылкой представление байта объекта URL.

    Объявление

    Swift

    func CFURLGetBytes(_ anURL: CFURL!, _ buffer: UnsafeMutablePointer<UInt8>, _ bufferLength: CFIndex) -> CFIndex

    Objective C

    CFIndex CFURLGetBytes ( CFURLRef url, UInt8 *buffer, CFIndex bufferLength );

    Параметры

    anURL

    URL возражает для преобразования в представление байта.

    buffer

    Буфер, где Вы хотите, чтобы были помещены байты. Если буфер имеет недостаточный размер, возвраты -1 и никакие байты не помещаются в буфер. Если NULL необходимая длина вычислена и возвращена. Возвращенные байты являются исходными байтами, из которых URL создавался (не включая базовый URL). Если URL создавался из строки, байты являются байтами строки, закодированной через UTF-8.

    bufferLength

    Число байтов в buffer.

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

    Возвращает число байтов в buffer это было заполнено. Если буфер имеет недостаточный размер, возвраты -1.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает диапазон указанного компонента в байтах URL.

    Объявление

    Swift

    func CFURLGetByteRangeForComponent(_ anURL: CFURL!, _ component: CFURLComponentType, _ rangeIncludingSeparators: UnsafeMutablePointer<CFRange>) -> CFRange

    Objective C

    CFRange CFURLGetByteRangeForComponent ( CFURLRef url, CFURLComponentType component, CFRange *rangeIncludingSeparators );

    Параметры

    anURL

    URL, содержащий component.

    component

    Тип компонента в anURL чей диапазон Вы хотите получить. Посмотрите Тип Компонента для возможных значений.

    rangeIncludingSeparators

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

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

    Диапазон байтов для component в буфере, возвращенном CFURLGetBytes функция. Если anURL не содержит component, первая часть возвращенного диапазона установлена в kCFNotFound.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает идентификатор типа для CFURL непрозрачный тип.

    Объявление

    Swift

    func CFURLGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CFURLGetTypeID ( void );

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

    Идентификатор типа для CFURL непрозрачный тип.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвраты, может ли быть достигнут ресурс, на который указывает файл URL.

    Объявление

    Swift

    func CFURLResourceIsReachable(_ url: CFURL!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFURLResourceIsReachable ( CFURLRef url, CFErrorRef *error );

    Параметры

    url

    URL для проверки.

    error

    Ошибка, произошедшая, когда не мог быть достигнут ресурс.

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

    true если ресурс достижим; иначе, false.

    Обсуждение

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

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Удаляет все кэшируемые значения ресурса и временные значения ресурса от объекта URL.

    Объявление

    Swift

    func CFURLClearResourcePropertyCache(_ url: CFURL!)

    Objective C

    void CFURLClearResourcePropertyCache ( CFURLRef url );

    Параметры

    url

    URL.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Удаляет кэшируемое значение ресурса, идентифицированное данным ключом от объекта URL.

    Объявление

    Swift

    func CFURLClearResourcePropertyCacheForKey(_ url: CFURL!, _ key: CFString!)

    Objective C

    void CFURLClearResourcePropertyCacheForKey ( CFURLRef url, CFStringRef key );

    Параметры

    url

    URL.

    key

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

    Обсуждение

    Удаление кэшируемого значения ресурса может удалить другие кэшируемые значения ресурса, потому что некоторые значения ресурса кэшируются как ряд значений, и потому что некоторые значения ресурса зависят от других значений ресурса. (Временные значения ресурса не имеют никаких зависимостей.)

    Этот метод в настоящее время применим только к URLs для ресурсов файловой системы.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLCopyResourcePropertiesForKeys(_ url: CFURL!, _ keys: CFArray!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef CFURLCopyResourcePropertiesForKeys ( CFURLRef url, CFArrayRef keys, CFErrorRef *error );

    Параметры

    url

    URL.

    keys

    Массив ключей свойства для желаемых свойств ресурса.

    error

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

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

    Словарь значений ресурса, индексированных ключом, или NULL если происходит ошибка.

    Обсуждение

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

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

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

    Если ошибка происходит, эта функция возвраты NULL и заполняет объектный указатель, на который ссылаются error с дополнительной информацией.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFURLSetResourcePropertiesForKeys
    “Common File System Resource Keys”
    “File Property Keys”
    “Ubiquitous Item Property Keys”
    “Volume Property Keys”

  • Возвращает значение данного свойства ресурса данного URL.

    Объявление

    Swift

    func CFURLCopyResourcePropertyForKey(_ url: CFURL!, _ key: CFString!, _ propertyValueTypeRefPtr: UnsafeMutablePointer<Void>, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFURLCopyResourcePropertyForKey ( CFURLRef url, CFStringRef key, void *propertyValueTypeRefPtr, CFErrorRef *error );

    Параметры

    url

    URL.

    key

    Ключ значения свойства для требуемого значения.

    propertyValueTypeRefPtr

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

    error

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

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

    true если propertyValueTypeRefPtr успешно заполняется; иначе, false.

    Обсуждение

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

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

    Если возвращается эта функция YEStrue и propertyValueTypeRefPtr заполняется с nil, это означает, что свойство ресурса не доступно для указанного ресурса, и что никакие ошибки не произошли при решении, что свойство ресурса было недоступно.

    Если возвращается эта функция NOfalse, ошибка произошла. объектный указатель, на который ссылаются error заполняется с дополнительной информацией.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 5.0 и позже. Несмотря на то, что этот символ существовал в предыдущих версиях iOS, он ничего не делал.

    См. также

    CFURLSetResourcePropertyForKey
    “Common File System Resource Keys”
    “File Property Keys”
    “Ubiquitous Item Property Keys”
    “Volume Property Keys”

  • Возвращает значения ресурса для свойств, идентифицированных указанным массивом ключей, содержавшихся в указанных данных закладки.

    Объявление

    Swift

    func CFURLCreateResourcePropertiesForKeysFromBookmarkData(_ allocator: CFAllocator!, _ resourcePropertiesToReturn: CFArray!, _ bookmark: CFData!) -> Unmanaged<CFDictionary>!

    Objective C

    CFDictionaryRef CFURLCreateResourcePropertiesForKeysFromBookmarkData ( CFAllocatorRef allocator, CFArrayRef resourcePropertiesToReturn, CFDataRef bookmark );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    resourcePropertiesToReturn

    Массив имен свойств ресурса URL. Посмотрите Ключи Системного ресурса Общего файла для списка возможных ключей.

    bookmark

    Данные закладки значения ресурса получены из.

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

    Словарь требуемых значений ресурса, содержавшихся в bookmarkData.

    Обсуждение

    Эта функция не пытается разрешить данные закладки или выполнить I/O.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Возвращает значение свойства ресурса от указанных данных закладки.

    Объявление

    Swift

    func CFURLCreateResourcePropertyForKeyFromBookmarkData(_ allocator: CFAllocator!, _ resourcePropertyKey: CFString!, _ bookmark: CFData!) -> Unmanaged<AnyObject>!

    Objective C

    CFTypeRef CFURLCreateResourcePropertyForKeyFromBookmarkData ( CFAllocatorRef allocator, CFStringRef resourcePropertyKey, CFDataRef bookmark );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    resourcePropertyKey

    Ключ свойства ресурса. Посмотрите Ключи Системного ресурса Общего файла для списка возможных ключей.

    bookmark

    Данные закладки значение ресурса получены из.

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

    Значение свойства ресурса.

    Обсуждение

    Эта функция не пытается разрешить данные закладки или выполнить I/O.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Устанавливает свойства ресурса URL’s для данного набора ключей к данному набору значений.

    Объявление

    Swift

    func CFURLSetResourcePropertiesForKeys(_ url: CFURL!, _ keyedPropertyValues: CFDictionary!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFURLSetResourcePropertiesForKeys ( CFURLRef url, CFDictionaryRef keyedPropertyValues, CFErrorRef *error );

    Параметры

    url

    URL.

    keyedPropertyValues

    Словарь ресурса оценивает, чтобы быть установленным.

    error

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

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

    true если весь ресурс оценивает в keyedValues успешно установлены; иначе, false.

    Обсуждение

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

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFURLCopyResourcePropertiesForKeys
    “Common File System Resource Keys”
    “File Property Keys”
    “Ubiquitous Item Property Keys”
    “Volume Property Keys”

  • Устанавливает свойство ресурса URL’s для данного ключа к данному значению.

    Объявление

    Swift

    func CFURLSetResourcePropertyForKey(_ url: CFURL!, _ key: CFString!, _ propertyValue: AnyObject!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFURLSetResourcePropertyForKey ( CFURLRef url, CFStringRef key, CFTypeRef propertyValue, CFErrorRef *error );

    Параметры

    url

    URL.

    key

    Имя одного из свойств ресурса URL’s.

    propertyValue

    Значение для свойства ресурса, определенного key.

    error

    Ошибка, произошедшая, если не могло бы быть установлено значение ресурса.

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

    true если называют свойство ресурса key успешно установлен в value; иначе, false.

    Обсуждение

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

    Если ошибка происходит, этот метод возвраты false и заполняет объектный указатель, на который ссылаются error с дополнительной информацией.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFURLCopyResourcePropertyForKey
    “Common File System Resource Keys”
    “File Property Keys”
    “Ubiquitous Item Property Keys”
    “Volume Property Keys”

  • Устанавливает временное значение ресурса на URL.

    Объявление

    Swift

    func CFURLSetTemporaryResourcePropertyForKey(_ url: CFURL!, _ key: CFString!, _ propertyValue: AnyObject!)

    Objective C

    void CFURLSetTemporaryResourcePropertyForKey ( CFURLRef url, CFStringRef key, CFTypeRef propertyValue );

    Параметры

    url

    URL.

    key

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

    propertyValue

    Значение для хранения.

    Обсуждение

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

    Ваше приложение может удалить временное значение ресурса из объекта URL путем вызова CFURLClearResourcePropertyCacheForKey или CFURLClearResourcePropertyCache (для удаления всех временных ценностей).

    Этот метод применим только к URLs для ресурсов файловой системы.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLCreateBookmarkData(_ allocator: CFAllocator!, _ url: CFURL!, _ options: CFURLBookmarkCreationOptions, _ resourcePropertiesToInclude: CFArray!, _ relativeToURL: CFURL!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFData>!

    Objective C

    CFDataRef CFURLCreateBookmarkData ( CFAllocatorRef allocator, CFURLRef url, CFURLBookmarkCreationOptions options, CFArrayRef resourcePropertiesToInclude, CFURLRef relativeToURL, CFErrorRef *error );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    url

    URL, отмечающий данные, создается для.

    options

    Опции, принятые во внимание при создании данных закладки.

    Для создания ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения включайте (посредством поразрядно OR операторы с любыми другими опциями в этом параметре) kCFURLBookmarkCreationWithSecurityScope опция.

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

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

    resourcePropertiesToInclude

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

    • NSString или CFString

    • NSData или CFData

    • NSDate или CFDate

    • NSNumber или CFNumber

    • CFBoolean

    • NSURL или CFURL

    • CFNull

    • CFUUID

    Кроме того, свойства могут содержать следующие классы набора:

    • NSArray или CFArray содержа только вышеупомянутые типы примитивов

    • NSDictionary или CFDictionary с NSString или CFString ключи, в которых все значения содержат только вышеупомянутые типы примитивов

    relativeToURL

    URL, относительно которого данные закладки.

    При создании ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения, используйте этот параметр следующим образом:

    • Для создания ограниченной по объему приложением закладки используйте значение nil.

    • Для создания ограниченной по объему документом закладки используйте абсолютный путь (несмотря на имя этого параметра) к файлу документа, которому должна принадлежать новая ограниченная по объему безопасностью закладка.

    error

    Ошибка, произошедшая в случае, что не могут быть созданы данные закладки.

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

    Данные закладки для URL.

    Обсуждение

    Для использования этой функции для создания ограниченной по объему безопасностью закладки для поддержки Тестовой среды приложения Вы, должно быть, сначала включили надлежащие права для своего приложения, как описано во Включении Ограниченной по объему безопасностью Закладки и Доступа через URL. Кроме того, обязательно поймите поведение options и relativeToURL параметры.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Инициализирует и возвращает данные закладки, полученные из файла, на который указывает указанный URL.

    Объявление

    Swift

    func CFURLCreateBookmarkDataFromFile(_ allocator: CFAllocator!, _ fileURL: CFURL!, _ errorRef: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Unmanaged<CFData>!

    Objective C

    CFDataRef CFURLCreateBookmarkDataFromFile ( CFAllocatorRef allocator, CFURLRef fileURL, CFErrorRef *errorRef );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для нового CFURL объект. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    fileURL

    Файл URL.

    errorRef

    Ошибка, произошедшая в случае, что не могут быть созданы данные закладки.

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

    Данные закладки для файла, или NULL если происходит ошибка.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLWriteBookmarkDataToFile(_ bookmarkRef: CFData!, _ fileURL: CFURL!, _ options: CFURLBookmarkFileCreationOptions, _ errorRef: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFURLWriteBookmarkDataToFile ( CFDataRef bookmarkRef, CFURLRef fileURL, CFURLBookmarkFileCreationOptions options, CFErrorRef *errorRef );

    Параметры

    bookmarkRef

    Данные закладки, содержащие информацию для файла псевдонима.

    fileURL

    Желаемое расположение файла псевдонима.

    options

    Опции, принятые во внимание при создании файла псевдонима.

    errorRef

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

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

    true если успешно создается файл псевдонима; иначе, false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLStartAccessingSecurityScopedResource(_ url: CFURL!) -> Boolean

    Objective C

    Boolean CFURLStartAccessingSecurityScopedResource ( CFURLRef url );

    Параметры

    url

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

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

    true если успешно выполнился запрос для доступа к ресурсу; иначе, false.

    Обсуждение

    При получении ограниченного по объему безопасностью URL, такой как путем разрешения ограниченной по объему безопасностью закладки, Вы не можете сразу использовать ресурс, на который она указывает. Для предоставления доступа к ресурсу доступным для приложения, посредством добавления его расположения к песочнице приложения, вызывают эту функцию (или его эквивалентное Какао, startAccessingSecurityScopedResource) на ограниченном по объему безопасностью URL.

    Вызовы к CFURLStartAccessingSecurityScopedResource функция (или ее эквивалентное Какао) nestable на основе для каждого процесса. Если Ваше приложение вызывает, это означает это start метод на URL дважды, чтобы полностью оставить доступ к ресурсу, на который ссылаются, необходимо вызвать соответствие stop метод дважды.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

    func CFURLStopAccessingSecurityScopedResource(_ url: CFURL!)

    Objective C

    void CFURLStopAccessingSecurityScopedResource ( CFURLRef url );

    Параметры

    url

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

    Обсуждение

    Когда Вы больше не нуждаетесь в доступе к файлу или каталогу, на который указывает ограниченный по объему безопасностью URL, такой как один возвращенный путем разрешения ограниченной по объему безопасностью закладки, вызываете эту функцию (или ее эквивалентное Какао, stopAccessingSecurityScopedResource) на URL.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Типы данных

Отметьте типы данных

Прочие условия

  • Ссылка на объект CFURL.

    Объявление

    Swift

    typealias CFURLRef = CFURL

    Objective C

    typedef const struct __CFURL *CFURLRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Константы

Константы данных закладки

  • Опции, используемые при создании данных закладки.

    Объявление

    Swift

    struct CFURLBookmarkCreationOptions : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var MinimalBookmarkMask: CFURLBookmarkCreationOptions { get } static var SuitableForBookmarkFile: CFURLBookmarkCreationOptions { get } static var WithSecurityScope: CFURLBookmarkCreationOptions { get } static var SecurityScopeAllowOnlyReadAccess: CFURLBookmarkCreationOptions { get } static var PreferFileIDResolutionMask: CFURLBookmarkCreationOptions { get } }

    Objective C

    enum { kCFURLBookmarkCreationPreferFileIDResolutionMask = ( 1UL << 8 ), kCFURLBookmarkCreationMinimalBookmarkMask = ( 1UL << 9 ), kCFURLBookmarkCreationSuitableForBookmarkFile = ( 1UL << 10 ), }; typedef CFOptionFlags CFURLBookmarkCreationOptions;

    Константы

    • kCFURLBookmarkCreationPreferFileIDResolutionMask

      Указывает, что псевдоним, создаваемый с данными закладки, предпочитает решать с его встроенным идентификатором файла.

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

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

    • MinimalBookmarkMask

      kCFURLBookmarkCreationMinimalBookmarkMask

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

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

    • SuitableForBookmarkFile

      kCFURLBookmarkCreationSuitableForBookmarkFile

      Указывает, что данные закладки включают свойства, требуемые создать файлы псевдонима Средства поиска.

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

    Обсуждение

    При создании закладки используйте поразрядно OR операторы для объединения опций Вы хотите указать, и обеспечить их для options параметр CFURLCreateBookmarkData метод.

  • Опции, используемые при разрешении данных закладки.

    Объявление

    Swift

    struct CFURLBookmarkResolutionOptions : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var CFURLBookmarkResolutionWithoutUIMask: CFURLBookmarkResolutionOptions { get } static var CFURLBookmarkResolutionWithoutMountingMask: CFURLBookmarkResolutionOptions { get } static var CFURLBookmarkResolutionWithSecurityScope: CFURLBookmarkResolutionOptions { get } static var CFBookmarkResolutionWithoutUIMask: CFURLBookmarkResolutionOptions { get } static var CFBookmarkResolutionWithoutMountingMask: CFURLBookmarkResolutionOptions { get } }

    Objective C

    enum { kCFBookmarkResolutionWithoutUIMask = ( 1UL << 8 ), kCFBookmarkResolutionWithoutMountingMask = ( 1UL << 9 ), }; typedef CFOptionFlags CFURLBookmarkResolutionOptions; typedef CFOptionFlags CFURLBookmarkFileCreationOptions;

    Константы

    • CFBookmarkResolutionWithoutUIMask

      kCFBookmarkResolutionWithoutUIMask

      Указывает, что никакая обратная связь UI не сопровождает разрешение данных закладки.

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

    • CFBookmarkResolutionWithoutMountingMask

      kCFBookmarkResolutionWithoutMountingMask

      Указывает, что никакой объем не должен быть смонтирован во время разрешения данных закладки.

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

    Обсуждение

    При разрешении закладки для получения URL используйте поразрядно OR операторы для объединения опций Вы хотите указать, и обеспечить их для options параметр CFURLCreateByResolvingBookmarkData функция.

Константы файловой системы

  • Ключи, которые применимы к файловой системе URLs.

    Объявление

    Swift

    let kCFURLNameKey: CFString! let kCFURLLocalizedNameKey: CFString! let kCFURLPathKey: CFString! let kCFURLIsRegularFileKey: CFString! let kCFURLIsDirectoryKey: CFString! let kCFURLIsSymbolicLinkKey: CFString! let kCFURLIsVolumeKey: CFString! let kCFURLIsPackageKey: CFString! let kCFURLIsSystemImmutableKey: CFString! let kCFURLIsUserImmutableKey: CFString! let kCFURLIsHiddenKey: CFString! let kCFURLHasHiddenExtensionKey: CFString! let kCFURLCreationDateKey: CFString! let kCFURLContentAccessDateKey: CFString! let kCFURLContentModificationDateKey: CFString! let kCFURLAttributeModificationDateKey: CFString! let kCFURLLinkCountKey: CFString! let kCFURLParentDirectoryURLKey: CFString! let kCFURLVolumeURLKey: CFString! let kCFURLTypeIdentifierKey: CFString! let kCFURLLocalizedTypeDescriptionKey: CFString! let kCFURLLabelNumberKey: CFString! let kCFURLLabelColorKey: CFString! let kCFURLLocalizedLabelKey: CFString! let kCFURLEffectiveIconKey: CFString! let kCFURLCustomIconKey: CFString! let kCFURLFileResourceIdentifierKey: CFString! let kCFURLVolumeIdentifierKey: CFString! let kCFURLPreferredIOBlockSizeKey: CFString! let kCFURLIsReadableKey: CFString! let kCFURLIsWritableKey: CFString! let kCFURLIsExecutableKey: CFString! let kCFURLFileSecurityKey: CFString! let kCFURLIsExcludedFromBackupKey: CFString! let kCFURLFileResourceTypeKey: CFString!

    Objective C

    const CFStringRef kCFURLNameKey const CFStringRef kCFURLLocalizedNameKey const CFStringRef kCFURLPathKey; const CFStringRef kCFURLIsRegularFileKey const CFStringRef kCFURLIsDirectoryKey const CFStringRef kCFURLIsSymbolicLinkKey const CFStringRef kCFURLIsVolumeKey const CFStringRef kCFURLIsPackageKey const CFStringRef kCFURLIsSystemImmutableKey const CFStringRef kCFURLIsUserImmutableKey const CFStringRef kCFURLIsHiddenKey const CFStringRef kCFURLHasHiddenExtensionKey const CFStringRef kCFURLCreationDateKey const CFStringRef kCFURLContentAccessDateKey const CFStringRef kCFURLContentModificationDateKey const CFStringRef kCFURLAttributeModificationDateKey const CFStringRef kCFURLLinkCountKey const CFStringRef kCFURLParentDirectoryURLKey const CFStringRef kCFURLVolumeURLKey const CFStringRef kCFURLTypeIdentifierKey const CFStringRef kCFURLLocalizedTypeDescriptionKey const CFStringRef kCFURLLabelNumberKey const CFStringRef kCFURLLabelColorKey const CFStringRef kCFURLLocalizedLabelKey const CFStringRef kCFURLEffectiveIconKey const CFStringRef kCFURLCustomIconKey const CFStringRef kCFURLFileResourceIdentifierKey const CFStringRef kCFURLVolumeIdentifierKey const CFStringRef kCFURLPreferredIOBlockSizeKey const CFStringRef kCFURLIsReadableKey const CFStringRef kCFURLIsWritableKey const CFStringRef kCFURLIsExecutableKey const CFStringRef kCFURLFileSecurityKey const CFStringRef kCFURLIsExcludedFromBackupKey; const CFStringRef kCFURLFileResourceTypeKey; const CFStringRef kCFURLFileResourceTypeKey

    Константы

    • kCFURLNameKey

      Ключ для имени ресурса в файловой системе, возвращенной как a CFString объект.

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

    • kCFURLLocalizedNameKey

      Ключ для локализованного или скрытого от расширения имени ресурса, повторно настроенного как a CFString объект.

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

    • kCFURLPathKey

      A CFString значение, содержащее URL’s, соединяет каналом как путь файловой системы. (только для чтения)

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

    • kCFURLIsRegularFileKey

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

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

    • kCFURLIsDirectoryKey

      Ключ для определения, является ли ресурс каталогом, возвратился как a CFBoolean объект.

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

    • kCFURLIsSymbolicLinkKey

      Ключ для определения, является ли ресурс символьной ссылкой, возвратился как a CFBoolean объект.

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

    • kCFURLIsVolumeKey

      Ключ для определения, является ли ресурс корневым каталогом объема, возвратился как a CFBoolean объект.

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

    • kCFURLIsPackageKey

      Ключ для определения, является ли ресурс упакованным каталогом, возвратился как a CFBoolean объект.

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

    • kCFURLIsSystemImmutableKey

      Ключ для определения, установлена ли система ресурса неизменный бит, возвратился как a CFBoolean объект.

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

    • kCFURLIsUserImmutableKey

      Ключ для определения, установлен ли пользователь ресурса неизменный бит, возвратился как a CFBoolean объект.

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

    • kCFURLIsHiddenKey

      Ключ для определения, не выводится ли ресурс обычно на экран пользователям, возвратился как a CFBoolean объект.

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

    • kCFURLHasHiddenExtensionKey

      Ключ для определения, удаляется ли расширение ресурса обычно из его локализованного имени, возвратился как a CFBoolean объект.

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

    • kCFURLCreationDateKey

      Ключ для даты создания ресурса, возвращенной как a CFDate возразите, поддерживает ли объем даты создания, или nil если не поддерживаются даты создания.

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

    • kCFURLContentAccessDateKey

      К ключу в последний раз ресурс получили доступ, возвращенный как a CFDate возразите, поддерживает ли объем даты доступа, или nil если не поддерживаются даты доступа.

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

    • kCFURLContentModificationDateKey

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

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

    • kCFURLAttributeModificationDateKey

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

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

    • kCFURLLinkCountKey

      Ключ для числа жестких ссылок на ресурс, возвращенный как a CFNumber объект.

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

    • kCFURLParentDirectoryURLKey

      Ключ для родительского каталога ресурса, возвращенного как a CFURL объект, или nil если ресурс является корневым каталогом своего объема.

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

    • kCFURLVolumeURLKey

      Ключ для корневого каталога объема ресурса, возвращенного как a CFURL объект.

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

    • kCFURLTypeIdentifierKey

      Ключ для универсального идентификатора типа (UTI) ресурса, возвращенного как a CFString объект.

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

    • kCFURLLocalizedTypeDescriptionKey

      Ключ для локализованного описания типа ресурса, возвращенного как a CFString объект.

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

    • kCFURLLabelNumberKey

      Ключ для номера метки ресурса, возвращенного как a CFNumber объект.

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

    • kCFURLLabelColorKey

      Ключ для цвета метки ресурса, возвращенного как a CFColorRef объект, или NULL если ресурс не имеет никакого цвета метки.

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

    • kCFURLLocalizedLabelKey

      Ключ для локализованного текста метки ресурса, возвращенного как a CFString объект, или NULL если ресурс не имеет никакого локализованного текста метки.

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

    • kCFURLEffectiveIconKey

      Ключ для нормального значка ресурса, возвращенного как a CGImageRef объект.

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

    • kCFURLCustomIconKey

      Ключ для значка, сохраненного ресурсом, возвращенным как a CGImageRef объект, или NULL если ресурс не имеет никакого пользовательского значка.

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

    • kCFURLFileResourceIdentifierKey

      Ключ для уникального идентификатора ресурса, возвращенного как a CFType объект.

      Этот идентификатор может использоваться для определения равенства между ресурсами файловой системы с CFEqual функция. Два ресурса равны, если у них есть тот же путь файловой системы или если их пути соединяются с тем же inode в той же файловой системе.

      Значение этого идентификатора не является персистентным через системные перезапуски.

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

    • kCFURLVolumeIdentifierKey

      Ключ для уникального идентификатора объема ресурса, возвращенного как a CFType объект.

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

      Значение этого идентификатора не является персистентным через системные перезапуски.

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

    • kCFURLPreferredIOBlockSizeKey

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

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

    • kCFURLIsReadableKey

      Ключ для определения, может ли текущий процесс (как определено EUID) считать ресурс, возвратился как a CFBoolean объект.

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

    • kCFURLIsWritableKey

      Ключ для определения, может ли текущий процесс (как определено EUID) записать в ресурс, возвратился как a CFBoolean объект.

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

    • kCFURLIsExecutableKey

      Ключ для определения, может ли текущий процесс (как определено EUID) выполнить ресурс (если это - файл) или ищет ресурс (если это - каталог), возвращенный как a CFBoolean объект.

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

    • kCFURLFileSecurityKey

      Ключ для получения информации о безопасности ресурса, возвращенной как a CFFileSecurity объект.

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

    • kCFURLIsExcludedFromBackupKey

      Ключ для определения, исключен ли ресурс из всех резервных копий данных приложения, возвратился как a CFBoolean объект.

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

    • kCFURLFileResourceTypeKey

      Ключ для типа объекта ресурса, возвращенного как a CFString объект. Посмотрите Типы ресурсов Файла для возможных значений.

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

  • Возможные значения для kCFURLFileResourceTypeKey ключ.

    Объявление

    Swift

    let kCFURLFileResourceTypeBlockSpecial: CFString! let kCFURLFileResourceTypeCharacterSpecial: CFString! let kCFURLFileResourceTypeDirectory: CFString! let kCFURLFileResourceTypeNamedPipe: CFString! let kCFURLFileResourceTypeRegular: CFString! let kCFURLFileResourceTypeSocket: CFString! let kCFURLFileResourceTypeSymbolicLink: CFString! let kCFURLFileResourceTypeUnknown: CFString!

    Objective C

    const CFStringRef kCFURLFileResourceTypeBlockSpecial const CFStringRef kCFURLFileResourceTypeCharacterSpecial const CFStringRef kCFURLFileResourceTypeDirectory const CFStringRef kCFURLFileResourceTypeNamedPipe const CFStringRef kCFURLFileResourceTypeRegular const CFStringRef kCFURLFileResourceTypeSocket const CFStringRef kCFURLFileResourceTypeSymbolicLink const CFStringRef kCFURLFileResourceTypeUnknown

    Константы

    • kCFURLFileResourceTypeBlockSpecial

      Ресурс является блоком специальный файл.

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

    • kCFURLFileResourceTypeCharacterSpecial

      Ресурс является символьным специальным файлом.

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

    • kCFURLFileResourceTypeDirectory

      Ресурс является каталогом.

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

    • kCFURLFileResourceTypeNamedPipe

      Ресурс является именованным каналом.

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

    • kCFURLFileResourceTypeRegular

      Ресурс является регулярным файлом.

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

    • kCFURLFileResourceTypeSocket

      Ресурс является сокетом.

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

    • kCFURLFileResourceTypeSymbolicLink

      Ресурс является символьной ссылкой.

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

    • kCFURLFileResourceTypeUnknown

      Тип ресурса неизвестен.

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

  • Ключи, применяющиеся к свойствам файлов.

    Объявление

    Swift

    let kCFURLFileAllocatedSizeKey: CFString! let kCFURLFileSizeKey: CFString! let kCFURLIsAliasFileKey: CFString! let kCFURLIsMountTriggerKey: CFString! let kCFURLTotalFileAllocatedSizeKey: CFString! let kCFURLTotalFileSizeKey: CFString!

    Objective C

    const CFStringRef kCFURLFileAllocatedSizeKey const CFStringRef kCFURLFileSizeKey const CFStringRef kCFURLIsAliasFileKey const CFStringRef kCFURLIsMountTriggerKey const CFStringRef kCFURLTotalFileAllocatedSizeKey const CFStringRef kCFURLTotalFileSizeKey

    Константы

    • kCFURLFileAllocatedSizeKey

      Ключ для общего размера, выделенного на диске для файла, возвращенного как CFNumber объект.

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

    • kCFURLFileSizeKey

      Ключ для размера файла в байтах, возвращенных как a CFNumber объект.

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

    • kCFURLIsAliasFileKey

      Ключ для определения, является ли файл псевдонимом, возвратился как a CFBoolean объект.

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

    • kCFURLIsMountTriggerKey

      Ключ для определения, является ли URL триггерным каталогом файловой системы, возвратился как a CFBoolean объект. Пересечение или открытие триггерного каталога файловой системы вызывают попытку смонтировать файловую систему на каталоге.

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

    • kCFURLTotalFileAllocatedSizeKey

      Ключ для общего выделенного размера файла в байтах, возвращенных как a CFNumber объект. Это включает размер любых метаданных файла.

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

    • kCFURLTotalFileSizeKey

      Ключ для общего визуализуемого размера файла в байтах, возвращенных как a CFNumber объект. Это включает размер любых метаданных файла.

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

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

    Объявление

    Swift

    let kCFURLIsUbiquitousItemKey: CFString! let kCFURLUbiquitousItemHasUnresolvedConflictsKey: CFString! let kCFURLUbiquitousItemIsDownloadingKey: CFString! let kCFURLUbiquitousItemIsUploadedKey: CFString! let kCFURLUbiquitousItemIsUploadingKey: CFString!

    Objective C

    const CFStringRef kCFURLIsUbiquitousItemKey; const CFStringRef kCFURLUbiquitousItemHasUnresolvedConflictsKey; const CFStringRef kCFURLUbiquitousItemIsDownloadedKey; const CFStringRef kCFURLUbiquitousItemIsDownloadingKey; const CFStringRef kCFURLUbiquitousItemIsUploadedKey; const CFStringRef kCFURLUbiquitousItemIsUploadingKey; const CFStringRef kCFURLUbiquitousItemPercentDownloadedKey; const CFStringRef kCFURLUbiquitousItemPercentUploadedKey;

    Константы

    • kCFURLIsUbiquitousItemKey

      A CFBoolean значение, говорящее, синхронизируется ли элемент к облаку. (только для чтения)

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

    • kCFURLUbiquitousItemHasUnresolvedConflictsKey

      A CFBoolean значение, говорящее, имеет ли элемент выдающиеся конфликты. (только для чтения)

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

    • kCFURLUbiquitousItemIsDownloadedKey

      A CFBoolean значение, говорящее, существует ли локальный подарок данных к элементу. (только для чтения)

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

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

    • kCFURLUbiquitousItemIsDownloadingKey

      A CFBoolean значение, говорящее, загружаются ли данные для элемента. (только для чтения)

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

    • kCFURLUbiquitousItemIsUploadedKey

      A CFBoolean значение, говорящее, существует ли настоящее данных в облаке для этого элемента. (только для чтения)

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

    • kCFURLUbiquitousItemIsUploadingKey

      A CFBoolean значение, говорящее, загружаются ли данные для элемента. (только для чтения)

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

    • kCFURLUbiquitousItemPercentDownloadedKey

      A CFNumber значение, обеспечивающее состояние происходящей загрузки.

      Осуждаемый. Использовать NSMetadataQuery и NSMetadataUbiquitousItemPercentDownloadedKey на NSMetadataItem вместо этого.

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

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

    • kCFURLUbiquitousItemPercentUploadedKey

      A CFNumber значение, обеспечивающее состояние происходящей загрузки.

      Осуждаемый. Использовать NSMetadataQuery и NSMetadataUbiquitousItemPercentUploadedKey на NSMetadataItem вместо этого.

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

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

  • Ключи, применяющиеся к объемам.

    Объявление

    Swift

    let kCFURLVolumeNameKey: CFString! let kCFURLVolumeLocalizedNameKey: CFString! let kCFURLVolumeLocalizedFormatDescriptionKey: CFString! let kCFURLVolumeTotalCapacityKey: CFString! let kCFURLVolumeAvailableCapacityKey: CFString! let kCFURLVolumeResourceCountKey: CFString! let kCFURLVolumeSupportsPersistentIDsKey: CFString! let kCFURLVolumeSupportsSymbolicLinksKey: CFString! let kCFURLVolumeSupportsHardLinksKey: CFString! let kCFURLVolumeSupportsJournalingKey: CFString! let kCFURLVolumeIsJournalingKey: CFString! let kCFURLVolumeSupportsSparseFilesKey: CFString! let kCFURLVolumeSupportsZeroRunsKey: CFString! let kCFURLVolumeSupportsCaseSensitiveNamesKey: CFString! let kCFURLVolumeSupportsCasePreservedNamesKey: CFString! let kCFURLVolumeSupportsRootDirectoryDatesKey: CFString! let kCFURLVolumeSupportsVolumeSizesKey: CFString! let kCFURLVolumeSupportsRenamingKey: CFString! let kCFURLVolumeSupportsAdvisoryFileLockingKey: CFString! let kCFURLVolumeSupportsExtendedSecurityKey: CFString! let kCFURLVolumeIsBrowsableKey: CFString! let kCFURLVolumeMaximumFileSizeKey: CFString! let kCFURLVolumeIsEjectableKey: CFString! let kCFURLVolumeIsRemovableKey: CFString! let kCFURLVolumeIsInternalKey: CFString! let kCFURLVolumeIsAutomountedKey: CFString! let kCFURLVolumeIsLocalKey: CFString! let kCFURLVolumeIsReadOnlyKey: CFString! let kCFURLVolumeCreationDateKey: CFString! let kCFURLVolumeURLForRemountingKey: CFString! let kCFURLVolumeUUIDStringKey: CFString!

    Objective C

    const CFStringRef kCFURLVolumeNameKey const CFStringRef kCFURLVolumeLocalizedNameKey const CFStringRef kCFURLVolumeLocalizedFormatDescriptionKey const CFStringRef kCFURLVolumeTotalCapacityKey const CFStringRef kCFURLVolumeAvailableCapacityKey const CFStringRef kCFURLVolumeResourceCountKey const CFStringRef kCFURLVolumeResourceCountKey const CFStringRef kCFURLVolumeSupportsSymbolicLinksKey const CFStringRef kCFURLVolumeSupportsHardLinksKey const CFStringRef kCFURLVolumeSupportsJournalingKey const CFStringRef kCFURLVolumeIsJournalingKey const CFStringRef kCFURLVolumeSupportsSparseFilesKey const CFStringRef kCFURLVolumeSupportsZeroRunsKey const CFStringRef kCFURLVolumeSupportsCaseSensitiveNamesKey const CFStringRef kCFURLVolumeSupportsCasePreservedNamesKey const CFStringRef kCFURLVolumeSupportsRootDirectoryDatesKey const CFStringRef kCFURLVolumeSupportsVolumeSizesKey const CFStringRef kCFURLVolumeSupportsRenamingKey const CFStringRef kCFURLVolumeSupportsAdvisoryFileLockingKey const CFStringRef kCFURLVolumeSupportsExtendedSecurityKey const CFStringRef kCFURLVolumeIsBrowsableKey const CFStringRef kCFURLVolumeMaximumFileSizeKey const CFStringRef kCFURLVolumeIsEjectableKey const CFStringRef kCFURLVolumeIsRemovableKey const CFStringRef kCFURLVolumeIsInternalKey const CFStringRef kCFURLVolumeIsAutomountedKey const CFStringRef kCFURLVolumeIsLocalKey const CFStringRef kCFURLVolumeIsReadOnlyKey const CFStringRef kCFURLVolumeCreationDateKey const CFStringRef kCFURLVolumeURLForRemountingKey const CFStringRef kCFURLVolumeUUIDStringKey

    Константы

    • kCFURLVolumeNameKey

      Имя объема, возвращенного как a CFString объект.

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

    • kCFURLVolumeLocalizedNameKey

      Презентабельное пользователем имя объема, возвращенного как a CFString объект.

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

    • kCFURLVolumeLocalizedFormatDescriptionKey

      Ключ для дескриптивного имени формата объема, возвращенного как a CFString объект.

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

    • kCFURLVolumeTotalCapacityKey

      Ключ для способности объема в байтах, возвращенных как a CFNumber объект.

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

    • kCFURLVolumeAvailableCapacityKey

      Ключ для полезной мощности объема в байтах, возвращенных как a CFNumber объект.

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

    • kCFURLVolumeResourceCountKey

      Ключ для общего количества ресурсов на объеме, возвращенном как a CFNumber объект.

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

    • kCFURLVolumeSupportsPersistentIDsKey

      Ключ для определения, поддерживает ли объем персистентный IDs, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsSymbolicLinksKey

      Ключ для определения, поддерживает ли объем символьные ссылки, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsHardLinksKey

      Ключ для определения, поддерживает ли объем жесткие ссылки, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsJournalingKey

      Ключ для определения, поддерживает ли объем журналирование, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeIsJournalingKey

      Ключ для определения, журналирует ли объем в настоящее время, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsSparseFilesKey

      Ключ для определения, поддерживает ли объем редкие файлы, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsZeroRunsKey

      Ключ для определения, поддерживает ли объем нулевые выполнения, возвращенные как a CFBoolean объект.

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

    • kCFURLVolumeSupportsCaseSensitiveNamesKey

      Ключ для определения, поддерживает ли объем чувствительные к регистру имена, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsCasePreservedNamesKey

      Ключ для определения, поддерживает ли объем сохраненные случаем имена, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsRootDirectoryDatesKey

      Ключ для определения, поддерживает ли объем надежное хранение времен для корневого каталога, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsVolumeSizesKey

      Ключ для определения, ли поддержки объема, возвращая информацию о размере тома, возвращенную как a CFBoolean объект. Если true, информация о размере тома доступна как значения kCFURLVolumeTotalCapacityKey и kCFURLVolumeAvailableCapacityKey ключи.

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

    • kCFURLVolumeSupportsRenamingKey

      Ключ для определения, может ли объем быть переименован, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeSupportsAdvisoryFileLockingKey

      Ключ для определения, реализует ли объем консультацию целого файла, привязывает стиль flock, вместе с O_EXLOCK и O_SHLOCK флаги open функция, возвращенная как a CFBoolean объект.

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

    • kCFURLVolumeSupportsExtendedSecurityKey

      Ключ для определения, поддерживает ли объем расширенную безопасность (списки управления доступом), возвращенные как a CFBoolean объект.

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

    • kCFURLVolumeIsBrowsableKey

      Ключ для определения, видим ли объем в основанных на GUI просматривающих файл средах, таков как Рабочий стол или приложение Средства поиска, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeMaximumFileSizeKey

      Ключ для самого большого размера файла, поддерживаемого объемом в байтах, возвращенных как a CFNumber объект, или NULL если это не может быть определено.

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

    • kCFURLVolumeIsEjectableKey

      Ключ для определения, является ли объем выбрасываемым от механизма диска при программном управлении, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeIsRemovableKey

      Ключ для определения, является ли объем съемным от механизма диска, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeIsInternalKey

      Ключ для определения, подключен ли объем к внутренней шине, возвратился как a CFBoolean объект, или NULL если это не может быть определено.

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

    • kCFURLVolumeIsAutomountedKey

      Ключ для определения, автосмонтирован ли объем, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeIsLocalKey

      Ключ для определения, сохранен ли объем на локальном устройстве, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeIsReadOnlyKey

      Ключ для определения, только ли объем для чтения, возвратился как a CFBoolean объект.

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

    • kCFURLVolumeCreationDateKey

      Ключ для даты создания объема, возвращенной как a CFDate объект, или NULL если это не может быть определено.

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

    • kCFURLVolumeURLForRemountingKey

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

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

    • kCFURLVolumeUUIDStringKey

      Ключ для персистентного UUID объема, возвращенного как a CFString объект, или NULL если персистентный UUID не доступен.

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

  • Ключи в userInfo словаре a CFError возразите, когда бесспорный, что функции CFURL возвращают ошибку.

    Объявление

    Swift

    let kCFURLKeysOfUnsetValuesKey: CFString!

    Objective C

    const CFStringRef kCFURLKeysOfUnsetValuesKey

    Константы

    • kCFURLKeysOfUnsetValuesKey

      Ключ для свойств ресурса, не установленных после CFURLSetResourcePropertiesForKeys функционируйте возвращает ошибку, возвращенную как массив CFString объекты.

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

Прочие условия

  • Типы компонентов в URL.

    Объявление

    Swift

    enum CFURLComponentType : CFIndex { case Scheme case NetLocation case Path case ResourceSpecifier case User case Password case UserInfo case Host case Port case ParameterString case Query case Fragment }

    Objective C

    typedef enum { kCFURLComponentScheme = 1, kCFURLComponentNetLocation = 2, kCFURLComponentPath = 3, kCFURLComponentResourceSpecifier = 4, kCFURLComponentUser = 5, kCFURLComponentPassword = 6, kCFURLComponentUserInfo = 7, kCFURLComponentHost = 8, kCFURLComponentPort = 9, kCFURLComponentParameterString = 10, kCFURLComponentQuery = 11, kCFURLComponentFragment = 12 } CFURLComponentType; typedef enum CFURLPathStyle CFURLPathStyle;

    Константы

    • Scheme

      kCFURLComponentScheme

      Схема URL’s.

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

    • NetLocation

      kCFURLComponentNetLocation

      Расположение сети URL’s.

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

    • Path

      kCFURLComponentPath

      Компонент контура URL’s.

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

    • ResourceSpecifier

      kCFURLComponentResourceSpecifier

      Спецификатор ресурса URL’s.

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

    • User

      kCFURLComponentUser

      Пользователь URL’s.

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

    • Password

      kCFURLComponentPassword

      Пароль пользователя.

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

    • UserInfo

      kCFURLComponentUserInfo

      Информация пользователя.

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

    • Host

      kCFURLComponentHost

      Узел URL’s.

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

    • Port

      kCFURLComponentPort

      Порт URL’s.

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

    • ParameterString

      kCFURLComponentParameterString

      Строка параметров URL’s.

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

    • Query

      kCFURLComponentQuery

      Запрос URL’s.

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

    • Fragment

      kCFURLComponentFragment

      Фрагмент URL’s.

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

    Обсуждение

    Эти константы используются CFURLGetByteRangeForComponent функция.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Опции, которые можно использовать, чтобы определить, как функции CFURL анализируют путь файловой системы.

    Объявление

    Swift

    enum CFURLPathStyle : CFIndex { case CFURLPOSIXPathStyle case CFURLHFSPathStyle case CFURLWindowsPathStyle }

    Objective C

    enum CFURLPathStyle { kCFURLPOSIXPathStyle = 0, kCFURLHFSPathStyle = 1, kCFURLWindowsPathStyle = 2 }; typedef enum CFURLPathStyle CFURLPathStyle;

    Константы

    • CFURLPOSIXPathStyle

      kCFURLPOSIXPathStyle

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

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

    • kCFURLHFSPathStyle

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

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

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

    • CFURLWindowsPathStyle

      kCFURLWindowsPathStyle

      Указывает, что Windows разрабатывает путь.

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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