Class

NSSet

A static, unordered collection of unique objects.

Declaration 宣言

@interface NSSet<__covariant ObjectType> : NSObject

Overview 概要

The NSSet, NSMutableSet, and NSCountedSet classes declare the programmatic interface to an unordered collection of objects. NSSetNSMutableSet、そしてNSCountedSetクラスは、オブジェクトの順番付けられないコレクションに対するプログラムインターフェイスを宣言します。

NSSet declares the programmatic interface for static sets of distinct objects. You establish a static set’s entries when it’s created, and can’t modify the entries after that. NSMutableSet, on the other hand, declares a programmatic interface for dynamic sets of distinct objects. A dynamic — or mutable — set allows the addition and deletion of entries at any time, automatically allocating memory as needed.

Use sets as an alternative to arrays when the order of elements isn’t important and you need to consider performance in testing whether the set contains an object. With an array, testing for membership is slower than with sets.

NSSet is “toll-free bridged” with its Core Foundation counterpart, CFSetRef. See Toll-Free Bridging for more information on toll-free bridging. トールフリーブリッジに関する更なる情報としてToll-Free Bridgingを見てください。

In Swift, use this class instead of a Set constant in cases where you require reference semantics.

Subclassing Notes サブクラス作成の注意

There should be little need of subclassing. サブクラスを作る必要はほとんどないはずです。 If you need to customize behavior, it’s often better to consider composition instead of subclassing.

Methods to Override メソッドのオーバーライド

In a subclass, you must override all of its primitive methods: サブクラスにおいて、あなたはそれの根本的メソッドの全てをオーバーライドする必要があります:

Alternatives to Subclassing サブクラス作成の代わりとなるもの

Before making a custom class of NSSet, investigate NSHashTable and the corresponding Core Foundation type, CFSet. Because NSSet and CFSet are “toll-free bridged,” you can substitute a CFSet object for a NSSet object in your code (with appropriate casting). Although they’re corresponding types, CFSet and NSSet don’t have identical interfaces or implementations, and you can sometimes do things with CFSet that you can’t easily do with NSSet.

If the behavior you want to add supplements that of the existing class, you could write a category on NSSet. Keep in mind, however, that this category affects all instances of NSSet that you use, and this might have unintended consequences. Alternatively, you could use composition to achieve the desired behavior. あるいは、あなたは望む挙動を達成するためにコンポジション(合成)を使うことができます。

Topics 話題

Creating a Set 集合の作成

Initializing a Set 集合を初期化する

Counting Entries 登録項目を数える

Accessing Set Members 集合メンバにアクセスする

Comparing Sets 集合を比較する

Creating a Sorted Array ソート配列を作成する

Key-Value Observing キー値監視する

Describing a Set 集合を記述する

Instance Methods インスタンス メソッド

Relationships 関係

Inherits From 継承元

See Also 参照

Basic Collections 基本コレクション