A Discrete-Event Network Simulator
API
int64x64-cairo.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2006 INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 #include "test.h"
21 #include "abort.h"
22 #include "assert.h"
23 #include "log.h"
24 #include <cmath>
25 #include <iostream>
26 #include "int64x64-cairo.h"
27 
28 // Include directly to allow optimizations within this compilation unit.
29 extern "C" {
30 #include "cairo-wideint.c"
31 }
32 
33 namespace ns3 {
34 
35 // Note: Logging in this file is largely avoided due to the
36 // number of calls that are made to these functions and the possibility
37 // of causing recursions leading to stack overflow
38 NS_LOG_COMPONENT_DEFINE ("int64x64-cairo");
39 
51 static inline
52 bool
54  const cairo_int128_t sb,
55  cairo_uint128_t & ua,
56  cairo_uint128_t & ub)
57 {
58  bool negA = _cairo_int128_negative (sa);
59  bool negB = _cairo_int128_negative (sb);
60  ua = _cairo_int128_to_uint128 (sa);
61  ub = _cairo_int128_to_uint128 (sb);
62  ua = negA ? _cairo_uint128_negate (ua) : ua;
63  ub = negB ? _cairo_uint128_negate (ub) : ub;
64  return (negA && !negB) || (!negA && negB);
65 }
66 
67 void
68 int64x64_t::Mul (const int64x64_t & o)
69 {
70  cairo_uint128_t a, b;
71  bool sign = output_sign (_v, o._v, a, b);
72  cairo_uint128_t result = Umul (a, b);
73  _v = sign ? _cairo_uint128_negate (result) : result;
74 }
75 
76 cairo_uint128_t
77 int64x64_t::Umul (const cairo_uint128_t a, const cairo_uint128_t b)
78 {
79  cairo_uint128_t result;
80  cairo_uint128_t hiPart, loPart, midPart;
81  cairo_uint128_t res1, res2;
82 
83  // Multiplying (a.h 2^64 + a.l) x (b.h 2^64 + b.l) =
84  // 2^128 a.h b.h + 2^64*(a.h b.l+b.h a.l) + a.l b.l
85  // get the low part a.l b.l
86  // multiply the fractional part
87  loPart = _cairo_uint64x64_128_mul (a.lo, b.lo);
88  // compute the middle part 2^64*(a.h b.l+b.h a.l)
89  midPart = _cairo_uint128_add (_cairo_uint64x64_128_mul (a.lo, b.hi),
90  _cairo_uint64x64_128_mul (a.hi, b.lo));
91  // compute the high part 2^128 a.h b.h
92  hiPart = _cairo_uint64x64_128_mul (a.hi, b.hi);
93  // if the high part is not zero, put a warning
94  NS_ABORT_MSG_IF (hiPart.hi != 0,
95  "High precision 128 bits multiplication error: multiplication overflow.");
96 
97  // Adding 64-bit terms to get 128-bit results, with carries
98  res1 = _cairo_uint64_to_uint128 (loPart.hi);
99  res2 = _cairo_uint64_to_uint128 (midPart.lo);
100  result = _cairo_uint128_add (res1, res2);
101 
102  res1 = _cairo_uint64_to_uint128 (midPart.hi);
103  res2 = _cairo_uint64_to_uint128 (hiPart.lo);
104  res1 = _cairo_uint128_add (res1, res2);
105  res1 = _cairo_uint128_lsl (res1, 64);
106 
107  result = _cairo_uint128_add (result, res1);
108 
109  return result;
110 }
111 
112 void
113 int64x64_t::Div (const int64x64_t & o)
114 {
115  cairo_uint128_t a, b;
116  bool sign = output_sign (_v, o._v, a, b);
117  cairo_uint128_t result = Udiv (a, b);
118  _v = sign ? _cairo_uint128_negate (result) : result;
119 }
120 
121 cairo_uint128_t
122 int64x64_t::Udiv (const cairo_uint128_t a, const cairo_uint128_t b)
123 {
124  cairo_uint128_t den = b;
126  cairo_uint128_t result = qr.quo;
127  cairo_uint128_t rem = qr.rem;
128 
129  // Now, manage the remainder
130  const uint64_t DIGITS = 64; // Number of fraction digits (bits) we need
131  const cairo_uint128_t ZERO = _cairo_uint32_to_uint128 ((uint32_t)0);
132 
133  NS_ASSERT_MSG (_cairo_uint128_lt (rem, den),
134  "Remainder not less than divisor");
135 
136  uint64_t digis = 0; // Number of digits we have already
137  uint64_t shift = 0; // Number we are going to get this round
138 
139  // Skip trailing zeros in divisor
140  while ( (shift < DIGITS) && !(den.lo & 0x1))
141  {
142  ++shift;
143  den = _cairo_uint128_rsl (den, 1);
144  }
145 
146  while ( (digis < DIGITS) && !(_cairo_uint128_eq(rem, ZERO)) )
147  {
148  // Skip leading zeros in remainder
149  while ( (digis + shift < DIGITS) &&
150  !(rem.hi & HPCAIRO_MASK_HI_BIT) )
151  {
152  ++shift;
153  rem = _cairo_int128_lsl (rem, 1);
154  }
155 
156  // Cast off denominator bits if:
157  // Need more digits and
158  // LSB is zero or
159  // rem < den
160  while ( (digis + shift < DIGITS) &&
161  ( !(den.lo & 0x1) || _cairo_uint128_lt (rem, den) ) )
162  {
163  ++shift;
164  den = _cairo_uint128_rsl (den, 1);
165  }
166 
167  // Do the division
168  qr = _cairo_uint128_divrem (rem, den);
169 
170  // Add in the quotient as shift bits of the fraction
171  result = _cairo_uint128_lsl (result, shift);
172  result = _cairo_uint128_add (result, qr.quo);
173  rem = qr.rem;
174  digis += shift;
175  shift = 0;
176  }
177  // Did we run out of remainder?
178  if (digis < DIGITS)
179  {
180  shift = DIGITS - digis;
181  result = _cairo_uint128_lsl (result, shift);
182  }
183 
184  return result;
185 }
186 
187 void
188 int64x64_t::MulByInvert (const int64x64_t & o)
189 {
190  bool sign = _cairo_int128_negative (_v);
191  cairo_uint128_t a = sign ? _cairo_int128_negate (_v) : _v;
192  cairo_uint128_t result = UmulByInvert (a, o._v);
193 
194  _v = sign ? _cairo_int128_negate (result) : result;
195 }
196 
197 cairo_uint128_t
198 int64x64_t::UmulByInvert (const cairo_uint128_t a, const cairo_uint128_t b)
199 {
200  cairo_uint128_t result;
201  cairo_uint128_t hi, mid;
202  hi = _cairo_uint64x64_128_mul (a.hi, b.hi);
203  mid = _cairo_uint128_add (_cairo_uint64x64_128_mul (a.hi, b.lo),
204  _cairo_uint64x64_128_mul (a.lo, b.hi));
205  mid.lo = mid.hi;
206  mid.hi = 0;
207  result = _cairo_uint128_add (hi,mid);
208  return result;
209 }
210 
211 int64x64_t
212 int64x64_t::Invert (const uint64_t v)
213 {
214  NS_ASSERT (v > 1);
215  cairo_uint128_t a, factor;
216  a.hi = 1;
217  a.lo = 0;
218  factor.hi = 0;
219  factor.lo = v;
220  int64x64_t result;
221  result._v = Udiv (a, factor);
222  int64x64_t tmp = int64x64_t (v, 0);
223  tmp.MulByInvert (result);
224  if (tmp.GetHigh () != 1)
225  {
226  cairo_uint128_t one = { 1, 0};
227  result._v = _cairo_uint128_add (result._v, one);
228  }
229  return result;
230 }
231 
232 
233 } // namespace ns3
cairo_uint128_t I _cairo_uint64_to_uint128(cairo_uint64_t i)
static uint128_t Udiv(const uint128_t a, const uint128_t b)
Unsigned division of Q64.64 values.
static int64x64_t Invert(const uint64_t v)
Compute the inverse of an integer value.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:61
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
cairo_uint128_t I _cairo_uint128_negate(cairo_uint128_t a)
int I _cairo_uint128_eq(cairo_uint128_t a, cairo_uint128_t b)
void MulByInvert(const int64x64_t &o)
Multiply this value by a Q0.128 value, presumably representing an inverse, completing a division oper...
static uint128_t UmulByInvert(const uint128_t a, const uint128_t b)
Unsigned multiplication of Q64.64 and Q0.128 values.
cairo_uquorem128_t I _cairo_uint128_divrem(cairo_uint128_t num, cairo_uint128_t den)
int I _cairo_uint128_lt(cairo_uint128_t a, cairo_uint128_t b)
cairo_uint128_t I _cairo_uint128_rsl(cairo_uint128_t a, int shift)
cairo_uint128_t I _cairo_uint32_to_uint128(uint32_t i)
cairo_uint128_t I _cairo_uint64x64_128_mul(cairo_uint64_t a, cairo_uint64_t b)
static uint128_t Umul(const uint128_t a, const uint128_t b)
Unsigned multiplication of Q64.64 values.
Definition: int64x64-128.cc:67
int128_t _v
The Q64.64 value.
Definition: int64x64-128.h:333
void Mul(const int64x64_t &o)
Implement *=.
Definition: int64x64-128.cc:58
int64x64_t()
Default constructor.
Definition: int64x64-128.h:80
cairo_uint128_t I _cairo_uint128_lsl(cairo_uint128_t a, int shift)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
#define _cairo_int128_negative(a)
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:84
#define _cairo_int128_lsl(a, b)
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
Definition: abort.h:108
void Div(const int64x64_t &o)
Implement /=.
#define _cairo_int128_negate(a)
#define _cairo_int128_to_uint128(i)
cairo_uint128_t I _cairo_uint128_add(cairo_uint128_t a, cairo_uint128_t b)
Debug message logging.
NS_ABORT_x macro definitions.
static bool output_sign(const int128_t sa, const int128_t sb, uint128_t &ua, uint128_t &ub)
Compute the sign of the result of multiplying or dividing Q64.64 fixed precision operands.
Definition: int64x64-128.cc:45