文書 > Foundation > Collections > Set > insert(_:)

インスタンスメソッド

insert(_:)

指定された要素がまだ存在しない場合は、Set に挿入します。

宣言

@discardableResult mutating func insert(_ newMember: Element) -> (inserted: Bool, memberAfterInsert: Element)

パラメータ

newMember

Set 内に挿入すべき要素。

戻り値

newMember が Set に含まれていなかった場合 (true、newMember)です。newMember と等しい要素がすでに Set に含まれている場合、メソッドは (false、oldMember) を返します。ここで、oldMember は newMember と等しかった要素です。場合によっては、識別情報の比較またはその他の方法で oldMember を newMember と区別できる場合があります。

議論

newMember と等しい要素がすでに Set に含まれている場合、このメソッドは効果がありません。以下の例では、新しい要素が classDays、つまり曜日の Set に挿入されます。既存の要素が挿入されても、classDays の Set は変更されません。

enum DayOfTheWeek: Int {
    case sunday, monday, tuesday, wednesday, thursday,
        friday, saturday
}

var classDays: Set<DayOfTheWeek> = [.wednesday, .friday]
print(classDays.insert(.monday))
// Prints "(true, .monday)"
print(classDays)
// Prints "[.friday, .wednesday, .monday]"

print(classDays.insert(.friday))
// Prints "(false, .friday)"
print(classDays)
// Prints "[.friday, .wednesday, .monday]"