mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
337 lines
15 KiB
Swift
337 lines
15 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2017 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
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#if DEPLOYMENT_RUNTIME_SWIFT
|
|
import CoreFoundation
|
|
#else
|
|
@_exported import Foundation // Clang module
|
|
import _SwiftCoreFoundationOverlayShims
|
|
#endif
|
|
|
|
/// A `Measurement` is a model type that holds a `Double` value associated with a `Unit`.
|
|
///
|
|
/// Measurements support a large set of operators, including `+`, `-`, `*`, `/`, and a full set of comparison operators.
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
public struct Measurement<UnitType : Unit> : ReferenceConvertible, Comparable, Equatable {
|
|
public typealias ReferenceType = NSMeasurement
|
|
|
|
/// The unit component of the `Measurement`.
|
|
public let unit: UnitType
|
|
|
|
/// The value component of the `Measurement`.
|
|
public var value: Double
|
|
|
|
/// Create a `Measurement` given a specified value and unit.
|
|
public init(value: Double, unit: UnitType) {
|
|
self.value = value
|
|
self.unit = unit
|
|
}
|
|
|
|
public var hashValue: Int {
|
|
return Int(bitPattern: __CFHashDouble(value))
|
|
}
|
|
}
|
|
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension Measurement : CustomStringConvertible, CustomDebugStringConvertible, CustomReflectable {
|
|
public var description: String {
|
|
return "\(value) \(unit.symbol)"
|
|
}
|
|
|
|
public var debugDescription: String {
|
|
return "\(value) \(unit.symbol)"
|
|
}
|
|
|
|
public var customMirror: Mirror {
|
|
var c: [(label: String?, value: Any)] = []
|
|
c.append((label: "value", value: value))
|
|
c.append((label: "unit", value: unit.symbol))
|
|
return Mirror(self, children: c, displayStyle: Mirror.DisplayStyle.struct)
|
|
}
|
|
}
|
|
|
|
|
|
/// When a `Measurement` contains a `Dimension` unit, it gains the ability to convert between the kinds of units in that dimension.
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension Measurement where UnitType : Dimension {
|
|
/// Returns a new measurement created by converting to the specified unit.
|
|
///
|
|
/// - parameter otherUnit: A unit of the same `Dimension`.
|
|
/// - returns: A converted measurement.
|
|
public func converted(to otherUnit: UnitType) -> Measurement<UnitType> {
|
|
if unit.isEqual(otherUnit) {
|
|
return Measurement(value: value, unit: otherUnit)
|
|
} else {
|
|
let valueInTermsOfBase = unit.converter.baseUnitValue(fromValue: value)
|
|
if otherUnit.isEqual(type(of: unit).baseUnit()) {
|
|
return Measurement(value: valueInTermsOfBase, unit: otherUnit)
|
|
} else {
|
|
let otherValueFromTermsOfBase = otherUnit.converter.value(fromBaseUnitValue: valueInTermsOfBase)
|
|
return Measurement(value: otherValueFromTermsOfBase, unit: otherUnit)
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Converts the measurement to the specified unit.
|
|
///
|
|
/// - parameter otherUnit: A unit of the same `Dimension`.
|
|
public mutating func convert(to otherUnit: UnitType) {
|
|
self = converted(to: otherUnit)
|
|
}
|
|
|
|
/// Add two measurements of the same Dimension.
|
|
///
|
|
/// If the `unit` of the `lhs` and `rhs` are `isEqual`, then this returns the result of adding the `value` of each `Measurement`. If they are not equal, then this will convert both to the base unit of the `Dimension` and return the result as a `Measurement` of that base unit.
|
|
/// - returns: The result of adding the two measurements.
|
|
public static func +(lhs: Measurement<UnitType>, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
if lhs.unit.isEqual(rhs.unit) {
|
|
return Measurement(value: lhs.value + rhs.value, unit: lhs.unit)
|
|
} else {
|
|
let lhsValueInTermsOfBase = lhs.unit.converter.baseUnitValue(fromValue: lhs.value)
|
|
let rhsValueInTermsOfBase = rhs.unit.converter.baseUnitValue(fromValue: rhs.value)
|
|
return Measurement(value: lhsValueInTermsOfBase + rhsValueInTermsOfBase, unit: type(of: lhs.unit).baseUnit())
|
|
}
|
|
}
|
|
|
|
/// Subtract two measurements of the same Dimension.
|
|
///
|
|
/// If the `unit` of the `lhs` and `rhs` are `==`, then this returns the result of subtracting the `value` of each `Measurement`. If they are not equal, then this will convert both to the base unit of the `Dimension` and return the result as a `Measurement` of that base unit.
|
|
/// - returns: The result of adding the two measurements.
|
|
public static func -(lhs: Measurement<UnitType>, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
if lhs.unit == rhs.unit {
|
|
return Measurement(value: lhs.value - rhs.value, unit: lhs.unit)
|
|
} else {
|
|
let lhsValueInTermsOfBase = lhs.unit.converter.baseUnitValue(fromValue: lhs.value)
|
|
let rhsValueInTermsOfBase = rhs.unit.converter.baseUnitValue(fromValue: rhs.value)
|
|
return Measurement(value: lhsValueInTermsOfBase - rhsValueInTermsOfBase, unit: type(of: lhs.unit).baseUnit())
|
|
}
|
|
}
|
|
}
|
|
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension Measurement {
|
|
/// Add two measurements of the same Unit.
|
|
/// - precondition: The `unit` of `lhs` and `rhs` must be `isEqual`.
|
|
/// - returns: A measurement of value `lhs.value + rhs.value` and unit `lhs.unit`.
|
|
public static func +(lhs: Measurement<UnitType>, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
if lhs.unit.isEqual(rhs.unit) {
|
|
return Measurement(value: lhs.value + rhs.value, unit: lhs.unit)
|
|
} else {
|
|
fatalError("Attempt to add measurements with non-equal units")
|
|
}
|
|
}
|
|
|
|
/// Subtract two measurements of the same Unit.
|
|
/// - precondition: The `unit` of `lhs` and `rhs` must be `isEqual`.
|
|
/// - returns: A measurement of value `lhs.value - rhs.value` and unit `lhs.unit`.
|
|
public static func -(lhs: Measurement<UnitType>, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
if lhs.unit.isEqual(rhs.unit) {
|
|
return Measurement(value: lhs.value - rhs.value, unit: lhs.unit)
|
|
} else {
|
|
fatalError("Attempt to subtract measurements with non-equal units")
|
|
}
|
|
}
|
|
|
|
/// Multiply a measurement by a scalar value.
|
|
/// - returns: A measurement of value `lhs.value * rhs` with the same unit as `lhs`.
|
|
public static func *(lhs: Measurement<UnitType>, rhs: Double) -> Measurement<UnitType> {
|
|
return Measurement(value: lhs.value * rhs, unit: lhs.unit)
|
|
}
|
|
|
|
/// Multiply a scalar value by a measurement.
|
|
/// - returns: A measurement of value `lhs * rhs.value` with the same unit as `rhs`.
|
|
public static func *(lhs: Double, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
return Measurement(value: lhs * rhs.value, unit: rhs.unit)
|
|
}
|
|
|
|
/// Divide a measurement by a scalar value.
|
|
/// - returns: A measurement of value `lhs.value / rhs` with the same unit as `lhs`.
|
|
public static func /(lhs: Measurement<UnitType>, rhs: Double) -> Measurement<UnitType> {
|
|
return Measurement(value: lhs.value / rhs, unit: lhs.unit)
|
|
}
|
|
|
|
/// Divide a scalar value by a measurement.
|
|
/// - returns: A measurement of value `lhs / rhs.value` with the same unit as `rhs`.
|
|
public static func /(lhs: Double, rhs: Measurement<UnitType>) -> Measurement<UnitType> {
|
|
return Measurement(value: lhs / rhs.value, unit: rhs.unit)
|
|
}
|
|
|
|
/// Compare two measurements of the same `Dimension`.
|
|
///
|
|
/// If `lhs.unit == rhs.unit`, returns `lhs.value == rhs.value`. Otherwise, converts `rhs` to the same unit as `lhs` and then compares the resulting values.
|
|
/// - returns: `true` if the measurements are equal.
|
|
public static func ==<LeftHandSideType, RightHandSideType>(_ lhs: Measurement<LeftHandSideType>, _ rhs: Measurement<RightHandSideType>) -> Bool {
|
|
if lhs.unit == rhs.unit {
|
|
return lhs.value == rhs.value
|
|
} else {
|
|
if let lhsDimensionalUnit = lhs.unit as? Dimension,
|
|
let rhsDimensionalUnit = rhs.unit as? Dimension {
|
|
if type(of: lhsDimensionalUnit).baseUnit() == type(of: rhsDimensionalUnit).baseUnit() {
|
|
let lhsValueInTermsOfBase = lhsDimensionalUnit.converter.baseUnitValue(fromValue: lhs.value)
|
|
let rhsValueInTermsOfBase = rhsDimensionalUnit.converter.baseUnitValue(fromValue: rhs.value)
|
|
return lhsValueInTermsOfBase == rhsValueInTermsOfBase
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
}
|
|
|
|
/// Compare two measurements of the same `Unit`.
|
|
/// - returns: `true` if the measurements can be compared and the `lhs` is less than the `rhs` converted value.
|
|
public static func <<LeftHandSideType, RightHandSideType>(lhs: Measurement<LeftHandSideType>, rhs: Measurement<RightHandSideType>) -> Bool {
|
|
if lhs.unit == rhs.unit {
|
|
return lhs.value < rhs.value
|
|
} else {
|
|
if let lhsDimensionalUnit = lhs.unit as? Dimension,
|
|
let rhsDimensionalUnit = rhs.unit as? Dimension {
|
|
if type(of: lhsDimensionalUnit).baseUnit() == type(of: rhsDimensionalUnit).baseUnit() {
|
|
let lhsValueInTermsOfBase = lhsDimensionalUnit.converter.baseUnitValue(fromValue: lhs.value)
|
|
let rhsValueInTermsOfBase = rhsDimensionalUnit.converter.baseUnitValue(fromValue: rhs.value)
|
|
return lhsValueInTermsOfBase < rhsValueInTermsOfBase
|
|
}
|
|
}
|
|
fatalError("Attempt to compare measurements with non-equal dimensions")
|
|
}
|
|
}
|
|
}
|
|
|
|
// Implementation note: similar to NSArray, NSDictionary, etc., NSMeasurement's import as an ObjC generic type is suppressed by the importer. Eventually we will need a more general purpose mechanism to correctly import generic types.
|
|
|
|
#if DEPLOYMENT_RUNTIME_SWIFT
|
|
internal typealias MeasurementBridgeType = _ObjectTypeBridgeable
|
|
#else
|
|
internal typealias MeasurementBridgeType = _ObjectiveCBridgeable
|
|
#endif
|
|
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension Measurement : MeasurementBridgeType {
|
|
@_semantics("convertToObjectiveC")
|
|
public func _bridgeToObjectiveC() -> NSMeasurement {
|
|
return NSMeasurement(doubleValue: value, unit: unit)
|
|
}
|
|
|
|
public static func _forceBridgeFromObjectiveC(_ source: NSMeasurement, result: inout Measurement?) {
|
|
result = Measurement(value: source.doubleValue, unit: source.unit as! UnitType)
|
|
}
|
|
|
|
public static func _conditionallyBridgeFromObjectiveC(_ source: NSMeasurement, result: inout Measurement?) -> Bool {
|
|
if let u = source.unit as? UnitType {
|
|
result = Measurement(value: source.doubleValue, unit: u)
|
|
return true
|
|
} else {
|
|
return false
|
|
}
|
|
}
|
|
|
|
public static func _unconditionallyBridgeFromObjectiveC(_ source: NSMeasurement?) -> Measurement {
|
|
let u = source!.unit as! UnitType
|
|
return Measurement(value: source!.doubleValue, unit: u)
|
|
}
|
|
}
|
|
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension NSMeasurement : _HasCustomAnyHashableRepresentation {
|
|
// Must be @nonobjc to avoid infinite recursion during bridging.
|
|
@nonobjc
|
|
public func _toCustomAnyHashable() -> AnyHashable? {
|
|
#if DEPLOYMENT_RUNTIME_SWIFT
|
|
return AnyHashable(Measurement._unconditionallyBridgeFromObjectiveC(self))
|
|
#else
|
|
return AnyHashable(self as Measurement)
|
|
#endif
|
|
}
|
|
}
|
|
|
|
// This workaround is required for the time being, because Swift doesn't support covariance for Measurement (26607639)
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension MeasurementFormatter {
|
|
public func string<UnitType>(from measurement: Measurement<UnitType>) -> String {
|
|
if let result = string(for: measurement) {
|
|
return result
|
|
} else {
|
|
return ""
|
|
}
|
|
}
|
|
}
|
|
|
|
// @available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
// extension Unit : Codable {
|
|
// public convenience init(from decoder: Decoder) throws {
|
|
// let container = try decoder.singleValueContainer()
|
|
// let symbol = try container.decode(String.self)
|
|
// self.init(symbol: symbol)
|
|
// }
|
|
|
|
// public func encode(to encoder: Encoder) throws {
|
|
// var container = encoder.singleValueContainer()
|
|
// try container.encode(self.symbol)
|
|
// }
|
|
// }
|
|
|
|
@available(OSX 10.12, iOS 10.0, watchOS 3.0, tvOS 10.0, *)
|
|
extension Measurement : Codable {
|
|
private enum CodingKeys : Int, CodingKey {
|
|
case value
|
|
case unit
|
|
}
|
|
|
|
private enum UnitCodingKeys : Int, CodingKey {
|
|
case symbol
|
|
case converter
|
|
}
|
|
|
|
private enum LinearConverterCodingKeys : Int, CodingKey {
|
|
case coefficient
|
|
case constant
|
|
}
|
|
|
|
public init(from decoder: Decoder) throws {
|
|
let container = try decoder.container(keyedBy: CodingKeys.self)
|
|
let value = try container.decode(Double.self, forKey: .value)
|
|
|
|
let unitContainer = try container.nestedContainer(keyedBy: UnitCodingKeys.self, forKey: .unit)
|
|
let symbol = try unitContainer.decode(String.self, forKey: .symbol)
|
|
|
|
let unit: UnitType
|
|
if UnitType.self is Dimension.Type {
|
|
let converterContainer = try unitContainer.nestedContainer(keyedBy: LinearConverterCodingKeys.self, forKey: .converter)
|
|
let coefficient = try converterContainer.decode(Double.self, forKey: .coefficient)
|
|
let constant = try converterContainer.decode(Double.self, forKey: .constant)
|
|
let unitMetaType = (UnitType.self as! Dimension.Type)
|
|
unit = (unitMetaType.init(symbol: symbol, converter: UnitConverterLinear(coefficient: coefficient, constant: constant)) as! UnitType)
|
|
} else {
|
|
unit = UnitType(symbol: symbol)
|
|
}
|
|
|
|
self.init(value: value, unit: unit)
|
|
}
|
|
|
|
public func encode(to encoder: Encoder) throws {
|
|
var container = encoder.container(keyedBy: CodingKeys.self)
|
|
try container.encode(self.value, forKey: .value)
|
|
|
|
var unitContainer = container.nestedContainer(keyedBy: UnitCodingKeys.self, forKey: .unit)
|
|
try unitContainer.encode(self.unit.symbol, forKey: .symbol)
|
|
|
|
if UnitType.self is Dimension.Type {
|
|
guard type(of: (self.unit as! Dimension).converter) is UnitConverterLinear.Type else {
|
|
preconditionFailure("Cannot encode a Measurement whose UnitType has a non-linear unit converter.")
|
|
}
|
|
|
|
let converter = (self.unit as! Dimension).converter as! UnitConverterLinear
|
|
var converterContainer = unitContainer.nestedContainer(keyedBy: LinearConverterCodingKeys.self, forKey: .converter)
|
|
try converterContainer.encode(converter.coefficient, forKey: .coefficient)
|
|
try converterContainer.encode(converter.constant, forKey: .constant)
|
|
}
|
|
}
|
|
}
|