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

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

Разработчик

Ссылка платформы CoreFoundation базовая ссылка утилит доступа через URL основы

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

На этой странице

Базовая ссылка утилит доступа через URL основы

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


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

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


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

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


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

Objective C

@import CoreFoundation;

Базовые Утилиты Доступа через URL Основы дают Вам удобные системно-независимые методы создания, чтения, обновления или удаления ресурса URL.

Учитывая объект CFURL, содержащий или файл или http URL, можно считать данные ресурса с CFURLCreateDataAndPropertiesFromResource функция. Можно записать данные в ресурс URL, возможно создав новый файл, с CFURLWriteDataAndPropertiesToResource функция. Наконец, можно уничтожить или удалить, ресурс, на который указывает URL с CFURLDestroyResource функция.

Функции

  • Загружает данные и свойства, именуемые данным URL.

    Объявление

    Objective C

    Boolean CFURLCreateDataAndPropertiesFromResource ( CFAllocatorRef alloc, CFURLRef url, CFDataRef *resourceData, CFDictionaryRef *properties, CFArrayRef desiredProperties, SInt32 *errorCode );

    Параметры

    allocator

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

    url

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

    resourceData

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

    properties

    По возврату, указателю на a CFDictionary объект, содержащий свойства ресурса, именуемые url. Владение соблюдает Создать Правило.

    desiredProperties

    Список свойств Вы хотите получить и возвратиться в properties. Посмотрите Файл Свойства URL и HTTP Свойства URL для списка доступных свойств.

    errorCode

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

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

    true в случае успеха, false иначе.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

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

    Объявление

    Objective C

    CFTypeRef CFURLCreatePropertyFromResource ( CFAllocatorRef alloc, CFURLRef url, CFStringRef property, SInt32 *errorCode );

    Параметры

    allocator

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

    url

    CFURL объект, относящийся к ресурсу, свойства которого загружаются.

    property

    Имя свойства Вы хотите загрузиться. Передайте одну из предоставленных строковых констант, указывающих свойство. Посмотрите Файл Свойства URL и HTTP Свойства URL для списка доступных свойств.

    errorCode

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

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

    Если успешный, требуемое свойство как a CFType объект, NULL иначе. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

  • Уничтожает ресурс, обозначенный данным URL.

    Объявление

    Objective C

    Boolean CFURLDestroyResource ( CFURLRef url, SInt32 *errorCode );

    Параметры

    url

    CFURL объект ресурса уничтожить.

    errorCode

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

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

    true в случае успеха, false иначе.

    Обсуждение

    Если url использует http схему, http DELETE запрос отправлен к ресурсу. Если url использует схему файла, тогда:

    • если ссылка является файлом, файл удален;

    • если ссылка является каталогом, и каталог пуст, каталог удален;

    • если ссылка является каталогом, и каталог не пуст, функциональные возвраты false и errorCode содержит kCFURLUnknownError.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

  • Пишут определенные данные и свойства к данному URL.

    Объявление

    Objective C

    Boolean CFURLWriteDataAndPropertiesToResource ( CFURLRef url, CFDataRef dataToWrite, CFDictionaryRef propertiesToWrite, SInt32 *errorCode );

    Параметры

    url

    Ресурс для записи.

    dataToWrite

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

    propertiesToWrite

    Свойства для записи. Передача NULL к данным только для записи. Посмотрите Файл Свойства URL и HTTP Свойства URL для списка доступных свойств.

    errorCode

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

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

    true в случае успеха, false иначе.

    Обсуждение

    Свойства, не существующие в propertiesToWrite оставлены без изменений, следовательно если propertiesToWrite NULL или пустой, свойства URL's не изменяются вообще.

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

    Если url использует схему файла, и она ссылается на каталог (последний символ пути»/«), содержание dataToWrite если значение параметра не, проигнорированы, но NULL— и все промежуточные каталоги вдоль пути действительно уже существуют — новый каталог создается (иначе, это не).

    Если url использует http схему, http PUT запрос отправлен к ресурсу с propertiesToWrite как поля заголовка и dataToWrite как данные.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

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

Константы

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

  • CFURL коды ошибки.

    Объявление

    Objective C

    enum CFURLError { kCFURLUnknownError = -10, kCFURLUnknownSchemeError = -11, kCFURLResourceNotFoundError = -12, kCFURLResourceAccessViolationError = -13, kCFURLRemoteHostUnavailableError = -14, kCFURLImproperArgumentsError = -15, kCFURLUnknownPropertyKeyError = -16, kCFURLPropertyKeyUnavailableError = -17, kCFURLTimeoutError = -18 }; typedef enum CFURLError CFURLError;

    Константы

    • kCFURLUnknownError

      Указывает неизвестную ошибку.

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

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

    • kCFURLUnknownSchemeError

      Указывает, что не распознана схема.

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

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

    • kCFURLResourceNotFoundError

      Указывает, что не был найден ресурс.

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

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

    • kCFURLResourceAccessViolationError

      Указывает ошибку в доступе к ресурсу.

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

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

    • kCFURLRemoteHostUnavailableError

      Указывает, что удаленный узел недоступен.

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

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

    • kCFURLImproperArgumentsError

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

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

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

    • kCFURLUnknownPropertyKeyError

      Указывает, что ключ свойства неизвестен.

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

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

    • kCFURLPropertyKeyUnavailableError

      Указывает, что ключ свойства был недоступен.

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

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

    • kCFURLTimeoutError

      Указывает тайм-аут.

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

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

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • Свойства для файла ресурсы URL.

    Объявление

    Objective C

    const CFStringRef kCFURLFileExists; const CFStringRef kCFURLFileDirectoryContents; const CFStringRef kCFURLFileLength; const CFStringRef kCFURLFileLastModificationTime; const CFStringRef kCFURLFilePOSIXMode; const CFStringRef kCFURLFileOwnerID;

    Константы

    • kCFURLFileExists

      A CFBoolean объект, указывающий, существует ли файл, именуемый URL.

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

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

    • kCFURLFileDirectoryContents

      A CFArray объектное содержание CFURL объекты для содержания каталога именуются URL.

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

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

    • kCFURLFileLength

      A CFNumber объект, содержащий длину файла в байтах.

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

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

    • kCFURLFileLastModificationTime

      A CFDate объект, содержащий время изменения файла.

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

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

    • kCFURLFilePOSIXMode

      A CFNumber содержание режима POSIX файла, как подано /usr/include/sys/stat.h.

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

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

    • kCFURLFileOwnerID

      A CFNumber содержание владельца файла UID.

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

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

  • Свойства для HTTP ресурсы URL.

    Объявление

    Objective C

    const CFStringRef kCFURLHTTPStatusCode; const CFStringRef kCFURLHTTPStatusLine;

    Константы

    • kCFURLHTTPStatusCode

      A CFNumber объект, содержащий код состояния Запроса HTTP.

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

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

    • kCFURLHTTPStatusLine

      A CFString объект, содержащий строку состояния Запроса HTTP.

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

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

    Обсуждение

    В дополнение к вышеупомянутым свойствам каждое поле в Запросе HTTP или заголовке ответа является самостоятельно свойством. Можно указать поле заголовка при помощи имени поля как имя свойства.