BigDecimal.Format Metodo

[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

Parametri

Valori restituiti

Oggetto String che rappresenta questo BigDecimaloggetto , disposto in base ai parametri specificati

Attributi

RegisterAttribute

Commenti

Restituisce la String rappresentazione di questo BigDecimaloggetto , modificato dai parametri di layout.

Questo metodo viene fornito come primitiva per l'uso da classi più sofisticate, ad esempio DecimalFormat , che possono applicare modifiche sensibili alle impostazioni locali del risultato. Il livello di formattazione fornito è una parte necessaria della classe BigDecimal perché è sensibile a e deve seguire il calcolo e le regole di arrotondamento per l'aritmetica BigDecimal. Tuttavia, se la funzione viene fornita altrove, potrebbe essere rimossa da questa classe.

I parametri, per entrambe le forme del format metodo sono tutti di tipo int. Un valore di -1 per qualsiasi parametro indica che deve essere utilizzata l'azione o il valore predefinito per tale parametro.

I parametri before e after, specificano rispettivamente il numero di caratteri da usare per la parte integer e la parte decimale del risultato. La notazione esponenziale non viene usata. Se uno dei due parametri è -1 (che indica l'azione predefinita), il numero di caratteri usati sarà esattamente il numero necessario per tale parte.

before deve essere un numero positivo; se è maggiore del necessario per contenere la parte integer, tale parte viene riempita a sinistra con spazi vuoti per la lunghezza richiesta. Se before non è sufficientemente grande da contenere la parte intera del numero (incluso il segno, per i numeri negativi) viene generata un'eccezione.

after deve essere un numero non negativo; se non è la stessa dimensione della parte decimale del numero, il numero verrà arrotondato (o esteso con zeri) per adattarsi. Se si specifica 0 per after , il numero verrà arrotondato a un numero intero, ovvero non avrà una parte decimale o una virgola decimale. Il metodo di arrotondamento sarà il valore predefinito, MathContext.ROUND_HALF_UP.

È possibile selezionare altri metodi di arrotondamento e l'uso della notazione esponenziale tramite #format(int,int,int,int,int,int). L'uso del formato a due parametri del metodo ha esattamente lo stesso effetto dell'uso del formato a sei parametri con i quattro parametri finali tutti pari a -1.

per android.icu.math.BigDecimal.format(int, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 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

Parametri

Valori restituiti

Oggetto String che rappresenta questo BigDecimaloggetto , disposto in base ai parametri specificati

Attributi

RegisterAttribute

Commenti

Restituisce la String rappresentazione di questo BigDecimaloggetto , modificato dai parametri di layout e che consente la notazione esponenziale.

Questo metodo viene fornito come primitiva per l'uso da classi più sofisticate, ad esempio DecimalFormat , che possono applicare modifiche sensibili alle impostazioni locali del risultato. Il livello di formattazione fornito è una parte necessaria della classe BigDecimal perché è sensibile a e deve seguire il calcolo e le regole di arrotondamento per l'aritmetica BigDecimal. Tuttavia, se la funzione viene fornita altrove, potrebbe essere rimossa da questa classe.

I parametri sono tutti di tipo int. Un valore di -1 per qualsiasi parametro indica che deve essere utilizzata l'azione o il valore predefinito per tale parametro.

I primi due parametri (before e after) specificano il numero di caratteri da usare rispettivamente per la parte intera e la parte decimale del risultato, come definito per #format(int,int). Se uno di questi è -1 (che indica l'azione predefinita), il numero di caratteri usati sarà esattamente il numero di caratteri necessari per tale parte.

I parametri rimanenti controllano l'uso della notazione esponenziale e dell'arrotondamento. Tre (explaces, exdigitse exform) controllano la parte esponente del risultato. Come in precedenza, è possibile selezionare l'azione predefinita per uno di questi parametri usando il valore -1.

explaces deve essere un numero positivo; imposta il numero di posizioni (cifre dopo il segno dell'esponente) da utilizzare per qualsiasi parte esponente, ovvero il valore predefinito (quando explaces è -1) da usare per il maggior numero necessario. Se explaces non è -1, lo spazio è sempre riservato per un esponente; se non è necessario (ad esempio, se l'esponente sarà 0), explacesal risultato vengono aggiunti +2 spazi vuoti. In questo modo viene mantenuto l'allineamento verticale di numeri formattati in modo analogo in un tipo di carattere monospace. Se explaces non è -1 e non è sufficientemente grande da contenere l'esponente, viene generata un'eccezione.

exdigits imposta il punto di attivazione per l'uso della notazione esponenziale. Se, prima di qualsiasi arrotondamento, il numero di posizioni necessarie prima del separatore decimale supera exdigitso se il valore assoluto del risultato è minore 0.000001di , verrà utilizzata la forma esponenziale, purché exdigits sia stata specificata. Quando exdigits è -1, non verrà mai usata la notazione esponenziale. Se si specifica 0 per exdigits, la notazione esponenziale viene sempre usata a meno che l'esponente non sia 0.

exform imposta il form per la notazione esponenziale , se necessario. Può essere MathContext#SCIENTIFIC o MathContext#ENGINEERING. Se quest'ultimo, progettazione, modulo viene richiesto, possono essere necessarie fino a tre cifre (segno più, se negativo) per la parte intera del risultato (before ). In caso contrario, è necessaria una sola cifra (segno più, se negativo).

Infine, il sesto argomento, exround, seleziona l'algoritmo di arrotondamento da usare e deve essere uno dei valori indicati da una costante pubblica nella classe il MathContext cui nome inizia con ROUND_ . È anche possibile selezionare il valore predefinito (ROUND_HALF_UP) usando il valore -1, come in precedenza.

Il valore MathContext.ROUND_UNNECESSARY speciale può essere usato per rilevare se le cifre diverse da zero vengono eliminate. Se exround ha questo valore rispetto a se le cifre non zero verranno eliminate (arrotondate) durante la formattazione, viene generata un'eccezione ArithmeticException .

per android.icu.math.BigDecimal.format(int, int, int, int, int, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.