Aller au contenu principal
Version: v1-alpha

NumberHelper

parse​

BigDecimal NumberHelper.parse(Object value)

Description​

Permet de convertir un objet vers un nombre représenté par le type BigDecimal.

Paramètres​

  • value l'objet que l'on souhaite convertir en nombre. Il peut être un BigDecimal, BigInteger, Integer, Double, Long, String ou une variable de type Nombre.

Retour​

Une valeur nombre correspondante à la valeur de l'objet en entrée value ou null.

Exemples
// VARIABLE_NUMBER = 3.14
NumberHelper.parse(VARIABLE_NUMBER.value) // = 3.14
NumberHelper.parse(VARIABLE_NUMBER) // = 3.14
NumberHelper.parse(13) // = 13
NumberHelper.parse("2023") // = 2023
NumberHelper.parse(DateHelper.today()) // = null

min​

BigDecimal NumberHelper.min(List<VariableNumber> list)
BigDecimal NumberHelper.min(Object... list)

Description​

Permet de retourner le nombre (le plus petit) parmi une liste de nombres.

Deux signatures possibles :

  • appliquer min sur les instances d'une variable multiple de type Nombre.
  • appliquer min sur une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres​

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour​

Le nombre minimum parmi les instances de la variable multiple de type Nombre ou bien la liste des objets convertibles vers un nombre.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.min(VARIABLE_AGES) // = 5
NumberHelper.min("3.14", 2023) // = 3.14

max​

BigDecimal NumberHelper.max(List<VariableNumber> list)
BigDecimal NumberHelper.max(Object... list)

Description​

Permet de retourner le nombre maximum (le plud grand) parmi une liste de nombres.

Deux signatures possibles :

  • appliquer max sur les instances d'une variable multiple de type Nombre.
  • appliquer max sur une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres​

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour​

Le nombre maximum parmi les instances de la variable multiple de type Nombre ou bien la liste des objets convertibles vers un nombre.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.max(VARIABLE_AGES) // = 33
NumberHelper.max("3.14", 2023) // = 2023

sum​

BigDecimal NumberHelper.sum(List<VariableNumber> list)
BigDecimal NumberHelper.sum(Object... list)

Description​

Permet de calculer la somme d'une liste de nombres.

Deux signatures possibles :

  • calculer la somme des instances d'une variable multiple de type Nombre.
  • calculer la somme d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres​

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour​

Un nombre représentant la somme.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.sum(VARIABLE_AGES) // = 69
NumberHelper.sum("1", 2, "3", 4) // = 10

product​

BigDecimal NumberHelper.product(List<VariableNumber> list)
BigDecimal NumberHelper.product(Object... list)

Description​

Permet de calculer le produit (multiplication) d'une liste de nombres.

Deux signatures possibles :

  • calculer le produit des instances d'une variable multiple de type Nombre.
  • calculer le produit d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres​

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour​

Un nombre représentant le produit.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.product(VARIABLE_AGES) // = 5115
NumberHelper.product("1", 2, "3", 4) // = 24

average​

BigDecimal NumberHelper.sum(List<VariableNumber> list)
BigDecimal NumberHelper.sum(Object... list)

Description​

Permet de calculer la moyenne d'une liste de nombres.

Deux signatures possibles :

  • calculer la moyenne des instances d'une variable multiple de type Nombre.
  • calculer la moyenne d'une liste d'objets convertibles vers un nombre (grâce à la fonction parse)

Paramètres​

  • list une variable multiple de type Nombre ou bien une liste d'objets convertibles vers un nombre séparés par des virgules.

Retour​

Un nombre représentant la moyenne.

Exemples
// VARIABLE_AGES = [33, 31, 5]
NumberHelper.average(VARIABLE_AGES) // = 23
NumberHelper.average("1", 2, "3", 4) // = 3.3333333333333333

floorDiv​

BigDecimal NumberHelper.floorDiv(Object number, Object divisor)

Description​

Permet de calculer une division entière. Renvoie le nombre le plus grand inférieur ou égal au quotient algébrique.

Paramètres​

  • number le numérateur
  • division le dénominateur

Retour​

Un nombre entier représentant le quotient de la division entière.

Exemples
NumberHelper.floorDiv(6, 3) // = 2
NumberHelper.floorDiv(7, 3) // = 2
NumberHelper.floorDiv(8, 3) // = 2
NumberHelper.floorDiv(9, 3) // = 3