Package fr.koor.poo

Class Rational


  • public class Rational
    extends java.lang.Object
    Cette classe permet de manipuler le concept de nombres rationnels (de fractions). Mathématiquement parlant, un nombre rationnel est constitué d'un numérateur et d'un dénominateur. Il est important de noter qu'un dénominateur ne peut, en aucun cas, être nul (valeur 0).
    Since:
    1.0
    See Also:
    RationalException
    • Constructor Summary

      Constructors 
      Constructor Description
      Rational()
      Ce constructeur produit un rationnel par défaut, soit [0/1].
      Rational​(int numerator, int denominator)
      Ce constructeur produit un rationnel avec le numérateur et le dénominateur spécifiés.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      Rational add​(Rational r2)
      Ajoute deux nombres rationnels et produit un nouveau nombre rationnel.
      int getDenominator()
      Retourne la valeur du dénominateur pour le rationnel courant.
      int getNumerator()
      Retourne la valeur du numérateur pour le rationnel courant.
      boolean lessThan​(Rational r2)
      Compare deux nombres rationnels entre eux et indique si le premier est plus petit que le second.
      void setDenominator​(int denominator)
      Modifie la valeur du dénominateur.
      void setNumerator​(int numerator)
      Modifie la valeur du numérateur.
      void simplify()
      Simplifie la faction en divisant le numérateur et le dénominateur par leur diviseur commun.
      java.lang.String toString()
      Produit la chaîne de caractères de représentation de notre nombre rationnel.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Constructor Detail

      • Rational

        public Rational()
        Ce constructeur produit un rationnel par défaut, soit [0/1].
        Since:
        1.0
      • Rational

        public Rational​(int numerator,
                        int denominator)
                 throws RationalException
        Ce constructeur produit un rationnel avec le numérateur et le dénominateur spécifiés.
        Parameters:
        numerator - La valeur du numérateur
        denominator - La valeur du dénominateur
        Throws:
        RationalException - Déclenchée si vous passez un dénominateur à 0.
        Since:
        1.0
    • Method Detail

      • getNumerator

        public int getNumerator()
        Retourne la valeur du numérateur pour le rationnel courant.
        Returns:
        La valeur du numérateur.
        Since:
        1.0
        See Also:
        setDenominator(int)
      • setNumerator

        public void setNumerator​(int numerator)
        Modifie la valeur du numérateur.
        Parameters:
        numerator - La nouvelle valeur pour le numérateur.
        Since:
        1.0
        See Also:
        getNumerator()
      • getDenominator

        public int getDenominator()
        Retourne la valeur du dénominateur pour le rationnel courant.
        Returns:
        La valeur du dénominateur.
        Since:
        1.0
        See Also:
        getDenominator()
      • setDenominator

        public void setDenominator​(int denominator)
                            throws RationalException
        Modifie la valeur du dénominateur. Attention, celui-ci ne peut pas être fixé à 0.
        Parameters:
        denominator - La nouvelle valeur, non nulle, pour le dénominateur.
        Throws:
        RationalException - Déclenchée si vous passez un dénominateur à 0.
        Since:
        1.0
        See Also:
        getNumerator()
      • add

        public Rational add​(Rational r2)
        Ajoute deux nombres rationnels et produit un nouveau nombre rationnel.
        Parameters:
        r2 - Le second rationnel à ajouter à this.
        Returns:
        La somme de deux rationnels.
        Since:
        1.0
      • lessThan

        public boolean lessThan​(Rational r2)
        Compare deux nombres rationnels entre eux et indique si le premier est plus petit que le second.
        Parameters:
        r2 - Le second rationnel à comparer à this.
        Returns:
        true si this est inféreur à r2, false sinon.
        Since:
        1.0
      • simplify

        public void simplify()
        Simplifie la faction en divisant le numérateur et le dénominateur par leur diviseur commun.
        Since:
        1.0
      • toString

        public java.lang.String toString()
        Produit la chaîne de caractères de représentation de notre nombre rationnel. Le format de sortie est [num/den].
        Overrides:
        toString in class java.lang.Object
        Since:
        1.0