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

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

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

Функции

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


    
    CFURLCreateDataAndPropertiesFromResource
    CFURLCreateDataAndPropertiesFromResource

(OS X v10.9)

Загружает данные и свойства, именуемые данным 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;

Доступность

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

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


    
    CFURLCreatePropertyFromResource
    CFURLCreatePropertyFromResource

(OS X v10.9)

Возвращает данное свойство, указанное данным 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;

Доступность

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

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


    
    CFURLDestroyResource
    CFURLDestroyResource

(OS X v10.9)

Уничтожает ресурс, обозначенный данным 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;

Доступность

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

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


    
    CFURLWriteDataAndPropertiesToResource
    CFURLWriteDataAndPropertiesToResource

(OS X v10.9)

Пишут определенные данные и свойства к данному 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;

Доступность

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

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

Константы

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

Коды ошибки
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
  
  kCFURLUnknownError
  
  Указывает неизвестную ошибку.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLUnknownSchemeError
  
  kCFURLUnknownSchemeError
  
  Указывает, что не распознана схема.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLResourceNotFoundError
  
  kCFURLResourceNotFoundError
  
  Указывает, что не был найден ресурс.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLResourceAccessViolationError
  
  kCFURLResourceAccessViolationError
  
  Указывает ошибку в доступе к ресурсу.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLRemoteHostUnavailableError
  
  kCFURLRemoteHostUnavailableError
  
  Указывает, что удаленный узел недоступен.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLImproperArgumentsError
  
  kCFURLImproperArgumentsError
  
  Указывает, что один или несколько параметров являются неподходящими.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLUnknownPropertyKeyError
  
  kCFURLUnknownPropertyKeyError
  
  Указывает, что ключ свойства неизвестен.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLPropertyKeyUnavailableError
  
  kCFURLPropertyKeyUnavailableError
  
  Указывает, что ключ свойства был недоступен.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLTimeoutError
  
  kCFURLTimeoutError
  
  Указывает тайм-аут.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
Оператор импорта

Objective C

@import CoreFoundation;

Доступность

Доступный в версии 10.0 OS X и позже.
Файл свойства URL
Свойства для файла ресурсы URL.

Объявление

Objective C

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

Константы
- kCFURLFileExists
  
  kCFURLFileExists
  
  A CFBoolean объект, указывающий, существует ли файл, именуемый URL.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLFileDirectoryContents
  
  kCFURLFileDirectoryContents
  
  A CFArray объектное содержание CFURL объекты для содержания каталога именуются URL.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLFileLength
  
  kCFURLFileLength
  
  A CFNumber объект, содержащий длину файла в байтах.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLFileLastModificationTime
  
  kCFURLFileLastModificationTime
  
  A CFDate объект, содержащий время изменения файла.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLFilePOSIXMode
  
  kCFURLFilePOSIXMode
  
  A CFNumber содержание режима POSIX файла, как подано /usr/include/sys/stat.h.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLFileOwnerID
  
  kCFURLFileOwnerID
  
  A CFNumber содержание владельца файла UID.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
Доступность

Доступный в версии 10.0 OS X и позже.
HTTP свойства URL
Свойства для HTTP ресурсы URL.

Объявление

Objective C

const CFStringRef kCFURLHTTPStatusCode; const CFStringRef kCFURLHTTPStatusLine;

Константы
- kCFURLHTTPStatusCode
  
  kCFURLHTTPStatusCode
  
  A CFNumber объект, содержащий код состояния Запроса HTTP.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
- kCFURLHTTPStatusLine
  
  kCFURLHTTPStatusLine
  
  A CFString объект, содержащий строку состояния Запроса HTTP.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.9.
Обсуждение

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

Доступность

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