Generic Structure

Measurement

A numeric quantity labeled with a unit of measure, with support for unit conversion and unit-aware calculations. ある寸法単位によってラベルをつけられたある数量、それは単位変換および単位を考慮した計算に対するサポートを備えます。

Declaration 宣言 

struct Measurement<UnitType> where UnitType : Unit

Overview 概要

A Measurement object represents a quantity and unit of measure. The Measurement type provides a programmatic interface to converting measurements into different units, as well as calculating the sum or difference between two measurements. あるMeasurementオブジェクトは、ある寸法の量と単位を表します。そのMeasurement型は、寸法を異なる単位に変換することに対してプログラムインターフェイスを提供します、２つの寸法の間の差やその合計を計算することだけでなく。

Measurement objects are initialized with a Unit object and double value. Measurement objects are immutable, and cannot be changed after being created. Measurementオブジェクトは、あるUnitオブジェクトとdouble値で初期化されます。Measurementオブジェクトは不変です、そして作成された後で変更されることはできません。

Measurements support a large set of operators, including +, -, *, /, and a full set of comparison operators. Measurementは、主要な一群の演算子を、+、-、*、/を含めて、そして完全な一式の比較演算子をサポートします。

Topics 話題

Creating a Measurement ある寸法を作成する

init(value: Double, unit: UnitType)
Create a Measurement given a specified value and unit. 指定された値と単位を与えられたMeasurementを作成します。
init(from: Decoder)
Creates a new instance by decoding from the given decoder. 新しいインスタンスをこの与えられたデコーダからデコーディングすることによって作成します。

Accessing the Value and Units 値と単位にアクセスする

let unit: UnitType
The unit component of the measurement. この寸法の単位構成要素。
var value: Double
The value component of the measurement. この寸法の値構成要素。

Converting to Other Units 他の単位に変換する

func convert(to: UnitType)
Converts the measurement to the specified unit. 寸法を指定された単位へ変換します。
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
func converted(to: UnitType) -> Measurement<UnitType>
Returns a new measurement created by converting to the specified unit. 指定された単位に変換することによって作成される新しい寸法を返します。
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。

Operating on a Measurement ある寸法に関して演算する

static func * (Double, Measurement<UnitType>) -> Measurement<UnitType>
Multiply a scalar value by a measurement. あるスカラー値に寸法を掛けます。
static func * (Measurement<UnitType>, Double) -> Measurement<UnitType>
Multiply a measurement by a scalar value. ある寸法にスカラー値を掛けます。
static func + (Measurement<UnitType>, Measurement<UnitType>) -> Measurement<UnitType>
Add two measurements. ２つの寸法を加算します。
static func + (Measurement<UnitType>, Measurement<UnitType>) -> Measurement<UnitType>
Adds two measurements of the same dimension.
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
static func - (Measurement<UnitType>, Measurement<UnitType>) -> Measurement<UnitType>
Subtract one measurement from another. 一方の寸法を別のものから引きます。
static func - (Measurement<UnitType>, Measurement<UnitType>) -> Measurement<UnitType>
Subtracts two measurements of the same dimension.
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
static func / (Double, Measurement<UnitType>) -> Measurement<UnitType>
Divide a scalar value by a measurement. あるスカラー値をある寸法で割ります。
static func / (Measurement<UnitType>, Double) -> Measurement<UnitType>
Divide a measurement by a scalar value. ある寸法をスカラー値で割ります。

Formatting a Measurement ある寸法を書式設定する

func formatted() -> String
Generates a locale-aware string representation of a measurement using the default measurement format style. ある寸法のロケールを意識した文字列表現を省略時の寸法書式形式を使って生成します。
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
func formatted<S>(S) -> S.FormatOutput
Generates a locale-aware string representation of a measurement using the provided measurement format style. ある寸法のロケールを意識した文字列表現をこの提供された寸法書式形式を使って生成します。
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
struct Measurement.FormatStyle
A type that provides localized representations of measurements. ある型、それは寸法のローカライズされた表現を提供します。
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。
struct Measurement.AttributedStyle
A type that provides localized representations of measurements with an attributed string.
Available when UnitType conforms to Dimension. UnitTypeがDimensionに準拠する時に利用可能。

Comparing Measurements 寸法を比較する

static func == <LeftHandSideType, RightHandSideType>(Measurement<LeftHandSideType>, Measurement<RightHandSideType>) -> Bool
Returns a Boolean value that indicates whether two values are equal. あるブール値を返します、それは２つの値が等しいかどうかを指し示します。
static func != (Measurement<UnitType>, Measurement<UnitType>) -> Bool
Returns a Boolean value that indicates whether two values are unequal. あるブール値を返します、それは２つの値が等しくないかどうかを指し示します。
static func > (Measurement<UnitType>, Measurement<UnitType>) -> Bool
Returns a Boolean value indicating whether the value of the first argument is greater than that of the second argument. 最初の引数の値が２番目の引数のそれより大きいかどうかを指し示すブール値を返します。
static func >= (Measurement<UnitType>, Measurement<UnitType>) -> Bool
Returns a Boolean value indicating whether the value of the first argument is greater than or equal to that of the second argument. 最初の引数の値が２番目の引数のそれより大きいまたは等しいかどうかを指し示すブール値を返します。
static func < <LeftHandSideType, RightHandSideType>(Measurement<LeftHandSideType>, Measurement<RightHandSideType>) -> Bool
Compare two measurements of the same Unit. 同じUnitの２つの寸法を比較します。
static func <= (Measurement<UnitType>, Measurement<UnitType>) -> Bool
Returns a Boolean value indicating whether the value of the first argument is less than or equal to that of the second argument. 最初の引数の値が２番目の引数のそれより少ないまたは等しいかどうかを指し示すブール値を返します。

Creating Ranges of Measurements 寸法の範囲を作成する

static func ... (Measurement<UnitType>) -> PartialRangeFrom<Measurement<UnitType>>
Returns a partial range extending upward from a lower bound. 下側の境界から上方に拡張している部分的な範囲を返します。
static func ... (Measurement<UnitType>) -> PartialRangeThrough<Measurement<UnitType>>
Returns a partial range up to, and including, its upper bound. それの上側の境界までの、そしてそれを含む部分的な範囲を返します。
static func ... (Measurement<UnitType>, Measurement<UnitType>) -> ClosedRange<Measurement<UnitType>>
Returns a closed range that contains both of its bounds. それの境界の両方を含む完結範囲を返します。
static func ..< (Measurement<UnitType>, Measurement<UnitType>) -> Range<Measurement<UnitType>>
Returns a half-open range that contains its lower bound but not its upper bound. それの下側の境界は含むがそれの上側の境界はそうしない半開範囲を返します。
static func ..< (Measurement<UnitType>) -> PartialRangeUpTo<Measurement<UnitType>>
Returns a partial range up to, but not including, its upper bound. それの上側の境界までの、しかしそれを含んでいない、部分的な範囲を返します。

Describing a Measurement 寸法を記述する

var description: String
A textual description of the measurement. 寸法のテキスト記述。
var debugDescription: String
A textual description of the measurement suitable for debugging. デバッグに適する寸法のテキスト表現。
var customMirror: Mirror
A mirror that reflects the date interval. 日付間隔を反映するミラー。
var hashValue: Int
The computed hash value for the date interval. 日付間隔に対する計算ハッシュ値。

Encoding Measurements 寸法をエンコードする

func encode(to: Encoder)
Encodes this value into the given encoder. この値をその与えられたエンコーダへとエンコードします。

Hashing Measurements 寸法をハッシュ化する

func hash(into: inout Hasher)
Hashes the essential components of this value by feeding them into the given hasher. この値の本質的な構成要素それらを、それらをこの与えられたハーシャーに供給する事によってハッシュ化します。

Using Reference Types 参照型を使用する

class NSMeasurement
An object representing a numeric quantity with a unit of measure, for use when you need reference semantics or other Foundation-specific behavior. ある数量をある寸法の単位で表しているオブジェクト、あなたが参照意味論または他のFoundation特有の挙動を必要とする時に使用するために。
typealias Measurement.ReferenceType
An alias for this value type's equivalent reference type. この値型のもつ同等な参照型に対するエイリアス。

Relationships 関係

Conforms To 次に準拠

See Also 参照

Essentials 要点

class Unit
An abstract class representing a unit of measure. ある寸法単位を表している抽象クラス。
class Dimension
An abstract class representing a dimensional unit of measure. ある次元の寸法単位を表している抽象クラス。