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

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

Разработчик

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

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

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

Ссылка CFMutableArray

Наследование


Не применимый

Соответствует


Не применимый

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


Swift

import CoreFoundation

Objective C

@import CoreFoundation;

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

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

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

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

Функции

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    Swift

    func CFArrayRemoveAllValues(_ theArray: CFMutableArray!)

    Objective C

    void CFArrayRemoveAllValues ( CFMutableArrayRef theArray );

    Параметры

    theArray

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

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

    Объявление

    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

    Доступность

    Доступный в iOS 2.0 и позже.

Типы данных

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

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

    Объявление

    Swift

    typealias CFMutableArrayRef = CFMutableArray

    Objective C

    typedef struct __CFArray *CFMutableArrayRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

    Доступный в iOS 2.0 и позже.