BigDecimal.Format Método

[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

Parâmetros

Retornos

Um String que representa isso BigDecimal, disposto de acordo com os parâmetros especificados

Atributos

RegisterAttribute

Comentários

Retorna a String representação disso BigDecimal, modificada por parâmetros de layout.

Esse método é fornecido como um primitivo para uso por classes mais sofisticadas, como DecimalFormat , que podem aplicar a edição sensível à localidade do resultado. O nível de formatação que ele fornece é uma parte necessária da classe BigDecimal, pois é sensível e deve seguir as regras de cálculo e arredondamento para a aritmética BigDecimal. No entanto, se a função for fornecida em outro lugar, ela poderá ser removida dessa classe.

Os parâmetros, para ambas as formas do format método, são todos do tipo int. Um valor de -1 para qualquer parâmetro indica que a ação ou o valor padrão para esse parâmetro deve ser usado.

Os parâmetros e afterespecifiquem before o número de caracteres a serem usados para a parte inteiro e a parte decimal do resultado, respectivamente. Notação exponencial não é usada. Se um dos parâmetros for -1 (o que indica a ação padrão), o número de caracteres usados será exatamente quantos forem necessários para essa parte.

before deve ser um número positivo; se for maior do que o necessário para conter a parte inteiro, essa parte será adicionada à esquerda com espaços em branco no comprimento solicitado. Se before não for grande o suficiente para conter a parte inteira do número (incluindo o sinal, para números negativos), uma exceção será gerada.

after deve ser um número não negativo; se não for do mesmo tamanho que a parte decimal do número, o número será arredondado (ou estendido com zeros) para caber. Especificar 0 fará after com que o número seja arredondado para um inteiro (ou seja, ele não terá nenhuma parte decimal ou ponto decimal). O método de arredondamento será o padrão. MathContext.ROUND_HALF_UP

Outros métodos de arredondamento e o uso da notação exponencial podem ser selecionados usando #format(int,int,int,int,int,int). Usar a forma de dois parâmetros do método tem exatamente o mesmo efeito que usar o formulário de seis parâmetros com os quatro parâmetros finais sendo -1.

Java documentação para android.icu.math.BigDecimal.format(int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Parâmetros

Retornos

Um String que representa isso BigDecimal, disposto de acordo com os parâmetros especificados

Atributos

RegisterAttribute

Comentários

Retorna a String representação disso BigDecimal, modificada por parâmetros de layout e permitindo notação exponencial.

Esse método é fornecido como um primitivo para uso por classes mais sofisticadas, como DecimalFormat , que podem aplicar a edição sensível à localidade do resultado. O nível de formatação que ele fornece é uma parte necessária da classe BigDecimal, pois é sensível e deve seguir as regras de cálculo e arredondamento para a aritmética BigDecimal. No entanto, se a função for fornecida em outro lugar, ela poderá ser removida dessa classe.

Os parâmetros são todos do tipo int. Um valor de -1 para qualquer parâmetro indica que a ação ou o valor padrão para esse parâmetro deve ser usado.

Os dois primeiros parâmetros (before e after) especificam o número de caracteres a serem usados para a parte inteiro e a parte decimal do resultado, respectivamente, conforme definido para #format(int,int). Se um deles for -1 (o que indica a ação padrão), o número de caracteres usados será exatamente quantos forem necessários para essa parte.

Os parâmetros restantes controlam o uso de notação exponencial e arredondamento. Três (explacese exdigitsexform) controlam a parte expoente do resultado. Como antes, a ação padrão para qualquer um desses parâmetros pode ser selecionada usando o valor -1.

explaces deve ser um número positivo; define o número de locais (dígitos após o sinal do expoente) a serem usados para qualquer parte exponencial, o padrão (quando explaces é -1) sendo usar quantos forem necessários. Se explaces não for -1, o espaço será sempre reservado para um expoente; se não for necessário (por exemplo, se o expoente for 0), + explaces2 espaços em branco serão acrescentados ao resultado. (Isso preserva o alinhamento vertical de números formatados da mesma forma em uma fonte de monospace.) Se explaces não for -1 e não for grande o suficiente para conter o expoente, uma exceção será gerada.

exdigits define o ponto de gatilho para uso de notação exponencial. Se, antes de qualquer arredondamento, o número de locais necessários exdigitsantes do ponto decimal exceder, ou se o valor absoluto do resultado for menor que 0.000001, então o formulário exponencial será usado, desde que exdigits especificado. Quando exdigits for -1, a notação exponencial nunca será usada. Se 0 for especificado para exdigits, a notação exponencial será sempre usada, a menos que o expoente seja 0.

exform define o formulário para notação exponencial (se necessário). Pode ser ou MathContext#SCIENTIFICMathContext#ENGINEERING. Se este último, engenharia, formulário for solicitado, até três dígitos (sinal de adição, se negativo) poderão ser necessários para a parte inteiro do resultado (before ). Caso contrário, apenas um dígito (sinal de adição, se negativo) será necessário.

Por fim, o sexto argumento exround, seleciona o algoritmo de arredondamento a ser usado e deve ser um dos valores indicados por uma constante pública na MathContext classe cujo nome começa com ROUND_ . O padrão (ROUND_HALF_UP) também pode ser selecionado usando o valor -1, como antes.

O valor MathContext.ROUND_UNNECESSARY especial pode ser usado para detectar se dígitos não zero são descartados. Se exround tiver esse valor do que se dígitos não zero forem descartados (arredondados) durante a formatação, um ArithmeticException será gerado.

Java documentação para android.icu.math.BigDecimal.format(int, int, int, int, int, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.