Ссылка класса NSArray

Создание массива

массив + массив

Создает и возвращает пустой массив.

Объявление

Objective C

+ (instancetype)array

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

Пустой массив.

Обсуждение

Этот метод используется непостоянными подклассами NSArray.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ arrayWithObject:
+ arrayWithObjects:
arrayWithArray: + arrayWithArray:

Создает и возвращает массив, содержащий объекты в другом данном массиве.

Объявление

Objective C

+ (instancetype)arrayWithArray:(NSArray *)anArray

Параметры

anArray

Массив.

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

Массив, содержащий объекты в anArray.

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

Objective C

@import Foundation;

Доступность

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

См. также

+ arrayWithObjects:
– initWithObjects:


    
    arrayWithContentsOfFile:
    + arrayWithContentsOfFile:

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

Объявление

Objective C

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

Параметры


      aPath

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– writeToFile:atomically:


    
    arrayWithContentsOfURL:
    + arrayWithContentsOfURL:

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

Объявление

Objective C

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

Параметры


      aURL

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– writeToURL:atomically:

init (объект:) + arrayWithObject:

Создает и возвращает массив, содержащий данный объект.

Объявление

Swift

convenience init(object anObject: AnyObject)

Objective C

+ (instancetype)arrayWithObject:(id)anObject

Параметры

anObject

Объект.

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

Массив, содержащий единственный элемент anObject.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ массив
+ arrayWithObjects:


    
    arrayWithObjects:
    + arrayWithObjects:

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

Объявление

Objective C

+ (instancetype)arrayWithObjects:(id)firstObj, ...

Параметры


      firstObj, ...

Список разделенных запятой значений объектов, заканчивающихся nil.

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

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

Обсуждение

Этот пример кода создает массив, содержащий три различных типов элемента:

      NSArray *myArray;
NSDate *aDate = [NSDate distantFuture];
NSValue *aValue = [NSNumber numberWithInt:5];
NSString *aString = @"a string";
 
myArray = [NSArray arrayWithObjects:aDate, aValue, aString, nil];

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

Objective C

@import Foundation;

Доступность

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

См. также

+ массив
+ arrayWithObject:


    
    arrayWithObjects:count:
    + arrayWithObjects:count:

Создает и возвращает массив, включающий данное число объектов от данного массива C.

Объявление

Objective C

+ (instancetype)arrayWithObjects:(const id [])objects count:(NSUInteger)count

Параметры

`objects`	Массив C объектов.
`count`	Число значений от `objects` C выстраивают для включения в новый массив. Это число будет количеством нового массива — это не должно быть отрицательным или больше, чем число элементов в `objects`.

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

Новый массив включая первое count объекты от objects.

Обсуждение

Элементы добавляются к новому массиву в том же порядке, в котором они появляются objects, до, но не включая индекс count. Например:

      NSString *strings[3];
strings[0] = @"First";
strings[1] = @"Second";
strings[2] = @"Third";
 
NSArray *stringsArray = [NSArray arrayWithObjects:strings count:2];
// strings array contains { @"First", @"Second" }


  

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

Objective C

@import Foundation;

Доступность

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

См. также

– getObjects:range:

Инициализация массива

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

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

Объявление

Swift

init()

Objective C

- (instancetype)init

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

Массив.

Обсуждение

После того, как неизменный массив был инициализирован таким образом, он не может быть изменен.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithObjects:
init (массив:) - initWithArray:

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

Объявление

Swift

convenience init(array anArray: [AnyObject])

Objective C

- (instancetype)initWithArray:(NSArray *)anArray

Параметры

anArray

Массив.

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

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

Обсуждение

После того, как неизменный массив был инициализирован таким образом, он не может быть изменен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ arrayWithObject:
– initWithObjects:


    
    init (array:copyItems:)
    - initWithArray:copyItems:

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

Объявление

Swift

convenience init(array array: [AnyObject], copyItems flag: Bool)

Objective C

- (instancetype)initWithArray:(NSArray *)array copyItems:(BOOL)flag

Параметры


      array

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


      flag

Если YEStrue, каждый объект в array получает a copyWithZone: сообщение для создания копии объекта — объекты должно соответствовать NSCopying протокол. В среде управляемой памяти это вместо retain обменивайтесь сообщениями объект иначе получил бы. Объектная копия тогда добавляется к возвращенному массиву.

Если NOfalse, тогда в среде управляемой памяти каждый объект в array просто получает a retain обменивайтесь сообщениями, когда это будет добавлено к возвращенному массиву.

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

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

Обсуждение

После того, как неизменный массив был инициализирован таким образом, он не может быть изменен.

copyWithZone: метод выполняет мелкую копию. Если у Вас есть набор произвольной глубины, передавая YEStrue для flag параметр выполнит неизменную копию первого уровня ниже поверхности. Если Вы передаете NOfalse переменчивость первого уровня незатронута. В любом случае переменчивость всех более глубоких уровней незатронута.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– init
– initWithArray:
+ arrayWithObject:
– initWithObjects:


    
    init (contentsOfFile:)
    - initWithContentsOfFile:

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

Объявление

Swift

convenience init?(contentsOfFile aPath: String)

Objective C

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

Параметры


      aPath

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ arrayWithContentsOfFile:
– writeToFile:atomically:


    
    init (contentsOfURL:)
    - initWithContentsOfURL:

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

Объявление

Swift

convenience init?(contentsOfURL aURL: NSURL)

Objective C

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

Параметры


      aURL

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

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

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

Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ arrayWithContentsOfURL:
– writeToURL:atomically:


    
    initWithObjects:
    - initWithObjects:

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

Объявление

Objective C

- (instancetype)initWithObjects:(id)firstObj, ...

Параметры


      firstObj, ...

Список разделенных запятой значений объектов, заканчивающихся nil.

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

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

Обсуждение

После того, как неизменный массив был инициализирован таким образом, он не может быть изменен.

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

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

Objective C

@import Foundation;

Доступность

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

См. также

– init
– initWithObjects:count:
+ arrayWithObjects:
– initWithArray:


    
    init (objects:count:)
    - initWithObjects:count:

Определяемый инициализатор

Инициализирует недавно выделенный массив для включения данного числа объектов от данного массива C.

Объявление

Swift

init(objects objects: UnsafePointer<AnyObject?>, count count: Int)

Objective C

- (instancetype)initWithObjects:(const id [])objects count:(NSUInteger)count

Параметры

`objects`	Массив C объектов.
`count`	Число значений от `objects` C выстраивают для включения в новый массив. Это число будет количеством нового массива — это не должно быть отрицательным или больше, чем число элементов в `objects`.

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

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

Обсуждение

Элементы добавляются к новому массиву в том же порядке, в котором они появляются objects, до, но не включая индекс count.

После того, как неизменный массив был инициализирован таким образом, он не может быть изменен.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithObjects:
+ arrayWithObjects:
– initWithArray:

Запросы массива

containsObject (_:) - containsObject:

Возвращает булево значение, указывающее, присутствует ли данный объект в массиве.

Объявление

Swift

func containsObject(_ anObject: AnyObject) -> Bool

Objective C

- (BOOL)containsObject:(id)anObject

Параметры

anObject

Объект.

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

YEStrue если anObject присутствует в массиве, иначе NOfalse.

Обсуждение

Этот метод определяет ли anObject присутствует в массиве путем отправки isEqual: обменивайтесь сообщениями к каждому из объектов массива (и передача anObject как параметр каждому isEqual: сообщение).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– indexOfObject:
– indexOfObjectIdenticalTo:
количество количество Свойство

Число объектов в массиве.

Объявление

Swift

var count: Int { get }

Objective C

@property(readonly) NSUInteger count

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
getObjects (_:) - getObjects: (OS X v10.6)
Копии все объекты, содержавшиеся в массиве к aBuffer.

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

Использовать getObjects:range: вместо этого.

Объявление

Swift

func getObjects(_ aBuffer: AutoreleasingUnsafeMutablePointer<AnyObject?>)

Objective C

- (void)getObjects:(id [])aBuffer

Параметры

aBuffer

Массив C объектов размера, по крайней мере, количество массива.
Обсуждение

Метод копирует в aBuffer все объекты в массиве; размер буфера должен поэтому быть, по крайней мере, количеством массива, умноженного на размер ссылки на объект, как показано в следующем примере (обратите внимание на то, что это - просто пример, Вы не должны обычно создавать буфер просто для итерации по содержанию массива):
NSArray *mArray = // ...;

id *objects;

NSUInteger count = [mArray count];

objects = malloc(sizeof(id) * count);

[mArray getObjects:objects];

for (i = 0; i < count; i++) {

NSLog(@"object at index %d: %@", i, objects[i]);

}

free(objects);
Специальные замечания

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.6.

См. также

+ arrayWithObjects:count:


    
    getObjects (_: диапазон:)
    - getObjects:range:

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

Объявление

Swift

func getObjects(_ aBuffer: AutoreleasingUnsafeMutablePointer<AnyObject?>, range aRange: NSRange)

Objective C

- (void)getObjects:(id [])aBuffer range:(NSRange)aRange

Параметры

`aBuffer`	Массив C объектов размера, по крайней мере, длина диапазона, указанного `aRange`.
`aRange`	Диапазон в границах массива. Если расположение плюс длина диапазона больше, чем количество массива, этот метод повышает `NSRangeException`.

Обсуждение

Метод копирует в aBuffer объекты в массиве в диапазоне, указанном aRange; размер буфера должен поэтому быть, по крайней мере, длиной диапазона, умноженного на размер ссылки на объект, как показано в следующем примере (это исключительно для иллюстрации — Вы не должны обычно создавать буфер просто для итерации по содержанию массива):

      NSArray *mArray = // an array with at least six elements...;
id *objects;
 
NSRange range = NSMakeRange(2, 4);
objects = malloc(sizeof(id) * range.length);
 
[mArray getObjects:objects range:range];
 
for (i = 0; i < range.length; i++) {
    NSLog(@"objects: %@", objects[i]);
}
free(objects);


  

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ arrayWithObjects:count:

firstObject firstObject Свойство

Первый объект в массиве. (только для чтения)

Объявление

Swift

var firstObject: AnyObject? { get }

Objective C

@property(nonatomic, readonly) id firstObject

Обсуждение

Если массив пуст, возвраты nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Последний объект в массиве. (только для чтения)

Объявление

Swift

var lastObject: AnyObject? { get }

Objective C

@property(nonatomic, readonly) id lastObject

Обсуждение

Если массив пуст, возвраты nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

removeLastObject (NSMutableArray)
objectAtIndex (_:) - objectAtIndex:

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

Объявление

Swift

func objectAtIndex(_ index: Int) -> AnyObject

Objective C

- (id)objectAtIndex:(NSUInteger)index

Параметры

index

Индекс в границах массива.

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

Объект расположился в index.

Обсуждение

Если index вне конца массива (т.е. если index больше, чем или равен значению, возвращенному count), NSRangeException повышен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– количество
– objectsAtIndexes:
– objectAtIndexedSubscript:
objectAtIndexedSubscript: - objectAtIndexedSubscript:

Возвращает объект в указанном индексе.

Объявление

Objective C

- (id)objectAtIndexedSubscript:(NSUInteger)idx

Параметры

idx

Индекс в границах массива.

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

Объект расположился в index.

Обсуждение

Если index вне конца массива (т.е. если index больше, чем или равен значению, возвращенному count), NSRangeException повышен.

Этот метод идентичен objectAtIndex:.

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

Objective C

@import Foundation;

Доступность

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

См. также

– количество
– objectsAtIndexes:
objectsAtIndexes (_:) - objectsAtIndexes:

Возвращает массив, содержащий объекты в массиве в индексах, указанных данным индексным набором.

Объявление

Swift

func objectsAtIndexes(_ indexes: NSIndexSet) -> [AnyObject]

Objective C

- (NSArray *)objectsAtIndexes:(NSIndexSet *)indexes

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

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

Обсуждение

Возвращенные объекты находятся в порядке по возрастанию их индексов в indexes, так, чтобы объект в возвращенном массиве с более высоким индексом в индексах следовал за объектом с меньшим индексом в indexes.

Повышения NSRangeException если любое расположение в indexes превышает границы массива, indexes nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– количество
– objectAtIndex:
objectEnumerator () - objectEnumerator
Возвращает объект перечислителя, позволяющий Вам доступ каждый объект в массиве.

Объявление

Swift

func objectEnumerator() -> NSEnumerator

Objective C

- (NSEnumerator *)objectEnumerator

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

Объект перечислителя, позволяющий Вам доступ каждый объект в массиве, в порядке, от элемента в самом низком индексе вверх.
Обсуждение

Возвращает объект перечислителя, позволяющий Вам доступ каждый объект в массиве, в порядке, начиная с элемента в индексе 0, как в:
NSEnumerator *enumerator = [myArray objectEnumerator];

id anObject;

while (anObject = [enumerator nextObject]) {

/* code to act on each element as it is returned */

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

Когда Вы используете этот метод с непостоянными подклассами NSArray, Вы не должны изменять массив во время перечисления.

Более эффективно использовать быстрый протокол перечисления (см. NSFastEnumeration). Быстрое перечисление доступно на OS X v10.5 и позже и iOS 2.0 и позже.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– reverseObjectEnumerator
nextObject (NSEnumerator)
reverseObjectEnumerator () - reverseObjectEnumerator

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

Объявление

Swift

func reverseObjectEnumerator() -> NSEnumerator

Objective C

- (NSEnumerator *)reverseObjectEnumerator

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

Объект перечислителя, позволяющий Вам доступ каждый объект в массиве, в порядке, от элемента в самом высоком индексе вниз к элементу в индексе 0.

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

Когда Вы используете этот метод с непостоянными подклассами NSArray, Вы не должны изменять массив во время перечисления.

Более эффективно использовать быстрый протокол перечисления (см. NSFastEnumeration). Быстрое перечисление доступно на OS X v10.5 и позже и iOS 2.0 и позже.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– objectEnumerator
nextObject (NSEnumerator)

Нахождение объектов в массиве

indexOfObject (_:) - indexOfObject:

Возвращает самый низкий индекс, соответствующее значение массива которого равно данному объекту.

Объявление

Swift

func indexOfObject(_ anObject: AnyObject) -> Int

Objective C

- (NSUInteger)indexOfObject:(id)anObject

Параметры

anObject

Объект.

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

Самый низкий индекс, соответствующее значение массива которого равно anObject. Если ни один из объектов в массиве не равен anObject, возвраты NSNotFound.

Обсуждение

Запуск в индексе 0, каждый элемент массива отправляется isEqual: сообщение до соответствия найдено, или конец массива достигнут. Этот метод передает anObject параметр каждому isEqual: сообщение. Объекты считают равными если isEqual: (объявленный в NSObject протокол) возвраты YEStrue.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– containsObject:
– indexOfObjectIdenticalTo:


    
    indexOfObject (_: inRange:)
    - indexOfObject:inRange:

Возвращает самый низкий индекс в указанном диапазоне, соответствующее значение массива которого равно данному объекту.

Объявление

Swift

func indexOfObject(_ anObject: AnyObject, inRange range: NSRange) -> Int

Objective C

- (NSUInteger)indexOfObject:(id)anObject inRange:(NSRange)range

Параметры

`anObject`	Объект.
`range`	Диапазон индексов в массиве, в котором можно искать `anObject`.

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

Самый низкий индекс в range чье соответствующее значение массива равно anObject. Если ни один из объектов в range равно anObject, возвраты NSNotFound.

Обсуждение

Запуск в range.location, каждый элемент массива отправляется isEqual: сообщение до соответствия найдено или конец range достигнут. Этот метод передает anObject параметр каждому isEqual: сообщение. Объекты считают равными если isEqual: возвраты YEStrue.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– containsObject:
– indexOfObjectIdenticalTo:inRange:

indexOfObjectIdenticalTo (_:) - indexOfObjectIdenticalTo:

Возвращает самый низкий индекс, соответствующее значение массива которого идентично данному объекту.

Объявление

Swift

func indexOfObjectIdenticalTo(_ anObject: AnyObject) -> Int

Objective C

- (NSUInteger)indexOfObjectIdenticalTo:(id)anObject

Параметры

anObject

Объект.

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

Самый низкий индекс, соответствующее значение массива которого идентично anObject. Если ни один из объектов в массиве не идентичен anObject, возвраты NSNotFound.

Обсуждение

Если их объектные адреса являются тем же, объекты считают идентичными.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– containsObject:
– indexOfObject:


    
    indexOfObjectIdenticalTo (_: inRange:)
    - indexOfObjectIdenticalTo:inRange:

Возвращает самый низкий индекс в указанном диапазоне, соответствующее значение массива которого равно данному объекту.

Объявление

Swift

func indexOfObjectIdenticalTo(_ anObject: AnyObject, inRange range: NSRange) -> Int

Objective C

- (NSUInteger)indexOfObjectIdenticalTo:(id)anObject inRange:(NSRange)range

Параметры

`anObject`	Объект.
`range`	Диапазон индексов в массиве, в котором можно искать `anObject`.

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

Самый низкий индекс в range чье соответствующее значение массива идентично anObject. Если ни один из объектов в range идентично anObject, возвраты NSNotFound.

Обсуждение

Если их объектные адреса являются тем же, объекты считают идентичными.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– containsObject:
– indexOfObject:inRange:


    
    indexOfObjectPassingTest (_:)
    - indexOfObjectPassingTest:

Возвращает индекс первого объекта в массиве, проходящем тест в данном Блоке.

Объявление

Swift

func indexOfObjectPassingTest(_ predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int

Objective C

- (NSUInteger)indexOfObjectPassingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест. Возврат YEStrue остановит последующую обработку массива.

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

Самый низкий индекс, соответствующее значение которого в массиве проходит тест, указанный predicate. Если никакие объекты в массиве не проходят тест, возвраты NSNotFound.

Обсуждение

Если Блочный параметр nil этот метод повысит исключение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexOfObjectWithOptions (_: passingTest:)
    - indexOfObjectWithOptions:passingTest:

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

Объявление

Swift

func indexOfObjectWithOptions(_ opts: NSEnumerationOptions, passingTest predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int

Objective C

- (NSUInteger)indexOfObjectWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      opts

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


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

Индекс, соответствующее значение которого в массиве проходит тест, указанный predicate и opts. Если opts битовая маска указывает обратный порядок, тогда последний элемент, соответствия возвращающийся. Иначе, индекс первого соответствующего объекта возвращается. Если никакие объекты в массиве не проходят тест, возвраты NSNotFound.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему объекту. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexOfObjectAtIndexes (_: options:passingTest:)
    - indexOfObjectAtIndexes:options:passingTest:

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

Объявление

Swift

func indexOfObjectAtIndexes(_ indexSet: NSIndexSet, options opts: NSEnumerationOptions, passingTest predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int

Objective C

- (NSUInteger)indexOfObjectAtIndexes:(NSIndexSet *)indexSet options:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      indexSet

Индексы объектов, по которым можно перечислить.


      opts

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


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

Самый низкий индекс, соответствующее значение которого в массиве проходит тест, указанный predicate. Если никакие объекты в массиве не проходят тест, возвраты NSNotFound.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему элементу, указанному indexSet. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexesOfObjectsPassingTest (_:)
    - indexesOfObjectsPassingTest:

Возвращает индексы объектов в массиве, проходящих тест в данном Блоке.

Объявление

Swift

func indexesOfObjectsPassingTest(_ predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> NSIndexSet

Objective C

- (NSIndexSet *)indexesOfObjectsPassingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

Индексы, соответствующие значения которых в массиве проходят тест, указанный predicate. Если никакие объекты в массиве не проходят тест, возвращает пустой индексный набор.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexesOfObjectsWithOptions (_: passingTest:)
    - indexesOfObjectsWithOptions:passingTest:

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

Объявление

Swift

func indexesOfObjectsWithOptions(_ opts: NSEnumerationOptions, passingTest predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> NSIndexSet

Objective C

- (NSIndexSet *)indexesOfObjectsWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      opts

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


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

Индексы, соответствующие значения которых в массиве проходят тест, указанный predicate. Если никакие объекты в массиве не проходят тест, возвращает пустой индексный набор.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему объекту. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexesOfObjectsAtIndexes (_: options:passingTest:)
    - indexesOfObjectsAtIndexes:options:passingTest:

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

Объявление

Swift

func indexesOfObjectsAtIndexes(_ indexSet: NSIndexSet, options opts: NSEnumerationOptions, passingTest predicate: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> NSIndexSet

Objective C

- (NSIndexSet *)indexesOfObjectsAtIndexes:(NSIndexSet *)indexSet options:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, NSUInteger idx, BOOL *stop))predicate

Параметры


      indexSet

Индексы объектов, по которым можно перечислить.


      opts

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


      predicate

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Блок возвращает булево значение, указывающее ли obj прошедший тест.

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

Индексы, соответствующие значения которых в массиве проходят тест, указанный predicate. Если никакие объекты в массиве не проходят тест, возвращает пустой индексный набор.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему элементу, указанному indexSet. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    indexOfObject (_: inSortedRange:options:usingComparator:)
    - indexOfObject:inSortedRange:options:usingComparator:

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

Объявление

Swift

func indexOfObject(_ obj: AnyObject, inSortedRange r: NSRange, options opts: NSBinarySearchingOptions, usingComparator cmp: NSComparator) -> Int

Objective C

- (NSUInteger)indexOfObject:(id)obj inSortedRange:(NSRange)r options:(NSBinarySearchingOptions)opts usingComparator:(NSComparator)cmp

Параметры

`obj`	Объект, который можно искать в массиве. Если это значение `nil`, броски `NSInvalidArgumentException`.
`r`	Диапазон в массиве для поиска `obj`. Если `r` превышает границы массива (если расположение плюс длина диапазона больше, чем количество массива), броски `NSRangeException`.
`opts`	Опции для поиска. Для возможных значений посмотрите NSBinarySearchingOptions. Если Вы указываете обоих `NSBinarySearchingFirstEqual` и `NSBinarySearchingLastEqual`, броски `NSInvalidArgumentException`.
`cmp`	Блок компаратора раньше сравнивал объект `obj` с элементами в массиве. Если это значение `NULL`, броски `NSInvalidArgumentException`.

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

Если NSBinarySearchingInsertionIndex опция не указана:

Если obj найден и ни один NSBinarySearchingFirstEqual ни NSBinarySearchingLastEqual указан, возвращает индекс произвольного соответствующего объекта.
Если NSBinarySearchingFirstEqual опция также указана, возвращает самый низкий индекс равных объектов.
Если NSBinarySearchingLastEqual опция также указана, возвращает самый высокий индекс равных объектов.
Если объект не найден, возвраты NSNotFound.

Если NSBinarySearchingInsertionIndex опция указана, возвращает индекс, в котором необходимо вставить obj для поддержания сортированного массива:

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

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

Элементы в массиве, должно быть, были уже сортированы с помощью компаратора cmp. Если массив не сортируется, результат не определен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Отправка сообщений к элементам


    
    makeObjectsPerformSelector:
    - makeObjectsPerformSelector:

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

Объявление

Objective C

- (void)makeObjectsPerformSelector:(SEL)aSelector

Параметры


      aSelector

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

Обсуждение

Этот метод повышает NSInvalidArgumentException если aSelector NULL.

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

Objective C

@import Foundation;

Доступность

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

См. также

– makeObjectsPerformSelector:withObject:


    
    makeObjectsPerformSelector:withObject:
    - makeObjectsPerformSelector:withObject:

Отправляет aSelector обменивайтесь сообщениями к каждому объекту в массиве, начиная с первого объекта и продолжающийся через массив к последнему объекту.

Объявление

Objective C

- (void)makeObjectsPerformSelector:(SEL)aSelector withObject:(id)anObject

Параметры

`aSelector`	Селектор, идентифицирующий сообщение для отправки к объектам в массиве. Метод должен взять отдельный аргумент идентификатора типа и не должен иметь побочного эффекта изменения приемной антенной решетки.
`anObject`	Объект отправить как параметр каждому вызову `aSelector` метод.

Обсуждение

Этот метод повышает NSInvalidArgumentException если aSelector NULL.

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

Objective C

@import Foundation;

Доступность

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

См. также

– makeObjectsPerformSelector:


    
    enumerateObjectsUsingBlock (_:)
    - enumerateObjectsUsingBlock:

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

Объявление

Swift

func enumerateObjectsUsingBlock(_ block: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateObjectsUsingBlock:(void (^)(id obj, NSUInteger idx, BOOL *stop))block

Параметры


      block

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Обсуждение

Если Блочный параметр nil этот метод повысит исключение. Значения, выделенные в блоке, будут освобождены после того, как блок выполняется. Использовать retain явно поддержать те значения.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– enumerateObjectsWithOptions:usingBlock:
– makeObjectsPerformSelector:
– makeObjectsPerformSelector:withObject:


    
    enumerateObjectsWithOptions (_: usingBlock:)
    - enumerateObjectsWithOptions:usingBlock:

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

Объявление

Swift

func enumerateObjectsWithOptions(_ opts: NSEnumerationOptions, usingBlock block: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(id obj, NSUInteger idx, BOOL *stop))block

Параметры


      opts

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


      block

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему объекту. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– enumerateObjectsUsingBlock:
– makeObjectsPerformSelector:
– makeObjectsPerformSelector:withObject:


    
    enumerateObjectsAtIndexes (_: options:usingBlock:)
    - enumerateObjectsAtIndexes:options:usingBlock:

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

Объявление

Swift

func enumerateObjectsAtIndexes(_ indexSet: NSIndexSet, options opts: NSEnumerationOptions, usingBlock block: (AnyObject!, Int, UnsafeMutablePointer<ObjCBool>) -> Void)

Objective C

- (void)enumerateObjectsAtIndexes:(NSIndexSet *)indexSet options:(NSEnumerationOptions)opts usingBlock:(void (^)(id obj, NSUInteger idx, BOOL *stop))block

Параметры


      indexSet

Индексы объектов, по которым можно перечислить.


      opts

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


      block

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

Блок берет три параметра:

`obj`	Элемент в массиве.
`idx`	Индекс элемента в массиве.
`stop`	Ссылка на булево значение. Блок может установить значение в `YEStrue` остановить последующую обработку массива. Параметром остановки является единственный параметр. Необходимо только когда-либо устанавливать эту булевскую переменную в `YEStrue` в Блоке.

Обсуждение

По умолчанию перечисление запускается с первого объекта и продолжается последовательно через массив к последнему элементу, указанному indexSet. Можно указать NSEnumerationConcurrent и/или NSEnumerationReverse как опции перечисления изменить это поведение.

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– enumerateObjectsUsingBlock:
– makeObjectsPerformSelector:
– makeObjectsPerformSelector:withObject:

Сравнение массивов

firstObjectCommonWithArray (_:) - firstObjectCommonWithArray:

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

Объявление

Swift

func firstObjectCommonWithArray(_ otherArray: [AnyObject]) -> AnyObject?

Objective C

- (id)firstObjectCommonWithArray:(NSArray *)otherArray

Параметры

otherArray

Массив.

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

Возвращает первый объект, содержавшийся в приемной антенной решетке, в которой это равно объекту otherArray. Если никакой такой объект не найден, возвраты nil.

Обсуждение

Этот метод использование isEqual: проверять на объектное равенство.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– containsObject:
isEqualToArray (_:) - isEqualToArray:

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

Объявление

Swift

func isEqualToArray(_ otherArray: [AnyObject]) -> Bool

Objective C

- (BOOL)isEqualToArray:(NSArray *)otherArray

Параметры

otherArray

Массив.

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

YEStrue если содержание otherArray равны содержанию приемной антенной решетки, иначе NOfalse.

Обсуждение

Два массива имеют равное содержание, если каждый из них содержит то же число объектов, и объекты в данном индексе в каждом массиве удовлетворяют isEqual: тест.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Получение новых массивов

arrayByAddingObject (_:) - arrayByAddingObject:

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

Объявление

Swift

func arrayByAddingObject(_ anObject: AnyObject) -> [AnyObject]

Objective C

- (NSArray *)arrayByAddingObject:(id)anObject

Параметры

anObject

Объект.

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

Новый массив, который является копией приемной антенной решетки с anObject добавленный до конца.

Обсуждение

Если anObject nil, NSInvalidArgumentException повышен.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

addObject: (NSMutableArray)
arrayByAddingObjectsFromArray (_:) - arrayByAddingObjectsFromArray:

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

Объявление

Swift

func arrayByAddingObjectsFromArray(_ otherArray: [AnyObject]) -> [AnyObject]

Objective C

- (NSArray *)arrayByAddingObjectsFromArray:(NSArray *)otherArray

Параметры

otherArray

Массив.

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

addObjectsFromArray: (NSMutableArray)


    
    filteredArrayUsingPredicate (_:)
    - filteredArrayUsingPredicate:

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

Объявление

Swift

func filteredArrayUsingPredicate(_ predicate: NSPredicate) -> [AnyObject]

Objective C

- (NSArray *)filteredArrayUsingPredicate:(NSPredicate *)predicate

Параметры


      predicate

Предикат, против которого можно оценить элементы приемной антенной решетки.

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

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

Обсуждение

Для получения дополнительной информации см. Руководство по программированию Предиката.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

subarrayWithRange (_:) - subarrayWithRange:
Возвращает новый массив, содержащий элементы приемной антенной решетки, находящиеся в пределах пределов, указанных данным диапазоном.

Объявление

Swift

func subarrayWithRange(_ range: NSRange) -> [AnyObject]

Objective C

- (NSArray *)subarrayWithRange:(NSRange)range

Параметры

range

Диапазон в диапазоне приемной антенной решетки элементов.

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

Новый массив, содержащий элементы приемной антенной решетки, находящиеся в пределах пределов, указанных range.
Обсуждение

Если range не в диапазоне приемной антенной решетки элементов, NSRangeException повышен.

Например, следующий пример кода создает массив, содержащий элементы, найденные в первой половине wholeArray (принятие wholeArray существует).
NSArray *halfArray;

NSRange theRange;

theRange.location = 0;

theRange.length = [wholeArray count] / 2;

halfArray = [wholeArray subarrayWithRange:theRange];
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Сортировка

sortedArrayHint sortedArrayHint Свойство

Анализирует массив и возвращает «подсказку», которая ускоряют сортировка массива, когда подсказка предоставляется sortedArrayUsingFunction:context:hint:. (только для чтения)

Объявление

Swift

@NSCopying var sortedArrayHint: NSData { get }

Objective C

@property(readonly, copy) NSData *sortedArrayHint

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
sortedArrayUsingFunction (_: контекст:) - sortedArrayUsingFunction:context:
Возвращает новый массив, перечисляющий элементы приемной антенной решетки в порядке возрастания, как определено функцией сравнения comparator.

Объявление

Swift

func sortedArrayUsingFunction(_ comparator: CFunctionPointer<((AnyObject!, AnyObject!, UnsafeMutablePointer<Void>) -> Int)>, context context: UnsafeMutablePointer<Void>) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayUsingFunction:(NSInteger (*)(id, id, void *))comparator context:(void *)context
Обсуждение

Новый массив содержит ссылки на элементы приемной антенной решетки, не копии их.

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

Данный anArray (массив NSNumber объекты) и функция сравнения этого типа:
NSInteger intSort(id num1, id num2, void *context)

{

int v1 = [num1 intValue];

int v2 = [num2 intValue];

if (v1 < v2)

return NSOrderedAscending;

else if (v1 > v2)

return NSOrderedDescending;

else

return NSOrderedSame;

}
Сортированная версия anArray создается таким образом:
NSArray *sortedArray; sortedArray = [anArray sortedArrayUsingFunction:intSort context:NULL];
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– sortedArrayUsingDescriptors:
– sortedArrayUsingFunction:context:hint:
– sortedArrayUsingSelector:
sortedArrayUsingFunction (_: context:hint:) - sortedArrayUsingFunction:context:hint:

Возвращает новый массив, перечисляющий элементы приемной антенной решетки в порядке возрастания, как определено функцией сравнения comparator.

Объявление

Swift

func sortedArrayUsingFunction(_ comparator: CFunctionPointer<((AnyObject!, AnyObject!, UnsafeMutablePointer<Void>) -> Int)>, context context: UnsafeMutablePointer<Void>, hint hint: NSData?) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayUsingFunction:(NSInteger (*)(id, id, void *))comparator context:(void *)context hint:(NSData *)hint

Обсуждение

Новый массив содержит ссылки на элементы приемной антенной решетки, не копии их.

Этот метод подобен sortedArrayUsingFunction:context:, за исключением того, что это использует предоставленную подсказку для ускорения процесса сортировки. Когда Вы знаете, что массив почти сортируется, этот метод быстрее, чем sortedArrayUsingFunction:context:. Если Вы сортировали большой массив (N записи), один раз, и Вы не изменяете его очень (P дополнения и удаления, где P намного меньше, чем N), тогда можно снова использовать работу, которую Вы выполнили в исходном виде путем концептуального выполнения сортировки слиянием между N «старые» элементы и P «новые» элементы.

Для получения надлежащей подсказки использовать sortedArrayHint. Необходимо получить эту подсказку, когда исходный массив был сортирован и держится за нее, пока Вам не нужна она, после того, как был изменен массив. Подсказка вычислена sortedArrayHint в O(N) (где N число элементов). Это предполагает, что элементы в массиве реализуют a -hash метод. Учитывая подходящую подсказку, и предполагая, что хеш-функция является «хорошей» хеш-функцией, -sortedArrayUsingFunction:context:hint: сортирует массив в O(P*LOG(P)+N) где P число, добавляет или удаляет. Это - улучшение по сравнению с видом, которому не подсказывают, O(N*LOG(N)), когда P является маленьким.

Подсказка является просто массивом размера N содержа N хеши. Для обращений необходимо внутренне составить таблицу карты, отображающую хеш на индекс. Используя эту таблицу карты на новом массиве, можно получить первое предположение для индексов, и затем вид это. Например, сортированный массив {A, B, D, E, F} с соответствующими значениями хэш-функции {25, 96, 78, 32, 17}, может подвергнуться небольшим изменениям, приводящим к содержанию {E, A, C, B, F}. Таблица отображения отображает хеши {25, 96, 78, 32, 17} к индексам {#0, № 1, № 2, № 3, № 4}. Если хеши для {E, A, C, B, F} {32, 25, 99, 96, 17}, то при помощи таблицы отображения можно ли получить вид первого порядка {#3, № 0? № 1, № 4}, поэтому создает начальный полусортированный массив {A, B, E, F}, и затем выполняет дешевую сортировку слиянием с {C}, уступающим {A, B, C, E, F}.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– sortedArrayUsingDescriptors:
– sortedArrayUsingFunction:context:
– sortedArrayUsingSelector:
sortedArrayUsingDescriptors (_:) - sortedArrayUsingDescriptors:

Возвращает копию приемной антенной решетки, сортированной, как указано данным массивом дескрипторов вида.

Объявление

Swift

func sortedArrayUsingDescriptors(_ sortDescriptors: [AnyObject]) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayUsingDescriptors:(NSArray *)sortDescriptors

Параметры

sortDescriptors

Массив NSSortDescriptor объекты.

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

Копия приемной антенной решетки, сортированной, как указано sortDescriptors.

Обсуждение

Первый дескриптор указывает путь первичного ключа, который будет использоваться в сортировке содержания приемной антенной решетки. Любые последующие дескрипторы используются для дальнейшего совершенствования сортировки объектов с двойными значениями. Посмотрите NSSortDescriptor для получения дополнительной информации.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– sortedArrayUsingSelector:
– sortedArrayUsingFunction:context:
– sortedArrayUsingFunction:context:hint:


    
    sortedArrayUsingSelector (_:)
    - sortedArrayUsingSelector:

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

Объявление

Swift

func sortedArrayUsingSelector(_ comparator: Selector) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayUsingSelector:(SEL)comparator

Параметры


      comparator

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

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

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

Обсуждение

Новый массив содержит ссылки на элементы приемной антенной решетки, не копии их.

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

Например, массив NSString объекты могут быть сортированы при помощи caseInsensitiveCompare: метод, объявленный в NSString класс. Принятие anArray существует, сортированная версия массива может быть создана таким образом:

           NSArray *sortedArray =
         [anArray sortedArrayUsingSelector:@selector(caseInsensitiveCompare:)];

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– sortedArrayUsingDescriptors:
– sortedArrayUsingFunction:context:
– sortedArrayUsingFunction:context:hint:

sortedArrayUsingComparator (_:) - sortedArrayUsingComparator:

Возвращает массив, перечисляющий элементы приемной антенной решетки в порядке возрастания, как определено методом сравнения, указанным данным NSComparator Блок.

Объявление

Swift

func sortedArrayUsingComparator(_ cmptr: NSComparator) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayUsingComparator:(NSComparator)cmptr

Параметры

cmptr

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

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    sortedArrayWithOptions (_: usingComparator:)
    - sortedArrayWithOptions:usingComparator:

Возвращает массив, перечисляющий элементы приемной антенной решетки в порядке возрастания, как определено методом сравнения, указанным данным NSComparator Блок.

Объявление

Swift

func sortedArrayWithOptions(_ opts: NSSortOptions, usingComparator cmptr: NSComparator) -> [AnyObject]

Objective C

- (NSArray *)sortedArrayWithOptions:(NSSortOptions)opts usingComparator:(NSComparator)cmptr

Параметры

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

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Работа со строковыми элементами

componentsJoinedByString (_:) - componentsJoinedByString:
Конструкции и возвраты NSString объект, который является результатом вмешательства данного разделителя между элементами массива.

Объявление

Swift

func componentsJoinedByString(_ separator: String) -> String

Objective C

- (NSString *)componentsJoinedByString:(NSString *)separator

Параметры

separator

Строка для вмешательства между элементами массива.

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

NSString объект, который является результатом вмешательства separator между элементами массива. Если массив не имеет никаких элементов, возвраты NSString объект, представляющий пустую строку.
Обсуждение

Например, эта выборка кода записи»here be dragons«к консоли:
NSArray *pathArray = [NSArray arrayWithObjects:@"here", @"be", @"dragons", nil];

NSLog(@"%@",[pathArray componentsJoinedByString:@" "]);
Специальные замечания

Каждый элемент в массиве должен обработать description.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

componentsSeparatedByString: (NSString)

Создание описания

описание описание Свойство

Строка, представляющая содержание массива, отформатированного как список свойств. (только для чтения)

Объявление

Swift

var description: String { get }

Objective C

@property(readonly, copy) NSString *description

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    descriptionWithLocale (_:)
    - descriptionWithLocale:

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

Объявление

Swift

func descriptionWithLocale(_ locale: AnyObject?) -> String

Objective C

- (NSString *)descriptionWithLocale:(id)locale

Параметры


      locale

NSLocale возразите или NSDictionary объект, указывающий опции, используемые для форматирования каждого из элементов массива (где распознано). Указать nil если Вы не хотите отформатированные элементы.

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

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

Обсуждение

Для описания как locale применяется к каждому элементу в приемной антенной решетке, посмотрите descriptionWithLocale:indent:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    descriptionWithLocale (_: отступ:)
    - descriptionWithLocale:indent:

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

Объявление

Swift

func descriptionWithLocale(_ locale: AnyObject?, indent level: Int) -> String

Objective C

- (NSString *)descriptionWithLocale:(id)locale indent:(NSUInteger)level

Параметры

`locale`	`NSLocale` возразите или `NSDictionary` объект, указывающий опции, используемые для форматирования каждого из элементов массива (где распознано). Указать `nil` если Вы не хотите отформатированные элементы.
`level`	Уровень отступа, для создания вывода более читаемым: набор `level` к `0` использовать четыре пробелов для расположения с отступом, или `1` располагать вывод с отступом с символом табуляции.

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

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

Обсуждение

Возвращенный NSString объект содержит строковые представления каждого из элементов массива, в порядке, от начала до конца. Получить строковое представление данного элемента, descriptionWithLocale:indent: доходы следующим образом:

Если элемент NSString объект, это использовано как есть.
Если элемент отвечает на descriptionWithLocale:indent:, тот метод вызывается для получения строкового представления элемента.
Если элемент отвечает на descriptionWithLocale:, тот метод вызывается для получения строкового представления элемента.
Если ни одному из вышеупомянутых условий не удовлетворяют, строковое представление элемента получено путем вызова description метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    writeToFile (_: атомарно:)
    - writeToFile:atomically:

Пишет содержание массива к файлу в данном пути.

Объявление

Swift

func writeToFile(_ path: String, atomically flag: Bool) -> Bool

Objective C

- (BOOL)writeToFile:(NSString *)path atomically:(BOOL)flag

Параметры


      path

Путь, в котором можно записать содержание массива.

Если path содержит тильду (~) символ, необходимо развернуть его с stringByExpandingTildeInPath прежде, чем вызвать этот метод.


      flag

Если YEStrue, массив записан во вспомогательный файл, и затем вспомогательный файл переименован к path. Если NOfalse, массив записан непосредственно в path. YEStrue опция гарантирует это path, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.

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

YEStrue если файл записан успешно, иначе NOfalse.

Обсуждение

Если содержание массива является всеми объектами списка свойств (NSString, NSData, NSArray, или NSDictionary объекты), файл, записанный этим методом, может использоваться для инициализации нового массива с методом класса arrayWithContentsOfFile: или метод экземпляра initWithContentsOfFile:. Этот метод рекурсивно проверяет это, все содержащие в нем объекты являются объектами списка свойств перед выписыванием файла и возвратов NOfalse если бы все объекты не являются объектами списка свойств, так как результирующий файл не был бы допустимым списком свойств.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithContentsOfFile:


    
    writeToURL (_: атомарно:)
    - writeToURL:atomically:

Пишет содержание массива к расположению, указанному данным URL.

Объявление

Swift

func writeToURL(_ aURL: NSURL, atomically flag: Bool) -> Bool

Objective C

- (BOOL)writeToURL:(NSURL *)aURL atomically:(BOOL)flag

Параметры


      aURL

Расположение, в котором можно записать массив.


      flag

Если YEStrue, массив записан во вспомогательное расположение, и затем вспомогательное расположение переименовано к aURL. Если NOfalse, массив записан непосредственно в aURL. YEStrue опция гарантирует это aURL, если это будет существовать вообще, то не будет поврежден, даже если система должна отказать во время записи.

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

YEStrue если расположение записано успешно, иначе NOfalse.

Обсуждение

Если содержание массива является всеми объектами списка свойств (NSString, NSData, NSArray, или NSDictionary объекты), расположение, записанное этим методом, может использоваться для инициализации нового массива с методом класса arrayWithContentsOfURL: или метод экземпляра initWithContentsOfURL:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– initWithContentsOfURL:

Сбор путей


    
    pathsMatchingExtensions (_:)
    - pathsMatchingExtensions:

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

Объявление

Swift

func pathsMatchingExtensions(_ filterTypes: [AnyObject]) -> [AnyObject]

Objective C

- (NSArray *)pathsMatchingExtensions:(NSArray *)filterTypes

Параметры


      filterTypes

Массив NSString объекты, содержащие расширения файла. Расширения не должны включать точку (“”.) символ.

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

Массив, содержащий все элементы пути в приемной антенной решетке, имеющие расширения файла от filterTypes массив.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Наблюдение значения ключа


    
    addObserver (_: forKeyPath:options:context:)
    - addObserver:forKeyPath:options:context:

Повышает исключение.

Объявление

Swift

func addObserver(_ observer: NSObject, forKeyPath keyPath: String, options options: NSKeyValueObservingOptions, context context: UnsafeMutablePointer<Void>)

Objective C

- (void)addObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context

Параметры

`observer`	Объект зарегистрироваться для уведомлений KVO. Наблюдатель должен реализовать метод наблюдения значения ключа `observeValueForKeyPath:ofObject:change:context:`.
`keyPath`	Ключевой путь, относительно массива, свойства для наблюдения. Это значение не должно быть `nil`.
`options`	Комбинация `NSKeyValueObservingOptions` значения, который указывает то, что включено в уведомления наблюдения.
`context`	Произвольные данные, передающиеся `observer` в `observeValueForKeyPath:ofObject:change:context:`.

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

NSArray объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSArray объект. Вместо того, чтобы наблюдать массив, наблюдайте к - многие отношение, для которого массив является набором связанных объектов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– removeObserver:forKeyPath:
– addObserver:toObjectsAtIndexes:forKeyPath:options:context:


    
    removeObserver (_: forKeyPath:)
    - removeObserver:forKeyPath:

Повышает исключение.

Объявление

Swift

func removeObserver(_ observer: NSObject, forKeyPath keyPath: String)

Objective C

- (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath

Параметры

`observer`	Объект удалить как наблюдатель.
`keyPath`	Ключевой путь тот, относительно массива, для который `observer` регистрируется для получения уведомлений изменения KVO. Это значение не должно быть `nil`.

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

NSArray объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSArray объект. Вместо того, чтобы наблюдать массив, наблюдайте к - многие отношение, для которого массив является набором связанных объектов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addObserver:forKeyPath:options:context:
– removeObserver:fromObjectsAtIndexes:forKeyPath:


    
    removeObserver (_: forKeyPath:context:)
    - removeObserver:forKeyPath:context:

Повышает исключение.

Объявление

Swift

func removeObserver(_ observer: NSObject, forKeyPath keyPath: String, context context: UnsafeMutablePointer<Void>)

Objective C

- (void)removeObserver:(NSObject *)observer forKeyPath:(NSString *)keyPath context:(void *)context

Параметры

`observer`	Объект удалить как наблюдатель.
`keyPath`	Ключевой путь тот, относительно набора, для который `observer` регистрируется для получения уведомлений изменения KVO. Это значение не должно быть `nil`.
`context`	Контекст передал уведомлениям.

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

NSArray объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSArray объект. Вместо того, чтобы наблюдать массив, наблюдайте упорядоченный - многие отношение, для которого массив является набором связанных объектов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addObserver:forKeyPath:options:context:
– removeObserver:forKeyPath:


    
    removeObserver (_: fromObjectsAtIndexes:forKeyPath:context:)
    - removeObserver:fromObjectsAtIndexes:forKeyPath:context:

Повышает исключение.

Объявление

Swift

func removeObserver(_ observer: NSObject, fromObjectsAtIndexes indexes: NSIndexSet, forKeyPath keyPath: String, context context: UnsafeMutablePointer<Void>)

Objective C

- (void)removeObserver:(NSObject *)observer fromObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath context:(void *)context

Параметры

`observer`	Объект удалить как наблюдатель.
`indexes`	Индекс установлен.
`keyPath`	Ключевой путь тот, относительно массива, для который `observer` регистрируется для получения уведомлений изменения KVO. Это значение не должно быть `nil`.
`context`	Контекст передал уведомлениям.

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

NSArray объекты не заметны, таким образом, этот метод повышает исключение, когда вызвано на NSArray объект. Вместо того, чтобы наблюдать массив, наблюдайте к - многие отношение, для которого массив является набором связанных объектов.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addObserver:forKeyPath:options:context:
– removeObserver:fromObjectsAtIndexes:forKeyPath:


    
    addObserver (_: toObjectsAtIndexes:forKeyPath:options:context:)
    - addObserver:toObjectsAtIndexes:forKeyPath:options:context:

Регистрирует наблюдателя для получения уведомлений наблюдателя значения ключа для указанного ключевого пути относительно объектов в индексах.

Объявление

Swift

func addObserver(_ anObserver: NSObject, toObjectsAtIndexes indexes: NSIndexSet, forKeyPath keyPath: String, options options: NSKeyValueObservingOptions, context context: UnsafeMutablePointer<Void>)

Objective C

- (void)addObserver:(NSObject *)anObserver toObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath options:(NSKeyValueObservingOptions)options context:(void *)context

Параметры

`anObserver`	Наблюдатель.
`indexes`	Индекс установлен.
`keyPath`	Ключевой путь, относительно массива, чтобы наблюдаться.
`options`	Опции, которые будут включены в уведомление.
`context`	Контекст передал уведомлениям.

Обсуждение

options определите то, что включено в уведомления, и context передается в уведомлениях.

Это не просто удобный метод; вызов этого метода потенциально намного быстрее, чем повторный вызов addObserver:forKeyPath:options:context:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– removeObserver:fromObjectsAtIndexes:forKeyPath:


    
    removeObserver (_: fromObjectsAtIndexes:forKeyPath:)
    - removeObserver:fromObjectsAtIndexes:forKeyPath:

Удаляет anObserver из всех уведомлений наблюдателя значения ключа, связанных с указанным keyPath относительно объектов массива в indexes.

Объявление

Swift

func removeObserver(_ anObserver: NSObject, fromObjectsAtIndexes indexes: NSIndexSet, forKeyPath keyPath: String)

Objective C

- (void)removeObserver:(NSObject *)anObserver fromObjectsAtIndexes:(NSIndexSet *)indexes forKeyPath:(NSString *)keyPath

Параметры

`anObserver`	Наблюдатель.
`indexes`	Индекс установлен.
`keyPath`	Ключевой путь, относительно массива, чтобы наблюдаться.

Обсуждение

Это не просто удобный метод; вызов этого метода потенциально намного быстрее, чем повторный вызов removeObserver:forKeyPath:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– addObserver:toObjectsAtIndexes:forKeyPath:options:context:

Кодирование значения ключа


    
    setValue (_: forKey:)
    - setValue:forKey:

Вызывает setValue:forKey: на каждом из элементов массива с помощью указанного value и key.

Объявление

Swift

func setValue(_ value: AnyObject?, forKey key: String)

Objective C

- (void)setValue:(id)value forKey:(NSString *)key

Параметры

`value`	Объектное значение.
`key`	Ключ для хранения значения.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– valueForKey:

valueForKey (_:) - valueForKey:

Возвращает массив, содержащий результаты вызова valueForKey: использование key на каждом из объектов массива.

Объявление

Swift

func valueForKey(_ key: String) -> AnyObject?

Objective C

- (id)valueForKey:(NSString *)key

Параметры

key

Ключ для получения.

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

Значение полученного ключа.

Обсуждение

Возвращенный массив содержит NSNull элементы для каждого возвращающегося объекта nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– setValue:forKey:

NSArray

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

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

Альтернативы разделению на подклассы

Создание массива

Объявление

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Инициализация массива

Объявление

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление

Параметры

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

Обсуждение

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

Доступность

См. также

Объявление