Безопасное обращение к элементам массива в Swift: как избежать Index out of range?

Проблема безопасного доступа к массиву в Swift

В Swift нет встроенного метода для безопасного доступа к элементам массива, который бы возвращал опциональное значение. Однако вы легко можете добавить его с помощью расширения (extension) протокола Collection. Это позволит использовать синтаксис numbers[safe: index], который вы ищете.

Решение: расширение для безопасного индексирования

Создадим расширение для протокола Collection, которое добавляет сабскрипт с проверкой границ:

extension Collection {
    /// Возвращает элемент по индексу, если он существует, иначе nil
    subscript(safe index: Index) -> Element? {
        return indices.contains(index) ? self[index] : nil
    }
}

Теперь вы можете использовать его так:

let numbers = [10, 20, 30]

// Безопасное обращение
if let value = numbers[safe: 5] {
    print("Значение: \(value)")
} else {
    print("Индекс вне диапазона")
}

// Или с guard
guard let value = numbers[safe: 1] else {
    print("Ошибка доступа")
    return
}
print("Успех: \(value)")

Почему это работает?

• indices — свойство коллекции, которое возвращает диапазон всех допустимых индексов.
• contains проверяет, входит ли переданный индекс в этот диапазон.
• Если индекс корректен, мы возвращаем элемент через стандартный сабскрипт, иначе — nil.

Более производительная версия

Для массивов (Array) можно сделать более эффективную проверку, используя startIndex и endIndex:

extension Array {
    subscript(safe index: Int) -> Element? {
        guard index >= startIndex && index < endIndex else {
            return nil
        }
        return self[index]
    }
}

Этот вариант быстрее, так как не создает диапазон индексов, а просто сравнивает числа. Однако первый вариант универсален для всех типов коллекций (Set, Dictionary, String и т.д.).

Работа с опциональными значениями

Возвращаемое значение — опциональное (Optional), поэтому вы можете использовать все стандартные конструкции:

• Optional Binding: if let или guard let
• Nil-coalescing: let value = numbers[safe: 5] ?? defaultValue
• Map/FlatMap: numbers[safe: 5].map { ... }
• Chaining: numbers[safe: 0]?.description

Пример с циклом

Допустим, у вас есть массив индексов, и вы хотите безопасно получить все значения:

let indices = [0, 2, 10, 1]
let results = indices.compactMap { numbers[safe: $0] }
print(results) // [10, 30, 20] — индекс 10 пропущен

Этот подход элегантно решает проблему без лишних проверок в коде.

Важно: Помните, что это расширение не является частью стандартной библиотеки Swift. Но оно настолько популярно, что многие разработчики включают его в свои проекты как базовый инструмент.

func safeAccess<T>(array: [T], index: Int) -> T? {
    guard index >= 0, index < array.count else {
        return nil
    }
    return array[index]
}

// Использование
let numbers = [10, 20, 30]
if let value = safeAccess(array: numbers, index: 5) {
    print(value)
}