Structure

Float

A single-precision, floating-point value type. 単精度、浮動小数点値型。

Declaration 宣言 

@frozen struct Float

Topics 話題

Converting Integers 整数の変換

init<Source>(Source)
Creates a new value, rounded to the closest possible representation. 新しい値を作成します、最も近い可能な表現へ丸められます。
init(Int)
Creates a new value, rounded to the closest possible representation. 新しい値を作成します、最も近い可能な表現へ丸められます。

Converting Strings 文字列の変換

init?<S>(S)
Creates a new instance from the given string. 与えられた値から新しいインスタンスを作成します。

Converting Floating-Point Values 浮動小数点値の変換

init<Source>(Source)
Creates a new instance from the given value, rounded to the closest possible representation. 与えられた値から新しいインスタンスを作成します、最も近い可能な表現に丸められます。
init<Source>(Source)
Creates a new value, rounded to the closest possible representation. 新しい値を作成します、最も近い可能な表現へ丸められます。
init(Double)
Creates a new instance that approximates the given value. 与えられた値におおよそ相当する新しいインスタンスを作成します。
init(Float)
Creates a new instance initialized to the given value. 与えられた値に初期化される新しいインスタンスを作成します。
init(Float80)
Creates a new instance that approximates the given value. 与えられた値におおよそ相当する新しいインスタンスを作成します。
init(CGFloat)
Creates a new instance that approximates the given value. 与えられた値におおよそ相当する新しいインスタンスを作成します。
init(signOf: Float, magnitudeOf: Float)
Creates a new floating-point value using the sign of one value and the magnitude of another. ある値の符号ともう一方の規模とを使って新しい浮動小数点値を作成します。
init(sign: FloatingPointSign, exponent: Int, significand: Float)
Creates a new value from the given sign, exponent, and significand. 与えられた符号、指数、そして仮数から新しい値を作成します。
init(truncating: NSNumber)

Converting with No Loss of Precision 精度の損失なしに変換する

These initializers result in nil if the value passed can't be represented without any loss of precision. これらのイニシャライザは、渡された値が何ら精度の損失なしに表現できないならばnilという結果になります。
init?<Source>(exactly: Source)
Creates a new instance from the given value, if it can be represented exactly. 新しいインスタンスをこの与えられた値から作成します、もしそれが正確に表現できるならば。
init?(exactly: Double)
Creates a new instance initialized to the given value, if it can be represented without rounding. それが丸めなしに表されるならば、与えられた値に初期化される新しいインスタンスを作成します。
init?(exactly: Float)
Creates a new instance initialized to the given value, if it can be represented without rounding. それが丸めなしに表されるならば、与えられた値に初期化される新しいインスタンスを作成します。
init?(exactly: Float80)
Creates a new instance initialized to the given value, if it can be represented without rounding. それが丸めなしに表されるならば、与えられた値に初期化される新しいインスタンスを作成します。
init?(exactly: NSNumber)
init?<Source>(exactly: Source)
Creates a new value, if the given integer can be represented exactly. 与えられた整数が正確に表現できるならば、新しい値を作成します。

Creating a Random Value 無作為な値を作成する

static func random(in: Range<Float>) -> Float
Returns a random value within the specified range. 指定された範囲内のある無作為の値を返します。
static func random<T>(in: Range<Float>, using: inout T) -> Float
Returns a random value within the specified range, using the given generator as a source for randomness. 指定された範囲内のある無作為な値を返します、与えられた生成子を無作為さの出典として使って使います。
static func random(in: ClosedRange<Float>) -> Float
Returns a random value within the specified range. 指定された範囲内のある無作為の値を返します。
static func random<T>(in: ClosedRange<Float>, using: inout T) -> Float
Returns a random value within the specified range, using the given generator as a source for randomness. 指定された範囲内のある無作為な値を返します、与えられた生成子を無作為さの出典として使って使います。

Performing Calculations 計算の実行

Floating-Point Operators for Float Float用の浮動小数点演算
Perform arithmetic and bitwise operations or compare values. 算術およびビット単位の演算を実行します、または値を比較します。
func addingProduct(Float, Float) -> Float
Returns the result of adding the product of the two given values to this value, computed without intermediate rounding. ２つの与えられた値の積をこの値に加える結果を返します、中間の丸めなしで計算されます。
func addProduct(Float, Float)
Adds the product of the two given values to this value in place, computed without intermediate rounding. ２つの与えられた値の積をこの値にその場で加えます、中間の丸めなしで計算されます。
func squareRoot() -> Float
Returns the square root of the value, rounded to a representable value. この値の平方根を返します、表現可能な値に丸められます。
func formSquareRoot()
Replaces this value with its square root, rounded to a representable value. この値をそれの平方根で置き換えます、表現可能な値に丸められます。
func remainder(dividingBy: Float) -> Float
Returns the remainder of this value divided by the given value. 与えられた値で除算されたこの値の余りを返します。
func formRemainder(dividingBy: Float)
Replaces this value with the remainder of itself divided by the given value. それ自身を与えられた値で除算した余りでこの値を置き換えます。
func truncatingRemainder(dividingBy: Float) -> Float
Returns the remainder of this value divided by the given value using truncating division. 切り捨て除算を使って与えられた値で除算されたこの値の余りを返します。
func formTruncatingRemainder(dividingBy: Float)
Replaces this value with the remainder of itself divided by the given value using truncating division. 切り捨て除算を使ってそれ自身を与えられた値で除算した余りでこの値を置き換えます。
func negate()
Replaces this value with its additive inverse. この値をそれの加法の逆元で置き換えます。

Rounding Values 値を丸める

func rounded() -> Float
Returns this value rounded to an integral value using “schoolbook rounding.” 「教科書丸め」を使って整数値に丸めたこの値を返します。
func rounded(FloatingPointRoundingRule) -> Float
Returns this value rounded to an integral value using the specified rounding rule. 指定された丸め規則を使って整数値に丸められたこの値を返します。
func round()
Rounds this value to an integral value using “schoolbook rounding.” 「教科書丸め」を使ってこの値を整数値に丸めます。
func round(FloatingPointRoundingRule)
Rounds the value to an integral value using the specified rounding rule. 指定された丸め規則を使ってこの値を整数値に丸めます。

Comparing Values 値の比較

Floating-Point Operators for Float Float用の浮動小数点演算
Perform arithmetic and bitwise operations or compare values. 算術およびビット単位の演算を実行します、または値を比較します。
func isEqual(to: Float) -> Bool
Returns a Boolean value indicating whether this instance is equal to the given value. このインスタンスが与えられた値と等しいかどうかを指し示すブール値を返します。
func isLess(than: Float) -> Bool
Returns a Boolean value indicating whether this instance is less than the given value. このインスタンスが与えられた値より小さいかどうかを指し示すブール値を返します。
func isLessThanOrEqualTo(Float) -> Bool
Returns a Boolean value indicating whether this instance is less than or equal to the given value. このインスタンスが与えられた値より小さいまたは等しいかどうかを指し示すブール値を返します。
func isTotallyOrdered(belowOrEqualTo: Float) -> Bool
Returns a Boolean value indicating whether this instance should precede or tie positions with the given value in an ascending sort. このインスタンスがある昇順ソートにおいて、与えられた値より前にくるまたは同じ位置かどうかを指し示すブール値を返します。
static func maximum(Float, Float) -> Float
Returns the greater of the two given values. ２つの与えられた値の大きい方を返します。
static func maximumMagnitude(Float, Float) -> Float
Returns the value with greater magnitude. より大きい規模を持つ値を返します。
static func minimum(Float, Float) -> Float
Returns the lesser of the two given values. ２つの与えられた値のより小さい方を返します。
static func minimumMagnitude(Float, Float) -> Float
Returns the value with lesser magnitude. より小さい規模を持つ値を返します。

Finding the Sign and Magnitude 符号と規模を見つける

var magnitude: Float
The magnitude of this value. この値の規模。
var sign: FloatingPointSign
The sign of the floating-point value. 浮動小数点値の符号。
typealias Float.Magnitude
A type that can represent the absolute value of any possible value of the conforming type. 準拠する型の何らかの可能な値の絶対値を表すことのできる型。

Querying a Float Floatに問い合わせる

var ulp: Float
The unit in the last place of this value. この値の最終桁単位。
var significand: Float
The significand of the floating-point value. 浮動小数点値の仮数。
var exponent: Int
The exponent of the floating-point value. 浮動小数点値の指数。
var nextUp: Float
The least representable value that compares greater than this value. 表現可能な最も小さい値で、この値と比較してより大きいもの。
var nextDown: Float
The greatest representable value that compares less than this value. 表現可能な最も大きい値で、この値と比較してより小さいもの。
var binade: Float
The floating-point value with the same sign and exponent as this value, but with a significand of 1.0. この値と同じ符号と指数を持つ浮動小数点値、しかし1.0の仮数を持ちます。

Accessing Numeric Constants 数に関する定数にアクセスする

static var pi: Float
The mathematical constant pi. 数学の定数pi。
static var infinity: Float
Positive infinity. 正の無限大
static var greatestFiniteMagnitude: Float
The greatest finite number representable by this type. この型によって表現可能な最も大きな有限数。
static var nan: Float
A quiet NaN (“not a number”). クワイエットNaN（非数）。
static var signalingNaN: Float
A signaling NaN (“not a number”). シグナルNaN（非数）。
static var ulpOfOne: Float
The unit in the last place of 1.0. 1.0の最終桁単位。
static var leastNormalMagnitude: Float
The least positive normal number. 最も小さい正のノーマル数。
static var leastNonzeroMagnitude: Float
The least positive number. 最も小さい正の数。
static var zero: Float
The zero value. ゼロ値。

Working with Binary Representation バイナリ表現を扱う

var bitPattern: UInt32
The bit pattern of the value’s encoding. 値の持つエンコーディングのビットパターン。
var significandBitPattern: UInt32
The raw encoding of the value’s significand field. 値の仮数フィールドの生のエンコーディング。
var significandWidth: Int
The number of bits required to represent the value’s significand. 値の仮数を表すのに必要とされるビットの数。
var exponentBitPattern: UInt
The raw encoding of the value’s exponent field. 値のもつ指数部の生のエンコーディング。
static var significandBitCount: Int
The available number of fractional significand bits. 利用可能な小数の仮数ビットの数。
static var exponentBitCount: Int
The number of bits used to represent the type’s exponent. 型のもつ指数を表すのに使われるビットの数。
static var radix: Int
The radix, or base of exponentiation, for a floating-point type. ある浮動小数点型の基数、または冪演算の底。
init(bitPattern: UInt32)
Creates a new value with the given bit pattern. 与えられたビットパターンから新しい値を作成します。
init(sign: FloatingPointSign, exponentBitPattern: UInt, significandBitPattern: UInt32)
Creates a new instance from the specified sign and bit patterns. 指定された符号とビットパターンから新しいインスタンスを作成します。
init(nan: Float.RawSignificand, signaling: Bool)
Creates a NaN (“not a number”) value with the specified payload. 指定されたペイロードをもつNaN（「非数」）値を作成します。
typealias Float.Exponent
A type that can represent any written exponent. 何らかの書かれた指数を表すことができる型。
typealias Float.RawSignificand
A type that represents the encoded significand of a value. ある値のエンコードされた仮数を表す型。

Querying a Float's State Floatの状態を問い合わせる

var isZero: Bool
A Boolean value indicating whether the instance is equal to zero. このインスタンスがゼロと等しいかどうかを指し示すブール値。
var isFinite: Bool
A Boolean value indicating whether this instance is finite. このインスタンスが有限であるかどうかを指し示すブール値。
var isInfinite: Bool
A Boolean value indicating whether the instance is infinite. このインスタンスが無限大であるかどうかを指し示すブール値。
var isNaN: Bool
A Boolean value indicating whether the instance is NaN (“not a number”). このインスタンスがNaN（非数）であるかどうかを指し示すブール値。
var isSignalingNaN: Bool
A Boolean value indicating whether the instance is a signaling NaN. このインスタンスがsignaling NaNであるかどうかを指し示すブール値。
var isNormal: Bool
A Boolean value indicating whether this instance is normal. このインスタンスがノーマルであるかどうかを指し示すブール値。
var isSubnormal: Bool
A Boolean value indicating whether the instance is subnormal. このインスタンスがサブノーマルであるかどうかを指し示すブール値。
var isCanonical: Bool
A Boolean value indicating whether the instance’s representation is in its canonical form. このインスタンスの表現がそれの正準形式であるかどうかを指し示すブール値。
var floatingPointClass: FloatingPointClassification
The classification of this value. この値の分類。

Encoding and Decoding Values 値をエンコードおよびデコードする

func encode(to: Encoder)
Encodes this value into the given encoder. この値を与えられたエンコーダにエンコードします。
init(from: Decoder)
Creates a new instance by decoding from the given decoder. 与えられたデコーダからデコードすることで新しいインスタンスを作成します。

Creating a Range 範囲を作成する

static func ..< (Float, Float) -> Range<Float>
Returns a half-open range that contains its lower bound but not its upper bound. それの下側の境界は含むがそれの上側の境界はそうしない半開範囲を返します。
static func ... (Float, Float) -> ClosedRange<Float>
Returns a closed range that contains both of its bounds. それの境界の両方を含む完結範囲を返します。

Describing a Float Floatを記述する

func hash(into: inout Hasher)
Hashes the essential components of this value by feeding them into the given hasher. この値の本質的な構成要素を、それらをその与えられたhasherへと与えることによって、ハッシュ化します。
var description: String
A textual representation of the value. その値のテキスト表現。
var debugDescription: String
A textual representation of the value, suitable for debugging. その値のテキスト表現、デバッグに適するもの。
var customMirror: Mirror
A mirror that reflects the Float instance. Floatインスタンスを反映するミラー。
var hashValue: Int
The hash value. ハッシュ値。

SIMD-Supporting Types SIMD支援型

typealias Float.SIMDMaskScalar
struct Float.SIMD2Storage
Storage for a vector of two floating-point values. ２浮動小数点値のベクターに対するストレージ。
struct Float.SIMD4Storage
Storage for a vector of four floating-point values. ４浮動小数点値のベクターに対するストレージ。
struct Float.SIMD8Storage
Storage for a vector of eight floating-point values. ８浮動小数点値のベクターに対するストレージ。
struct Float.SIMD16Storage
Storage for a vector of 16 floating-point values. 16浮動小数点値のベクターに対するストレージ。
struct Float.SIMD32Storage
Storage for a vector of 32 floating-point values. 32浮動小数点値のベクターに対するストレージ。
struct Float.SIMD64Storage
Storage for a vector of 64 floating-point values. 64浮動小数点値のベクターに対するストレージ。

Infrequently Used Functionality 滅多に使われない機能性

init()
Creates a value initialized to zero. ゼロに初期化される値を作成します。
init(integerLiteral: Int64)
Creates an instance initialized to the specified integer value. 指定された整数値に初期化されるインスタンスを作成します。
init(floatLiteral: Float)
Creates an instance initialized to the specified floating-point value. 指定された浮動小数点値に初期化されるインスタンスを作成します。
init(integerLiteral: Float)
Creates an instance initialized to the specified integer value. 指定された整数値に初期化されるインスタンスを作成します。
func advanced(by: Float) -> Float
Returns a value that is offset the specified distance from this value. 指定の隔たりをこの値からオフセットされたある値を返します。
func distance(to: Float) -> Float
Returns the distance from this value to the given value, expressed as a stride. この値から特定の値までの隔たりを返します、ストライドとして表されます。
func write<Target>(to: inout Target)
Writes a textual representation of this instance into the given output stream. このインスタンスのテキスト表現を与えられた出力ストリームへ書き出します。

Deprecated 非推奨

init(NSNumber)Deprecated 非推奨
var customPlaygroundQuickLook: _PlaygroundQuickLook
A custom playground Quick Look for the Float instance. Floatインスタンスのためのあつらえのプレイグラウンド「クイックルック」。
Deprecated 非推奨

Type Aliases 型エイリアス

typealias Float.BiquadFunctions
typealias Float.DFTFunctions
typealias Float.DiscreteFourierTransformFunctions
typealias Float.FloatLiteralType
A type that represents a floating-point literal. 浮動小数点リテラルを表すある型。
typealias Float.IntegerLiteralType
A type that represents an integer literal. ある整数リテラルを表す型。
typealias Float.RawExponent
A type that represents the encoded exponent of a value. ある値のエンコードされた指数を表す型。
typealias Float.Stride
A type that represents the distance between two values. ２つの値の間の隔たりを表す型。

Initializers イニシャライザ

init(Float16)
Creates a new instance that approximates the given value. 与えられた値におおよそ相当する新しいインスタンスを作成します。
init?(Substring)
init?(exactly: Float16)
Creates a new instance initialized to the given value, if it can be represented without rounding. それが丸めなしに表されるならば、与えられた値に初期化される新しいインスタンスを作成します。
init?<Source>(exactly: Source)
Creates a new value, if the given integer can be represented exactly. 与えられた整数が正確に表現できるならば、新しい値を作成します。

Instance Properties 様々なインスタンスプロパティ

var magnitudeSquared: Double

Type Properties 型プロパティ

static var bnnsDataType: BNNSDataType
static var mlMultiArrayDataType: MLMultiArrayDataType
static var multiArrayDataType: MLMultiArrayDataType

Instance Methods インスタンスメソッド

func scale(by: Double)

Relationships 関係

Conforms To 次に準拠

See Also 参照

Numeric Values 数値

struct Int
A signed integer value type. 符号付き整数値型。
struct Double
A double-precision, floating-point value type. 倍精度、浮動小数点値型。