Ссылка CFMutableBag

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

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

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

Функции

Создание непостоянной сумки


    
    CFBagCreateMutable (_: _: _:)
    CFBagCreateMutable

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

Объявление

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 и позже.


    
    CFBagCreateMutableCopy (_: _: _:)
    CFBagCreateMutableCopy

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

Объявление

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 и позже.

Изменение непостоянной сумки


    
    CFBagAddValue (_: _:)
    CFBagAddValue

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

Объявление

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 и позже.

CFBagRemoveAllValues (_:) CFBagRemoveAllValues

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

Объявление

Swift

func CFBagRemoveAllValues(_ theBag: CFMutableBag!)

Objective C

void CFBagRemoveAllValues ( CFMutableBagRef theBag );

Параметры

theBag

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFBagRemoveValue (_: _:)
    CFBagRemoveValue

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

Объявление

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 и позже.


    
    CFBagReplaceValue (_: _:)
    CFBagReplaceValue

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

Объявление

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 и позже.


    
    CFBagSetValue (_: _:)
    CFBagSetValue

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

Объявление

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 и позже.

Типы данных

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

CFMutableBagRef CFMutableBagRef

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

Объявление

Swift

typealias CFMutableBagRef = CFMutableBag

Objective C

typedef struct __CFBag *CFMutableBagRef;

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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