release: 1.0.15

[lilypond.git] / flower / include / rational.hh

diff --git a/flower/include/rational.hh b/flower/include/rational.hh
index 4160af814d87b8eac8c34d64fbe4ff552b907d88..7394af6aa5c79269d9fb56562577321dc097258d 100644 (file)
--- a/flower/include/rational.hh
+++ b/flower/include/rational.hh
@@ -3,7 +3,7 @@
 
   source file of the Flower Library
 
-  (c) 1997 Han-Wen Nienhuys <hanwen@stack.nl>
+  (c)  1997--1998 Han-Wen Nienhuys <hanwen@cs.uu.nl>
 */
 
 
@@ -20,22 +20,40 @@
 #include "arithmetic-operator.hh"
 #include "fproto.hh"
 
+/**
+   Rational numbers.  Included is support for + and - infinity.
+ */
 class Rational {
+  /**
+     Sign of rational.
+     -2, .. 2
+
+     -2,2 is - and + infinity.
+     -1,1 is negative and positive.
+     0 if *this is zero.
+   */
   int sign_;
   unsigned int num_, den_;
   void normalise ();
   void copy (Rational const &);
+
 public:
   void set_infinite (int sign);
   bool infty_b () const;
   void invert ();
   int num  () const { return sign_ * num_; }
   int den  () const { return den_; }
+  int num_i  () const { return sign_ * num_; }
+  int den_i  () const { return den_; }
   Rational truncated () const;
   void negate ();
   operator bool () const;
-  operator String () const;
+  operator int () const;
+  operator double () const;
   Rational operator - () const;
+  /**
+     Initialize to 0. 
+   */
   Rational ();
   Rational (int, int =1);
   Rational (double);
@@ -43,9 +61,9 @@ public:
 
   Rational &operator = (Rational const &);
   Rational &operator *= (Rational);
-  Rational  &operator /= (Rational);  
-  Rational  &operator += (Rational);
-  Rational  &operator -= (Rational);
+  Rational &operator /= (Rational);  
+  Rational &operator += (Rational);
+  Rational &operator -= (Rational);
   static int compare (Rational const&, Rational const&);
   int sign () const;
   String str () const;