Double Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
La Double classe encapsule une valeur du type double primitif dans un objet.
[Android.Runtime.Register("java/lang/Double", DoNotGenerateAcw=true)]
public sealed class Double : Java.Lang.Number, IConvertible, IDisposable, Java.Lang.IComparable
[<Android.Runtime.Register("java/lang/Double", DoNotGenerateAcw=true)>]
type Double = class
inherit Number
interface IConvertible
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- Héritage
- Attributs
- Implémente
Remarques
La Double classe encapsule une valeur du type double primitif dans un objet. Un objet de type Double contient un champ unique dont le type est double.
En outre, cette classe fournit plusieurs méthodes pour convertir un double en un String et un String en , doubleainsi que d’autres constantes et méthodes utiles lors de la gestion d’un double.
<-- Supprimé par Android : paragraphe sur ValueBased
Il s’agit d’une classe basée sur une valeur ; Les programmeurs doivent traiter les instances qui sont #equals(Object) égales comme interchangeables et ne doivent pas utiliser d’instances pour la synchronisation, ou un comportement imprévisible peut se produire. Par exemple, dans une version ultérieure, la synchronisation peut échouer. -->
<égalité>à virgule flottante h2>équivalence, équivalence et comparaison</h2>
Les valeurs à virgule flottante IEEE 754 incluent des valeurs non nulles finies, des zéros signés (+0.0 et -0.0), des infinis signés Double#POSITIVE_INFINITY infini positif et Double#NEGATIVE_INFINITY l’infini négatif) et Double#NaN NaN (not-a-number).
Une <relation> d’équivalence em< sur un ensemble de valeurs est une relation booléenne sur des paires de valeurs réflexives, symétriques et>transitives. Pour plus d’informations sur les relations d’équivalence et l’égalité des objets, consultez la Object#equals Object.equals spécification. Une relation d’équivalence partitionne les valeurs sur lesquelles il opère dans des ensembles appelés classes d’équivalence. Tous les membres de la classe d’équivalence sont égaux les uns aux autres sous la relation. Une classe d’équivalence ne peut contenir qu’un seul membre. Au moins à certaines fins, tous les membres d’une classe d’équivalence sont substituables les uns aux autres. En particulier, dans une expression numérique, les valeurs équivalentes peuvent être <remplacées par em>/em< pour les uns> des autres sans modifier le résultat de l’expression, ce qui signifie modifier la classe d’équivalence du résultat de l’expression.
Notamment, l’opération intégrée == sur les valeurs à virgule flottante n’est <>pas< une> relation d’équivalence. Malgré la définition d’une relation d’équivalence, la sémantique de l’opérateur IEEE 754 == a été délibérément conçue pour répondre à d’autres besoins de calcul numérique. Il existe deux exceptions où les propriétés d’une relation d’équivalence ne sont pas satisfaites par les == valeurs à virgule flottante :
<ul>
<li>If v1 et v2 sont tous les deux NaN, alors v1 == v2 a la valeur false. Par conséquent, pour deux arguments NaN, la propriété em<réflexive>/em< d’une relation d’équivalence n’est>< pas>/em< satisfaite par l’opérateur>.==
<li>If v1 représente pendant la +0.0 représentation v2-0.0, ou inversement, v1 == v2 a la valeur true même si +0.0 et -0.0 sont distinguées sous différentes opérations à virgule flottante. Par exemple, 1.0/+0.0 l’infini positif est évalué à 1.0/-0.0 l’infini em<négatif/em> et l’infini positif et l’infini négatif< ne sont ni égaux les uns >aux autres ni équivalents les uns aux autres. Ainsi, alors qu’une entrée zéro signée détermine le signe d’un résultat zéro, en raison de la division par zéro, +0.0 et -0.0 peut ne pas être substituée l’une à l’autre en général. Le signe d’une entrée nulle a également un effet non substituable sur le résultat de certaines méthodes de bibliothèque mathématique.
</ul>
Pour les comparaisons ordonnées à l’aide des opérateurs de comparaison intégrés (<, <=etc.), les valeurs NaN ont une autre situation anormale : un NaN n’est ni inférieur, ni supérieur à, ni égal à n’importe quelle valeur, y compris elle-même. Cela signifie que la trichotomie de comparaison ne <>tient pas</em>.
Pour fournir la sémantique appropriée pour equals et compareTo les méthodes, ces méthodes ne peuvent pas simplement être des wrappers autour == ou des opérations de comparaison ordonnées. Au lieu de cela, Double#equals equals définit les arguments NaN à être égaux les uns aux autres et définit +0.0 à <em>not</em> être égal à -0.0, en restaurant la réflexivité. Pour les comparaisons, Double#compareTo compareTo définit un ordre -0.0 total où est inférieur +0.0 à et où un NaN est égal à lui-même et considéré comme supérieur à l’infini positif.
La sémantique opérationnelle des equalscompareTo valeurs à virgule flottante en valeurs intégrales est exprimée en termes de #doubleToLongBits valeurs à virgule flottante.
L’ordre <>naturel em< implémenté par > est comparable#compareTo compareToavec les égaux. Autrement dit, deux objets sont signalés comme égaux si equals et seulement si compareTo sur ces objets retourne zéro.
Les comportements ajustés définis pour equals et compareTo permettent aux instances de classes wrapper de fonctionner correctement avec les structures de données conventionnelles. Par exemple, la définition de valeurs NaN pour qu’elles soient equals les unes des autres permet à NaN d’être utilisée comme élément d’un java.util.HashSet HashSet ou comme clé d’un java.util.HashMap HashMap. De même, la définition compareTo en tant qu’ordre total, y compris +0.0, -0.0et NaN, permet aux instances de classes wrapper d’être utilisées en tant qu’éléments d’un java.util.SortedSet SortedSet ou en tant que clés d’un java.util.SortedMap SortedMap.
Ajouté dans la version 1.0.
Java documentation pour java.lang.Double.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| Double(Double) |
Construit un objet nouvellement alloué |
| Double(String) |
Construit un objet nouvellement alloué |
Champs
| Nom | Description |
|---|---|
| Bytes |
Nombre d’octets utilisés pour représenter une |
| MaxExponent |
L’exposant maximal d’une variable finie |
| MaxValue |
Constante contenant la plus grande valeur finie positive de type |
| MinExponent |
L’exposant minimal d’une variable normalisée |
| MinNormal |
Constante contenant la plus petite valeur normale positive de type , 2 |
| MinValue |
Constante contenant la plus petite valeur positive non nulle de type , 2 |
| NaN |
Constante contenant une valeur Not-a-Number (NaN) de type |
| NegativeInfinity |
Constante tenant l’infini négatif du type |
| PositiveInfinity |
Constante tenant l’infini positif du type |
| Precision |
Nombre de bits dans l’élément significand d’une |
| Size |
Nombre de bits utilisés pour représenter une |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IsInfinite |
Retourne |
| IsNaN |
Retourne |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
La |
| JniPeerMembers |
Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Number) |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de Number) |
| Type |
Instance |
Méthodes
| Nom | Description |
|---|---|
| ByteValue() |
Retourne la valeur du nombre spécifié en tant que |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Compare(Double, Double) |
Compare les deux valeurs spécifiées |
| CompareTo(Double) |
Compare numériquement deux |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
La |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
La |
| DoubleToLongBits(Double) |
Retourne une représentation de la valeur à virgule flottante spécifiée en fonction de la disposition de bits « double format » ieee 754. |
| DoubleToRawLongBits(Double) |
Retourne une représentation de la valeur à virgule flottante spécifiée en fonction de la disposition de bits « double format » ieee 754, en conservant les valeurs NaN (Not-a-Number). |
| DoubleValue() |
Retourne la |
| Equals(Object) |
La |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| FloatValue() |
Retourne la valeur de ceci |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| HashCode(Double) |
Retourne un code de hachage pour une |
| IntValue() |
Retourne la valeur de ceci |
| InvokeIsInfinite(Double) |
Retourne |
| InvokeIsNaN(Double) |
Retourne |
| IsFinite(Double) |
Retourne |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| LongBitsToDouble(Int64) |
Retourne la |
| LongValue() |
Retourne la valeur de ceci |
| Max(Double, Double) |
Retourne la valeur supérieure de deux |
| Min(Double, Double) |
Retourne la plus petite de deux |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| ParseDouble(String) |
Retourne une nouvelle |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
La |
| ShortValue() |
Retourne la valeur du nombre spécifié en tant que |
| Sum(Double, Double) |
Ajoute deux |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToHexString(Double) |
Retourne une représentation sous forme de chaîne hexadécimale de l’argument |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| ToString(Double) |
Retourne une représentation sous forme de chaîne de l’argument |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| ValueOf(Double) |
Retourne une |
| ValueOf(String) |
Retourne un |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Opérateurs
| Nom | Description |
|---|---|
| Explicit(Double to Double) |
Convertit la valeur spécifiée |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IComparable.CompareTo(Object) |
Compare cette valeur à l’objet spécifié pour l’ordre. |
| IConvertible.GetTypeCode() |
Retourne le code de type de cette valeur. |
| IConvertible.ToBoolean(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToByte(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToChar(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToDateTime(IFormatProvider) |
La conversion en |
| IConvertible.ToDecimal(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToDouble(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToInt16(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToInt32(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToInt64(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToSByte(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToSingle(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToString(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToType(Type, IFormatProvider) |
Convertit cette valeur en type spécifié par |
| IConvertible.ToUInt16(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToUInt32(IFormatProvider) |
Convertit cette valeur en |
| IConvertible.ToUInt64(IFormatProvider) |
Convertit cette valeur en |
| IJavaPeerable.Disposed() |
La |
| IJavaPeerable.Finalized() |
La |
| IJavaPeerable.JniObjectReferenceControlBlock |
La |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
La |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
La |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
La |
| IJavaPeerable.UnregisterFromRuntime() |
La |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
La |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |