Single 構造体

.NET Framework クラス ライブラリ リファレンス

Single 構造体

単精度浮動小数点数を表します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Structure Single
    Implements IComparable, IFormattable, IConvertible, IComparable(Of
 Single), _
    IEquatable(Of Single)

Visual Basic (使用法)

Dim instance As Single

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public struct Single : IComparable, IFormattable, IConvertible,
 
    IComparable<float>, IEquatable<float>

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public value class Single : IComparable, IFormattable,
 IConvertible, 
    IComparable<float>, IEquatable<float>

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class Single extends ValueType
 implements IComparable, IFormattable, 
    IConvertible, IComparable<float>, IEquatable<float>

JScript

JScript では、構造体を使用できますが、新規に宣言することはできません。

解説

Single 値型は、-3.402823e38 から +3.402823e38 までの単精度 32 ビット数と、正の 0 または負の 0、PositiveInfinity、NegativeInfinity、および非数 (NaN) を表します。

Single は、2 進の浮動小数点演算に関する IEC 60559:1989 (IEEE 754) 規格に準拠しています。

Single は、この型の複数のインスタンスを比較したり、インスタンスの値を文字列形式に変換したり、数値の文字列形式をこの型のインスタンスに変換するためのメソッドを提供します。書式指定コードで値型の文字列形式を制御する方法については、「書式設定の概要」、「標準の数値書式指定文字列」、および「カスタム数値書式指定文字列」を参照してください。

浮動小数点数の使用

二項演算の実行時に、一方のオペランドが Single または Double の浮動小数点型である場合、もう一方のオペランドは整数型または浮動小数点型であることが必要です。この演算は、次のように評価されます。

• 一方のオペランドが整数型の場合、そのオペランドはもう一方のオペランドに合わせて浮動小数点型に変換されます。

• 次に、一方のオペランドが Double である場合には、もう一方のオペランドが Double に変換され、演算は少なくとも Double の範囲および精度を使用して実行されます。数値演算の場合、結果の型は Double になります。

• それ以外の場合、演算は少なくとも Single 型の範囲および精度を使用して実行され、数値演算の結果の型は Single になります。

代入演算子を含む浮動小数点演算子は、例外をスローしません。その代わり、例外状況での浮動小数点演算の結果は、次に説明するように 0、無限大、または NaN になります。

• 浮動小数点演算の結果が変換先の形式に対して小さすぎる場合、演算結果は 0 になります。

• 浮動小数点演算の結果の絶対値が変換先形式に対して大きすぎる場合、演算結果は符号に応じて PositiveInfinity または NegativeInfinity になります。

• 浮動小数点演算が無効な場合、演算結果は NaN になります。

• 浮動小数点演算の一方または両方のオペランドが NaN の場合、演算結果は NaN になります。

浮動小数点数は 10 進数の概数を表すことができるだけであること、および、浮動小数点数の有効桁数によって数値が表す 10 進数の概数の精度が決定されることに注意してください。既定では、Single に含まれる有効桁数は 7 桁だけですが、内部的には最大 9 桁が保持されています。浮動小数点数の桁数から、複数の結果が生成されます。

• 特定の桁数において等しい 2 つの浮動小数点数が、最下位バイトが異なっているために、等価でないと評価される場合があります。

• 浮動小数点数を使用する数値演算または比較演算において、10 進数が使用された場合は、浮動小数点数が表す概数の 10 進数が完全には一致しないために同じ結果が生成されないことがあります。

• 浮動小数点数が使用されると、値がラウンドトリップされない場合があります。値がラウンドトリップされるというのは、演算で元の浮動小数点数が別の形式に変換され、逆の演算で変換された形式から浮動小数点数に戻されて、最終の浮動小数点数が元の浮動小数点数と等価である場合です。最下位の桁数が 1 つ以上失われるか、または変更された場合は、ラウンドトリップが失敗します。

インターフェイスの実装

この型は、IComparable、IComparable、IFormattable、および IConvertible の各インターフェイスを実装します。この型の明示的な IConvertible インターフェイス メンバの実装の代わりに、Convert クラスを使用します。

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Single メンバ
System 名前空間