MapDocumentation.swift

/// Returns an array containing the results of mapping the given closure
/// over the sequence's elements.
/// - Parameter transform: A mapping closure. `transform` accepts an
///   element of this sequence as its parameter and returns a transformed
///   value of the same or of a different type.
/// - Returns: An array containing the transformed elements of this
///   sequence.
public func map<T>(_ transform: (Element) throws -> T) rethrows -> [T]