BigDecimal.Format Methode

Definition

Namespace:: Android.Icu.Math

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Name	Beschreibung
Format(Int32, Int32)	Gibt die `String` Darstellung dieser `BigDecimal`, geändert durch Layoutparameter zurück.
Format(Int32, Int32, Int32, Int32, Int32, RoundOptions)	Gibt die `String` Darstellung dieses `BigDecimal`, geändert durch Layoutparameter und zulassen der exponentiellen Schreibweise zurück.

Format(Int32, Int32)

Gibt die String Darstellung dieser BigDecimal, geändert durch Layoutparameter zurück.

[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

Parameter

before: Int32

Die int Angabe der Anzahl der Stellen vor dem Dezimalkomma. Verwenden Sie -1 für "so viele wie erforderlich".

after: Int32

Die int Angabe der Anzahl der Stellen nach dem Dezimalkomma. Verwenden Sie -1 für "so viele wie erforderlich".

Gibt zurück

String

Ein String Darstellungs-Wert BigDecimal, der gemäß den angegebenen Parametern angeordnet ist

Attribute: RegisterAttribute

Hinweise

Gibt die String Darstellung dieser BigDecimal, geändert durch Layoutparameter zurück.

Diese Methode wird als Grundtyp bereitgestellt, der von komplexeren Klassen verwendet werden kann, z DecimalFormat . B. die Gebietsschemasensitive Bearbeitung des Ergebnisses. Die Formatierungsebene, die sie bereitstellt, ist ein erforderlicher Teil der BigDecimal-Klasse, da sie sensibel ist und die Berechnungs- und Rundungsregeln für BigDecimal-Arithmetik befolgen muss. Wenn die Funktion jedoch an anderer Stelle bereitgestellt wird, kann sie aus dieser Klasse entfernt werden.

Die Parameter für beide Formen der format Methode sind alle Typ int. Ein Wert von -1 für jeden Parameter gibt an, dass die Standardaktion oder der Wert für diesen Parameter verwendet werden soll.

Die Parameter before und after, geben die Anzahl der Zeichen an, die für den ganzzahligen Teil bzw. dezimalen Teil des Ergebnisses verwendet werden sollen. Exponentielle Notation wird nicht verwendet. Wenn ein Parameter -1 ist (was die Standardaktion angibt), ist die Anzahl der verwendeten Zeichen genau so viele wie für diesen Teil erforderlich.

before muss eine positive Zahl sein; wenn sie größer als erforderlich ist, um den ganzzahligen Teil zu enthalten, wird dieser Teil auf der linken Seite mit Leerzeichen bis zur angeforderten Länge aufgefüllt. Wenn before nicht groß genug ist, um den ganzzahligen Teil der Zahl (einschließlich des Vorzeichens für negative Zahlen) zu enthalten, wird eine Ausnahme ausgelöst.

after muss eine nicht negative Zahl sein; Wenn sie nicht die gleiche Größe wie der Dezimalteil der Zahl aufweist, wird die Zahl gerundet (oder mit Nullen erweitert), um sie einzufügen. Wenn Sie "0 after " angeben, wird die Zahl auf eine ganze Zahl gerundet (d. r. sie hat keinen Dezimalteil oder Dezimalkomma). Die Rundungsmethode ist die Standardmethode. MathContext.ROUND_HALF_UP

Andere Rundungsmethoden und die Verwendung der exponentiellen Notation können mithilfe #format(int,int,int,int,int,int)von . Die Verwendung der Zwei-Parameter-Form der Methode hat genau die gleiche Wirkung wie die Verwendung des Formulars mit sechs Parametern mit den letzten vier Parametern, die alle -1 sind.

Java Dokumentation für android.icu.math.BigDecimal.format(int, int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Format(Int32, Int32, Int32, Int32, Int32, RoundOptions)

Gibt die String Darstellung dieses BigDecimal, geändert durch Layoutparameter und zulassen der exponentiellen Schreibweise zurück.

[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

Parameter

before: Int32

Die int Angabe der Anzahl der Stellen vor dem Dezimalkomma. Verwenden Sie -1 für "so viele wie erforderlich".

after: Int32

Die int Angabe der Anzahl der Stellen nach dem Dezimalkomma. Verwenden Sie -1 für "so viele wie erforderlich".

explaces: Int32

Die int Angabe der Anzahl der Orte, die für einen beliebigen Exponenten verwendet werden sollen. Verwenden Sie -1 für "so viele wie erforderlich".

exdigits: Int32

Die int Angabe des Triggers (Ziffern vor dem Dezimalkomma), der bei Überschreitung die Verwendung der exponentiellen Notation bewirkt. Verwenden Sie 0, um die exponentielle Notation zu erzwingen. Verwenden Sie -1, um eine einfache Schreibweise (keine exponentielle Schreibweise) zu erzwingen.

exformint: Int32

Die int Angabe der Form der exponentiellen Notation, die verwendet werden soll ( MathContext#SCIENTIFIC oder MathContext#ENGINEERING).

exround: RoundOptions

Die int Angabe des zu verwendenden Rundungsmodus. Verwenden Sie -1 für die Standardeinstellung . MathContext#ROUND_HALF_UP

Gibt zurück

String

Ein String Darstellungs-Wert BigDecimal, der gemäß den angegebenen Parametern angeordnet ist

Attribute: RegisterAttribute

Hinweise

Gibt die String Darstellung dieses BigDecimal, geändert durch Layoutparameter und zulassen der exponentiellen Schreibweise zurück.

Die Parameter sind alle vom Typ int. Ein Wert von -1 für jeden Parameter gibt an, dass die Standardaktion oder der Wert für diesen Parameter verwendet werden soll.

Die ersten beiden Parameter (before und after) geben die Anzahl der Zeichen an, die für den ganzzahligen Teil bzw. dezimalen Teil des Ergebnisses verwendet werden sollen, wie definiert für #format(int,int). Wenn eines dieser Zeichen -1 ist (was die Standardaktion angibt), ist die Anzahl der verwendeten Zeichen genau so viele wie für diesen Teil erforderlich.

Die verbleibenden Parameter steuern die Verwendung von exponentieller Notation und Rundung. Drei (explaces, exdigitsund exform) steuern den exponenten Teil des Ergebnisses. Wie zuvor kann die Standardaktion für jeden dieser Parameter mithilfe des Werts -1 ausgewählt werden.

explaces muss eine positive Zahl sein; Sie legt die Anzahl der Stellen (Ziffern nach dem Vorzeichen des Exponenten) fest, die für einen exponenten Teil verwendet werden sollen, wobei die Standardeinstellung (wenn explaces -1ist) so viele wie erforderlich verwendet werden soll. Ist "-1" nicht angegeben, wird der Platz immer für einen Exponenten reserviert. Wenn explaces kein Exponent erforderlich ist (z. B. wenn der Exponent 0 ist), explaceswerden +2 Leerzeichen an das Ergebnis angefügt. (Dadurch wird die vertikale Ausrichtung von ähnlich formatierten Zahlen in einer Monospace-Schriftart beibehalten.) Wenn explaces nicht -1 ist und nicht groß genug ist, um den Exponenten zu enthalten, wird eine Ausnahme ausgelöst.

exdigits legt den Triggerpunkt für die Verwendung exponentieller Notation fest. Wenn vor einer Rundung die Anzahl der vor dem Dezimalkomma erforderlichen Stellen überschritten wird oder der absolute Wert des Ergebnisses exdigitskleiner als 0.000001ist, wird exponentielles Formular verwendet, vorausgesetzt, das exdigits wurde angegeben. Wenn exdigits -1 ist, wird die exponentielle Notation nie verwendet. Wenn 0 für exdigits, exponentielle Notation angegeben wird, wird immer verwendet, es sei denn, der Exponent wäre 0.

exform legt das Formular für die exponentielle Notation fest (falls erforderlich). Es kann entweder MathContext#SCIENTIFIC oder MathContext#ENGINEERING. Wenn letzteres, Engineering, Formular angefordert wird, können bis zu drei Ziffern (Pluszeichen, falls negativ) für den ganzzahligen Teil des Ergebnisses (before ) erforderlich sein. Andernfalls ist nur eine Ziffer (Pluszeichen, falls negativ) erforderlich.

Schließlich wählt das sechste Argument den zu verwendenden Rundungsalgorithmus aus und muss eines der Werte sein, exrounddie durch eine öffentliche Konstante in der MathContext Klasse angegeben werden, deren Name mit ROUND_ . Der Standardwert (ROUND_HALF_UP) kann auch mit dem Wert -1 wie zuvor ausgewählt werden.

Der Sonderwert MathContext.ROUND_UNNECESSARY kann verwendet werden, um zu erkennen, ob Nicht-Null-Ziffern verworfen werden . Wenn exround dieser Wert über diesen Wert verfügt, als wenn nicht null Ziffern während der Formatierung verworfen (gerundet) werden, wird ein ArithmeticException Fehler ausgelöst.

Java Dokumentation für android.icu.math.BigDecimal.format(int, int, int, int, int, int).

Gilt für: