Класс массивов объектов
Подробнее...
#import <SCArray.h>
Класс массивов объектов
- SDK
- macOS 10.6+, iOS 7.0+, GNUstep
- Начиная с
- версии 1.1.3
Реализует представление массивов, хранящих экземпляры различных классов.
При работе класса возможно возникновение следующих ошибок:
Классовый метод создает пустой неименованный массив.
- Возвращает
- Созданный массив
Переопределяет метод предка SCCollection.
+ (instancetype) arrayWithArray: |
|
(SCArray *) |
array |
|
Классовый метод создает массив как копию указанного массива.
- Аргументы
-
- Возвращает
- Созданный массив
- Исключения
-
+ (instancetype) arrayWithAscendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Классовый метод создает массив с использованием отсортированной по возрастанию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
- См. также
- + arrayWithSortedCollection:
Классовый метод создает массив с использованием указанной коллекции, отсортированной по возрастанию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
- См. также
- + arrayWithSortedCollection:sorter:
+ (instancetype) arrayWithCoder: |
|
(NSCoder *) |
coder |
|
Классовый метод создает массив с использованием указанного кодировщика данных.
- Аргументы
-
coder | - исходный кодировщик данных |
- Возвращает
- Созданный массив
+ (instancetype) arrayWithCollection: |
|
(id<SCCollection>) |
collection |
|
Классовый метод создает массив из объектов указанной коллекции.
- Аргументы
-
collection | - коллекция с исходными объектами |
- Возвращает
- Созданный массив
- Исключения
-
+ (instancetype) arrayWithContentsOfSerializedFile: |
|
(NSString *) |
path |
|
Классовый метод создает массив с использованием данных из стандартного последовательного файла с заданным путем.
- Аргументы
-
path | - путь к исходному стандартному последовательному файлу |
- Возвращает
- Созданный массив
+ (instancetype) arrayWithDataDictionary: |
|
(NSDictionary *) |
dictionary |
|
Классовый метод создает массив на основании данных из указанного словаря.
- Аргументы
-
dictionary | - словарь с исходными данными |
- Возвращает
- Созданный массив
+ (instancetype) arrayWithDataDictionaryFromFile: |
|
(NSString *) |
path |
|
Классовый метод создает массив на основании данных словаря из указанного файла.
- Аргументы
-
path | - путь к файлу словаря |
- Возвращает
- Созданный массив
+ (instancetype) arrayWithDescendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Классовый метод создает массив с использованием отсортированной по убыванию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
Классовый метод создает массив с использованием указанной коллекции, отсортированной по убыванию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
+ (instancetype) arrayWithFileStream: |
|
(NSString *) |
path |
|
Классовый метод создает массив с использованием данных из указанного файлового потока.
- Аргументы
-
path | - путь к файлу потока |
- Возвращает
- Созданный массив
- Исключения
-
+ (instancetype) arrayWithName: |
|
(NSString *) |
name |
|
Классовый метод создает пустой массив с указанным именем.
- Аргументы
-
- Возвращает
- Созданный массив
Классовый метод создает массив с указанным объектом.
- Аргументы
-
object | - добавляемый объект |
- Возвращает
- Созданный массив
- Исключения
-
+ (instancetype) arrayWithObjects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Классовый метод создает массив из указанного списка объектов.
- Аргументы
-
object | - первый объект в списке |
... | - остальные объекты в списке |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- Созданный массив
+ (instancetype) arrayWithSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Классовый метод создает массив с использованием отсортированной по возрастанию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
- См. также
- + arrayWithAscendingSortedCollection:
Классовый метод создает массив с использованием указанной коллекции, отсортированной по возрастанию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Созданный отсортированный массив
- Исключения
-
- См. также
- + arrayWithAscendingSortedCollection:sorter:
+ (instancetype) arrayWithStream: |
|
(SCStream *) |
stream |
|
Классовый метод создает массив с использованием данных из указанного потока.
- Аргументы
-
stream | - поток для чтения данных массива |
- Возвращает
- Созданный массив
- Исключения
-
Метод возвращает отсортированный по возрастанию массив.
- Возвращает
- Отсортированный массив
- Исключения
-
- См. также
- Свойство sortedArray
Метод возвращает массив, отсортированный по возрастанию с использованием указанного сортировщика.
- Аргументы
-
sorter | - сортировщик данных |
- Возвращает
- Отсортированный массив
- Исключения
-
- См. также
- - sortedArrayWithSorter:
- (void) copyObjectAtIndex: |
|
(SCIndex) |
index |
toIndex: |
|
(SCIndex) |
destination |
|
|
| |
Метод копирует объект с указанным индексом по заданному индексу.
- Аргументы
-
index | - индекс копируемого объекта |
destination | - индекс копии объекта |
- Исключения
-
- (void) copyObjectsInRange: |
|
(NSRange) |
range |
toIndex: |
|
(SCIndex) |
destination |
|
|
| |
Метод копирует объекты в указанном диапазоне по заданному индексу.
- Аргументы
-
range | - диапазон копируемых объектов |
destination | - индекс для копирования объектов |
- Исключения
-
- (SCArray *) descendingSortedArray |
|
|
|
Метод возвращает отсортированный по убыванию массив.
- Возвращает
- Отсортированный массив
- Исключения
-
Метод возвращает массив, отсортированный по убыванию с использованием указанного сортировщика.
- Аргументы
-
sorter | - сортировщик данных |
- Возвращает
- Отсортированный массив
- Исключения
-
Метод дублирует содержимое массива.
- Исключения
-
- (void) duplicateAllObjects |
|
|
|
Метод дублирует все объекты массива.
- Исключения
-
- (void) duplicateObjectAtIndex: |
|
(SCIndex) |
index |
|
Метод дублирует объект с указанным индексом.
- Аргументы
-
index | - индекс дублируемого объекта |
- Исключения
-
- (void) duplicateObjectsInRange: |
|
(NSRange) |
range |
|
Метод дублирует объекты в указанном диапазоне.
- Аргументы
-
range | - диапазон дублируемых объектов |
- Исключения
-
- (void) exchangeObjectAtIndex: |
|
(SCIndex) |
index |
withObjectAtIndex: |
|
(SCIndex) |
destination |
|
|
| |
Метод меняет местами объекты с указанными индексами.
- Аргументы
-
index | - индекс первого объекта |
destination | - индекс второго объекта |
- Исключения
-
Метод возвращает наименьший индекс указанного объекта.
- Аргументы
-
- Возвращает
- Индекс объекта или SCNotFound при отсутствии объекта
Переопределяет метод предка <SCIndexedCollection>.
Метод возвращает наименьший индекс указанного объекта в заданном диапазоне.
- Аргументы
-
object | - искомый объект |
range | - диапазон поиска |
- Возвращает
- Индекс объекта или SCNotFound при отсутствии объекта
- Исключения
-
Метод инициализирует пустой неименованный массив.
- Возвращает
- Инициализированный массив
- (instancetype) initWithArray: |
|
(SCArray *) |
array |
|
Метод инициализирует массив как копию указанного массива.
- Внимание
- Является назначенным инициализатором класса
- Аргументы
-
- Возвращает
- Инициализированный массив
- Исключения
-
- (instancetype) initWithAscendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Метод инициализирует массив с использованием отсортированной по возрастанию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
- См. также
- - initWithSortedCollection:
Метод инициализирует массив с использованием указанной коллекции, отсортированной по возрастанию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
- См. также
- - initWithSortedCollection:sorter:
- (instancetype) initWithCollection: |
|
(id<SCCollection>) |
collection |
|
Метод инициализирует массив из объектов указанной коллекции.
- Аргументы
-
collection | - коллекция с исходными объектами |
- Возвращает
- Инициализированный массив
- Исключения
-
Переопределяет метод предка SCCollection.
- (instancetype) initWithDescendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Метод инициализирует массив с использованием отсортированной по убыванию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
Метод инициализирует массив с использованием указанной коллекции, отсортированной по убыванию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
- (instancetype) initWithName: |
|
(NSString *) |
name |
|
Метод инициализирует пустой массив с указанным именем.
- Внимание
- Является назначенным инициализатором класса
- Аргументы
-
- Возвращает
- Инициализированный массив
Метод инициализирует массив с указанным объектом.
- Аргументы
-
object | - добавляемый объект |
- Возвращает
- Инициализированный массив
- Исключения
-
- (instancetype) initWithObjects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод инициализирует массив из указанного списка объектов.
- Аргументы
-
object | - первый объект в списке |
... | - остальные объекты в списке |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Возвращает
- Инициализированный массив
- (instancetype) initWithSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Метод инициализирует массив с использованием отсортированной по возрастанию указанной коллекции.
- Аргументы
-
collection | - исходная коллекция |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
- См. также
- - initWithAscendingSortedCollection:
Метод инициализирует массив с использованием указанной коллекции, отсортированной по возрастанию с использованием заданного сортировщика.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Возвращает
- Инициализированный отсортированный массив
- Исключения
-
Метод добавляет в массив объекты из указанного списка по заданному индексу.
- Аргументы
-
index | - индекс для добавления объектов |
object | - первый добавляемый объект |
... | - другие добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
- (void) insertAtIndexes: |
|
(NSIndexSet *) |
indexes |
objects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод добавляет в массив объекты из указанного списка по заданным индексам.
- Аргументы
-
indexes | - список индексов для добавления объектов |
object | - первый добавляемый объект |
... | - остальные добавляемые объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
Метод добавляет в массив объекты из указанной коллекции по заданному индексу.
- Аргументы
-
collection | - коллекция с добавляемыми объектами |
index | - индекс для добавления объектов |
- Исключения
-
- (void) insertCollection: |
|
(id<SCCollection>) |
collection |
atIndexes: |
|
(NSIndexSet *) |
indexes |
|
|
| |
Метод добавляет в массив объекты из указанной коллекции по заданным индексам.
- Аргументы
-
collection | - коллекция с добавляемыми объектами |
indexes | - список индексов для добавления объектов |
- Исключения
-
Метод добавляет в массив указанный объект перед элементом с заданным индексом.
- Аргументы
-
object | - добавляемый объект |
index | - индекс для добавления объекта |
- Исключения
-
Переопределяет метод предка <SCMutableIndexedCollection>.
- (BOOL) isEqualToArray: |
|
(SCArray *) |
array |
|
Метод выполняет сравнение содержимого и параметров массива с содержимым и параметрами указанного массива.
- Аргументы
-
array | - массив для сравнения |
- Возвращает
- YES если содержимое и параметры массивов совпадают и NO в противном случае
- (BOOL) isEqualToContentsOfArray: |
|
(SCArray *) |
array |
|
Метод выполняет сравнение содержимого массива с содержимым указанного массива.
- Аргументы
-
array | - массив для сравнения |
- Возвращает
- YES если содержимое массивов совпадает и NO в противном случае
- (void) moveObjectAtIndex: |
|
(SCIndex) |
index |
toIndex: |
|
(SCIndex) |
destination |
|
|
| |
Метод перемещает объект с указанным индексом по заданному индексу.
- Аргументы
-
index | - индекс перемещения объекта |
destination | - индекс назначения |
- Исключения
-
- (void) moveObjectsInRange: |
|
(NSRange) |
range |
toIndex: |
|
(SCIndex) |
destination |
|
|
| |
Метод перемещает объекты в указанном диапазоне по заданному индексу.
- Аргументы
-
range | - диапазон перемещаемых объектов |
destination | - индекс назначения |
- Исключения
-
- (id) objectAtIndex: |
|
(SCIndex) |
index |
|
Метод возвращает объект с указанным индексом.
- Аргументы
-
index | - индекс искомого объекта |
- Возвращает
- Объект по указанному индексу
- Исключения
-
Переопределяет метод предка <SCIndexedCollection>.
- (SCArray *) objectsAtIndexes: |
|
(NSIndexSet *) |
indexes |
|
Метод возвращает массив с объектами, которые соответствуют индексам из указанного множества индексов.
- Аргументы
-
indexes | - множество индексов |
- Возвращает
- Массив с искомыми объектами
- Исключения
-
- (SCArray *) objectsInRange: |
|
(NSRange) |
range |
|
Метод возвращает массив с объектами в указанном диапазоне.
- Аргументы
-
- Возвращает
- Массив с искомыми объектами
- Исключения
-
- (void) removeFirstObject |
|
|
|
Метод удаляет из массива первый объект.
- Исключения
-
- (void) removeLastObject |
|
|
|
Метод удаляет из массива последний объект.
- Исключения
-
- (void) removeObjectAtIndex: |
|
(SCIndex) |
index |
|
Метод удаляет из массива объект с указанным индексом.
- Аргументы
-
index | - индекс удаляемого элемента |
- Исключения
-
Переопределяет метод предка <SCMutableIndexedCollection>.
- (void) removeObjectsAtIndexes: |
|
(NSIndexSet *) |
indexes |
|
Метод удаляет из массива объекты с указанными индексами.
- Аргументы
-
indexes | - список индексов удаляемых объектов |
- Исключения
-
Переопределяет метод предка <SCMutableIndexedCollection>.
- (void) removeObjectsInRange: |
|
(NSRange) |
range |
|
Метод удаляет из массива объекты в указанном диапазоне.
- Аргументы
-
range | - диапазон удаляемых объектов |
- Исключения
-
Метод заменяет объект с указанным индексом на заданный объект.
- Аргументы
-
index | - индекс заменяемого объекта |
object | - замещающий объект |
- Исключения
-
Переопределяет метод предка <SCMutableIndexedCollection>.
- (void) replaceObjectsAtIndexes: |
|
(NSIndexSet *) |
indexes |
withCollection: |
|
(id<SCCollection>) |
collection |
|
|
| |
Метод заменяет объекты с указанными индексами на объекты из заданной коллекции.
- Аргументы
-
indexes | - список индексов заменяемых объектов |
collection | - коллекция с замещающими объектами |
- Исключения
-
- (void) replaceObjectsAtIndexes: |
|
(NSIndexSet *) |
indexes |
withObjects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод заменяет объекты с указанными индексами на объекты из заданного списка.
- Аргументы
-
indexes | - список индексов заменяемых объектов |
object | - первый замещающий объект |
... | - остальные замещающие объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
- (void) replaceObjectsInRange: |
|
(NSRange) |
range |
withCollection: |
|
(id<SCCollection>) |
collection |
|
|
| |
Метод заменяет объекты в указанном диапазоне объектами из заданной коллекции.
- Аргументы
-
range | - диапазон заменяемых объектов |
collection | - коллекция с замещающими объектами |
- Исключения
-
- (void) replaceObjectsInRange: |
|
(NSRange) |
range |
withObjects: |
|
(id<SCCollectioning>) |
object |
, |
|
|
NS_REQUIRES_NIL_TERMINATION |
|
|
| |
Метод заменяет объекты в указанном диапазоне объектами из заданного списка.
- Аргументы
-
range | - диапазон замещаемых объектов |
object | - первый замещающий объект |
... | - остальные замещающие объекты |
NS_REQUIRES_NIL_TERMINATION | - завершающий список нулевой указатель nil |
- Исключения
-
Метод изменяет порядок следования объектов массива на противоположный.
- Исключения
-
- (void) setArray: |
|
(SCArray *) |
array |
|
Метод замещает содержимое и настройки массива содержимым и настройками указанного массива.
- Аргументы
-
- Исключения
-
- (void) setAscendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по возрастанию.
- Аргументы
-
collection | - исходная коллекция |
- Исключения
-
- См. также
- - setSortedCollection:
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по возрастанию с использованием заданного сортировщика данных.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Исключения
-
- См. также
- - setSortedCollection:sorter:
- (void) setDescendingSortedCollection: |
|
(id<SCCollection>) |
collection |
|
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по убыванию.
- Аргументы
-
collection | - исходная коллекция |
- Исключения
-
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по убыванию с использованием заданного сортировщика данных.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Исключения
-
Метод заменяет указанным объектом объект массива с заданным индексом. Если объекта с таким индексом в массиве не существует, метод добавляет указанный объект.
- Аргументы
-
object | - замещающий объект |
index | - индекс замещаемого объекта |
- Исключения
-
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по возрастанию.
- Аргументы
-
collection | - исходная коллекция |
- Исключения
-
- См. также
- - setAscendingSortedCollection:
Метод замещает содержимое и настройки массива содержимым и настроками указанной коллекции с предварительной сортировкой данных по возрастанию с использованием заданного сортировщика данных.
- Аргументы
-
collection | - исходная коллекция |
sorter | - сортировщик данных |
- Исключения
-
- См. также
- - setAscendingSortedCollection:sorter:
Метод сортирует массив по возрастанию.
- Исключения
-
- См. также
- - sort
- (void) sortAscendingWithSorter: |
|
(id<SCSorter>) |
sorter |
|
Метод сортирует массив по возрастанию с использованием указанного сортировщика данных.
- Аргументы
-
sorter | - сортировщик данных |
- Исключения
-
- См. также
- - sortWithSorter:
Метод сортирует массив по убыванию.
- Исключения
-
- (void) sortDescendingWithSorter: |
|
(id<SCSorter>) |
sorter |
|
Метод сортирует массив по убыванию с использованием указанного сортировщика данных.
- Аргументы
-
sorter | - сортировщик данных |
- Исключения
-
Метод возвращает массив, отсортированный по возрастанию с использованием указанного сортировщика.
- Аргументы
-
sorter | - сортировщик данных |
- Возвращает
- Отсортированный массив
- Исключения
-
- См. также
- - ascendingSortedArrayWithSorter:
- (void) sortWithSorter: |
|
(id<SCSorter>) |
sorter |
|
Метод сортирует массив по возрастанию с использованием указанного сортировщика данных.
- Аргументы
-
sorter | - сортировщик данных |
- Исключения
-
- См. также
- - sortAscendingWithSorter:
Индекс последнего объекта в массиве
Массив с объектами в обратном порядке
Массив с отсортированными по возрастанию объектами
Объявления и описания членов классов находятся в файлах: