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

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

Разработчик

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

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

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

Ссылка CFBundle

CFBundle позволяет, Вы для использования иерархии папок вызвали пакет, чтобы организовать и определить местоположение многих типов ресурсов приложений включая изображения, звуки, локализованные строки и исполняемый код. В OS X пакеты могут также использоваться приложениями CFM, чтобы загрузить и выполнить функции от Мужественных платформ. Можно использовать пакеты, чтобы поддерживать многократные языки или выполнить приложение на многократных операционных средах.

Вы создаете объект пакета использование одного из CFBundleCreate... функции. CFBundle обеспечивает несколько функций для нахождения ресурсов в пакете. CFBundleCopyResourceURL функционируйте возвращает расположение ресурса указанного имени и типа, и в указанном подкаталоге. Использовать CFBundleCopyResourceURLForLocalization ограничить поиск определенным именем локализации. Использовать CFBundleCopyResourceURLsOfType получить расположения всех ресурсов указанного типа.

CFBundle обеспечивает функции для получения информации пакета, такой как ее идентификатор и информационный словарь. Используйте CFBundleGetIdentifier функция для получения идентификатора пакета, и CFBundleGetInfoDictionary функция для получения ее информационного словаря. Принципал предназначил, чтобы цель для определения местоположения пакетов идентификатором состояла в том так, чтобы код (в платформах, плагинах, и т.д.) мог найти свой собственный пакет.

Можно также получить расположения подкаталогов в пакете, представленном как объекты CFURL. CFBundleCopyExecutableURL функционируйте возвращает расположение исполнимой программы приложения. Функции CFBundleCopyResourceURL, CFBundleCopySharedFrameworksURL, CFBundleCopyPrivateFrameworksURL, CFBundleCopySharedSupportURL, и CFBundleCopyBuiltInPlugInsURL возвратите расположение подкаталога пакета, содержащего ресурсы, совместно использованные платформы, частные платформы, совместно использовали файлы поддержки и плагины соответственно.

Другие функции используются для управления локализациями. CFBundleCopyLocalizedString и CFBundleCopyLocalizationsForURL функции возвращают локализованную строку из строкового файла пакета. CFBundleCopyLocalizationsForPreferences функционируйте возвращает локализации, которые CFBundle предпочел бы учитывая указанный пакет и локализации пользовательской настройки.

В отличие от некоторой другой Базовой Основы непрозрачные типы с подобными именами Основы Какао (такими как CFString и NSString), NSBundle объекты не могут быть брошены (“бесплатный соединенный мостом”) к объектам CFBundle.

В отличие от этого NSBundle, который не поддерживает разгрузку (потому что время выполнения Objective C не поддерживает разгрузку кода Objective C), можно разгрузить объекты CFBundle.

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

С другой стороны, если Вы хотите вручную управлять, когда пакет загружен и разгружен, тогда можно использовать CFBundleLoadExecutable и CFBundleUnloadExecutable— несмотря на то, что не рекомендуется этот метод. Эти функции вызывают непосредственную загрузку и разгрузку исполнимой программы (если это не было уже загружено/разгружено, и в случае разгрузки, если исполнимая программа имеет тип, поддерживающий разгрузку). Если Вы делаете это, то вызов кода CFBundleUnloadExecutable ответственно за проверку, что нет никаких остающихся ссылок ни на что в коде пакета, прежде чем он будет разгружен. В предыдущем подходе, в отличие от этого, эта ответственность может быть распределена отдельным разделам кода, использующим пакет путем проверки, что каждый сохраняет его собственное, сохраняют на объекте CFBundle.

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

Обратите внимание на то, что лучше компилировать любые незагружаемые пакеты с флагом -fno-constant-cfstrings— дополнительную информацию см. в Руководстве по программированию Пакета.

Функции

Создание и доступ к пакетам
  • CFBundleCreate (_: _:) CFBundleCreate

    Создает объект CFBundle.

    Объявление

    Swift

    func CFBundleCreate(_ allocator: CFAllocator!, _ bundleURL: CFURL!) -> CFBundle!

    Objective C

    CFBundleRef CFBundleCreate ( CFAllocatorRef allocator, CFURLRef bundleURL );

    Параметры

    allocator

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

    bundleURL

    Расположение пакета, для которого можно создать объект CFBundle.

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

    Объект CFBundle, создаваемый из пакета в bundleURL. Владение соблюдает Создать Правило.

    Возвраты NULL если была проблема выделения памяти. Может возвратить существующий объект CFBundle с постепенно увеличенным подсчетом ссылок. Может возвратиться NULL если пакет не существует в bundleURL (см. Обсуждение).

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCreateBundlesFromDirectory (_: _: _:) CFBundleCreateBundlesFromDirectory

    Ищет каталог и создает массив объектов CFBundle от всех допустимых пакетов в указанном каталоге.

    Объявление

    Swift

    func CFBundleCreateBundlesFromDirectory(_ allocator: CFAllocator!, _ directoryURL: CFURL!, _ bundleType: CFString!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCreateBundlesFromDirectory ( CFAllocatorRef allocator, CFURLRef directoryURL, CFStringRef bundleType );

    Параметры

    allocator

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

    directoryURL

    Расположение каталога для поиска допустимых пакетов.

    bundleType

    Абстрактный тип пакетов, чтобы расположиться и создать. Тип выражен как расширение файла, такой как bundle. Передача NULL создать объекты CFBundle для пакетов любого типа.

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

    Объект CFArray, содержащий объекты CFBundle, создается из содержания указанного каталога. Если никакие пакеты не существуют в, возвращает пустой массив directoryURL, и NULL если была проблема выделения памяти. Владение соблюдает Создать Правило.

    Обсуждение

    Массив, возвращенный этой функцией, не будет содержать устаревшие ссылки CFBundle.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetAllBundles () CFBundleGetAllBundles

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

    Объявление

    Swift

    func CFBundleGetAllBundles() -> CFArray!

    Objective C

    CFArrayRef CFBundleGetAllBundles ( void );

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

    Объект CFArray, содержащий CFBundle, возражает для каждого открытого пакета в приложении. Владение соблюдает Получить Правило.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetBundleWithIdentifier (_:) CFBundleGetBundleWithIdentifier

    Найдите пакет, данный его определенный с помощью программы идентификатор.

    Объявление

    Swift

    func CFBundleGetBundleWithIdentifier(_ bundleID: CFString!) -> CFBundle!

    Objective C

    CFBundleRef CFBundleGetBundleWithIdentifier ( CFStringRef bundleID );

    Параметры

    bundleID

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

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

    Объект CFBundle, или NULL если не был найден пакет. Владение соблюдает Получить Правило.

    Обсуждение

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

    Идентификаторы пакета создаются путем ввода значения для ключа CFBundleIdentifier в пакете Info.plist файл.

    Для обеспечения уникальности необходимо создать идентификаторы пакета с формой обратного DNS, называющего имена пакета стиля, такой как com.MyCompany.MyApp.bundleName.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetMainBundle () CFBundleGetMainBundle

    Возвращает основной пакет приложения.

    Объявление

    Swift

    func CFBundleGetMainBundle() -> CFBundle!

    Objective C

    CFBundleRef CFBundleGetMainBundle ( void );

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

    Объект CFBundle представление основного пакета приложения, или NULL если не возможно создать пакет. Владение соблюдает Получить Правило.

    Обсуждение

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

    Для объяснения основного пакета посмотрите Определение местоположения и Открытие Bundles in Bundle Programming Guide.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Загрузка и разгрузка пакет
  • CFBundleIsExecutableLoaded (_:) CFBundleIsExecutableLoaded

    Получает информацию о состоянии загрузки для основной исполнимой программы пакета.

    Объявление

    Swift

    func CFBundleIsExecutableLoaded(_ bundle: CFBundle!) -> Boolean

    Objective C

    Boolean CFBundleIsExecutableLoaded ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    true если bundleосновная исполнимая программа была загружена, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundlePreflightExecutable (_: _:) CFBundlePreflightExecutable

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

    Объявление

    Swift

    func CFBundlePreflightExecutable(_ bundle: CFBundle!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFBundlePreflightExecutable ( CFBundleRef bundle, CFErrorRef *error );

    Параметры

    bundle

    Пакет для исследования.

    error

    По возврату, если ошибка происходит, содержит CFError, описывающий проблему. Владение соблюдает Создать Правило.

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

    true если bundle загружается или на проверку, кажется, загружаемый, иначе false.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleLoadExecutable (_:) CFBundleLoadExecutable

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

    Объявление

    Swift

    func CFBundleLoadExecutable(_ bundle: CFBundle!) -> Boolean

    Objective C

    Boolean CFBundleLoadExecutable ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет, основную исполнимую программу которого Вы хотите загрузить.

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

    true если исполнимая программа была успешно загружена, иначе false.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleLoadExecutableAndReturnError (_: _:) CFBundleLoadExecutableAndReturnError

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

    Объявление

    Swift

    func CFBundleLoadExecutableAndReturnError(_ bundle: CFBundle!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Boolean

    Objective C

    Boolean CFBundleLoadExecutableAndReturnError ( CFBundleRef bundle, CFErrorRef *error );

    Параметры

    bundle

    Пакет для исследования.

    error

    По возврату, если ошибка происходит, содержит CFError, описывающий проблему. Владение соблюдает Создать Правило.

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

    Если bundle уже загружается, возвраты true. Если bundle уже не загружается, попытки загрузиться bundle; если та попытка следует за возвратами true, иначе возвраты false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleUnloadExecutable (_:) CFBundleUnloadExecutable

    Разгружает основную исполнимую программу для указанного пакета.

    Объявление

    Swift

    func CFBundleUnloadExecutable(_ bundle: CFBundle!)

    Objective C

    void CFBundleUnloadExecutable ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет, основную исполнимую программу которого Вы хотите разгрузить.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Нахождение расположений в пакете
  • CFBundleCopyAuxiliaryExecutableURL (_: _:) CFBundleCopyAuxiliaryExecutableURL

    Возвращает расположение вспомогательного исполняемого кода пакета.

    Объявление

    Swift

    func CFBundleCopyAuxiliaryExecutableURL(_ bundle: CFBundle!, _ executableName: CFString!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyAuxiliaryExecutableURL ( CFBundleRef bundle, CFStringRef executableName );

    Параметры

    bundle

    Пакет для исследования.

    executableName

    Имя bundleвспомогательный исполняемый код.

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

    Расположение URL вспомогательного исполняемого кода указанного пакета, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyBuiltInPlugInsURL (_:) CFBundleCopyBuiltInPlugInsURL

    Возвращается расположение пакета создало в плагине.

    Объявление

    Swift

    func CFBundleCopyBuiltInPlugInsURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyBuiltInPlugInsURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL описание расположения bundleсозданный в плагинах, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyExecutableURL (_:) CFBundleCopyExecutableURL

    Возвращает расположение основного исполняемого кода пакета.

    Объявление

    Swift

    func CFBundleCopyExecutableURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyExecutableURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyPrivateFrameworksURL (_:) CFBundleCopyPrivateFrameworksURL

    Возвращает расположение частного каталога Frameworks пакета.

    Объявление

    Swift

    func CFBundleCopyPrivateFrameworksURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyPrivateFrameworksURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL описание расположения bundleчастный каталог платформ, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourcesDirectoryURL (_:) CFBundleCopyResourcesDirectoryURL

    Возвращает расположение каталога Resources пакета.

    Объявление

    Swift

    func CFBundleCopyResourcesDirectoryURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyResourcesDirectoryURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL описание расположения bundleкаталог ресурсов, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

    Обсуждение

    В целом Вы никогда не должны должны быть использовать эту функцию. Использовать CFBundleCopyResourceURL и подобные функции вместо этого.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopySharedFrameworksURL (_:) CFBundleCopySharedFrameworksURL

    Возвращает расположение совместно используемого каталога платформ пакета.

    Объявление

    Swift

    func CFBundleCopySharedFrameworksURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopySharedFrameworksURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL, содержащий расположение bundleсовместно используемый каталог платформ, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopySharedSupportURL (_:) CFBundleCopySharedSupportURL

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

    Объявление

    Swift

    func CFBundleCopySharedSupportURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopySharedSupportURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL, содержащий расположение bundleсовместно используемый каталог файлов поддержки, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopySupportFilesDirectoryURL (_:) CFBundleCopySupportFilesDirectoryURL

    Возвращает расположение каталога файлов поддержки пакета.

    Объявление

    Swift

    func CFBundleCopySupportFilesDirectoryURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopySupportFilesDirectoryURL ( CFBundleRef bundle );

    Параметры

    bundle

    CFBundle возражают, чьего каталога файлов поддержки Вы хотите определить местоположение.

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

    Объект CFURL описание расположения каталога файлов поддержки пакета, или NULL если это не могло бы быть найдено. Владение соблюдает Создать Правило.

    Обсуждение

    В целом Вы никогда не должны должны быть использовать эту функцию. Использовать CFBundleCopyResourceURL и подобные функции вместо этого.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Определение местоположения ресурсов пакета
  • CFBundleCloseBundleResourceMap (_: _:) CFBundleCloseBundleResourceMap

    Закрывает открытую карту ресурса для пакета.

    Объявление

    Swift

    func CFBundleCloseBundleResourceMap(_ bundle: CFBundle!, _ refNum: CFBundleRefNum)

    Objective C

    void CFBundleCloseBundleResourceMap ( CFBundleRef bundle, CFBundleRefNum refNum );

    Параметры

    bundle

    Пакет, картой ресурса которого ссылаются refNum.

    refNum

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

    Обсуждение

    Вы открываете карту ресурса с помощью также CFBundleOpenBundleResourceFiles или CFBundleOpenBundleResourceMap.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURL (_: _: _: _:) CFBundleCopyResourceURL

    Возвращает расположение ресурса, содержавшегося в указанном пакете.

    Объявление

    Swift

    func CFBundleCopyResourceURL(_ bundle: CFBundle!, _ resourceName: CFString!, _ resourceType: CFString!, _ subDirName: CFString!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyResourceURL ( CFBundleRef bundle, CFStringRef resourceName, CFStringRef resourceType, CFStringRef subDirName );

    Параметры

    bundle

    Пакет для исследования.

    resourceName

    Имя требуемого ресурса.

    resourceType

    Абстрактный тип требуемого ресурса. Тип выражен как расширение файла, такой как jpg. Передача NULL если resourceName полное имя файла, который Вы ищете, включая любое расширение.

    subDirName

    Имя подкаталога каталога ресурсов пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

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

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

    Обсуждение

    Например, если пакет содержит подкаталог WaterSounds это включает файл Water1.aiff, можно получить URL для использования файла:

    • CFBundleCopyResourceURL(bundle, CFSTR("Water1"), CFSTR("aiff"), CFSTR("WaterSounds"));

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURLInDirectory (_: _: _: _:) CFBundleCopyResourceURLInDirectory

    Возвращает расположение ресурса, содержавшегося в указанном каталоге пакета, не требуя создания объекта CFBundle.

    Объявление

    Swift

    func CFBundleCopyResourceURLInDirectory(_ bundleURL: CFURL!, _ resourceName: CFString!, _ resourceType: CFString!, _ subDirName: CFString!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyResourceURLInDirectory ( CFURLRef bundleURL, CFStringRef resourceName, CFStringRef resourceType, CFStringRef subDirName );

    Параметры

    bundleURL

    Пакет для исследования.

    resourceName

    Имя требуемого ресурса.

    resourceType

    Абстрактный тип требуемого ресурса. Тип выражен как расширение файла, такой как jpg. Передача NULL если Вы не должны искать типом.

    subDirName

    Имя подкаталога каталога ресурсов пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

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

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

    Обсуждение

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

    Обратите внимание на то, что поиски чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURLsOfType (_: _: _:) CFBundleCopyResourceURLsOfType

    Собирает массив URLs, указывающего все ресурсы указанного типа, найденного в пакете.

    Объявление

    Swift

    func CFBundleCopyResourceURLsOfType(_ bundle: CFBundle!, _ resourceType: CFString!, _ subDirName: CFString!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyResourceURLsOfType ( CFBundleRef bundle, CFStringRef resourceType, CFStringRef subDirName );

    Параметры

    bundle

    Пакет для исследования.

    resourceType

    Абстрактный тип ресурсов для определения местоположения. Тип выражен как расширение файла, такой как jpg.

    subDirName

    Имя подкаталога каталога ресурсов пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

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

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

    Обсуждение

    Обратите внимание на то, что поиски чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURLsOfTypeInDirectory (_: _: _:) CFBundleCopyResourceURLsOfTypeInDirectory

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

    Объявление

    Swift

    func CFBundleCopyResourceURLsOfTypeInDirectory(_ bundleURL: CFURL!, _ resourceType: CFString!, _ subDirName: CFString!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyResourceURLsOfTypeInDirectory ( CFURLRef bundleURL, CFStringRef resourceType, CFStringRef subDirName );

    Параметры

    bundleURL

    Расположение пакета для исследования.

    resourceType

    Абстрактный тип ресурсов для определения местоположения. Тип выражен как расширение файла, такой как jpg.

    subDirName

    Имя подкаталога каталога ресурсов пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

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

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

    Обсуждение

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

    Обратите внимание на то, что имена файлов чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURLForLocalization (_: _: _: _: _:) CFBundleCopyResourceURLForLocalization

    Возвращает расположение локализованного ресурса в пакете.

    Объявление

    Swift

    func CFBundleCopyResourceURLForLocalization(_ bundle: CFBundle!, _ resourceName: CFString!, _ resourceType: CFString!, _ subDirName: CFString!, _ localizationName: CFString!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyResourceURLForLocalization ( CFBundleRef bundle, CFStringRef resourceName, CFStringRef resourceType, CFStringRef subDirName, CFStringRef localizationName );

    Параметры

    bundle

    Пакет для исследования.

    resourceName

    Имя требуемого ресурса.

    resourceType

    Абстрактный тип ресурса для определения местоположения. Тип выражен как расширение файла, такой как jpg.

    subDirName

    Имя подкаталога каталога ресурсов пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

    localizationName

    Имя локализации. Это значение должно соответствовать имени одного из специфичных для языка каталогов ресурса пакета без .lproj расширение. (Этот параметр обрабатывается буквально: Если Вы передаете "de", функция не будет соответствовать ресурсы в a German.lproj каталог в пакете.)

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

    Расположение локализованного ресурса в bundle, или NULL если не мог бы быть найден ресурс. Владение соблюдает Создать Правило.

    Обсуждение

    Обратите внимание на то, что имена файлов чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.

    У Вас должно обычно быть мало причины использовать эту функцию (см. Получение Текущего языка и Локали) — интерфейсы CFBUNDLE автоматически применяют предпочтения пользователя для определения, который локализовал файлы ресурсов для возврата в ответ на программируемый запрос. См. также CFBundleCopyBundleLocalizations поскольку, как определить, какие локализации доступны

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyResourceURLsOfTypeForLocalization (_: _: _: _:) CFBundleCopyResourceURLsOfTypeForLocalization

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

    Объявление

    Swift

    func CFBundleCopyResourceURLsOfTypeForLocalization(_ bundle: CFBundle!, _ resourceType: CFString!, _ subDirName: CFString!, _ localizationName: CFString!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyResourceURLsOfTypeForLocalization ( CFBundleRef bundle, CFStringRef resourceType, CFStringRef subDirName, CFStringRef localizationName );

    Параметры

    bundle

    Пакет для исследования.

    resourceType

    Абстрактный тип ресурсов для определения местоположения. Тип выражен как расширение файла, такой как jpg.

    subDirName

    Имя подкаталога каталога Resources пакета для поиска. Передача NULL искать стандартные расположения ресурса CFBundle.

    localizationName

    Имя локализации. Это значение должно соответствовать имени одного из специфичных для языка каталогов ресурса пакета без .lproj расширение. (Этот параметр обрабатывается буквально: Если Вы передаете "de", функция не будет соответствовать ресурсы в a German.lproj каталог в пакете.)

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

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

    Обсуждение

    Обратите внимание на то, что имена файлов чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.

    У Вас должно обычно быть мало причины использовать эту функцию (см. Получение Текущего языка и Локали) — интерфейсы CFBUNDLE автоматически применяют предпочтения пользователя для определения, который локализовал файлы ресурсов для возврата в ответ на программируемый запрос. См. также CFBundleCopyBundleLocalizations поскольку, как определить, какие локализации доступны

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleOpenBundleResourceFiles (_: _: _:) CFBundleOpenBundleResourceFiles

    Открывает нелокализованные и локализованные файлы ресурсов (если таковые имеются) для пакета в отдельных картах ресурса.

    Объявление

    Swift

    func CFBundleOpenBundleResourceFiles(_ bundle: CFBundle!, _ refNum: UnsafeMutablePointer<CFBundleRefNum>, _ localizedRefNum: UnsafeMutablePointer<CFBundleRefNum>) -> Int32

    Objective C

    SInt32 CFBundleOpenBundleResourceFiles ( CFBundleRef bundle, CFBundleRefNum *refNum, CFBundleRefNum *localizedRefNum );

    Параметры

    bundle

    Пакет, карту ресурса которого Вы хотите открыть.

    refNum

    По возврату, ссылочному номеру нелокализованной карты ресурса.

    localizedRefNum

    По возврату, ссылочному номеру локализованной карты ресурса.

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

    Код ошибки. Функциональные возвраты 0 (noErr) в случае успеха. Если пакет содержит больше чем один файл ресурсов, функция возвращает код ошибки, только если ни один не был открыт. Наиболее распространенная ошибка resFNotFound, но функция может также пройти через другие ошибки, возвращенные из Менеджера ресурсов.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleOpenBundleResourceMap (_:) CFBundleOpenBundleResourceMap

    Открывает нелокализованные и локализованные файлы ресурсов (если таковые имеются) для пакета в единственной карте ресурса.

    Объявление

    Swift

    func CFBundleOpenBundleResourceMap(_ bundle: CFBundle!) -> CFBundleRefNum

    Objective C

    CFBundleRefNum CFBundleOpenBundleResourceMap ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет, карту ресурса которого Вы хотите открыть.

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

    Отличный ссылочный номер для карты ресурса.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Управление локализациями
  • CFBundleCopyBundleLocalizations (_:) CFBundleCopyBundleLocalizations

    Возвращает массив, содержащий локализации пакета.

    Объявление

    Swift

    func CFBundleCopyBundleLocalizations(_ bundle: CFBundle!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyBundleLocalizations ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Массив, содержащий bundleлокализации. Владение соблюдает Создать Правило.

    Обсуждение

    Массив, возвращенный этой функцией, обычно передается в качестве параметра любому CFBundleCopyPreferredLocalizationsFromArray или CFBundleCopyLocalizationsForPreferences функция.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyLocalizedString (_: _: _: _:) CFBundleCopyLocalizedString

    Возвращает локализованную строку из строкового файла пакета.

    Объявление

    Swift

    func CFBundleCopyLocalizedString(_ bundle: CFBundle!, _ key: CFString!, _ value: CFString!, _ tableName: CFString!) -> CFString!

    Objective C

    CFStringRef CFBundleCopyLocalizedString ( CFBundleRef bundle, CFStringRef key, CFStringRef value, CFStringRef tableName );

    Параметры

    bundle

    Пакет для исследования.

    key

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

    value

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

    tableName

    Имя строкового файла для поиска. Имя не должно включать strings расширение файла. Случай строки должен соответствовать случай имени файла, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов

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

    Объект CFString, содержащий локализованную строку. Если никакое значение не существует для key, возвраты value если value NULL или пустая строка, когда key возвращается вместо этого. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyLocalizationsForPreferences (_: _:) CFBundleCopyLocalizationsForPreferences

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

    Объявление

    Swift

    func CFBundleCopyLocalizationsForPreferences(_ locArray: CFArray!, _ prefArray: CFArray!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyLocalizationsForPreferences ( CFArrayRef locArray, CFArrayRef prefArray );

    Параметры

    locArray

    Массив возможных локализаций для поиска.

    prefArray

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

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

    Массив, содержащий локализации, которые использовал бы CFBundle. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyLocalizationsForURL (_:) CFBundleCopyLocalizationsForURL

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

    Объявление

    Swift

    func CFBundleCopyLocalizationsForURL(_ url: CFURL!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyLocalizationsForURL ( CFURLRef url );

    Параметры

    url

    Расположение локализаций пакета.

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

    Массив, содержащий локализации, доступные в url. Владение соблюдает Создать Правило.

    Обсуждение

    Для каталога URL это эквивалентно вызову CFBundleCopyBundleLocalizations функция на соответствующем пакете. Для простого файла URL, представляющий несвязанное приложение, это попытается определить его локализации с помощью kCFBundleLocalizationsKey и kCFBundleDevelopmentRegionKey ключи в словаре, возвращенном CFBundleCopyInfoDictionaryForURL, или a vers ресурс, если те не присутствуют.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyPreferredLocalizationsFromArray (_:) CFBundleCopyPreferredLocalizationsFromArray

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

    Объявление

    Swift

    func CFBundleCopyPreferredLocalizationsFromArray(_ locArray: CFArray!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyPreferredLocalizationsFromArray ( CFArrayRef locArray );

    Параметры

    locArray

    Массив возможных локализаций.

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

    Подмножество locArray это CFBundle использовало бы в текущем контексте приложения. Владение соблюдает Создать Правило.

    Обсуждение

    Можно получить locArray использование CFBundleCopyBundleLocalizations функция.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFCopyLocalizedString CFCopyLocalizedString

    Ищет строковый файл по умолчанию Localizable.strings для строки, связанной с указанным ключом.

    Объявление

    Objective C

    CFStringRef CFCopyLocalizedString ( CFStringRef key, const char *comment );

    Параметры

    key

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

    comment

    Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.

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

    Локализованная версия требуемой строки. Возвраты key если никакое соответствие значения key найден. Владение соблюдает Создать Правило.

    Обсуждение

    Это - макро-вариант CFBundleCopyLocalizedString для использования с genstrings инструмент.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • CFCopyLocalizedStringFromTable CFCopyLocalizedStringFromTable

    Ищет указанный строковый файл строку, связанную с указанным ключом.

    Объявление

    Objective C

    CFStringRef CFCopyLocalizedStringFromTable ( CFStringRef key, CFStringRef tableName, const char *comment );

    Параметры

    key

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

    tableName

    Имя строкового файла для поиска. Имя не должно включать strings расширение файла. Случай строки должен соответствовать случай имени файла, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов

    comment

    Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.

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

    Локализованная версия требуемой строки, или key если никакое соответствие значения key найден. Владение соблюдает Создать Правило.

    Обсуждение

    Это - макро-вариант CFBundleCopyLocalizedString для использования с genstrings инструмент.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • CFCopyLocalizedStringFromTableInBundle CFCopyLocalizedStringFromTableInBundle

    Возвращает локализованную версию указанной строки.

    Объявление

    Objective C

    CFStringRef CFCopyLocalizedStringFromTableInBundle ( CFStringRef key, CFStringRef tableName, CFBundleRef bundle, const char *comment );

    Параметры

    key

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

    tableName

    Имя строкового файла для поиска. Имя не должно включать strings расширение файла. Случай строки должен соответствовать случай имени файла, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов

    bundle

    Пакет для исследования.

    comment

    Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.

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

    Локализованная версия требуемой строки, или key если никакое соответствие значения key найден. Владение соблюдает Создать Правило.

    Обсуждение

    Это - макро-вариант CFBundleCopyLocalizedString для использования с genstrings инструмент.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

  • CFCopyLocalizedStringWithDefaultValue CFCopyLocalizedStringWithDefaultValue

    Возвращает локализованную версию строки локализации.

    Объявление

    Objective C

    CFStringRef CFCopyLocalizedStringWithDefaultValue ( CFStringRef key, CFStringRef tableName, CFBundleRef bundle, CFStringRef value, const char *comment );

    Параметры

    key

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

    tableName

    Имя строкового файла для поиска. Имя не должно включать strings расширение файла.

    bundle

    Пакет для исследования.

    value

    Значение по умолчанию для требуемой строки локализации.

    comment

    Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.

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

    Локализованная версия требуемой строки. Если никакое соответствие значения key найден, возвраты value, если value NULL или пустая строка, когда key возвращается вместо этого. Владение соблюдает Создать Правило.

    Обсуждение

    Это - макро-вариант CFBundleCopyLocalizedString для использования с genstrings инструмент.

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

    Objective C

    @import CoreFoundation;

    Доступность

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

Управление исполняемым кодом
  • CFBundleGetDataPointerForName (_: _:) CFBundleGetDataPointerForName

    Возвращает указатель данных на символ имени.

    Объявление

    Swift

    func CFBundleGetDataPointerForName(_ bundle: CFBundle!, _ symbolName: CFString!) -> UnsafeMutablePointer<Void>

    Objective C

    void * CFBundleGetDataPointerForName ( CFBundleRef bundle, CFStringRef symbolName );

    Параметры

    bundle

    Пакет для исследования.

    symbolName

    Имя символа Вы ищете.

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

    Указатель данных на символ называют symbolName в bundle, или NULL если symbolName не может быть найден. Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetDataPointersForNames (_: _: _:) CFBundleGetDataPointersForNames

    Возвращает массив C указателя данных на символы имен.

    Объявление

    Swift

    func CFBundleGetDataPointersForNames(_ bundle: CFBundle!, _ symbolNames: CFArray!, _ stbl: UnsafeMutablePointer<UnsafeMutablePointer<Void>>)

    Objective C

    void CFBundleGetDataPointersForNames ( CFBundleRef bundle, CFArrayRef symbolNames, void *stbl[] );

    Параметры

    bundle

    Пакет для исследования.

    symbolNames

    Объект CFArray, содержащий объекты CFString, представляющие символ, называет к поиску.

    stbl

    C выстраивает, в который эта функция хранит указатели данных для символов, указанных в symbolNames. Массив содержит NULL для любых имен в symbolNames это не может быть найдено.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetFunctionPointerForName (_: _:) CFBundleGetFunctionPointerForName

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

    Объявление

    Swift

    func CFBundleGetFunctionPointerForName(_ bundle: CFBundle!, _ functionName: CFString!) -> UnsafeMutablePointer<Void>

    Objective C

    void * CFBundleGetFunctionPointerForName ( CFBundleRef bundle, CFStringRef functionName );

    Параметры

    bundle

    Пакет для исследования.

    functionName

    Имя функции для определения местоположения.

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

    Указатель на функцию в a bundleисполняемый код, или NULL если functionName не может быть найден. Владение соблюдает Получить Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetFunctionPointersForNames (_: _: _:) CFBundleGetFunctionPointersForNames

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

    Объявление

    Swift

    func CFBundleGetFunctionPointersForNames(_ bundle: CFBundle!, _ functionNames: CFArray!, _ ftbl: UnsafeMutablePointer<UnsafeMutablePointer<Void>>)

    Objective C

    void CFBundleGetFunctionPointersForNames ( CFBundleRef bundle, CFArrayRef functionNames, void *ftbl[] );

    Параметры

    bundle

    Пакет для исследования.

    functionNames

    Объект CFArray, содержащий список имен функций для определения местоположения.

    ftbl

    C выстраивает, в который эта функция хранит указатели функции для символов, указанных в functionNames. Массив содержит NULL для любых имен в functionNames это не может быть найдено.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetPlugIn (_:) CFBundleGetPlugIn

    Возвращает плагин пакета.

    Объявление

    Swift

    func CFBundleGetPlugIn(_ bundle: CFBundle!) -> CFPlugIn!

    Objective C

    CFPlugInRef CFBundleGetPlugIn ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Плагин для bundle. Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Получение свойств пакета
  • CFBundleCopyBundleURL (_:) CFBundleCopyBundleURL

    Возвращает расположение пакета.

    Объявление

    Swift

    func CFBundleCopyBundleURL(_ bundle: CFBundle!) -> CFURL!

    Objective C

    CFURLRef CFBundleCopyBundleURL ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFURL описание расположения bundle, или NULL если не существует указанный пакет. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetDevelopmentRegion (_:) CFBundleGetDevelopmentRegion

    Возвращает область разработки пакета из информационного списка свойств пакета.

    Объявление

    Swift

    func CFBundleGetDevelopmentRegion(_ bundle: CFBundle!) -> CFString!

    Objective C

    CFStringRef CFBundleGetDevelopmentRegion ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFString, содержащий имя области разработки пакета. Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetIdentifier (_:) CFBundleGetIdentifier

    Возвращает идентификатор пакета из информационного списка свойств пакета.

    Объявление

    Swift

    func CFBundleGetIdentifier(_ bundle: CFBundle!) -> CFString!

    Objective C

    CFStringRef CFBundleGetIdentifier ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFString, содержащий идентификатор пакета, или NULL если ни один не был указан в информационном списке свойств. Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetInfoDictionary (_:) CFBundleGetInfoDictionary

    Возвращает информационный словарь пакета.

    Объявление

    Swift

    func CFBundleGetInfoDictionary(_ bundle: CFBundle!) -> CFDictionary!

    Objective C

    CFDictionaryRef CFBundleGetInfoDictionary ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Объект CFDictionary, содержащий данные, хранившие в информационном списке свойств пакета ( Info.plist файл). Это - глобальный информационный словарь. CFBundle может добавить дополнительные ключи к этому словарю для его собственного использования. Владение соблюдает Получить Правило.

    Обсуждение

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

    Для получения информационного словаря, не создавая объект CFBundle посмотрите CFBundleCopyInfoDictionaryInDirectory и CFBundleCopyInfoDictionaryForURL.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetLocalInfoDictionary (_:) CFBundleGetLocalInfoDictionary

    Возвращает локализованный информационный словарь пакета.

    Объявление

    Swift

    func CFBundleGetLocalInfoDictionary(_ bundle: CFBundle!) -> CFDictionary!

    Objective C

    CFDictionaryRef CFBundleGetLocalInfoDictionary ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Словарь, содержащий пары ключ/значение в bundleлокализованный информационный словарь (от InfoPlist.strings файл для текущей локали). Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetValueForInfoDictionaryKey (_: _:) CFBundleGetValueForInfoDictionaryKey

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

    Объявление

    Swift

    func CFBundleGetValueForInfoDictionaryKey(_ bundle: CFBundle!, _ key: CFString!) -> AnyObject!

    Objective C

    CFTypeRef CFBundleGetValueForInfoDictionaryKey ( CFBundleRef bundle, CFStringRef key );

    Параметры

    bundle

    Пакет для исследования.

    key

    Ключ для значения для возврата.

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

    Соответствие значения key в bundleинформационный словарь. При наличии локализованное значение возвращается, иначе глобальное значение возвращается. Владение соблюдает Получить Правило.

    Обсуждение

    Необходимо использовать эту функцию вместо того, чтобы получить значения непосредственно из информационного словаря (Info.plist) потому что CFBundleGetValueForInfoDictionaryKey возвраты локализовали значения, если кто-либо доступен (от InfoPlist.strings файл для текущей локали).

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyInfoDictionaryInDirectory (_:) CFBundleCopyInfoDictionaryInDirectory

    Возвращает информационный словарь пакета.

    Объявление

    Swift

    func CFBundleCopyInfoDictionaryInDirectory(_ bundleURL: CFURL!) -> CFDictionary!

    Objective C

    CFDictionaryRef CFBundleCopyInfoDictionaryInDirectory ( CFURLRef bundleURL );

    Параметры

    bundleURL

    Объект CFURL описание расположения пакета.

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

    Объект CFDictionary, содержащий информационный словарь для пакета, расположился в bundleURL. Владение соблюдает Создать Правило.

    Обсуждение

    Эта функция обеспечивает средние значения для получения информационного словаря для пакета без первого создания объекта CFBundle.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyInfoDictionaryForURL (_:) CFBundleCopyInfoDictionaryForURL

    Возвращает информационный словарь для данного расположения URL.

    Объявление

    Swift

    func CFBundleCopyInfoDictionaryForURL(_ url: CFURL!) -> CFDictionary!

    Objective C

    CFDictionaryRef CFBundleCopyInfoDictionaryForURL ( CFURLRef url );

    Параметры

    url

    Объект CFURL описание расположения файла.

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

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

    Обсуждение

    Для каталога URL это эквивалентно CFBundleCopyInfoDictionaryInDirectory. Для простого файла URL, представляющий несвязанное приложение, эта функция попытается считать информационный словарь любой из (__TEXT, __info_plist) раздел файла (для Мужественного файла) или от a plst ресурс.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetPackageInfo (_: _: _:) CFBundleGetPackageInfo

    Возвращает тип и создателя пакета пакета.

    Объявление

    Swift

    func CFBundleGetPackageInfo(_ bundle: CFBundle!, _ packageType: UnsafeMutablePointer<UInt32>, _ packageCreator: UnsafeMutablePointer<UInt32>)

    Objective C

    void CFBundleGetPackageInfo ( CFBundleRef bundle, UInt32 *packageType, UInt32 *packageCreator );

    Параметры

    bundle

    Пакет для исследования.

    packageType

    По возврату, коду типа с четырьмя буквами для пакета. Это APPL для приложений, FMWK для платформ, и BNDL для универсальных пакетов. Или более определенный тип кодирует для универсальных пакетов.

    packageCreator

    По возврату, коду «создателя» с четырьмя буквами для пакета.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleGetPackageInfoInDirectory (_: _: _:) CFBundleGetPackageInfoInDirectory

    Возвращает тип пакета пакета и создателя, не имея необходимость создавать объект CFBundle.

    Объявление

    Swift

    func CFBundleGetPackageInfoInDirectory(_ url: CFURL!, _ packageType: UnsafeMutablePointer<UInt32>, _ packageCreator: UnsafeMutablePointer<UInt32>) -> Boolean

    Objective C

    Boolean CFBundleGetPackageInfoInDirectory ( CFURLRef url, UInt32 *packageType, UInt32 *packageCreator );

    Параметры

    url

    Расположение пакета.

    packageType

    По возврату, коду типа с четырьмя буквами для пакета. Это APPL для приложений, FMWK для платформ, и BNDL для универсальных пакетов. Или более определенный тип кодирует для универсальных пакетов.

    packageCreator

    По возврату, коду «создателя» с четырьмя буквами для пакета.

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

    true если тип пакета и создатель были найдены, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleCopyExecutableArchitectures (_:) CFBundleCopyExecutableArchitectures

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

    Объявление

    Swift

    func CFBundleCopyExecutableArchitectures(_ bundle: CFBundle!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyExecutableArchitectures ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования.

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

    Если исполнимая программа пакета существует и является Мужественным файлом, возвращает массив CFNumbers, значения которого являются целыми числами, представляющими архитектуру, которую обеспечивает файл. Возможные значения перечислены в Типах архитектуры. Если исполнимая программа не является Мужественным файлом, возвратами NULL. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFBundleCopyExecutableArchitecturesForURL

  • CFBundleCopyExecutableArchitecturesForURL (_:) CFBundleCopyExecutableArchitecturesForURL

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

    Объявление

    Swift

    func CFBundleCopyExecutableArchitecturesForURL(_ url: CFURL!) -> CFArray!

    Objective C

    CFArrayRef CFBundleCopyExecutableArchitecturesForURL ( CFURLRef url );

    Параметры

    url

    URL для исследования.

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

    Для каталога URL, если исполнимая программа пакета существует и является Мужественным файлом, возвращает массив CFNumbers, значения которого являются целыми числами, представляющими архитектуру, которую обеспечивает URL. Для простого файла URL, представляющий несвязанную исполнимую программу, возвращает архитектуру, которую это обеспечивает, если это - Мужественный файл. Возможные значения перечислены в Типах архитектуры. Если исполнимая программа не является Мужественным файлом, возвратами, если нет никакой исполнимой программы пакета или NULL. Владение соблюдает Создать Правило.

    Обсуждение

    Для каталога URL это эквивалентно вызову CFBundleCopyExecutableArchitectures на соответствующем пакете.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFBundleCopyExecutableArchitectures

  • CFBundleGetVersionNumber (_:) CFBundleGetVersionNumber

    Возвращает номер версии пакета.

    Объявление

    Swift

    func CFBundleGetVersionNumber(_ bundle: CFBundle!) -> UInt32

    Objective C

    UInt32 CFBundleGetVersionNumber ( CFBundleRef bundle );

    Параметры

    bundle

    Пакет для исследования. Номер версии пакета может быть числом или строкой стандартной формы «2.5.3d5».

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

    A vers номер версии стиля ресурса. Если это - строка, это автоматически преобразовывается в числовое представление, где номер основной версии ограничивается 2 цифрами BCD (другими словами, это должно быть в диапазоне 0-99), и номера версий незначительного и исправления ошибки каждый ограничиваются единственной цифрой (0-9) BCD.

    Обсуждение

    Эта функция только поддерживается для vers номера версий стиля ресурса. Где другой номер версии разрабатывает — а именно, X, или X.Y, или X.Y.Z — используются, можно использовать CFBundleGetValueForInfoDictionaryKey с ключом kCFBundleVersionKey извлечь номер версии как строку из информационного словаря пакета.

    Некоторые номера версий формы X, X.Y и X.Y.Z могут работать с этой функцией, если X <= 99, Y <= 9, и Z <= 9. Таким образом номер версии 76.5.4 будет работать, но 76.12 не будет работать.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Получение идентификатора типа CFBundle
  • CFBundleGetTypeID () CFBundleGetTypeID

    Возвращает идентификатор типа для непрозрачного типа CFBundle.

    Объявление

    Swift

    func CFBundleGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CFBundleGetTypeID ( void );

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

    Идентификатор типа для непрозрачного типа CFBundle.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Типы данных

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

  • CFBundleRefNum CFBundleRefNum

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

    Объявление

    Swift

    typealias CFBundleRefNum = Int32

    Objective C

    #if __LP64__ typedef int CFBundleRefNum; #else /* __LP64__ */ typedef SInt16 CFBundleRefNum; #endif /* __LP64__ */

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFBundleRef CFBundleRef

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

    Объявление

    Swift

    typealias CFBundleRef = CFBundle

    Objective C

    typedef struct __CFBundle *CFBundleRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Константы

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

  • Информационные ключи списка свойств

    Стандартные ключи найдены в информационном файле списка свойств пакета.

    Объявление

    Swift

    let kCFBundleInfoDictionaryVersionKey: CFString! let kCFBundleExecutableKey: CFString! let kCFBundleIdentifierKey: CFString! let kCFBundleVersionKey: CFString! let kCFBundleDevelopmentRegionKey: CFString! let kCFBundleNameKey: CFString! let kCFBundleLocalizationsKey: CFString!

    Objective C

    const CFStringRef kCFBundleInfoDictionaryVersionKey; const CFStringRef kCFBundleExecutableKey; const CFStringRef kCFBundleIdentifierKey; const CFStringRef kCFBundleVersionKey; const CFStringRef kCFBundleDevelopmentRegionKey; const CFStringRef kCFBundleNameKey; const CFStringRef kCFBundleLocalizationsKey;

    Константы

    • kCFBundleInfoDictionaryVersionKey

      kCFBundleInfoDictionaryVersionKey

      Версия информационного формата списка свойств.

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

    • kCFBundleExecutableKey

      kCFBundleExecutableKey

      Имя исполнимой программы в этом пакете (если таковые имеются).

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

    • kCFBundleIdentifierKey

      kCFBundleIdentifierKey

      Идентификатор пакета.

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

    • kCFBundleVersionKey

      kCFBundleVersionKey

      Номер версии пакета.

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

    • kCFBundleDevelopmentRegionKey

      kCFBundleDevelopmentRegionKey

      Имя языка разработки пакета.

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

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

    • kCFBundleNameKey

      kCFBundleNameKey

      Человекочитаемое имя пакета.

      Этот ключ часто находится в InfoPlist.strings так как это обычно локализуется.

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

    • kCFBundleLocalizationsKey

      kCFBundleLocalizationsKey

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

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

  • Типы архитектуры

    Константы, идентифицирующие исполнимые типы архитектуры.

    Объявление

    Swift

    var kCFBundleExecutableArchitectureI386: Int { get } var kCFBundleExecutableArchitecturePPC: Int { get } var kCFBundleExecutableArchitectureX86_64: Int { get } var kCFBundleExecutableArchitecturePPC64: Int { get }

    Objective C

    enum { kCFBundleExecutableArchitectureI386 = 0x00000007, kCFBundleExecutableArchitecturePPC = 0x00000012, kCFBundleExecutableArchitectureX86_64 = 0x01000007, kCFBundleExecutableArchitecturePPC64 = 0x01000012 };

    Константы

    • kCFBundleExecutableArchitectureI386

      kCFBundleExecutableArchitectureI386

      Указывает 32-разрядную архитектуру Intel.

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

    • kCFBundleExecutableArchitecturePPC

      kCFBundleExecutableArchitecturePPC

      Указывает 32-разрядную архитектуру PowerPC.

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

    • kCFBundleExecutableArchitectureX86_64

      kCFBundleExecutableArchitectureX86_64

      Указывает 64-разрядную архитектуру Intel.

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

    • kCFBundleExecutableArchitecturePPC64

      kCFBundleExecutableArchitecturePPC64

      Указывает 64-разрядную архитектуру PowerPC.

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