Ссылка CFBundle
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Swift
import CoreFoundation
Objective C
@import CoreFoundation;
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
— дополнительную информацию см. в Руководстве по программированию Пакета.
-
Создает объект 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
Доступность
Доступный в iOS 2.0 и позже.
-
Ищет каталог и создает массив объектов 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращается массив, содержащий все пакеты в настоящее время, открываются в приложении.
Объявление
Swift
func CFBundleGetAllBundles() -> CFArray!
Objective C
CFArrayRef CFBundleGetAllBundles ( void );
Возвращаемое значение
Объект CFArray, содержащий CFBundle, возражает для каждого открытого пакета в приложении. Владение соблюдает Получить Правило.
Специальные замечания
Эта функция является потенциально дорогой и не ориентированной на многопотоковое исполнение. Это лучше всего используется для отладки или других задач диагностики, а не как часть основного пути выполнения производственного кода.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Найдите пакет, данный его определенный с помощью программы идентификатор.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает основной пакет приложения.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Получает информацию о состоянии загрузки для основной исполнимой программы пакета.
Объявление
Swift
func CFBundleIsExecutableLoaded(_
bundle
: CFBundle!) -> BooleanObjective C
Boolean CFBundleIsExecutableLoaded ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
true
еслиbundle
основная исполнимая программа была загружена, иначеfalse
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает булево значение, указывающее, загружается ли данный пакет или, кажется, является загружаемым.
Объявление
Swift
func CFBundlePreflightExecutable(_
bundle
: CFBundle!, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BooleanObjective C
Boolean CFBundlePreflightExecutable ( CFBundleRef bundle, CFErrorRef *error );
Параметры
bundle
Пакет для исследования.
error
По возврату, если ошибка происходит, содержит CFError, описывающий проблему. Владение соблюдает Создать Правило.
Возвращаемое значение
true
еслиbundle
загружается или на проверку, кажется, загружаемый, иначеfalse
.Обсуждение
Если эта функция возвращает true, это не означает, что пакет является окончательно загружаемым, так как это может не загрузиться вследствие ошибок ссылки или других проблем, не с готовностью обнаруживаемых.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Загружает основной исполняемый код пакета в память и динамично соединяет его в запущенное приложение.
Объявление
Swift
func CFBundleLoadExecutable(_
bundle
: CFBundle!) -> BooleanObjective C
Boolean CFBundleLoadExecutable ( CFBundleRef bundle );
Параметры
bundle
Пакет, основную исполнимую программу которого Вы хотите загрузить.
Возвращаемое значение
true
если исполнимая программа была успешно загружена, иначеfalse
.Обсуждение
Необходимо обычно пытаться избегать использования этой функции, но вместо этого использовать
CFBundleGetFunctionPointerForName
и связанные функции, так как они делают управление памятью пакета проще.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает булево значение, указывающее, загружается ли данный пакет, пытаясь загрузить его при необходимости.
Объявление
Swift
func CFBundleLoadExecutableAndReturnError(_
bundle
: CFBundle!, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BooleanObjective C
Boolean CFBundleLoadExecutableAndReturnError ( CFBundleRef bundle, CFErrorRef *error );
Параметры
bundle
Пакет для исследования.
error
По возврату, если ошибка происходит, содержит CFError, описывающий проблему. Владение соблюдает Создать Правило.
Возвращаемое значение
Если
bundle
уже загружается, возвратыtrue
. Еслиbundle
уже не загружается, попытки загрузитьсяbundle
; если та попытка следует за возвратамиtrue
, иначе возвратыfalse
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Разгружает основную исполнимую программу для указанного пакета.
Объявление
Swift
func CFBundleUnloadExecutable(_
bundle
: CFBundle!)Objective C
void CFBundleUnloadExecutable ( CFBundleRef bundle );
Параметры
bundle
Пакет, основную исполнимую программу которого Вы хотите разгрузить.
Обсуждение
Необходимо обычно пытаться избегать использования этой функции, но вместо этого использовать
CFBundleGetFunctionPointerForName
и связанные функции, так как они делают управление пакетом проще (когда последняя ссылка на объект CFBundle выпущена, и это наконец освобождено, тогда код, будут разгружены, если это будет все еще загружено, и если исполнимая программа имеет тип, поддерживающий разгрузку).Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение вспомогательного исполняемого кода пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращается расположение пакета создало в плагине.
Объявление
Swift
func CFBundleCopyBuiltInPlugInsURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopyBuiltInPlugInsURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL описание расположения
bundle
созданный в плагинах, илиNULL
если это не могло бы быть найдено. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение основного исполняемого кода пакета.
Объявление
Swift
func CFBundleCopyExecutableURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopyExecutableURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL описание расположения
bundle
исполняемый код, илиNULL
если ни один не найден. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение частного каталога Frameworks пакета.
Объявление
Swift
func CFBundleCopyPrivateFrameworksURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopyPrivateFrameworksURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL описание расположения
bundle
частный каталог платформ, илиNULL
если это не могло бы быть найдено. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение каталога 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение совместно используемого каталога платформ пакета.
Объявление
Swift
func CFBundleCopySharedFrameworksURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopySharedFrameworksURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL, содержащий расположение
bundle
совместно используемый каталог платформ, илиNULL
если это не могло бы быть найдено. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение совместно используемого каталога файлов поддержки пакета.
Объявление
Swift
func CFBundleCopySharedSupportURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopySharedSupportURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL, содержащий расположение
bundle
совместно используемый каталог файлов поддержки, илиNULL
если это не могло бы быть найдено. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение каталога файлов поддержки пакета.
Объявление
Swift
func CFBundleCopySupportFilesDirectoryURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopySupportFilesDirectoryURL ( CFBundleRef bundle );
Параметры
bundle
CFBundle возражают, чьего каталога файлов поддержки Вы хотите определить местоположение.
Возвращаемое значение
Объект CFURL описание расположения каталога файлов поддержки пакета, или
NULL
если это не могло бы быть найдено. Владение соблюдает Создать Правило.Обсуждение
В целом Вы никогда не должны должны быть использовать эту функцию. Использовать
CFBundleCopyResourceURL
и подобные функции вместо этого.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Закрывает открытую карту ресурса для пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение ресурса, содержавшегося в указанном пакете.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение ресурса, содержавшегося в указанном каталоге пакета, не требуя создания объекта 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
Доступность
Доступный в iOS 2.0 и позже.
-
Собирает массив 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив объектов 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение локализованного ресурса в пакете.
Объявление
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"
, функция не будет соответствовать ресурсы в aGerman.lproj
каталог в пакете.)Возвращаемое значение
Расположение локализованного ресурса в
bundle
, илиNULL
если не мог бы быть найден ресурс. Владение соблюдает Создать Правило.Обсуждение
Обратите внимание на то, что имена файлов чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.
У Вас должно обычно быть мало причины использовать эту функцию (см. Получение Текущего языка и Локали) — интерфейсы CFBUNDLE автоматически применяют предпочтения пользователя для определения, который локализовал файлы ресурсов для возврата в ответ на программируемый запрос. См. также
CFBundleCopyBundleLocalizations
поскольку, как определить, какие локализации доступныОператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.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"
, функция не будет соответствовать ресурсы в aGerman.lproj
каталог в пакете.)Возвращаемое значение
Объект CFArray, содержащий копии требуемых расположений. Владение соблюдает Создать Правило.
Обсуждение
Обратите внимание на то, что имена файлов чувствительны к регистру, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файлов.
У Вас должно обычно быть мало причины использовать эту функцию (см. Получение Текущего языка и Локали) — интерфейсы CFBUNDLE автоматически применяют предпочтения пользователя для определения, который локализовал файлы ресурсов для возврата в ответ на программируемый запрос. См. также
CFBundleCopyBundleLocalizations
поскольку, как определить, какие локализации доступныОператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Открывает нелокализованные и локализованные файлы ресурсов (если таковые имеются) для пакета в отдельных картах ресурса.
Объявление
Swift
func CFBundleOpenBundleResourceFiles(_
bundle
: CFBundle!, _refNum
: UnsafeMutablePointer<CFBundleRefNum>, _localizedRefNum
: UnsafeMutablePointer<CFBundleRefNum>) -> Int32Objective C
SInt32 CFBundleOpenBundleResourceFiles ( CFBundleRef bundle, CFBundleRefNum *refNum, CFBundleRefNum *localizedRefNum );
Параметры
bundle
Пакет, карту ресурса которого Вы хотите открыть.
refNum
По возврату, ссылочному номеру нелокализованной карты ресурса.
localizedRefNum
По возврату, ссылочному номеру локализованной карты ресурса.
Возвращаемое значение
Код ошибки. Функциональные возвраты
0
(noErr
) в случае успеха. Если пакет содержит больше чем один файл ресурсов, функция возвращает код ошибки, только если ни один не был открыт. Наиболее распространенная ошибкаresFNotFound
, но функция может также пройти через другие ошибки, возвращенные из Менеджера ресурсов.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Открывает нелокализованные и локализованные файлы ресурсов (если таковые имеются) для пакета в единственной карте ресурса.
Объявление
Swift
func CFBundleOpenBundleResourceMap(_
bundle
: CFBundle!) -> CFBundleRefNumObjective C
CFBundleRefNum CFBundleOpenBundleResourceMap ( CFBundleRef bundle );
Параметры
bundle
Пакет, карту ресурса которого Вы хотите открыть.
Возвращаемое значение
Отличный ссылочный номер для карты ресурса.
Обсуждение
Создает и делает текущим единственная карта ресурса только для чтения, содержащая нелокализованные и локализованные файлы ресурсов. Если эта функция вызвана многократно, она открывает файлы многократно и возвращает отличные ссылочные номера для каждого. Использовать
CFBundleCloseBundleResourceMap
закрыть карту ресурса.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив, содержащий локализации пакета.
Объявление
Swift
func CFBundleCopyBundleLocalizations(_
bundle
: CFBundle!) -> CFArray!Objective C
CFArrayRef CFBundleCopyBundleLocalizations ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Массив, содержащий
bundle
локализации. Владение соблюдает Создать Правило.Обсуждение
Массив, возвращенный этой функцией, обычно передается в качестве параметра любому
CFBundleCopyPreferredLocalizationsFromArray
илиCFBundleCopyLocalizationsForPreferences
функция.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную строку из строкового файла пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Учитывая массив возможных локализаций и предпочтенных расположений, возвращает то или больше из них, что 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив, содержащий локализации для пакета или исполнимой программы в определенном расположении.
Объявление
Swift
func CFBundleCopyLocalizationsForURL(_
url
: CFURL!) -> CFArray!Objective C
CFArrayRef CFBundleCopyLocalizationsForURL ( CFURLRef url );
Параметры
url
Расположение локализаций пакета.
Возвращаемое значение
Массив, содержащий локализации, доступные в
url
. Владение соблюдает Создать Правило.Обсуждение
Для каталога URL это эквивалентно вызову
CFBundleCopyBundleLocalizations
функция на соответствующем пакете. Для простого файла URL, представляющий несвязанное приложение, это попытается определить его локализации с помощьюkCFBundleLocalizationsKey
иkCFBundleDevelopmentRegionKey
ключи в словаре, возвращенномCFBundleCopyInfoDictionaryForURL
, или avers
ресурс, если те не присутствуют.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Учитывая массив возможных локализаций, возвращает ту или больше из них, что 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
Доступность
Доступный в iOS 2.0 и позже.
-
Ищет строковый файл по умолчанию
Localizable.strings
для строки, связанной с указанным ключом.Объявление
Objective C
CFStringRef CFCopyLocalizedString ( CFStringRef key, const char *comment );
Параметры
key
Версия языка разработки строки. Эта строка используется в качестве ключа поиска для определения местоположения локализованной версии строки.
comment
Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.
Возвращаемое значение
Локализованная версия требуемой строки. Возвраты
key
если никакое соответствие значенияkey
найден. Владение соблюдает Создать Правило.Обсуждение
Это - макро-вариант
CFBundleCopyLocalizedString
для использования сgenstrings
инструмент.Оператор импорта
Objective C
@import CoreFoundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Ищет указанный строковый файл строку, связанную с указанным ключом.
Объявление
Objective C
CFStringRef CFCopyLocalizedStringFromTable ( CFStringRef key, CFStringRef tableName, const char *comment );
Параметры
key
Версия языка разработки строки. Эта строка используется в качестве ключа поиска для определения местоположения локализованной версии строки.
tableName
Имя строкового файла для поиска. Имя не должно включать
strings
расширение файла. Случай строки должен соответствовать случай имени файла, даже в файловых системах (таких как HFS +), которые не чувствительны к регистру относительно имен файловcomment
Комментарий для обеспечения переводчиков контекстной информацией, необходимой для надлежащего перевода.
Возвращаемое значение
Локализованная версия требуемой строки, или
key
если никакое соответствие значенияkey
найден. Владение соблюдает Создать Правило.Обсуждение
Это - макро-вариант
CFBundleCopyLocalizedString
для использования сgenstrings
инструмент.Оператор импорта
Objective C
@import CoreFoundation;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную версию указанной строки.
Объявление
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;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованную версию строки локализации.
Объявление
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;
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает указатель данных на символ имени.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает указатель на функцию в исполняемом коде пакета с помощью имени функции в качестве ключа поиска.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Создает функциональную таблицу, содержащую указатели на все функции, найденные в основном исполняемом коде пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает плагин пакета.
Объявление
Swift
func CFBundleGetPlugIn(_
bundle
: CFBundle!) -> CFPlugIn!Objective C
CFPlugInRef CFBundleGetPlugIn ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Плагин для
bundle
. Владение соблюдает Получить Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает расположение пакета.
Объявление
Swift
func CFBundleCopyBundleURL(_
bundle
: CFBundle!) -> CFURL!Objective C
CFURLRef CFBundleCopyBundleURL ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFURL описание расположения
bundle
, илиNULL
если не существует указанный пакет. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает область разработки пакета из информационного списка свойств пакета.
Объявление
Swift
func CFBundleGetDevelopmentRegion(_
bundle
: CFBundle!) -> CFString!Objective C
CFStringRef CFBundleGetDevelopmentRegion ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFString, содержащий имя области разработки пакета. Владение соблюдает Получить Правило.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает идентификатор пакета из информационного списка свойств пакета.
Объявление
Swift
func CFBundleGetIdentifier(_
bundle
: CFBundle!) -> CFString!Objective C
CFStringRef CFBundleGetIdentifier ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Объект CFString, содержащий идентификатор пакета, или
NULL
если ни один не был указан в информационном списке свойств. Владение соблюдает Получить Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает информационный словарь пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает локализованный информационный словарь пакета.
Объявление
Swift
func CFBundleGetLocalInfoDictionary(_
bundle
: CFBundle!) -> CFDictionary!Objective C
CFDictionaryRef CFBundleGetLocalInfoDictionary ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Словарь, содержащий пары ключ/значение в
bundle
локализованный информационный словарь (отInfoPlist.strings
файл для текущей локали). Владение соблюдает Получить Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает значение (локализованный если возможный) из информационного словаря пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает информационный словарь пакета.
Объявление
Swift
func CFBundleCopyInfoDictionaryInDirectory(_
bundleURL
: CFURL!) -> CFDictionary!Objective C
CFDictionaryRef CFBundleCopyInfoDictionaryInDirectory ( CFURLRef bundleURL );
Параметры
bundleURL
Объект CFURL описание расположения пакета.
Возвращаемое значение
Объект CFDictionary, содержащий информационный словарь для пакета, расположился в
bundleURL
. Владение соблюдает Создать Правило.Обсуждение
Эта функция обеспечивает средние значения для получения информационного словаря для пакета без первого создания объекта CFBundle.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает информационный словарь для данного расположения URL.
Объявление
Swift
func CFBundleCopyInfoDictionaryForURL(_
url
: CFURL!) -> CFDictionary!Objective C
CFDictionaryRef CFBundleCopyInfoDictionaryForURL ( CFURLRef url );
Параметры
url
Объект CFURL описание расположения файла.
Возвращаемое значение
Объект CFDictionary, содержащий
url
информационный словарь. Владение соблюдает Создать Правило.Обсуждение
Для каталога URL это эквивалентно
CFBundleCopyInfoDictionaryInDirectory
. Для простого файла URL, представляющий несвязанное приложение, эта функция попытается считать информационный словарь любой из(__TEXT, __info_plist)
раздел файла (для Мужественного файла) или от aplst
ресурс.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает тип и создателя пакета пакета.
Объявление
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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает тип пакета пакета и создателя, не имея необходимость создавать объект CFBundle.
Объявление
Swift
func CFBundleGetPackageInfoInDirectory(_
url
: CFURL!, _packageType
: UnsafeMutablePointer<UInt32>, _packageCreator
: UnsafeMutablePointer<UInt32>) -> BooleanObjective C
Boolean CFBundleGetPackageInfoInDirectory ( CFURLRef url, UInt32 *packageType, UInt32 *packageCreator );
Параметры
url
Расположение пакета.
packageType
По возврату, коду типа с четырьмя буквами для пакета. Это
APPL
для приложений,FMWK
для платформ, иBNDL
для универсальных пакетов. Или более определенный тип кодирует для универсальных пакетов.packageCreator
По возврату, коду «создателя» с четырьмя буквами для пакета.
Возвращаемое значение
true
если тип пакета и создатель были найдены, иначеfalse
.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив CFNumbers представление архитектуры, которую обеспечивает данный пакет.
Объявление
Swift
func CFBundleCopyExecutableArchitectures(_
bundle
: CFBundle!) -> CFArray!Objective C
CFArrayRef CFBundleCopyExecutableArchitectures ( CFBundleRef bundle );
Параметры
bundle
Пакет для исследования.
Возвращаемое значение
Если исполнимая программа пакета существует и является Мужественным файлом, возвращает массив CFNumbers, значения которого являются целыми числами, представляющими архитектуру, которую обеспечивает файл. Возможные значения перечислены в Типах архитектуры. Если исполнимая программа не является Мужественным файлом, возвратами
NULL
. Владение соблюдает Создать Правило.Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает массив 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
Доступность
Доступный в iOS 2.0 и позже.
См. также
-
Возвращает номер версии пакета.
Объявление
Swift
func CFBundleGetVersionNumber(_
bundle
: CFBundle!) -> UInt32Objective 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
Доступность
Доступный в iOS 2.0 и позже.
-
Возвращает идентификатор типа для непрозрачного типа CFBundle.
Объявление
Swift
func CFBundleGetTypeID() -> CFTypeID
Objective C
CFTypeID CFBundleGetTypeID ( void );
Возвращаемое значение
Идентификатор типа для непрозрачного типа CFBundle.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Введите, который идентифицирует отличный ссылочный номер для карты ресурса.
Объявление
Swift
typealias CFBundleRefNum = Int16
Objective C
#if __LP64__ typedef int CFBundleRefNum; #else /* __LP64__ */ typedef SInt16 CFBundleRefNum; #endif /* __LP64__ */
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Ссылка на объект CFBundle.
Объявление
Swift
typealias CFBundleRef = CFBundle
Objective C
typedef struct __CFBundle *CFBundleRef;
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.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
Версия информационного формата списка свойств.
Доступный в iOS 2.0 и позже.
-
kCFBundleExecutableKey
Имя исполнимой программы в этом пакете (если таковые имеются).
Доступный в iOS 2.0 и позже.
-
kCFBundleIdentifierKey
Идентификатор пакета.
Доступный в iOS 2.0 и позже.
-
kCFBundleVersionKey
Номер версии пакета.
Доступный в iOS 2.0 и позже.
-
kCFBundleDevelopmentRegionKey
Имя языка разработки пакета.
Когда CFBundle ищет ресурсы, нейтрализация должна посмотреть в lproj, имя которого дано
kCFBundleDevelopmentRegionKey
вInfo.plist
файл. Необходимо, поэтому, гарантировать, что пакет содержит lproj с тем точным именем, содержащим копию каждого локализованного ресурса, иначе CFBundle не может гарантировать, что будет работать механизм нейтрализации.Доступный в iOS 2.0 и позже.
-
kCFBundleNameKey
Человекочитаемое имя пакета.
Этот ключ часто находится в
InfoPlist.strings
так как это обычно локализуется.Доступный в iOS 2.0 и позже.
-
kCFBundleLocalizationsKey
Позволяет несвязанное приложение, обрабатывающее саму локализацию для указания, какие локализации она имеет в наличии.
Доступный в iOS 2.0 и позже.
-
-
Константы, идентифицирующие исполнимые типы архитектуры.
Объявление
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
Указывает 32-разрядную архитектуру Intel.
Доступный в iOS 2.0 и позже.
-
kCFBundleExecutableArchitecturePPC
Указывает 32-разрядную архитектуру PowerPC.
Доступный в iOS 2.0 и позже.
-
kCFBundleExecutableArchitectureX86_64
Указывает 64-разрядную архитектуру Intel.
Доступный в iOS 2.0 и позже.
-
kCFBundleExecutableArchitecturePPC64
Указывает 64-разрядную архитектуру PowerPC.
Доступный в iOS 2.0 и позже.
-