Ссылка 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!Параметры
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
Если
YES
true
, данные закладки являются устаревшими.error
Ошибка, произошедшая в случае, что не может быть создан URL.
Возвращаемое значение
Новый URL сделан путем разрешения
bookmark
, илиNULL
если происходит ошибка.Обсуждение
Для получения ограниченного по объему безопасностью URL из ограниченной по объему безопасностью закладки вызовите этот метод с помощью
kCFURLBookmarkResolutionWithSecurityScope
опция. Кроме того, для использования объема безопасности Вы, должно быть, сначала включили надлежащие права для своего приложения, как описано во Включении Ограниченной по объему безопасностью Закладки и Доступа через URL.Тогда получить доступ к ресурсу файловой системы, на который указывает ограниченный по объему безопасностью URL (другими словами, принести ресурс в песочницу Вашего приложения), вызов
CFURLStartAccessingSecurityScopedResource
функция (или ее эквивалентное Какао) на URL.Для ограниченной по объему приложением закладки никакое поигравшее в песочнице приложение кроме того, создавшего закладку, не может получить доступ к ресурсу файловой системы, на который указывает URL (полученный из закладки).
Для ограниченной по объему документом закладки любое поигравшее в песочнице приложение, имеющее доступ к самим данным закладки и имеющее доступ к документу, которому принадлежит закладка, может получить доступ к ресурсу.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 4.0 и позже.
См. также
-
Создает копию данного 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 должен закончиться в «/». Если у Вас есть URLhttp://www.apple.com/foo/
и Вы добавляете компонент контураbar
, тогда, еслиisDirectory
YES
true
тогда получающийся URLhttp://www.apple.com/foo/bar/
, тогда как, еслиisDirectory
NO
false
тогда получающийся URLhttp://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 и позже.
-
CFURLCreateFromFileSystemRepresentationRelativeToBase (_: _: _: _: _:) CFURLCreateFromFileSystemRepresentationRelativeToBase
Создает 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 и позже.
-
CFURLCreateFromFSRef
(iOS 7.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 и позже.
-
CFURLCreateWithFileSystemPathRelativeToBase (_: _: _: _: _:) CFURLCreateWithFileSystemPathRelativeToBase
Создает 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!) -> BooleanObjective 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
пустая строка.CFStringRef urlString = CFSTR("http://www.apple.com");
CFURLRef url = CFURLCreateWithString(NULL, urlString, NULL);
CFStringRef lastPathComponent = CFURLCopyLastPathComponent (url);
Если
urlString
создавались сCFSTR("http://www.apple.com/")
, тогдаlastPathComponent
был бы aCFString
объект, содержащий символ “/
“.См. также
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
если не существует никакая строка параметров. Например, в URLmyproto://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!) -> Int32Objective 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!) -> BooleanObjective 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
в aCFData
объект.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 и позже.
-
CFURLCreateStringByReplacingPercentEscapesUsingEncoding (_: _: _: _:) CFURLCreateStringByReplacingPercentEscapesUsingEncoding
Создает новую строку путем замены любых 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Параметры
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
возразите для преобразования в aCFString
объект.Возвращаемое значение
Строковое представление
anURL
. Владение соблюдает получить правило. См. Получить Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает базовый URL данного URL, если он существует.
Объявление
Swift
func CFURLGetBaseURL(_
anURL
: CFURL!) -> CFURL!Параметры
anURL
CFURL
объект исследовать.Возвращаемое значение
A
CFURL
объект, представляющий базовый URLanURL
. Владение соблюдает получить правило. См. Получить Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвраты ссылкой представление байта объекта URL.
Объявление
Параметры
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>) -> CFRangeObjective 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
непрозрачный тип.Возвращаемое значение
Идентификатор типа для
CFURL
непрозрачный тип.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвраты, может ли быть достигнут ресурс, на который указывает файл URL.
Объявление
Swift
func CFURLResourceIsReachable(_
url
: CFURL!, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BooleanObjective 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.
Оператор импорта
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>?>) -> BooleanObjective C
Boolean CFURLCopyResourcePropertyForKey ( CFURLRef url, CFStringRef key, void *propertyValueTypeRefPtr, CFErrorRef *error );
Параметры
url
URL.
key
Ключ значения свойства для требуемого значения.
propertyValueTypeRefPtr
Выходной указатель, заполняющийся с результатом.
error
Ошибка, произошедшая, если не могло бы быть получено значение свойства. Этот параметр является дополнительным. Если Вы не интересуетесь получением информации об ошибке, можно передать
NULL
.Возвращаемое значение
true
еслиpropertyValueTypeRefPtr
успешно заполняется; иначе,false
.Обсуждение
Эта функция сначала проверяет, кэширует ли объект URL уже значение ресурса. Если так, это возвращает кэшируемое значение ресурса вызывающей стороне. В противном случае тогда эта функция синхронно получает значение ресурса из запоминающего устройства, добавляет, что ресурс оценивает кэшу объекта URL, и возвращает значение ресурса вызывающей стороне.
Тип возвращенного значения ресурса варьируется свойством ресурса; для подробных данных см. документацию для ключа, к которому Вы хотите получить доступ.
Если возвращается эта функция
YES
true
и propertyValueTypeRefPtr заполняется сnil
, это означает, что свойство ресурса не доступно для указанного ресурса, и что никакие ошибки не произошли при решении, что свойство ресурса было недоступно.Если возвращается эта функция
NO
false
, ошибка произошла. объектный указатель, на который ссылаются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”
-
CFURLCreateResourcePropertiesForKeysFromBookmarkData (_: _: _:) CFURLCreateResourcePropertiesForKeysFromBookmarkData
Возвращает значения ресурса для свойств, идентифицированных указанным массивом ключей, содержавшихся в указанных данных закладки.
Объявление
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 и позже.
-
CFURLCreateResourcePropertyForKeyFromBookmarkData (_: _: _:) CFURLCreateResourcePropertyForKeyFromBookmarkData
Возвращает значение свойства ресурса от указанных данных закладки.
Объявление
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>?>) -> BooleanObjective C
Boolean CFURLSetResourcePropertiesForKeys ( CFURLRef url, CFDictionaryRef keyedPropertyValues, CFErrorRef *error );
Параметры
url
URL.
keyedPropertyValues
Словарь ресурса оценивает, чтобы быть установленным.
error
Ошибка, произошедшая, если не могли бы быть установлены одно или более значений ресурса.
Возвращаемое значение
true
если весь ресурс оценивает вkeyedValues
успешно установлены; иначе,false
.Обсуждение
Эта функция синхронно выписывает новое значение ресурса к диску. Если ошибка происходит после того, как некоторые свойства ресурса были успешно изменены,
userInfo
словарь в возвращенном ошибочном объекте содержит akCFURLKeysOfUnsetValuesKey
ключ, значение которого является массивом успешно не установленных значений ресурса.Попытки установить свойство ресурса только для чтения или установить свойство ресурса, не поддерживающееся ресурсом, игнорируют и не считают ошибками.
Порядок, в котором установлены значения ресурса, не определяется. Если необходимо гарантировать порядок, в котором установлены значения ресурса, необходимо выполнить многократные запросы к этой функции или
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>?>) -> BooleanObjective 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>?>) -> BooleanObjective 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!) -> BooleanObjective 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 и позже.
-
Введите для опций создания данных закладки.
Объявление
Swift
struct CFURLBookmarkCreationOptions : RawOptionSetType { init(_
rawValue
: CFOptionFlags) init(rawValuerawValue
: 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
typedef CFOptionFlags CFURLBookmarkCreationOptions;
Обсуждение
Посмотрите Опции Создания Данных Закладки для возможных значений.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
Введите для опций создания файла закладки.
Объявление
Swift
typealias CFURLBookmarkFileCreationOptions = CFOptionFlags
Objective C
typedef CFOptionFlags CFURLBookmarkFileCreationOptions;
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 5.0 и позже.
-
Введите для параметров разрешения данных закладки.
Объявление
Swift
struct CFURLBookmarkResolutionOptions : RawOptionSetType { init(_
rawValue
: CFOptionFlags) init(rawValuerawValue
: 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
typedef CFOptionFlags CFURLBookmarkResolutionOptions;
Обсуждение
Посмотрите Параметры разрешения Данных Закладки для возможных значений.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 5.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(rawValuerawValue
: 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(rawValuerawValue
: 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
функция, возвращенная как aCFBoolean
объект.Доступный в 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 и позже.
-