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

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

Разработчик

Ссылка платформы основы ссылка класса NSMutableArray

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

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

NSMutableArray

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

NSMutableArray класс объявляет программируемый интерфейс к объектам, управляющим модифицируемым массивом объектов. Этот класс добавляет вставку и операции удаления к основному обрабатывающему массив поведению, наследованному от NSArray.

NSMutableArray “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFMutableArrayRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации.

Разделение на подклассы примечаний

Существует обычно маленькая причина разделить на подклассы NSMutableArray. Класс преуспевает, что он разработан, чтобы сделать — поддерживают непостоянный, упорядоченный набор объектов. Но существуют ситуации где пользовательское NSArray объект мог бы пригодиться. Вот несколько возможностей:

  • Изменение, как NSMutableArray хранит элементы его набора. Вы могли бы сделать это по причинам производительности или по лучшей совместимости с устаревшим кодом.

  • Получая больше информации о том, что происходит с набором (например, сбор статистики).

Методы для переопределения

NSMutableArray определяет пять примитивных методов:

В подклассе необходимо переопределить все эти методы. Необходимо также переопределить примитивные методы NSArray класс.

Создание и инициализация непостоянного массива
  • + arrayWithCapacity:

    Создает и возвращается NSMutableArray объект с достаточным количеством выделенной памяти для начального содержания данного числа объектов.

    Объявление

    Objective C

    + (instancetype)arrayWithCapacity:(NSUInteger)numItems

    Параметры

    numItems

    Начальная способность нового массива.

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

    Новое NSMutableArray объект с достаточным количеством выделенной памяти для содержания numItems объекты.

    Обсуждение

    Непостоянные массивы расширяются по мере необходимости; numItems просто устанавливает начальную способность объекта.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – initWithCapacity:
    – init

  • + arrayWithContentsOfFile:

    Создает и возвращает непостоянный массив containg содержание файла, указанного данным путем.

    Объявление

    Objective C

    + (NSMutableArray *)arrayWithContentsOfFile:(NSString *)aPath

    Параметры

    aPath

    Путь к файлу, содержащему строковое представление непостоянного массива, произведенного writeToFile:atomically: метод.

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

    Указан непостоянный массив, содержащий содержание файла aPath. Возвраты nil если содержание файла не может быть проанализировано в непостоянный массив, если файл не может быть открыт или.

    Обсуждение

    Непостоянное представление в виде массива в файле, идентифицированном aPath должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionaray объекты). Для получения дополнительной информации см. Руководство по программированию Списка свойств. Даже если массив является непостоянным, объекты, содержавшие этим массивом, являются неизменными.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – writeToFile:atomically:

  • + arrayWithContentsOfURL:

    Создает и возвращает непостоянный массив, содержащий содержание, указанное данным URL.

    Объявление

    Objective C

    + (NSMutableArray *)arrayWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

    Расположение файла, содержащего строковое представление непостоянного массива, произведенного writeToURL:atomically: метод.

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

    Непостоянный массив, содержащий содержание, указанное aURL. Возвраты nil если содержание расположения не может быть проанализировано в непостоянный массив, если расположение не может быть открыто или.

    Обсуждение

    Представление в виде массива в расположении, идентифицированном aURL должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionaray объекты). Даже если массив является непостоянным, объекты, содержавшие этим массивом, являются неизменными.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – writeToURL:atomically:

  • init () - init Определяемый инициализатор

    Инициализирует недавно выделенный массив.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Массив.

    Обсуждение

    Этот метод является определяемым инициализатором.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithCapacity:

  • init (способность:) - initWithCapacity: Определяемый инициализатор

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

    Объявление

    Swift

    init(capacity numItems: Int)

    Objective C

    - (instancetype)initWithCapacity:(NSUInteger)numItems

    Параметры

    numItems

    Начальная способность нового массива.

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

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

    Обсуждение

    Непостоянные массивы расширяются по мере необходимости; numItems просто устанавливает начальную способность объекта.

    Этот метод является определяемым инициализатором.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + arrayWithCapacity:
    – init

  • init (contentsOfFile:) - initWithContentsOfFile:

    Инициализирует недавно выделенный непостоянный массив с содержанием файла, указанного данным путем

    Объявление

    Swift

    convenience init?(contentsOfFile aPath: String)

    Objective C

    - (NSMutableArray *)initWithContentsOfFile:(NSString *)aPath

    Параметры

    aPath

    Путь к файлу, содержащему представление непостоянного массива, произведенного writeToFile:atomically: метод.

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

    Непостоянный массив, инициализированный для содержания содержания файла, указанного aPath или nil если файл не может быть открыт, или содержание файла не может быть проанализировано в непостоянный массив. Возвращенный объект должен отличаться, чем исходный получатель.

    Обсуждение

    Непостоянное представление в виде массива в файле, идентифицированном aPath должен содержать только объекты списка свойств (NSString, NSData, NSDate, NSNumber, NSArray, или NSDictionaray объекты). Даже если массив является непостоянным, объекты, содержавшие этим массивом, являются неизменными.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + arrayWithContentsOfFile:
    – writeToFile:atomically:

  • init (contentsOfURL:) - initWithContentsOfURL:

    Инициализированный недавно выделенный непостоянный массив с содержанием расположения указан данным URL.

    Объявление

    Swift

    convenience init?(contentsOfURL aURL: NSURL)

    Objective C

    - (NSMutableArray *)initWithContentsOfURL:(NSURL *)aURL

    Параметры

    aURL

    Передозировка расположения файл, содержащий строку representaion непостоянного массива, произведенного writeToURL:atomically: метод.

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

    Непостоянный массив, инициализированный для содержания содержания, указанного aURL. Возвраты nil если содержание расположения не может быть проанализировано в непостоянный массив, если расположение не может быть открыто или. Возвращенные объекты должны отличаться, чем исходный получатель.

    Обсуждение

    Представление в виде массива в расположении, идентифицированном aURL должен содержать только объекты списка свойств (NSString, NSData,NSDate, NSNumber, NSArray, или NSDictionaray объекты). Даже если массив является непостоянным, объекты, содержавшие этим массивом, являются неизменными.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + arrayWithContentsOfURL:
    – writeToURL:atomically:

Добавление объектов
  • addObject (_:) - addObject:

    Вставляет данный объект в конце массива.

    Объявление

    Swift

    func addObject(_ anObject: AnyObject)

    Objective C

    - (void)addObject:(id)anObject

    Параметры

    anObject

    Объект добавить до конца содержания массива. Это значение не должно быть nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addObjectsFromArray:
    – removeObject:
    – setArray:

  • addObjectsFromArray (_:) - addObjectsFromArray:

    Добавляют объекты, содержавшиеся в другом данном массиве до конца содержания приемной антенной решетки.

    Объявление

    Swift

    func addObjectsFromArray(_ otherArray: [AnyObject])

    Objective C

    - (void)addObjectsFromArray:(NSArray *)otherArray

    Параметры

    otherArray

    Массив объектов добавить до конца содержания приемной антенной решетки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – setArray:
    – removeObject:

  • insertObject (_: atIndex:) - insertObject:atIndex:

    Вставляет данный объект в содержание массива в данном индексе.

    Объявление

    Swift

    func insertObject(_ anObject: AnyObject, atIndex index: Int)

    Objective C

    - (void)insertObject:(id)anObject atIndex:(NSUInteger)index

    Параметры

    anObject

    Объект добавить к содержанию массива. Это значение не должно быть nil.

    index

    Индекс в массиве, в котором можно вставить anObject. Это значение не должно быть больше, чем количество элементов в массиве.

    Обсуждение

    Если index уже занят, объекты в index и вне смещаются путем добавления 1 к их индексам для создания места.

    Обратите внимание на то, что NSArray объекты не походят на массивы C. Т.е. даже при том, что Вы указываете размер при создании массива указанный размер расценивается как «подсказка»; фактический размер массива все еще 0. Это означает, что Вы не можете вставить объект в индексе, больше, чем текущее количество массива. Например, если массив содержит два объекта, его размер равняется 2, таким образом, можно добавить объекты в индексах 0, 1, или 2. Индекс 3 недопустим и за пределы; при попытке добавить объект в индексе 3 (когда размер массива равняется 2), NSMutableArray повышает исключение.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeObjectAtIndex:

  • insertObjects (_: atIndexes:) - insertObjects:atIndexes:

    Вставляет объекты в предоставленный массив в приемную антенную решетку в указанных индексах.

    Объявление

    Swift

    func insertObjects(_ objects: [AnyObject], atIndexes indexes: NSIndexSet)

    Objective C

    - (void)insertObjects:(NSArray *)objects atIndexes:(NSIndexSet *)indexes

    Параметры

    objects

    Массив объектов вставить в приемную антенную решетку.

    indexes

    Индексы те, в который объекты в objects должен быть вставлен. Количество расположений в indexes должен равняться количеству objects. Для получения дополнительной информации посмотрите Обсуждение.

    Обсуждение

    Каждый объект в objects вставляется в приемную антенную решетку поочередно в соответствующем расположении, указанном в indexes после того, как более ранние вставки были сделаны. Реализация концептуально подобна проиллюстрированному в следующем примере.

    • - void insertObjects:(NSArray *)additions atIndexes:(NSIndexSet *)indexes
    • {
    • NSUInteger currentIndex = [indexes firstIndex];
    • NSUInteger i, count = [indexes count];
    • for (i = 0; i < count; i++)
    • {
    • [self insertObject:[additions objectAtIndex:i] atIndex:currentIndex];
    • currentIndex = [indexes indexGreaterThanIndex:currentIndex];
    • }
    • }

    Получающееся поведение проиллюстрировано следующим примером.

    • NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
    • NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", nil];
    • NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
    • [indexes addIndex:3];
    • [array insertObjects:newAdditions atIndexes:indexes];
    • NSLog(@"array: %@", array);
    • // Output: array: (one, a, two, b, three, four)

    Расположения, указанные indexes май поэтому только превышает границы приемной антенной решетки, если одно расположение указывает количество массива или количество массива после предыдущих вставок, и другие расположения, превышающие границы, делают так непрерывным способом от того расположения, как проиллюстрировано в следующих примерах.

    В этом примере оба новых объекта добавляются до конца массива.

    • NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
    • NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", nil];
    • NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:5];
    • [indexes addIndex:4];
    • [array insertObjects:newAdditions atIndexes:indexes];
    • NSLog(@"array: %@", array);
    • // Output: array: (one, two, three, four, a, b)

    Если Вы заменяете [indexes addIndex:4] с [indexes addIndex:6] (так, чтобы индексы равнялись 5 и 6), тогда приложение перестанет работать с за пределы исключение.

    В этом примере два объекта добавляются в середину массива и другого в текущем конце массива (индекс 4), что означает, что это является третьим от конца измененного массива.

    • NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"two", @"three", @"four", nil];
    • NSArray *newAdditions = [NSArray arrayWithObjects: @"a", @"b", @"c", nil];
    • NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
    • [indexes addIndex:2];
    • [indexes addIndex:4];
    • [array insertObjects:newAdditions atIndexes:indexes];
    • NSLog(@"array: %@", array);
    • // Output: array: (one, a, b, two, c, three, four)

    Если Вы заменяете [indexes addIndex:4] с [indexes addIndex:6] (так, чтобы индексы равнялись 1, 2, и 6), тогда вывод (one, a, b, two, three, four, c).

    Если objects или indexes nil этот метод повысит исключение.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:

Удаление объектов
  • removeAllObjects () - removeAllObjects

    Освобождает массив всех его элементов.

    Объявление

    Swift

    func removeAllObjects()

    Objective C

    - (void)removeAllObjects

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeObject:
    – removeLastObject
    – removeObjectAtIndex:
    – removeObjectIdenticalTo:

  • removeLastObject () - removeLastObject

    Удаляет объект с оцененным самым высоким образом индексом в массиве

    Объявление

    Swift

    func removeLastObject()

    Objective C

    - (void)removeLastObject

    Обсуждение

    removeLastObject повышает исключение NSRangeException при отсутствии объектов в массиве.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeObject:
    – removeObjectAtIndex:
    – removeObjectIdenticalTo:

  • removeObject (_:) - removeObject:

    Удаляет все случаи в массиве данного объекта.

    Объявление

    Swift

    func removeObject(_ anObject: AnyObject)

    Objective C

    - (void)removeObject:(id)anObject

    Параметры

    anObject

    Объект удалить из массива.

    Обсуждение

    Этот метод использование indexOfObject: определять местоположение соответствий и затем удаляет их при помощи removeObjectAtIndex:. Таким образом соответствия определяются на основе ответа объекта на isEqual: сообщение. Если массив не содержит anObject, метод не имеет никакого эффекта (несмотря на то, что он действительно подвергается издержкам поиска содержания).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeLastObject
    – removeObjectAtIndex:
    – removeObjectIdenticalTo:
    – removeObjectsInArray:

  • removeObject (_: inRange:) - removeObject:inRange:

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

    Объявление

    Swift

    func removeObject(_ anObject: AnyObject, inRange aRange: NSRange)

    Objective C

    - (void)removeObject:(id)anObject inRange:(NSRange)aRange

    Параметры

    anObject

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

    aRange

    Диапазон, из которого можно удалить anObject.

    Обсуждение

    Соответствия определяются на основе ответа объекта на isEqual: сообщение. Если массив не содержит anObject в aRange, метод не имеет никакого эффекта (несмотря на то, что он действительно подвергается издержкам поиска содержания).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeLastObject
    – removeObjectAtIndex:
    – removeObjectIdenticalTo:
    – removeObjectsInArray:

  • removeObjectAtIndex (_:) - removeObjectAtIndex:

    Удаляет объект в index .

    Объявление

    Swift

    func removeObjectAtIndex(_ index: Int)

    Objective C

    - (void)removeObjectAtIndex:(NSUInteger)index

    Параметры

    index

    Индекс, из которого можно удалить объект в массиве. Значение не должно превышать границы массива.

    Обсуждение

    Устранить разрыв, все элементы вне index перемещены путем вычитания 1 от их индекса.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeAllObjects
    – removeLastObject
    – removeObject:
    – removeObjectIdenticalTo:
    – removeObjectsAtIndexes:

  • removeObjectsAtIndexes (_:) - removeObjectsAtIndexes:

    Удаляет объекты в указанных индексах от массива.

    Объявление

    Swift

    func removeObjectsAtIndexes(_ indexes: NSIndexSet)

    Objective C

    - (void)removeObjectsAtIndexes:(NSIndexSet *)indexes

    Параметры

    indexes

    Индексы объектов удалить из массива. Расположения, указанные indexes должен лечь в границах массива.

    Обсуждение

    Этот метод подобен removeObjectAtIndex:, но позволяет Вам эффективно удалять многократные объекты с единственной работой. indexes указывает расположения объектов, которые будут удалены данный состояние массива, когда метод вызывается, как проиллюстрировано в следующем примере:

    • NSMutableArray *array = [NSMutableArray arrayWithObjects: @"one", @"a", @"two", @"b", @"three", @"four", nil];
    • NSMutableIndexSet *indexes = [NSMutableIndexSet indexSetWithIndex:1];
    • [indexes addIndex:3];
    • [array removeObjectsAtIndexes:indexes];
    • NSLog(@"array: %@", array);
    • // Output: array: (one, two, three, four)

    Если indexes nil, этот метод повышает исключение.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – initWithCapacity:
    – removeObjectAtIndex:
    – removeObject:inRange:

  • removeObjectIdenticalTo (_:) - removeObjectIdenticalTo:

    Удаляет все случаи данного объекта в массиве.

    Объявление

    Swift

    func removeObjectIdenticalTo(_ anObject: AnyObject)

    Objective C

    - (void)removeObjectIdenticalTo:(id)anObject

    Параметры

    anObject

    Объект удалить из массива.

    Обсуждение

    Этот метод использует indexOfObjectIdenticalTo: метод для определения местоположения соответствий и затем удаляет их при помощи removeObjectAtIndex:. Таким образом соответствия определяются с помощью объектных адресов. Если массив не содержит anObject, метод не имеет никакого эффекта (несмотря на то, что он действительно подвергается издержкам поиска содержания).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeLastObject
    – removeObject:
    – removeObjectAtIndex:

  • removeObjectIdenticalTo (_: inRange:) - removeObjectIdenticalTo:inRange:

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

    Объявление

    Swift

    func removeObjectIdenticalTo(_ anObject: AnyObject, inRange aRange: NSRange)

    Objective C

    - (void)removeObjectIdenticalTo:(id)anObject inRange:(NSRange)aRange

    Параметры

    anObject

    Объект удалить из массива в aRange.

    aRange

    Диапазон в массиве, из которого можно удалить anObject.

    Обсуждение

    Этот метод использует indexOfObjectIdenticalTo: метод для определения местоположения соответствий и затем удаляет их при помощи removeObjectAtIndex:. Таким образом соответствия определяются с помощью объектных адресов. Если массив не содержит anObject в aRange, метод не имеет никакого эффекта (несмотря на то, что он действительно подвергается издержкам поиска содержания).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeLastObject
    – removeObject:
    – removeObjectAtIndex:
    – removeObjectsAtIndexes:

  • - removeObjectsFromIndices:numIndices: (iOS 4.0)

    Удаляет конкретное количество объектов от массива, начинающегося в указанном индексе.

    Оператор осуждения

    Вместо этого ofusing этот метод, использовать removeObjectsAtIndexes: вместо этого.

    Объявление

    Objective C

    - (void)removeObjectsFromIndices:(NSUInteger *)indices numIndices:(NSUInteger)count

    Параметры

    indices

    Массив C индексов объектов удалить из приемной антенной решетки.

    count

    Число объектов удалить из приемной антенной решетки.

    Обсуждение

    Этот метод подобен removeObjectAtIndex:, но это позволяет Вам эффективно удалять многократные объекты с единственной работой. При сортировке списка индексов в порядке возрастания Вы улучшите скорость этой работы.

    Этот метод не может быть отправлен в удаленный объект с распределенными объектами.

    Специальные замечания

    Этот устаревший метод использует массив C индексов. removeObjectsAtIndexes: метод использует NSIndexSet который обеспечивает более эффективный способ индексировать в массив.

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

    Objective C

    @import Foundation;

    Доступность

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

    Осуждаемый в iOS 4.0.

    См. также

    – initWithCapacity:
    – removeObjectAtIndex:
    – removeObject:inRange:
    – removeObjectsAtIndexes:

  • removeObjectsInArray (_:) - removeObjectsInArray:

    Удаляет из приемной антенной решетки объекты в другом данном массиве.

    Объявление

    Swift

    func removeObjectsInArray(_ otherArray: [AnyObject])

    Objective C

    - (void)removeObjectsInArray:(NSArray *)otherArray

    Параметры

    otherArray

    Массив, содержащий объекты, которые будут удалены из приемной антенной решетки.

    Обсуждение

    Этот метод подобен removeObject:, но это позволяет Вам эффективно удалять большие наборы объектов с единственной работой. Если приемная антенная решетка не содержит объекты в otherArray, метод не имеет никакого эффекта (несмотря на то, что он действительно подвергается издержкам поиска содержания).

    Этот метод предполагает что все элементы в otherArray ответьте на hash и isEqual:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – removeAllObjects
    – removeObjectIdenticalTo:
    – removeObjectsAtIndexes:

  • removeObjectsInRange (_:) - removeObjectsInRange:

    Удаляет из массива каждый из объектов в данном диапазоне.

    Объявление

    Swift

    func removeObjectsInRange(_ aRange: NSRange)

    Objective C

    - (void)removeObjectsInRange:(NSRange)aRange

    Параметры

    aRange

    Диапазон объектов, которые будут удалены из массива.

    Обсуждение

    Объекты удалены с помощью removeObjectAtIndex:.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Замена объектов
  • replaceObjectAtIndex (_: withObject:) - replaceObjectAtIndex:withObject:

    Заменяет объект в index с anObject.

    Объявление

    Swift

    func replaceObjectAtIndex(_ index: Int, withObject anObject: AnyObject)

    Objective C

    - (void)replaceObjectAtIndex:(NSUInteger)index withObject:(id)anObject

    Параметры

    index

    Индекс объекта, который будет заменен. Это значение не должно превышать границы массива.

    anObject

    Объект, которым можно заменить объект в индексе index в массиве. Это значение не должно быть nil.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeObjectAtIndex:
    – removeObjectsAtIndexes:
    – replaceObjectsAtIndexes:withObjects:
    – setObject:atIndexedSubscript:

  • - setObject:atIndexedSubscript:

    Заменяет объект в индексе с новым объектом, возможно добавляя объект.

    Объявление

    Objective C

    - (void)setObject:(id)anObject atIndexedSubscript:(NSUInteger)index

    Параметры

    anObject

    Объект, которым можно заменить объект в индексе index в массиве. Это значение не должно быть nil.

    index

    Индекс объекта, который будет заменен. Это значение не должно превышать границы массива.

    Обсуждение

    Если index равно count, элемент добавляется до конца массива, увеличивая массив.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeObjectAtIndex:
    – removeObjectsAtIndexes:
    – replaceObjectAtIndex:withObject:
    – replaceObjectsAtIndexes:withObjects:

  • replaceObjectsAtIndexes (_: withObjects:) - replaceObjectsAtIndexes:withObjects:

    Заменяет объекты в приемной антенной решетке в расположениях, указанных с объектами от данного массива.

    Объявление

    Swift

    func replaceObjectsAtIndexes(_ indexes: NSIndexSet, withObjects objects: [AnyObject])

    Objective C

    - (void)replaceObjectsAtIndexes:(NSIndexSet *)indexes withObjects:(NSArray *)objects

    Параметры

    indexes

    Индексы объектов, которые будут заменены.

    objects

    Объекты, которыми можно заменить объекты в приемной антенной решетке в индексах, указанных indexes. Количество расположений в indexes должен равняться количеству objects.

    Обсуждение

    Индексы в indexes используются в том же порядке в качестве объектов в objects.

    Если objects или indexes nil, этот метод будет повышать исключение.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeObjectAtIndex:
    – replaceObjectAtIndex:withObject:

  • replaceObjectsInRange (_: withObjectsFromArray:range:) - replaceObjectsInRange:withObjectsFromArray:range:

    Заменяет объекты в приемной антенной решетке, указанной одним данным диапазоном с объектами в другом массиве, указанном другим диапазоном.

    Объявление

    Swift

    func replaceObjectsInRange(_ aRange: NSRange, withObjectsFromArray otherArray: [AnyObject], range otherRange: NSRange)

    Objective C

    - (void)replaceObjectsInRange:(NSRange)aRange withObjectsFromArray:(NSArray *)otherArray range:(NSRange)otherRange

    Параметры

    aRange

    Диапазон объектов, которые будут заменены в (или удалены из) приемная антенная решетка.

    otherArray

    Массив объектов, из которых можно выбрать замены для объектов в aRange.

    otherRange

    Диапазон объектов быть выбранным из otherArray как замены для объектов в aRange.

    Обсуждение

    Длины aRange и otherRange не должны быть равными: Если aRange более длинно, чем otherRange, дополнительные объекты в приемной антенной решетке удалены; если otherRange более длинно, чем aRange, дополнительные объекты от otherArray вставляются в приемную антенную решетку.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeObjectAtIndex:
    – replaceObjectAtIndex:withObject:
    – replaceObjectsAtIndexes:withObjects:

  • replaceObjectsInRange (_: withObjectsFromArray:) - replaceObjectsInRange:withObjectsFromArray:

    Заменяет объекты в приемной антенной решетке, указанной данным диапазоном со всеми объектами от данного массива.

    Объявление

    Swift

    func replaceObjectsInRange(_ aRange: NSRange, withObjectsFromArray otherArray: [AnyObject])

    Objective C

    - (void)replaceObjectsInRange:(NSRange)aRange withObjectsFromArray:(NSArray *)otherArray

    Параметры

    aRange

    Диапазон объектов, которые будут заменены в (или удалены из) приемная антенная решетка.

    otherArray

    Массив объектов, из которых можно выбрать замены для объектов в aRange.

    Обсуждение

    Если otherArray имеет меньше объектов, чем указано aRange, дополнительные объекты в приемной антенной решетке удалены. Если otherArray имеет больше объектов, чем указано aRange, дополнительные объекты от otherArray вставляются в приемную антенную решетку.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – insertObject:atIndex:
    – removeObjectAtIndex:
    – replaceObjectAtIndex:withObject:
    – replaceObjectsAtIndexes:withObjects:

  • setArray (_:) - setArray:

    Устанавливает элементы приемной антенной решетки в тех в другом данном массиве.

    Объявление

    Swift

    func setArray(_ otherArray: [AnyObject])

    Objective C

    - (void)setArray:(NSArray *)otherArray

    Параметры

    otherArray

    Массив объектов, которыми можно заменить содержание приемной антенной решетки.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – addObjectsFromArray:
    – insertObject:atIndex:

Фильтрация содержания
  • filterUsingPredicate (_:) - filterUsingPredicate:

    Оценивает данный предикат против содержания массива и оставляет только объекты тем соответствием.

    Объявление

    Swift

    func filterUsingPredicate(_ predicate: NSPredicate)

    Objective C

    - (void)filterUsingPredicate:(NSPredicate *)predicate

    Параметры

    predicate

    Предикат для оценки против элементов массива.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    filteredArrayUsingPredicate: (NSArray)

Реконструкция содержания
  • exchangeObjectAtIndex (_: withObjectAtIndex:) - exchangeObjectAtIndex:withObjectAtIndex:

    Обменивается объектами в массиве в данных индексах.

    Объявление

    Swift

    func exchangeObjectAtIndex(_ idx1: Int, withObjectAtIndex idx2: Int)

    Objective C

    - (void)exchangeObjectAtIndex:(NSUInteger)idx1 withObjectAtIndex:(NSUInteger)idx2

    Параметры

    idx1

    Индекс объекта, которым можно заменить объект в индексе idx2.

    idx2

    Индекс объекта, которым можно заменить объект в индексе idx1.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • sortUsingDescriptors (_:) - sortUsingDescriptors:

    Сортирует приемную антенную решетку с помощью данного массива дескрипторов вида.

    Объявление

    Swift

    func sortUsingDescriptors(_ sortDescriptors: [AnyObject])

    Objective C

    - (void)sortUsingDescriptors:(NSArray *)sortDescriptors

    Параметры

    sortDescriptors

    Массив, содержащий NSSortDescriptor объекты использовать для сортировки содержания приемной антенной решетки.

    Обсуждение

    Посмотрите NSSortDescriptor для получения дополнительной информации.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – sortUsingFunction:context:
    – sortUsingSelector:
    – sortUsingComparator:
    – sortWithOptions:usingComparator:
    sortedArrayUsingDescriptors: (NSArray)

  • sortUsingComparator (_:) - sortUsingComparator:

    Сортирует массив с помощью метода сравнения, указанного данным NSComparator блок.

    Объявление

    Swift

    func sortUsingComparator(_ cmptr: NSComparator)

    Objective C

    - (void)sortUsingComparator:(NSComparator)cmptr

    Параметры

    cmptr

    Блок компаратора.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – sortUsingFunction:context:
    – sortUsingSelector:
    – sortUsingDescriptors:
    – sortWithOptions:usingComparator:
    sortedArrayUsingDescriptors: (NSArray)

  • sortWithOptions (_: usingComparator:) - sortWithOptions:usingComparator:

    Сортирует массив с помощью указанных опций и метода сравнения, указанного данным NSComparator блок.

    Объявление

    Swift

    func sortWithOptions(_ opts: NSSortOptions, usingComparator cmptr: NSComparator)

    Objective C

    - (void)sortWithOptions:(NSSortOptions)opts usingComparator:(NSComparator)cmptr

    Параметры

    opts

    Битовая маска, указывающая опции для вида (должно ли это быть выполнено одновременно и должно ли это быть выполнено устойчиво).

    cmptr

    Блок компаратора.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – sortUsingFunction:context:
    – sortUsingSelector:
    – sortUsingDescriptors:
    – sortUsingComparator:
    sortedArrayUsingDescriptors: (NSArray)

  • sortUsingFunction (_: контекст:) - sortUsingFunction:context:

    Сортирует элементы массива в порядке возрастания, как определено функцией сравнения compare.

    Объявление

    Swift

    func sortUsingFunction(_ compare: CFunctionPointer<((AnyObject!, AnyObject!, UnsafeMutablePointer<Void>) -> Int)>, context context: UnsafeMutablePointer<Void>)

    Objective C

    - (void)sortUsingFunction:(NSInteger (*)(id, id, void *))compare context:(void *)context

    Параметры

    compare

    Функция сравнения для использования для сравнения двух элементов за один раз.

    Параметры функции являются двумя объектами выдержать сравнение и параметр контекста, context. Функция должна возвратиться NSOrderedAscending если первый элемент меньше, чем второе, NSOrderedDescending если первый элемент больше, чем второе, и NSOrderedSame если элементы равны.

    context

    Аргумент context, который будет передан сравнить функции.

    Обсуждение

    Этот подход позволяет сравнению основываться на некотором внешнем параметре, такой как, чувствительна ли символьная сортировка к регистру или нечувствительна к регистру.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – sortUsingDescriptors:
    – sortUsingSelector:
    sortedArrayUsingFunction:context: (NSArray)

  • sortUsingSelector (_:) - sortUsingSelector:

    Сортирует элементы массива в порядке возрастания, как определено методом сравнения, указанным данным селектором.

    Объявление

    Swift

    func sortUsingSelector(_ comparator: Selector)

    Objective C

    - (void)sortUsingSelector:(SEL)comparator

    Параметры

    comparator

    Селектор, указывающий метод сравнения использовать для сравнения элементов в массиве.

    comparator сообщение отправляется в каждый объект в массиве и имеет как его отдельный аргумент другой объект в массиве. comparator метод должен возвратиться NSOrderedAscending если массив меньше, чем параметр, NSOrderedDescending если массив больше, чем параметр, и NSOrderedSame если они равны.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    – sortUsingDescriptors:
    – sortUsingFunction:context:
    sortedArrayUsingSelector: (NSArray)