mirror of
https://github.com/Instagram/IGListKit
synced 2026-05-14 04:49:05 +00:00
ad30e53507
Summary: Moving files to `Common` dir so changes are more automated with Buck and easier to manage in the long run. Ran `pod install` on test and example targets. Updated buck file to include `Common` so diffing lib still works. Part of #270 Reviewed By: jessesquires Differential Revision: D4346722 fbshipit-source-id: 366d89f6dd571b158b5fccd542080c51517ed341
39 lines
1.2 KiB
Objective-C
39 lines
1.2 KiB
Objective-C
/**
|
|
* Copyright (c) 2016-present, Facebook, Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This source code is licensed under the BSD-style license found in the
|
|
* LICENSE file in the root directory of this source tree. An additional grant
|
|
* of patent rights can be found in the PATENTS file in the same directory.
|
|
*/
|
|
|
|
#import <Foundation/Foundation.h>
|
|
|
|
/**
|
|
The `IGListDiffable` protocol provides methods needed to compare the identity and equality of two objects.
|
|
*/
|
|
@protocol IGListDiffable
|
|
|
|
/**
|
|
Returns a key that uniquely identifies the object.
|
|
|
|
@return A key that can be used to uniquely identify the object.
|
|
|
|
@note Two objects may share the same identifier, but are not equal. A common pattern is to use the `NSObject`
|
|
category for automatic conformance. However this means that objects will be identified on their
|
|
pointer value so finding updates becomes impossible.
|
|
|
|
@warning This value should never be mutated.
|
|
*/
|
|
- (nonnull id<NSObject>)diffIdentifier;
|
|
|
|
/**
|
|
Returns whether the receiver and a given object are equal.
|
|
|
|
@param object The object to be compared to the receiver.
|
|
|
|
@return `YES` if the receiver and object are equal, otherwise `NO`.
|
|
*/
|
|
- (BOOL)isEqualToDiffableObject:(nullable id<IGListDiffable>)object;
|
|
|
|
@end
|