NSSet.h翻译

/* NSSet.h  是无序的集合,但是它保证数据的唯一性。当插入相同的数据时，不会有任何效果。集合是一种哈希表，运用散列算法，查找集合中的元素比数组速度更快，但是它没有顺序。Copyright (c) 1994-2014, Apple Inc. All rights reserved.*/#import <Foundation/NSObject.h>#import <Foundation/NSEnumerator.h>@class NSArray, NSDictionary, NSString;/**************** Immutable Set ****************/ /**************** 不可变的Set   ****************/ @interface NSSet : NSObject <NSCopying, NSMutableCopying, NSSecureCoding, NSFastEnumeration>//  返回集合中对象的个数@property (readonly) NSUInteger count;//如果object是集合中的一员则返回这个object，否则返回null。- (id)member:(id)object;//返回一个NSEnumerator(枚举器)类型 - (NSEnumerator *)objectEnumerator;//初始化- (instancetype)init NS_DESIGNATED_INITIALIZER;//初始化的时候加入- (instancetype)initWithObjects:(const id [])objects count:(NSUInteger)cnt NS_DESIGNATED_INITIALIZER;- (instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;@end@interface NSSet (NSExtendedSet)//数组类型，set中所有的对象@property (readonly, copy) NSArray *allObjects;//返回集合中的第一个对象- (id)anyObject;// 判断集合是否包含对象anObject- (BOOL)containsObject:(id)anObject;//使用当前的集合生成字符串。可以重写description改变生成的字符串。@property (readonly, copy) NSString *description;- (NSString *)descriptionWithLocale:(id)locale;// 判断两个集合的交集是否至少存在一个元素- (BOOL)intersectsSet:(NSSet *)otherSet;// 判断两个集合是否相等- (BOOL)isEqualToSet:(NSSet *)otherSet;// 判断集合是否是另一个集合(otherSet)的子集- (BOOL)isSubsetOfSet:(NSSet *)otherSet;// 类似于for循环- (void)makeObjectsPerformSelector:(SEL)aSelector;- (void)makeObjectsPerformSelector:(SEL)aSelector withObject:(id)argument;//把一个对象加到原本集合 返回一个新NSSet * 无序的- (NSSet *)setByAddingObject:(id)anObject NS_AVAILABLE(10_5, 2_0);//把一个集合加到原本集合 返回一个新NSSet * 无序的- (NSSet *)setByAddingObjectsFromSet:(NSSet *)other NS_AVAILABLE(10_5, 2_0);//把一个数组加到原本集合 返回一个新NSSet * 无序的- (NSSet *)setByAddingObjectsFromArray:(NSArray *)other NS_AVAILABLE(10_5, 2_0);//遍历集合中的所有元素，obj就是集合中的元素 *stop BOOL类型的 控制什么时候停止遍历- (void)enumerateObjectsUsingBlock:(void (^)(id obj, BOOL *stop))block NS_AVAILABLE(10_6, 4_0);- (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(id obj, BOOL *stop))block NS_AVAILABLE(10_6, 4_0);- (NSSet *)objectsPassingTest:(BOOL (^)(id obj, BOOL *stop))predicate NS_AVAILABLE(10_6, 4_0);- (NSSet *)objectsWithOptions:(NSEnumerationOptions)opts passingTest:(BOOL (^)(id obj, BOOL *stop))predicate NS_AVAILABLE(10_6, 4_0);@end@interface NSSet (NSSetCreation)//构造对象+ (instancetype)set;//创建集合对象，并且初始化集合中的数值，结尾必须使用nil标志+ (instancetype)setWithObject:(id)object;+ (instancetype)setWithObjects:(const id [])objects count:(NSUInteger)cnt;+ (instancetype)setWithObjects:(id)firstObj, ... NS_REQUIRES_NIL_TERMINATION;//用另外一个set对象构造+ (instancetype)setWithSet:(NSSet *)set;//用数组构造+ (instancetype)setWithArray:(NSArray *)array;//使用一组对象创建新的集合 - (instancetype)initWithObjects:(id)firstObj, ... NS_REQUIRES_NIL_TERMINATION;//使用一个set来构造另一个set- (instancetype)initWithSet:(NSSet *)set;//使用一个set来构造另一个set flag YES 把里面的每一个对象都copy一份加到这个构造的set 如果flag 是NO 不做copy直接加到新集合中- (instancetype)initWithSet:(NSSet *)set copyItems:(BOOL)flag;//使用一个array来构造另一个set- (instancetype)initWithArray:(NSArray *)array;@end/**************** Mutable Set ****************//**************** 可变的 Set 继承自NSSet****************/@interface NSMutableSet : NSSet//向集合中动态的添加对象- (void)addObject:(id)object;//删除集合中的一个对象- (void)removeObject:(id)object;- (instancetype)initWithCoder:(NSCoder *)aDecoder NS_DESIGNATED_INITIALIZER;//初始化Mutable Set- (instancetype)init NS_DESIGNATED_INITIALIZER;//创建可变的集合对像，并且初始化长度为numItems- (instancetype)initWithCapacity:(NSUInteger)numItems NS_DESIGNATED_INITIALIZER;@end@interface NSMutableSet (NSExtendedMutableSet)//把一个数组加到原本集合 返回一个新NSSet * 无序的- (void)addObjectsFromArray:(NSArray *)array;//一个set是否包含otherSet中的对象 如果有返回YES - (void)intersectSet:(NSSet *)otherSet; - (void)minusSet:(NSSet *)otherSet;//移除集合里面的所有数据- (void)removeAllObjects;//把set和OtherSet的并集替换成set- (void)unionSet:(NSSet *)otherSet;//把一个set用otherSet替换了并把两个集合的交集加到set中- (void)setSet:(NSSet *)otherSet;@end创建可变集合对象,并且初始化长度为6@interface NSMutableSet (NSMutableSetCreation)//创建可变集合对象，并且初始化长度为numItems+ (instancetype)setWithCapacity:(NSUInteger)numItems;@end/**************** 继承自NSMutableSet的Counted Set ****************/@interface NSCountedSet : NSMutableSet {    @private    id _table;    void *_reserved;}//创建NSMutableSet集合对像，并且初始化长度为numItems- (instancetype)initWithCapacity:(NSUInteger)numItems; // designated initializer//用数组构造- (instancetype)initWithArray:(NSArray *)array;//用set构造- (instancetype)initWithSet:(NSSet *)set;//统计重复对象的个数- (NSUInteger)countForObject:(id)object;//返回一个枚举类型- (NSEnumerator *)objectEnumerator;//添加一个元素到CountedSet- (void)addObject:(id)object;//移除CountedSet中的某一个元素- (void)removeObject:(id)object;@end