BigDecimal.Format Méthode

[Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)]
public virtual string? Format(int before, int after);

[<Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)>]
abstract member Format : int * int -> string
override this.Format : int * int -> string

Paramètres

Retours

Représentant String cela BigDecimal, disposé en fonction des paramètres spécifiés

Attributs

RegisterAttribute

Remarques

Retourne la String représentation de ce BigDecimalparamètre, modifiée par les paramètres de disposition.

Cette méthode est fournie en tant que primitive à utiliser par des classes plus sophistiquées, telles que DecimalFormat , qui peuvent appliquer une modification sensible aux paramètres régionaux du résultat. Le niveau de mise en forme qu’il fournit est une partie nécessaire de la classe BigDecimal, car elle est sensible et doit suivre les règles de calcul et d’arrondi pour l’arithmétique BigDecimal. Toutefois, si la fonction est fournie ailleurs, elle peut être supprimée de cette classe.

Les paramètres, pour les deux formes de la format méthode sont tous de type int. Une valeur de -1 pour n’importe quel paramètre indique que l’action ou la valeur par défaut de ce paramètre doit être utilisée.

Les paramètres et beforeafter, spécifient respectivement le nombre de caractères à utiliser pour la partie entière et la partie décimale du résultat. La notation exponentielle n’est pas utilisée. Si l’un ou l’autre paramètre est -1 (qui indique l’action par défaut), le nombre de caractères utilisés sera exactement autant que nécessaire pour cette partie.

before doit être un nombre positif ; s’il est plus grand que nécessaire pour contenir la partie entière, cette partie est rembourrée sur la gauche avec des espaces à la longueur demandée. S’il before n’est pas suffisamment grand pour contenir la partie entière du nombre (y compris le signe, pour les nombres négatifs), une exception est levée.

after doit être un nombre non négatif ; s’il n’est pas de la même taille que la partie décimale du nombre, le nombre est arrondi (ou étendu avec des zéros) à ajuster. Si vous spécifiez 0, after le nombre sera arrondi à un entier (autrement dit, il n’aura pas de partie décimale ou de décimale). La méthode d’arrondi est la méthode par défaut. MathContext.ROUND_HALF_UP

D’autres méthodes d’arrondi, et l’utilisation de notation exponentielle, peuvent être sélectionnées à l’aide #format(int,int,int,int,int,int)de . L’utilisation de la forme à deux paramètres de la méthode a exactement le même effet que l’utilisation du formulaire de six paramètres avec les quatre derniers paramètres étant tous -1.

Java documentation pour android.icu.math.BigDecimal.format(int, int).

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.

[Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)]
public virtual string? Format(int before, int after, int explaces, int exdigits, int exformint, Android.Icu.Math.RoundOptions exround);

[<Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)>]
abstract member Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string
override this.Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string

Paramètres

Retours

Représentant String cela BigDecimal, disposé en fonction des paramètres spécifiés

Attributs

RegisterAttribute

Remarques

Retourne la String représentation de ce BigDecimal, modifiée par les paramètres de disposition et autorisant la notation exponentielle.

Cette méthode est fournie en tant que primitive à utiliser par des classes plus sophistiquées, telles que DecimalFormat , qui peuvent appliquer une modification sensible aux paramètres régionaux du résultat. Le niveau de mise en forme qu’il fournit est une partie nécessaire de la classe BigDecimal, car elle est sensible et doit suivre les règles de calcul et d’arrondi pour l’arithmétique BigDecimal. Toutefois, si la fonction est fournie ailleurs, elle peut être supprimée de cette classe.

Les paramètres sont tous de type int. Une valeur de -1 pour n’importe quel paramètre indique que l’action ou la valeur par défaut de ce paramètre doit être utilisée.

Les deux premiers paramètres (before et after) spécifient respectivement le nombre de caractères à utiliser pour la partie entière et la partie décimale du résultat, comme défini pour #format(int,int). Si l’un de ces éléments est -1 (qui indique l’action par défaut), le nombre de caractères utilisés sera exactement autant que nécessaire pour cette partie.

Les paramètres restants contrôlent l’utilisation de la notation exponentielle et de l’arrondi. Trois (explaces, exdigitset exform) contrôlent la partie exposante du résultat. Comme précédemment, l’action par défaut pour l’un de ces paramètres peut être sélectionnée à l’aide de la valeur -1.

explaces doit être un nombre positif ; il définit le nombre d’emplacements (chiffres après le signe de l’exposant) à utiliser pour n’importe quelle partie exposante, la valeur par défaut (quand explaces est -1) à utiliser autant que nécessaire. Si explaces ce n’est pas -1, l’espace est toujours réservé à un exposant ; s’il n’est pas nécessaire (par exemple, si l’exposant sera égal à 0), explaces+2 espaces sont ajoutés au résultat. (Cela préserve l’alignement vertical des nombres mis en forme de la même façon dans une police monospace.) Si explaces ce n’est pas -1 et n’est pas suffisamment grand pour contenir l’exposant, une exception est levée.

exdigits définit le point de déclencheur pour l’utilisation de notation exponentielle. Si, avant toute arrondi, le nombre de places nécessaires avant la virgule décimale dépasse exdigits, ou si la valeur absolue du résultat est inférieure 0.000001à , la forme exponentielle sera utilisée, à condition que celle-ci exdigits ait été spécifiée. Quand exdigits est -1, la notation exponentielle ne sera jamais utilisée. Si 0 est spécifié pour exdigits, la notation exponentielle est toujours utilisée, sauf si l’exposant serait 0.

exform définit le formulaire pour la notation exponentielle (si nécessaire). Il peut être soit soit MathContext#SCIENTIFIC ou MathContext#ENGINEERING. Si ce dernier, ingénierie, formulaire est demandé, jusqu’à trois chiffres (signe plus, si négatif) peuvent être nécessaires pour la partie entière du résultat (before ). Sinon, un seul chiffre (signe plus, si négatif) est nécessaire.

Enfin, le sixième argument, exroundsélectionne l’algorithme d’arrondi à utiliser et doit être l’une des valeurs indiquées par une constante publique dans la MathContext classe dont le nom commence par ROUND_ . La valeur par défaut (ROUND_HALF_UP) peut également être sélectionnée à l’aide de la valeur -1, comme précédemment.

La valeur MathContext.ROUND_UNNECESSARY spéciale peut être utilisée pour détecter si les chiffres autres que zéro sont ignorés. Si exround cette valeur est égale à si les chiffres non nuls sont ignorés (arrondis) lors de la mise en forme, une ArithmeticException valeur est levée.

Java documentation pour android.icu.math.BigDecimal.format(int, int, int, int, int, int).

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.