src/float/lfloat/cl_LF.h

   1 // cl_LF internals
   2
   3 #ifndef _CL_LF_H
   4 #define _CL_LF_H
   5
   6 #include "cln/number.h"
   7 #include "cln/lfloat_class.h"
   8 #include "cln/integer_class.h"
   9
  10 namespace cln {
  11
  12 struct cl_heap_lfloat : cl_heap {
  13         unsigned int len;       // length of mantissa (in digits)
  14         int sign;               // sign (0 or -1)
  15         uint32 expo;            // exponent
  16         uintD data[1];          // mantissa
  17 };
  18
  19 // Minimum number of mantissa digits,
  20 // so that a LF has not fewer mantissa bits than a DF.
  21   #define LF_minlen  ceiling(53,intDsize)
  22 // Exponent.
  23   #define LF_exp_low  1
  24   #define LF_exp_mid  0x80000000UL
  25   #define LF_exp_high 0xFFFFFFFFUL
  26
  27 inline cl_heap_lfloat* TheLfloat (cl_heap_lfloat* p)
  28         { return p; }
  29 inline cl_heap_lfloat* TheLfloat (const cl_number& obj)
  30         { return (cl_heap_lfloat*)(obj.pointer); }
  31
  32
  33 // Liefert zu einem Long-Float x : (futruncate x), ein LF.
  34 // x wird von der 0 weg zur nächsten ganzen Zahl gerundet.
  35 extern const cl_LF futruncate (const cl_LF& x);
  36
  37 // shorten(x,len) verkürzt ein Long-Float x auf gegebene Länge len
  38 // und rundet dabei.
  39 // > cl_LF x: ein Long-FLoat
  40 // > uintC len: gewünschte Länge (>= LF_minlen, < TheLfloat(x)->len)
  41 // < cl_LF ergebnis: verkürztes Long-Float
  42 extern const cl_LF shorten (const cl_LF& x, uintC len);
  43
  44 // extend(x,len) verlängert ein Long-Float x auf gegebene Länge len.
  45 // > cl_LF x: ein Long-FLoat
  46 // > uintC len: gewünschte Länge (> TheLfloat(x)->len)
  47 // < cl_LF ergebnis: verlängertes Long-Float
  48 extern const cl_LF extend (const cl_LF& x, uintC len);
  49
  50 // LF_to_LF(x,len) wandelt ein Long-Float x in ein Long-Float gegebener Länge
  51 // len um und rundet dabei nötigenfalls.
  52 // > cl_LF x: ein Long-FLoat
  53 // > uintC len: gewünschte Länge (>= LF_minlen)
  54 // < cl_LF ergebnis: Long-Float gegebener Länge
  55 extern const cl_LF LF_to_LF (const cl_LF& x, uintC len);
  56
  57 // GEN_LF_OP2(arg1,arg2,LF_OP,ergebnis_zuweisung)
  58 // generates the body of a LF operation with two arguments.
  59 // LF_OP is only executed once both arguments have been converted to the same
  60 // float format (the longer one of arg1 and arg2). The result is then
  61 // converted the shorter of the two float formats.
  62 #define GEN_LF_OP2(arg1,arg2,LF_OP,ergebnis_zuweisung)  \
  63 {                                                                       \
  64         var uintC len1 = TheLfloat(arg1)->len;                          \
  65         var uintC len2 = TheLfloat(arg2)->len;                          \
  66         if (len1==len2) /* gleich -> direkt ausführen */                \
  67                 return LF_OP(arg1,arg2);                                \
  68         elif (len1>len2) /* -> arg2 auf die Länge von arg1 bringen */   \
  69                 return shorten(LF_OP(arg1,extend(arg2,len1)),len2);     \
  70         else /* (len1<len2) -> arg1 auf die Länge von arg2 bringen */   \
  71                 return shorten(LF_OP(extend(arg1,len2),arg2),len1);     \
  72 }
  73
  74 // Liefert zu zwei gleichlangen Long-Float x und y : (+ x y), ein LF.
  75 // LF_LF_plus_LF(x)
  76 extern const cl_LF LF_LF_plus_LF (const cl_LF& x, const cl_LF& y);
  77
  78 // Liefert zu zwei gleichlangen Long-Float x und y : (- x y), ein LF.
  79 // LF_LF_minus_LF(x)
  80 extern const cl_LF LF_LF_minus_LF (const cl_LF& x, const cl_LF& y);
  81
  82 // Use this macro if ALL of your cl_LF operations (+, -, *, /) in the
  83 // rest of your file ALWAYS get two operands of the same precision.
  84 #define ALL_cl_LF_OPERATIONS_SAME_PRECISION()  \
  85                                                                         \
  86 inline const cl_LF operator+ (const cl_LF& x, const cl_LF& y)           \
  87 {                                                                       \
  88         return LF_LF_plus_LF(x,y);                                      \
  89 }                                                                       \
  90                                                                         \
  91 inline const cl_LF operator- (const cl_LF& x, const cl_LF& y)           \
  92 {                                                                       \
  93         return LF_LF_minus_LF(x,y);                                     \
  94 }
  95
  96 // LF_to_I(x) wandelt ein Long-Float x, das eine ganze Zahl darstellt,
  97 // in ein Integer um.
  98 extern const cl_I cl_LF_to_I (const cl_LF& x);
  99
 100 // cl_I_to_LF(x,len) wandelt ein Integer x in ein Long-Float um und rundet dabei.
 101 extern const cl_LF cl_I_to_LF (const cl_I& x, uintC len);
 102
 103 // cl_RA_to_LF(x,len) wandelt eine rationale Zahl x in ein Long-Float um
 104 // und rundet dabei.
 105 extern const cl_LF cl_RA_to_LF (const cl_RA& x, uintC len);
 106
 107 // cl_LF_I_mul(x,y) multipliziert ein Long-Float x und ein Integer y.
 108 extern const cl_R cl_LF_I_mul (const cl_LF& x, const cl_I& y);
 109
 110 // cl_LF_I_div(x,y) dividiert ein Long-Float x durch ein Integer y.
 111 extern const cl_LF cl_LF_I_div (const cl_LF& x, const cl_I& y);
 112
 113 // cl_I_LF_div(x,y) dividiert ein Integer x durch ein Long-Float y.
 114 extern const cl_R cl_I_LF_div (const cl_I& x, const cl_LF& y);
 115
 116 // cl_LF_RA_mul(x,y) multipliziert ein Long-Float x und eine rationale Zahl y.
 117 extern const cl_R cl_LF_RA_mul (const cl_LF& x, const cl_RA& y);
 118
 119 // cl_LF_RA_div(x,y) dividiert ein Long-Float x durch eine rationale Zahl y.
 120 extern const cl_LF cl_LF_RA_div (const cl_LF& x, const cl_RA& y);
 121
 122 // cl_RA_LF_div(x,y) dividiert eine rationale Zahl x durch ein Long-Float y.
 123 extern const cl_R cl_RA_LF_div (const cl_RA& x, const cl_LF& y);
 124
 125 // Vergrößert eine Long-Float-Länge n, so daß aus d = intDsize*n
 126 // mindestens d+sqrt(d)+2 wird.
 127 extern uintC cl_LF_len_incsqrt (uintC len);
 128
 129 // Vergrößert eine Long-Float-Länge n, so daß aus d = intDsize*n
 130 // mindestens d+sqrt(d)+2+(LF_exp_len-1) wird.
 131 extern uintC cl_LF_len_incsqrtx (uintC len);
 132
 133 // cl_LF_shortenrelative(x,y) tries to reduce the size of x, such that one
 134 // wouldn't notice it when adding x to y. y must be /= 0. More precisely,
 135 // this returns a float approximation of x, such that 1 ulp(x) < 1 ulp(y).
 136 extern const cl_LF cl_LF_shortenrelative (const cl_LF& x, const cl_LF& y);
 137
 138 // cl_LF_shortenwith(x,y) tries to reduce the size of x, such that still
 139 // 1 ulp(x) < y. y must be >0.
 140 extern const cl_LF cl_LF_shortenwith (const cl_LF& x, const cl_LF& y);
 141
 142 }  // namespace cln
 143
 144 #endif /* _CL_LF_H */