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

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

Разработчик

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

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

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

Ссылка CFMutableBag

CFMutableBag управляет динамическими сумками. Основной интерфейс для управления сумками предоставлен CFBag. CFMutableBag добавляет функции для изменения содержания сумки.

Вы создаете непостоянный объект сумки, использующий любого CFBagCreateMutable или CFBagCreateMutableCopy функция.

CFMutableBag обеспечивает несколько функций для добавления и удаления значений от сумки. CFBagAddValue функция добавляет значение к сумке и CFBagRemoveValue удаляет значения из сумки.

Функции

  • Создает новую пустую непостоянную сумку.

    Объявление

    Swift

    func CFBagCreateMutable(_ allocator: CFAllocator!, _ capacity: CFIndex, _ callBacks: UnsafePointer<CFBagCallBacks>) -> CFMutableBag!

    Objective C

    CFMutableBagRef CFBagCreateMutable ( CFAllocatorRef allocator, CFIndex capacity, const CFBagCallBacks *callBacks );

    Параметры

    allocator

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

    capacity

    Максимальное количество значений, которые могут содержаться новой сумкой. Сумка запускается пустой и может расти до этого числа значений (и это может иметь меньше). Если этот параметр 0, максимальная способность сумки не ограничивается. Это значение не должно быть отрицательным.

    callBacks

    Указатель на a CFBagCallBacks структура, инициализированная с обратными вызовами для использования для сохранения, выпустите, опишите и сравните значения в сумке. Копия содержания структуры обратных вызовов сделана, так, чтобы указатель на структуру на штабеле мог быть передан в или мог быть снова использован для многократных созданий набора. Этот параметр может быть NULL, который обрабатывается как будто допустимая структура версии 0 со всеми полями NULL был передан в.

    Если какое-либо из полей не является допустимыми указателями на функции корректного типа, или этот параметр не является допустимым указателем на a CFBagCallBacks структура, поведение не определено. Если какое-либо значение, помещенное в набор, не является тем, понятым под одной из функций обратного вызова, поведение, когда та функция обратного вызова используется, не определено.

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

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

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

    Обсуждение

    Эта функция создает новую пустую непостоянную сумку, для которой Вы можете добавленные стоимости с помощью CFBagAddValue функция. capacity параметр указывает максимальное количество значений, которые может содержать объект CFBag. Если это 0, тогда нет никакого предела числу значений, которые могут быть добавлены (кроме ограничений, таких как доступная память).

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Создает новую непостоянную сумку со значениями от другой сумки.

    Объявление

    Swift

    func CFBagCreateMutableCopy(_ allocator: CFAllocator!, _ capacity: CFIndex, _ theBag: CFBag!) -> CFMutableBag!

    Objective C

    CFMutableBagRef CFBagCreateMutableCopy ( CFAllocatorRef allocator, CFIndex capacity, CFBagRef theBag );

    Параметры

    allocator

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

    capacity

    Максимальное количество значений, которые могут содержаться новой сумкой. Сумка запускается с того же количества как theBag, и может расти до этого числа значений (и оно может иметь меньше). Если это значение 0, максимальная способность сумки не ограничивается. Это значение должно быть больше, чем или равным количеству theBag, и не должно быть отрицательным.

    theBag

    Сумка для копирования. Указатель оценивает от theBag копируются в новую сумку. Однако значения также сохраняются новой сумкой. Количество новой сумки совпадает с количеством theBag. Новая сумка использует те же обратные вызовы как theBag.

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

    Новая непостоянная сумка, содержащая те же значения как theBag. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Добавляет значение к непостоянной сумке.

    Объявление

    Swift

    func CFBagAddValue(_ theBag: CFMutableBag!, _ value: UnsafePointer<Void>)

    Objective C

    void CFBagAddValue ( CFMutableBagRef theBag, const void *value );

    Параметры

    theBag

    Сумка та, к который value добавляется.

    value

    CFType возражает или значение указателя для добавления к theBag (или само значение, если это вписывается в размер указателя).

    Обсуждение

    value параметр сохраняется theBag использование сохранить обратный вызов обеспечило когда theBag создавался. Если value не имеет типа, ожидаемого сохранить обратным вызовом, поведение не определено. Если value уже существует в наборе, он просто сохраняется снова — никакая память не выделяется для добавленной стоимости. Используйте объект CFSet, если Вы не хотите двойные значения в своем наборе.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Удаляет все значения из непостоянной сумки.

    Объявление

    Swift

    func CFBagRemoveAllValues(_ theBag: CFMutableBag!)

    Objective C

    void CFBagRemoveAllValues ( CFMutableBagRef theBag );

    Параметры

    theBag

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Удаляет значение из непостоянной сумки.

    Объявление

    Swift

    func CFBagRemoveValue(_ theBag: CFMutableBag!, _ value: UnsafePointer<Void>)

    Objective C

    void CFBagRemoveValue ( CFMutableBagRef theBag, const void *value );

    Параметры

    theBag

    Сумка та, от который value должен быть удален.

    value

    Значение, которое будет удалено из набора.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Заменяет значение в непостоянной сумке.

    Объявление

    Swift

    func CFBagReplaceValue(_ theBag: CFMutableBag!, _ value: UnsafePointer<Void>)

    Objective C

    void CFBagReplaceValue ( CFMutableBagRef theBag, const void *value );

    Параметры

    theBag

    Сумка та, от который value должен быть заменен.

    value

    Значение, которое будет заменено в наборе. Если это значение уже не существует в наборе, функция ничего не делает. Можно передать само значение вместо указателя, если это - размер указателя или меньше. Равный обратный вызов обеспечил когда theBag создавался используется для сравнения. Если равный обратный вызов был NULL, равенство указателя (в C, ==) используется. Если value, или любое другое значение в theBag, не понят под равным обратным вызовом, поведение не определено.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Устанавливает значение в непостоянной сумке.

    Объявление

    Swift

    func CFBagSetValue(_ theBag: CFMutableBag!, _ value: UnsafePointer<Void>)

    Objective C

    void CFBagSetValue ( CFMutableBagRef theBag, const void *value );

    Параметры

    theBag

    Сумка та, в который value должен быть установлен.

    value

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

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Типы данных

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

  • Ссылка на непостоянный объект сумки.

    Объявление

    Swift

    typealias CFMutableBagRef = CFMutableBag

    Objective C

    typedef struct __CFBag *CFMutableBagRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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