Function Overview

Returns a new array with duplicate elements removed while preserving order. By default, the function keeps the first occurrence of each unique element. If keepLast is true, it keeps the last occurrence of each unique element, preserving their order as it appears in the original array.

Parameters

• items: [T] The source array to deduplicate. Element type T must conform to Hashable.
• keepLast: Bool (default: false)
  • false: Keep the first occurrence of each unique element (stable first-keep).
  • true: Keep the last occurrence of each unique element (stable last-keep).

Return Value

• [T]: A new array containing unique elements according to the chosen policy (first or last), with order preserved among the kept elements.

Example Usage

// Keep first occurrence (default)
let input = [1, 2, 1, 3, 2, 4]
let uniqueFirst = deduplicated(input)
// uniqueFirst: [1, 2, 3, 4]

// Keep last occurrence
let uniqueLast = deduplicated(input, keepLast: true)
// uniqueLast: [1, 3, 2, 4]

// Works with any Hashable type
let names = ["Ana", "Bob", "Ana", "Cara", "Bob"]
let firstKept = deduplicated(names)                   // ["Ana", "Bob", "Cara"]
let lastKept  = deduplicated(names, keepLast: true)   // ["Ana", "Cara", "Bob"]

Notes

• Uniqueness is determined by Hashable/Equatable conformance of T. For custom types, ensure Hashable and equality are defined correctly.
• Time complexity: O(n); Space complexity: O(n), where n is items.count.
• Ordering:
  • keepLast == false: Keeps the first occurrence and preserves the original order of first appearances.
  • keepLast == true: Keeps the last occurrence and preserves the original order of those last appearances.
• Floating-point caveat: Because NaN != NaN in Swift, multiple NaN values are treated as distinct and will not be deduplicated.

• 函数功能概述

  • 将指定的 Date 根据给定的格式模板、时区标识和本地化设置格式化为字符串。当提供的时区标识无效时抛出错误。

• 参数说明

  • date: Date
    • 需要被格式化的日期时间对象。
  • pattern: String = "yyyy-MM-dd HH:mm"
    • 日期时间格式模板，直接赋值给 DateFormatter.dateFormat。
    • 使用 Unicode TR-35 标准的格式符号（大小写敏感），例如：
      • yyyy 年、MM 月、dd 日、HH 24小时、hh 12小时、mm 分、ss 秒、zzz 时区缩写等。
  • timeZoneID: String? = nil
    • IANA 时区标识（例如 "UTC"、"Asia/Shanghai"、"America/Los_Angeles"）。
    • 传入 nil 时使用系统当前时区。
    • 传入非空但无效的标识时将抛出 DateFormatError.invalidTimeZone。
  • locale: Locale = .current
    • 本地化设置，影响月份/星期名称、数字形态等语言化结果。
    • 不影响时区，仅决定文本如何本地化显示。

• 返回值描述

  • String
    • 按照给定格式、时区和本地化设置生成的日期时间字符串。

• 使用示例

  • 基本用法（使用默认格式、系统时区和当前语言环境）：
    • let text = try format(date: Date())
  • 指定格式、时区与本地化：
    • let date = Date(timeIntervalSince1970: 1_696_000_000) // 示例时间戳 let text = try format( date: date, pattern: "yyyy-MM-dd HH:mm zzz", timeZoneID: "Asia/Shanghai", locale: Locale(identifier: "zh_CN") )
  • 异常处理（无效时区标识）：
    • do { _ = try format(date: Date(), timeZoneID: "Invalid/Zone") } catch DateFormatError.invalidTimeZone { print("提供的时区标识无效") } catch { print("其他错误：(error)") }

• 注意事项

  • 错误抛出：仅当 timeZoneID 非空且无法解析为有效的 TimeZone 标识时抛出 DateFormatError.invalidTimeZone。
  • 默认时区：timeZoneID 为 nil 时结果依赖运行环境的当前系统时区，不同设备或设置下结果可能不同。
  • 格式模板：pattern 使用 Unicode TR-35 标准，大小写严格区分（例如 MM 表示“月”，mm 表示“分”；HH 为 24 小时制，hh 为 12 小时制）。
  • 本地化：locale 影响语言化输出（如月份/星期名），若需要固定、不随用户设置变化的“机器可读”格式，建议使用 Locale(identifier: "en_US_POSIX")。
  • 性能与线程安全：函数每次调用都会新建 DateFormatter（线程安全），但高频调用可能有性能开销；需要时可在上层对 DateFormatter 做缓存复用。