Как добавить элементы в словарь (Dictionary) в Swift?

Правильный способ добавления элементов в Dictionary в Swift

В Swift словари (Dictionary) не имеют метода append(), потому что это не упорядоченная коллекция, как массив. Вместо этого для добавления или обновления элемента используется прямая установка значения по ключу с помощью сабскрипта (subscript).

Основной синтаксис

Чтобы добавить новую пару ключ-значение, используйте следующий синтаксис:

var studentGrades = ["Иван": 5, "Мария": 4]
studentGrades["Пётр"] = 3
print(studentGrades) // ["Иван": 5, "Мария": 4, "Пётр": 3]

Если ключ уже существует, значение будет перезаписано:

studentGrades["Иван"] = 4 // Оценка Ивана изменилась с 5 на 4

Использование метода updateValue(_:forKey:)

Swift также предоставляет метод updateValue(_:forKey:), который возвращает старое значение (если оно было) или nil, если ключ новый. Это полезно, когда нужно проверить, был ли ключ уже в словаре:

var studentGrades = ["Иван": 5, "Мария": 4]

if let oldValue = studentGrades.updateValue(3, forKey: "Пётр") {
    print("Обновлено: \(oldValue) -> 3")
} else {
    print("Добавлен новый студент Пётр с оценкой 3")
}
// Вывод: "Добавлен новый студент Пётр с оценкой 3"

if let oldValue = studentGrades.updateValue(4, forKey: "Иван") {
    print("Обновлено: \(oldValue) -> 4")
}
// Вывод: "Обновлено: 5 -> 4"

Добавление нескольких элементов

Если нужно добавить сразу несколько пар, можно использовать словарный литерал или метод merge(_:uniquingKeysWith:):

var studentGrades = ["Иван": 5, "Мария": 4]

// Способ 1: прямое присваивание
studentGrades["Пётр"] = 3
studentGrades["Анна"] = 5

// Способ 2: merge
let newStudents = ["Олег": 4, "Елена": 2]
studentGrades.merge(newStudents) { (current, new) in
    return new // если ключи совпадают, берём новое значение
}
print(studentGrades)
// ["Иван": 5, "Мария": 4, "Пётр": 3, "Анна": 5, "Олег": 4, "Елена": 2]

Добавление с проверкой на nil (опциональные значения)

Если словарь хранит опциональные значения, например [String: Int?], нужно быть внимательным. Установка nil удаляет ключ:

var optionalDict: [String: Int?] = ["a": 1]
optionalDict["b"] = nil // Ключ "b" не будет добавлен, это равносильно удалению
optionalDict["a"] = nil // Ключ "a" будет удалён из словаря

// Чтобы добавить nil как значение, используйте Optional:
optionalDict["c"] = Optional(nil) // или .some(nil)
print(optionalDict) // ["c": nil]

Важные замечания

• Ключи должны быть уникальными и хешируемыми — в Swift все базовые типы (String, Int, Double) соответствуют протоколу Hashable.
• Dictionary — это структура (value type), поэтому при изменении создаётся копия, если словарь объявлен как let (константа), изменить его нельзя.
• Порядок элементов не гарантируется — в отличие от массивов, словари не сохраняют порядок добавления (хотя в Swift 5+ порядок итерации стабилен, но не зафиксирован документально).

Что делать, если нужно сохранить порядок?

Если порядок важен, используйте NSOrderedDictionary из Foundation или создайте массив кортежей:

var orderedStudents: [(name: String, grade: Int)] = []
orderedStudents.append(("Иван", 5))
orderedStudents.append(("Мария", 4))

Итак, запомните: в Swift для добавления элемента в словарь используйте dict[key] = value. Это самый простой и распространённый способ.

let pairs: [(String, Int)] = [
    ("Иван", 5),
    ("Мария", 4),
    ("Пётр", 3)
]

var studentGrades = Dictionary(uniqueKeysWithValues: pairs)
print(studentGrades) // ["Иван": 5, "Мария": 4, "Пётр": 3]

let pairsWithDuplicates = [("Иван", 5), ("Иван", 3)]
let grades = Dictionary(pairsWithDuplicates) { first, _ in first }
print(grades) // ["Иван": 5] — остаётся первое значение

let baseGrades = ["Иван": 5, "Мария": 4]
let newGrades = ["Пётр": 3]
let allGrades = baseGrades.merging(newGrades) { $1 }
// или так:
let allGrades2 = baseGrades + newGrades // если определить оператор
// Но стандартного оператора нет, нужно писать расширение

extension Dictionary {
    static func + (lhs: [Key: Value], rhs: [Key: Value]) -> [Key: Value] {
        return lhs.merging(rhs) { $1 }
    }
}

let combined = baseGrades + newGrades
print(combined) // ["Иван": 5, "Мария": 4, "Пётр": 3]