mirror of
https://github.com/apple/swift-collections
synced 2026-11-22 04:20:40 +00:00
71 lines
2.7 KiB
Swift
71 lines
2.7 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Swift Collections open source project
|
|
//
|
|
// Copyright (c) 2022 - 2026 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0 WITH Swift-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
extension TreeDictionary {
|
|
/// Returns a new dictionary containing the keys of this dictionary with the
|
|
/// values transformed by the given closure.
|
|
///
|
|
/// - Parameter transform: A closure that transforms a value. `transform`
|
|
/// accepts each value of the dictionary as its parameter and returns a
|
|
/// transformed value of the same or of a different type.
|
|
/// - Returns: A dictionary containing the keys and transformed values of
|
|
/// this dictionary.
|
|
///
|
|
/// - Complexity: O(`count`)
|
|
@inlinable
|
|
public func mapValues<T>(
|
|
_ transform: (Value) throws -> T
|
|
) rethrows -> TreeDictionary<Key, T> {
|
|
let transformed = try _root.mapValues { try transform($0.value) }
|
|
let r = TreeDictionary<Key, T>(_new: transformed)
|
|
r._invariantCheck()
|
|
return r
|
|
}
|
|
|
|
/// Returns a new dictionary containing only the key-value pairs that have
|
|
/// non-`nil` values as the result of transformation by the given closure.
|
|
///
|
|
/// Use this method to receive a dictionary with non-optional values when
|
|
/// your transformation produces optional values.
|
|
///
|
|
/// In this example, note the difference in the result of using `mapValues`
|
|
/// and `compactMapValues` with a transformation that returns an optional
|
|
/// `Int` value.
|
|
///
|
|
/// let data: TreeDictionary = ["a": "1", "b": "three", "c": "///4///"]
|
|
///
|
|
/// let m: [String: Int?] = data.mapValues { str in Int(str) }
|
|
/// // ["a": Optional(1), "b": nil, "c": nil]
|
|
///
|
|
/// let c: [String: Int] = data.compactMapValues { str in Int(str) }
|
|
/// // ["a": 1]
|
|
///
|
|
/// - Parameter transform: A closure that transforms a value. `transform`
|
|
/// accepts each value of the dictionary as its parameter and returns an
|
|
/// optional transformed value of the same or of a different type.
|
|
///
|
|
/// - Returns: A dictionary containing the keys and non-`nil` transformed
|
|
/// values of this dictionary.
|
|
///
|
|
/// - Complexity: O(`count`)
|
|
@inlinable
|
|
public func compactMapValues<T>(
|
|
_ transform: (Value) throws -> T?
|
|
) rethrows -> TreeDictionary<Key, T> {
|
|
let result = try _root.compactMapValues(.top, transform)
|
|
let d = TreeDictionary<Key, T>(_new: result.finalize(.top))
|
|
d._invariantCheck()
|
|
return d
|
|
}
|
|
}
|