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

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

Разработчик

Фото ссылка платформы ссылка класса PHFetchResult

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

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

PHFetchResult

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

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

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

Swift

import Photos

Objective C

@import Photos;

Доступность

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

A PHFetchResult объект является контейнером для упорядоченного списка фото объектов объекта. (Фото объекты являются объектами, моделирующими элементы, с которыми работает пользователь в фото приложении: активы, наборы актива и списки набора.), Когда Вы используете методы класса для PHAsset, PHCollection, PHAssetCollection, и PHCollectionList классы для получения объектов фотографии обеспечивают полученные объекты в результате выборки. Вы получаете доступ к содержанию результата выборки с теми же методами и соглашениями, используемыми NSArray класс. В отличие от этого NSArray объект, однако, a PHFetchResult возразите динамично загружает ее содержание из фото библиотеки по мере необходимости, обеспечивая оптимальную производительность, обрабатывая большое количество результатов.

Результат выборки обеспечивает ориентированный на многопотоковое исполнение доступ к своему содержанию. После выборки, результат выборки count значение является постоянным, и все объекты в результате выборки сохраняют то же localIdentifier значение. (Для получения обновленного содержания для выборки зарегистрируйте наблюдателя изменения в совместно используемом PHPhotoLibrary объект.)

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

Запросы результата выборки
  • 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 Photos;

    Swift

    import Photos

    Доступность

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

  • count Свойство

    Число объектов в результате выборки. (только для чтения)

    Объявление

    Swift

    var count: Int { get }

    Objective C

    @property(readonly) NSUInteger count

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • countOfAssetsWithMediaType (_:) - countOfAssetsWithMediaType:

    Возвращает число активов в результате выборки указанного типа.

    Объявление

    Swift

    func countOfAssetsWithMediaType(_ mediaType: PHAssetMediaType) -> Int

    Objective C

    - (NSUInteger)countOfAssetsWithMediaType:(PHAssetMediaType)mediaType

    Параметры

    mediaType

    Тип активов для подсчета, такие как изображение или видео. Посмотрите Типы Актива.

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

    Число активов в результате выборки указанного типа.

    Обсуждение

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

    Этот метод рассчитывает только PHAsset объекты в результате выборки. Если результат выборки содержит только PHAssetCollection или PHCollectionList объекты, возвращаемое значение 0.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • firstObject Свойство

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

    Объявление

    Swift

    var firstObject: AnyObject! { get }

    Objective C

    @property(nonatomic, readonly) id firstObject

    Обсуждение

    Вы указываете упорядочивание результата выборки в PHFetchOptions возразите, что Вы передаете методу выборки.

    Возвраты nil если результат выборки пуст.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • lastObject Свойство

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

    Объявление

    Swift

    var lastObject: AnyObject! { get }

    Objective C

    @property(nonatomic, readonly) id lastObject

    Обсуждение

    Вы указываете упорядочивание результата выборки в PHFetchOptions возразите, что Вы передаете методу выборки.

    Возвраты nil если результат выборки пуст.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • objectAtIndex (_:) - objectAtIndex:

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

    Объявление

    Swift

    func objectAtIndex(_ index: Int) -> AnyObject!

    Objective C

    - (id)objectAtIndex:(NSUInteger)index

    Параметры

    index

    Индекс в границах результата выборки.

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

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

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • - objectAtIndexedSubscript:

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

    Объявление

    Objective C

    - (id)objectAtIndexedSubscript:(NSUInteger)idx

    Параметры

    idx

    Индекс в границах результата выборки.

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

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

    Обсуждение

    Повышает исключение (NSRangeException) если idx вне конца результата выборки (т.е. больше, чем или равный значению count свойство).

    Этот метод ведет себя тождественно к objectAtIndex: метод и позволяет Вам получать доступ к результату выборки с помощью синтаксиса нижнего индекса Objective C. Т.е. эти два оператора ниже приводят к тому же результату:

    • NSLog(@"First object: %@", [fetchResult objectAtIndex:0]);
    • NSLog(@"First object: %@", fetchResult[0]);

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

    Objective C

    @import Photos;

    Доступность

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

  • objectsAtIndexes (_:) - objectsAtIndexes:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    indexes

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

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

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

    Обсуждение

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

    Повышает исключение (NSRangeException) если какой-либо индекс в индексном наборе вне конца результата выборки (т.е. больше, чем или равный значению count свойство).

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Нахождение объектов в результате выборки
  • indexOfObject (_:) - indexOfObject:

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

    Объявление

    Swift

    func indexOfObject(_ anObject: AnyObject!) -> Int

    Objective C

    - (NSUInteger)indexOfObject:(id)anObject

    Параметры

    anObject

    Объект.

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

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

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • 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, или NSNotFound если никакой такой объект не находится в результате выборки.

    Обсуждение

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

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Выполнение операций с объектами в результате выборки
  • enumerateObjectsAtIndexes (_: options:usingBlock:) - enumerateObjectsAtIndexes:options:usingBlock:

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    s

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

    opts

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

    block

    Блок для применения к элементам в результате выборки.

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

    obj

    Элемент в результате выборки.

    idx

    Индекс элемента в результате выборки.

    stop

    Указатель на булево значение. Набор *stop к YEStrue в блоке для отмены последующей обработки результата выборки.

    Обсуждение

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

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • 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

    Указатель на булево значение. Набор *stop к YEStrue в блоке для отмены последующей обработки результата выборки.

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • 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

    Указатель на булево значение. Набор *stop к YEStrue в блоке для отмены последующей обработки результата выборки.

    Обсуждение

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

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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