Ссылка CFMutableArray

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

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

CFMutableArray обеспечивает несколько функций для изменения содержания массива, например CFArrayAppendValue и CFArrayInsertValueAtIndex добавленные стоимости функций к массиву и CFArrayRemoveValueAtIndex удаляет значения из массива. Можно также переупорядочить содержание использования массива CFArrayExchangeValuesAtIndices и CFArraySortValues.

CFMutableArray “бесплатный соединенный мостом” с его дубликатом Основы Какао, NSMutableArray. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Поэтому в методе, где Вы видите NSMutableArray * параметр, можно передать в a CFMutableArrayRef, и в функции, где Вы видите a CFMutableArrayRef параметр, можно передать в экземпляре NSMutableArray. Этот факт также применяется к конкретным подклассам NSMutableArray. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.

Функции

Разные функции CFMutableArray


    
    CFArrayAppendArray (_: _: _:)
    CFArrayAppendArray

Добавляют значения от одного массива до другого массива.

Объявление

Swift

func CFArrayAppendArray(_ theArray: CFMutableArray!, _ otherArray: CFArray!, _ otherRange: CFRange)

Objective C

void CFArrayAppendArray ( CFMutableArrayRef theArray, CFArrayRef otherArray, CFRange otherRange );

Параметры

`theArray`	Массив тот, к который значения от `otherArray` добавляются. Если `theArray` массив ограниченной вместимости, добавляя `otherRange.length` значения от `otherArray` не должен вызывать полный предел `theArray` быть превышенным.
`otherArray`	Массив, обеспечивающий значения, которые будут добавлены к `theArray`.
`otherRange`	Диапазон в `otherArray` от которого можно добавить значения к `theArray`. Диапазон не должен превышать индексное пространство `otherArray`.

Обсуждение

Новые значения сохраняются theArray использование сохранить обратный вызов обеспечило когда theArray создавался. Если значения не имеют типа, ожидаемого сохранить обратным вызовом, поведение не определено. Значения присваиваются индексам одно большее, чем предыдущий самый большой индекс в theArray, и вне, и количество theArray увеличен otherRange.length. Значения присваиваются новые индексы в theArray от самого маленького до самого большого индекса в порядке, в котором они появляются в otherArray.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayAppendValue (_: _:)
    CFArrayAppendValue

Добавляет значение к массиву, дающему его новый самый большой индекс.

Объявление

Swift

func CFArrayAppendValue(_ theArray: CFMutableArray!, _ value: UnsafePointer<Void>)

Objective C

void CFArrayAppendValue ( CFMutableArrayRef theArray, const void *value );

Параметры

`theArray`	Массив тот, к который `value` должен быть добавлен. Если `theArray` массив ограниченной вместимости, и это полно, прежде чем эта работа, поведение будет не определено.
`value`	CFType возражает или значение указателя для добавления к `theArray`.

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayCreateMutable (_: _: _:)
    CFArrayCreateMutable

Создает новый пустой непостоянный массив.

Объявление

Swift

func CFArrayCreateMutable(_ allocator: CFAllocator!, _ capacity: CFIndex, _ callBacks: UnsafePointer<CFArrayCallBacks>) -> CFMutableArray!

Objective C

CFMutableArrayRef CFArrayCreateMutable ( CFAllocatorRef allocator, CFIndex capacity, const CFArrayCallBacks *callBacks );

Параметры

`allocator`	Средство выделения для использования для выделения памяти для нового массива и его хранения для значений. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`capacity`	Максимальное количество значений, которые могут содержаться новым массивом. Массив запускается пустой и может расти до этого числа значений (и это может иметь меньше). Передача `0` указать, что не ограничивается максимальная способность. Значение не должно быть отрицательным.
`callBacks`	Указатель на a `CFArrayCallBacks` структура, инициализированная с обратными вызовами для массива для использования на каждом значении в массиве. Копия содержания структуры обратных вызовов сделана, так, чтобы указатель на структуру на штабеле мог быть передан в или мог быть снова использован для многократных созданий массива. Если массив содержит объекты CFType только, то передайте `kCFTypeArrayCallBacks` использовать функции обратного вызова по умолчанию. Этот параметр может быть `NULL`, который обрабатывается как будто допустимая структура версии `0` со всеми полями `NULL` был передан в. Если какое-либо из полей не является допустимыми указателями на функции корректного типа, или этот параметр не является допустимым указателем на a `CFArrayCallBacks` структура, поведение не определено. Если какое-либо значение, помещенное в массив, не является тем, понятым под одной из функций обратного вызова, поведение, когда та функция обратного вызова используется, не определено.

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayCreateMutableCopy (_: _: _:)
    CFArrayCreateMutableCopy

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

Объявление

Swift

func CFArrayCreateMutableCopy(_ allocator: CFAllocator!, _ capacity: CFIndex, _ theArray: CFArray!) -> CFMutableArray!

Objective C

CFMutableArrayRef CFArrayCreateMutableCopy ( CFAllocatorRef allocator, CFIndex capacity, CFArrayRef theArray );

Параметры

`allocator`	Средство выделения для использования для выделения памяти для нового массива и его хранения для значений. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`capacity`	Максимальное количество значений, которые могут содержаться новым массивом. Массив запускается с того же числа значений как `theArray` и может расти до этого числа значений (и оно может иметь меньше). Передача `0` указать, что не ограничивается максимальная способность. Если не -`0`, `capacity` должно быть больше, чем или равным количеству `theArray`.
`theArray`	Массив для копирования. Значения указателя от массива копируются в новый массив. Однако значения также сохраняются новым массивом.

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

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayExchangeValuesAtIndices (_: _: _:)
    CFArrayExchangeValuesAtIndices

Обменивается значениями в двух индексах массива.

Объявление

Swift

func CFArrayExchangeValuesAtIndices(_ theArray: CFMutableArray!, _ idx1: CFIndex, _ idx2: CFIndex)

Objective C

void CFArrayExchangeValuesAtIndices ( CFMutableArrayRef theArray, CFIndex idx1, CFIndex idx2 );

Параметры

`theArray`	Массив, содержащий значения, которые будут подкачаны.
`idx1`	Индекс значения для свопинга со значением в `idx2`. Индекс не должен превышать индексное пространство `theArray` (`0` к `N-1` включительно, где `N` количество `theArray` перед работой).
`idx2`	Индекс значения для свопинга со значением в `idx1`. Индекс не должен превышать индексное пространство `theArray` (`0` к `N-1` включительно, где `N` количество `theArray` перед работой).

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayInsertValueAtIndex (_: _: _:)
    CFArrayInsertValueAtIndex

Вставляет значение в массив в данном индексе.

Объявление

Swift

func CFArrayInsertValueAtIndex(_ theArray: CFMutableArray!, _ idx: CFIndex, _ value: UnsafePointer<Void>)

Objective C

void CFArrayInsertValueAtIndex ( CFMutableArrayRef theArray, CFIndex idx, const void *value );

Параметры

`theArray`	Массив тот, в который `value` вставляется. Если `theArray` массив фиксированной способности, и это полно, прежде чем эта работа, поведение будет не определено.
`idx`	Индекс, в котором можно вставить `value`. Индекс должен быть в диапазоне `0` к `N` включительно, где `N` количество `theArray` перед работой. Если индекс совпадает с количеством `theArray`, эта функция имеет тот же эффект как `CFArrayAppendValue`.
`value`	Значение для вставки в `theArray`. Значение сохраняется `theArray` использование сохранить обратный вызов обеспечило когда `theArray` создавался. Если `value` не имеет типа, ожидаемого сохранить обратным вызовом, поведение не определено.

Обсуждение

value параметр присваивается индексу idx, и все значения в theArray с равными и большими индексами увеличили их индексы одним.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

CFArrayRemoveAllValues (_:) CFArrayRemoveAllValues

Удаляет все значения из массива, делая его пустым.

Объявление

Swift

func CFArrayRemoveAllValues(_ theArray: CFMutableArray!)

Objective C

void CFArrayRemoveAllValues ( CFMutableArrayRef theArray );

Параметры

theArray

Массив, из которого удалены все значения.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayRemoveValueAtIndex (_: _:)
    CFArrayRemoveValueAtIndex

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

Объявление

Swift

func CFArrayRemoveValueAtIndex(_ theArray: CFMutableArray!, _ idx: CFIndex)

Objective C

void CFArrayRemoveValueAtIndex ( CFMutableArrayRef theArray, CFIndex idx );

Параметры

`theArray`	Массив, из которого должно быть удалено значение.
`idx`	Индекс значения для удаления. Значение не лежит вне индексного пространства `theArray` (`0` к `N-1` включительно, где `N` количество `theArray` перед работой).

Обсуждение

Все значения в theArray с индексами, больше, чем idx уменьши их индексы один.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArrayReplaceValues (_: _: _: _:)
    CFArrayReplaceValues

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

Объявление

Swift

func CFArrayReplaceValues(_ theArray: CFMutableArray!, _ range: CFRange, _ newValues: UnsafeMutablePointer<UnsafePointer<Void>>, _ newCount: CFIndex)

Objective C

void CFArrayReplaceValues ( CFMutableArrayRef theArray, CFRange range, const void **newValues, CFIndex newCount );

Параметры

`theArray`	Массив, в котором должны быть заменены некоторые значения. Если этот параметр не является допустимым объектом CFMutableArray, поведение не определено.
`range`	Диапазон значений в `theArray` заменять. Расположение диапазона или конечная точка (определенный расположением плюс длина минус 1) не должны лежать вне индексного пространства `theArray` (`0` к `N-1` включительно, где `N` количество `theArray`). Длина диапазона не должна быть отрицательной. Диапазон может быть пустым (длина 0), когда новые значения просто вставляются в расположении диапазона.
`newValues`	Массив C значений размера указателя, которые будут помещены в `theArray`. Новые значения в `theArray` упорядочиваются в том же порядке, в котором они появляются в этом массиве C. Этот параметр может быть `NULL` если `newCount` параметр 0. Этот массив C не изменен или освобожден этой функцией. Если этот параметр не является допустимым указателем на массив C, по крайней мере, `newCount` указатели, поведение не определено.
`newCount`	Число значений для копирования с `newValues` C выстраивают в `theArray`. Если этот параметр отличается от длины диапазона, избытка `newCount` значения вставляются после того, как диапазон или избыточные значения диапазона удалены. Этот параметр может быть 0, когда никакие новые значения не заменяются в `theArray` и значения в диапазоне просто удалены. Если этот параметр отрицателен или больше, чем число значений фактически в `newValues` C массив, поведение не определено.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArraySetValueAtIndex (_: _: _:)
    CFArraySetValueAtIndex

Изменяет значение в данном индексе в массиве.

Объявление

Swift

func CFArraySetValueAtIndex(_ theArray: CFMutableArray!, _ idx: CFIndex, _ value: UnsafePointer<Void>)

Objective C

void CFArraySetValueAtIndex ( CFMutableArrayRef theArray, CFIndex idx, const void *value );

Параметры

`theArray`	Массив, в котором должно быть изменено значение.
`idx`	Индекс, в котором можно установить новое значение. Значение не должно лежать вне индексного пространства `theArray` (`0` к `N-1` включительно, где `N` количество массива перед работой).
`value`	Значение для начинаний `theArray`. Значение сохраняется `theArray` использование сохранить обратный вызов обеспечило когда `theArray` создавался и предыдущее значение в `idx` выпущен. Если значение не имеет типа, ожидаемого сохранить обратным вызовом, поведение не определено. Индексы других значений не затронуты.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFArraySortValues (_: _: _: _:)
    CFArraySortValues

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

Объявление

Swift

func CFArraySortValues(_ theArray: CFMutableArray!, _ range: CFRange, _ comparator: CFComparatorFunction, _ context: UnsafeMutablePointer<Void>)

Objective C

void CFArraySortValues ( CFMutableArrayRef theArray, CFRange range, CFComparatorFunction comparator, void *context );

Параметры

`theArray`	Массив, значения которого сортируются.
`range`	Диапазон значений в `theArray` к виду. Расположение диапазона или конечная точка (определенный расположением плюс длина минус 1) не должны лежать вне индексного пространства `theArray` (`0` к `N-1` включительно, где `N` количество `theArray`). Длина диапазона не должна быть отрицательной. Диапазон может быть пустым (длина 0).
`comparator`	Функция с компаратором функционирует подпись типа, использующаяся в работе вида для сравнения значений в `theArray`. Если этот параметр не является указателем на функцию корректного прототипа, поведение не определено. Если существуют значения в `theArray` то, что `comparator` функция не ожидает или не может должным образом выдержать сравнение, поведение не определено. Значения в диапазоне сортируются от наименьшего количества до самого большого согласно этой функции.
`context`	Определенное с помощью программы значение размера указателя, передающееся как третий параметр `comparator` функция, но иначе не использовано этой функцией. Если контекст не то, что ожидается `comparator` функция, поведение не определено.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Типы данных

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

CFMutableArrayRef CFMutableArrayRef

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

Объявление

Swift

typealias CFMutableArrayRef = CFMutableArray

Objective C

typedef struct __CFArray *CFMutableArrayRef;

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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