include/cln/univpoly.h

   1 // Univariate Polynomials.
   2
   3 #ifndef _CL_UNIVPOLY_H
   4 #define _CL_UNIVPOLY_H
   5
   6 #include "cln/object.h"
   7 #include "cln/ring.h"
   8 #include "cln/malloc.h"
   9 #include "cln/proplist.h"
  10 #include "cln/symbol.h"
  11 #include "cln/V.h"
  12 #include "cln/io.h"
  13
  14 namespace cln {
  15
  16 // To protect against mixing elements of different polynomial rings, every
  17 // polynomial carries its ring in itself.
  18
  19 class cl_heap_univpoly_ring;
  20
  21 class cl_univpoly_ring : public cl_ring {
  22 public:
  23         // Default constructor.
  24         cl_univpoly_ring ();
  25         // Constructor. Takes a cl_heap_univpoly_ring*, increments its refcount.
  26         cl_univpoly_ring (cl_heap_univpoly_ring* r);
  27         // Private constructor. Doesn't increment the refcount.
  28         cl_univpoly_ring (cl_private_thing);
  29         // Copy constructor.
  30         cl_univpoly_ring (const cl_univpoly_ring&);
  31         // Assignment operator.
  32         cl_univpoly_ring& operator= (const cl_univpoly_ring&);
  33         // Automatic dereferencing.
  34         cl_heap_univpoly_ring* operator-> () const
  35         { return (cl_heap_univpoly_ring*)heappointer; }
  36 };
  37 // Copy constructor and assignment operator.
  38 CL_DEFINE_COPY_CONSTRUCTOR2(cl_univpoly_ring,cl_ring)
  39 CL_DEFINE_ASSIGNMENT_OPERATOR(cl_univpoly_ring,cl_univpoly_ring)
  40
  41 // Normal constructor for `cl_univpoly_ring'.
  42 inline cl_univpoly_ring::cl_univpoly_ring (cl_heap_univpoly_ring* r)
  43         : cl_ring ((cl_private_thing) (cl_inc_pointer_refcount((cl_heap*)r), r)) {}
  44 // Private constructor for `cl_univpoly_ring'.
  45 inline cl_univpoly_ring::cl_univpoly_ring (cl_private_thing p)
  46         : cl_ring (p) {}
  47
  48 // Operations on univariate polynomial rings.
  49
  50 inline bool operator== (const cl_univpoly_ring& R1, const cl_univpoly_ring& R2)
  51 { return (R1.pointer == R2.pointer); }
  52 inline bool operator!= (const cl_univpoly_ring& R1, const cl_univpoly_ring& R2)
  53 { return (R1.pointer != R2.pointer); }
  54 inline bool operator== (const cl_univpoly_ring& R1, cl_heap_univpoly_ring* R2)
  55 { return (R1.pointer == R2); }
  56 inline bool operator!= (const cl_univpoly_ring& R1, cl_heap_univpoly_ring* R2)
  57 { return (R1.pointer != R2); }
  58
  59 // Representation of a univariate polynomial.
  60
  61 class _cl_UP /* cf. _cl_ring_element */ {
  62 public:
  63         cl_gcpointer rep; // vector of coefficients, a cl_V_any
  64         // Default constructor.
  65         _cl_UP ();
  66 public: /* ugh */
  67         // Constructor.
  68         _cl_UP (const cl_heap_univpoly_ring* R, const cl_V_any& r) : rep (as_cl_private_thing(r)) { (void)R; }
  69         _cl_UP (const cl_univpoly_ring& R, const cl_V_any& r) : rep (as_cl_private_thing(r)) { (void)R; }
  70 public:
  71         // Conversion.
  72         CL_DEFINE_CONVERTER(_cl_ring_element)
  73 public: // Ability to place an object at a given address.
  74         void* operator new (size_t size) { return malloc_hook(size); }
  75         void* operator new (size_t size, void* ptr) { (void)size; return ptr; }
  76         void operator delete (void* ptr) { free_hook(ptr); }
  77 };
  78
  79 class cl_UP /* cf. cl_ring_element */ : public _cl_UP {
  80 protected:
  81         cl_univpoly_ring _ring; // polynomial ring (references the base ring)
  82 public:
  83         const cl_univpoly_ring& ring () const { return _ring; }
  84 private:
  85         // Default constructor.
  86         cl_UP ();
  87 public: /* ugh */
  88         // Constructor.
  89         cl_UP (const cl_univpoly_ring& R, const cl_V_any& r)
  90                 : _cl_UP (R,r), _ring (R) {}
  91         cl_UP (const cl_univpoly_ring& R, const _cl_UP& r)
  92                 : _cl_UP (r), _ring (R) {}
  93 public:
  94         // Conversion.
  95         CL_DEFINE_CONVERTER(cl_ring_element)
  96         // Destructive modification.
  97         void set_coeff (uintL index, const cl_ring_element& y);
  98         void finalize();
  99         // Evaluation.
 100         const cl_ring_element operator() (const cl_ring_element& y) const;
 101         // Debugging output.
 102         void debug_print () const;
 103 public: // Ability to place an object at a given address.
 104         void* operator new (size_t size) { return malloc_hook(size); }
 105         void* operator new (size_t size, void* ptr) { (void)size; return ptr; }
 106         void operator delete (void* ptr) { free_hook(ptr); }
 107 };
 108
 109
 110 // Ring operations.
 111
 112 struct _cl_univpoly_setops /* cf. _cl_ring_setops */ {
 113         // print
 114         void (* fprint) (cl_heap_univpoly_ring* R, std::ostream& stream, const _cl_UP& x);
 115         // equality
 116         // (Be careful: This is not well-defined for polynomials with
 117         // floating-point coefficients.)
 118         bool (* equal) (cl_heap_univpoly_ring* R, const _cl_UP& x, const _cl_UP& y);
 119 };
 120 struct _cl_univpoly_addops /* cf. _cl_ring_addops */ {
 121         // 0
 122         const _cl_UP (* zero) (cl_heap_univpoly_ring* R);
 123         bool (* zerop) (cl_heap_univpoly_ring* R, const _cl_UP& x);
 124         // x+y
 125         const _cl_UP (* plus) (cl_heap_univpoly_ring* R, const _cl_UP& x, const _cl_UP& y);
 126         // x-y
 127         const _cl_UP (* minus) (cl_heap_univpoly_ring* R, const _cl_UP& x, const _cl_UP& y);
 128         // -x
 129         const _cl_UP (* uminus) (cl_heap_univpoly_ring* R, const _cl_UP& x);
 130 };
 131 struct _cl_univpoly_mulops /* cf. _cl_ring_mulops */ {
 132         // 1
 133         const _cl_UP (* one) (cl_heap_univpoly_ring* R);
 134         // canonical homomorphism
 135         const _cl_UP (* canonhom) (cl_heap_univpoly_ring* R, const cl_I& x);
 136         // x*y
 137         const _cl_UP (* mul) (cl_heap_univpoly_ring* R, const _cl_UP& x, const _cl_UP& y);
 138         // x^2
 139         const _cl_UP (* square) (cl_heap_univpoly_ring* R, const _cl_UP& x);
 140         // x^y, y Integer >0
 141         const _cl_UP (* expt_pos) (cl_heap_univpoly_ring* R, const _cl_UP& x, const cl_I& y);
 142 };
 143 struct _cl_univpoly_modulops {
 144         // scalar multiplication x*y
 145         const _cl_UP (* scalmul) (cl_heap_univpoly_ring* R, const cl_ring_element& x, const _cl_UP& y);
 146 };
 147 struct _cl_univpoly_polyops {
 148         // degree
 149         sintL (* degree) (cl_heap_univpoly_ring* R, const _cl_UP& x);
 150         // low degree
 151         sintL (* ldegree) (cl_heap_univpoly_ring* R, const _cl_UP& x);
 152         // monomial
 153         const _cl_UP (* monomial) (cl_heap_univpoly_ring* R, const cl_ring_element& x, uintL e);
 154         // coefficient (0 if index>degree)
 155         const cl_ring_element (* coeff) (cl_heap_univpoly_ring* R, const _cl_UP& x, uintL index);
 156         // create new polynomial, bounded degree
 157         const _cl_UP (* create) (cl_heap_univpoly_ring* R, sintL deg);
 158         // set coefficient in new polynomial
 159         void (* set_coeff) (cl_heap_univpoly_ring* R, _cl_UP& x, uintL index, const cl_ring_element& y);
 160         // finalize polynomial
 161         void (* finalize) (cl_heap_univpoly_ring* R, _cl_UP& x);
 162         // evaluate, substitute an element of R
 163         const cl_ring_element (* eval) (cl_heap_univpoly_ring* R, const _cl_UP& x, const cl_ring_element& y);
 164 };
 165   typedef const _cl_univpoly_setops  cl_univpoly_setops;
 166   typedef const _cl_univpoly_addops  cl_univpoly_addops;
 167   typedef const _cl_univpoly_mulops  cl_univpoly_mulops;
 168   typedef const _cl_univpoly_modulops  cl_univpoly_modulops;
 169   typedef const _cl_univpoly_polyops  cl_univpoly_polyops;
 170
 171 // Representation of a univariate polynomial ring.
 172
 173 class cl_heap_univpoly_ring /* cf. cl_heap_ring */ : public cl_heap {
 174         SUBCLASS_cl_heap_ring()
 175 private:
 176         cl_property_list properties;
 177 protected:
 178         cl_univpoly_setops* setops;
 179         cl_univpoly_addops* addops;
 180         cl_univpoly_mulops* mulops;
 181         cl_univpoly_modulops* modulops;
 182         cl_univpoly_polyops* polyops;
 183 protected:
 184         cl_ring _basering;      // the coefficients are elements of this ring
 185 public:
 186         const cl_ring& basering () const { return _basering; }
 187 public:
 188         // Low-level operations.
 189         void _fprint (std::ostream& stream, const _cl_UP& x)
 190                 { setops->fprint(this,stream,x); }
 191         bool _equal (const _cl_UP& x, const _cl_UP& y)
 192                 { return setops->equal(this,x,y); }
 193         const _cl_UP _zero ()
 194                 { return addops->zero(this); }
 195         bool _zerop (const _cl_UP& x)
 196                 { return addops->zerop(this,x); }
 197         const _cl_UP _plus (const _cl_UP& x, const _cl_UP& y)
 198                 { return addops->plus(this,x,y); }
 199         const _cl_UP _minus (const _cl_UP& x, const _cl_UP& y)
 200                 { return addops->minus(this,x,y); }
 201         const _cl_UP _uminus (const _cl_UP& x)
 202                 { return addops->uminus(this,x); }
 203         const _cl_UP _one ()
 204                 { return mulops->one(this); }
 205         const _cl_UP _canonhom (const cl_I& x)
 206                 { return mulops->canonhom(this,x); }
 207         const _cl_UP _mul (const _cl_UP& x, const _cl_UP& y)
 208                 { return mulops->mul(this,x,y); }
 209         const _cl_UP _square (const _cl_UP& x)
 210                 { return mulops->square(this,x); }
 211         const _cl_UP _expt_pos (const _cl_UP& x, const cl_I& y)
 212                 { return mulops->expt_pos(this,x,y); }
 213         const _cl_UP _scalmul (const cl_ring_element& x, const _cl_UP& y)
 214                 { return modulops->scalmul(this,x,y); }
 215         sintL _degree (const _cl_UP& x)
 216                 { return polyops->degree(this,x); }
 217         sintL _ldegree (const _cl_UP& x)
 218                 { return polyops->ldegree(this,x); }
 219         const _cl_UP _monomial (const cl_ring_element& x, uintL e)
 220                 { return polyops->monomial(this,x,e); }
 221         const cl_ring_element _coeff (const _cl_UP& x, uintL index)
 222                 { return polyops->coeff(this,x,index); }
 223         const _cl_UP _create (sintL deg)
 224                 { return polyops->create(this,deg); }
 225         void _set_coeff (_cl_UP& x, uintL index, const cl_ring_element& y)
 226                 { polyops->set_coeff(this,x,index,y); }
 227         void _finalize (_cl_UP& x)
 228                 { polyops->finalize(this,x); }
 229         const cl_ring_element _eval (const _cl_UP& x, const cl_ring_element& y)
 230                 { return polyops->eval(this,x,y); }
 231         // High-level operations.
 232         void fprint (std::ostream& stream, const cl_UP& x)
 233         {
 234                 if (!(x.ring() == this)) throw runtime_exception();
 235                 _fprint(stream,x);
 236         }
 237         bool equal (const cl_UP& x, const cl_UP& y)
 238         {
 239                 if (!(x.ring() == this)) throw runtime_exception();
 240                 if (!(y.ring() == this)) throw runtime_exception();
 241                 return _equal(x,y);
 242         }
 243         const cl_UP zero ()
 244         {
 245                 return cl_UP(this,_zero());
 246         }
 247         bool zerop (const cl_UP& x)
 248         {
 249                 if (!(x.ring() == this)) throw runtime_exception();
 250                 return _zerop(x);
 251         }
 252         const cl_UP plus (const cl_UP& x, const cl_UP& y)
 253         {
 254                 if (!(x.ring() == this)) throw runtime_exception();
 255                 if (!(y.ring() == this)) throw runtime_exception();
 256                 return cl_UP(this,_plus(x,y));
 257         }
 258         const cl_UP minus (const cl_UP& x, const cl_UP& y)
 259         {
 260                 if (!(x.ring() == this)) throw runtime_exception();
 261                 if (!(y.ring() == this)) throw runtime_exception();
 262                 return cl_UP(this,_minus(x,y));
 263         }
 264         const cl_UP uminus (const cl_UP& x)
 265         {
 266                 if (!(x.ring() == this)) throw runtime_exception();
 267                 return cl_UP(this,_uminus(x));
 268         }
 269         const cl_UP one ()
 270         {
 271                 return cl_UP(this,_one());
 272         }
 273         const cl_UP canonhom (const cl_I& x)
 274         {
 275                 return cl_UP(this,_canonhom(x));
 276         }
 277         const cl_UP mul (const cl_UP& x, const cl_UP& y)
 278         {
 279                 if (!(x.ring() == this)) throw runtime_exception();
 280                 if (!(y.ring() == this)) throw runtime_exception();
 281                 return cl_UP(this,_mul(x,y));
 282         }
 283         const cl_UP square (const cl_UP& x)
 284         {
 285                 if (!(x.ring() == this)) throw runtime_exception();
 286                 return cl_UP(this,_square(x));
 287         }
 288         const cl_UP expt_pos (const cl_UP& x, const cl_I& y)
 289         {
 290                 if (!(x.ring() == this)) throw runtime_exception();
 291                 return cl_UP(this,_expt_pos(x,y));
 292         }
 293         const cl_UP scalmul (const cl_ring_element& x, const cl_UP& y)
 294         {
 295                 if (!(y.ring() == this)) throw runtime_exception();
 296                 return cl_UP(this,_scalmul(x,y));
 297         }
 298         sintL degree (const cl_UP& x)
 299         {
 300                 if (!(x.ring() == this)) throw runtime_exception();
 301                 return _degree(x);
 302         }
 303         sintL ldegree (const cl_UP& x)
 304         {
 305                 if (!(x.ring() == this)) throw runtime_exception();
 306                 return _ldegree(x);
 307         }
 308         const cl_UP monomial (const cl_ring_element& x, uintL e)
 309         {
 310                 return cl_UP(this,_monomial(x,e));
 311         }
 312         const cl_ring_element coeff (const cl_UP& x, uintL index)
 313         {
 314                 if (!(x.ring() == this)) throw runtime_exception();
 315                 return _coeff(x,index);
 316         }
 317         const cl_UP create (sintL deg)
 318         {
 319                 return cl_UP(this,_create(deg));
 320         }
 321         void set_coeff (cl_UP& x, uintL index, const cl_ring_element& y)
 322         {
 323                 if (!(x.ring() == this)) throw runtime_exception();
 324                 _set_coeff(x,index,y);
 325         }
 326         void finalize (cl_UP& x)
 327         {
 328                 if (!(x.ring() == this)) throw runtime_exception();
 329                 _finalize(x);
 330         }
 331         const cl_ring_element eval (const cl_UP& x, const cl_ring_element& y)
 332         {
 333                 if (!(x.ring() == this)) throw runtime_exception();
 334                 return _eval(x,y);
 335         }
 336         // Property operations.
 337         cl_property* get_property (const cl_symbol& key)
 338                 { return properties.get_property(key); }
 339         void add_property (cl_property* new_property)
 340                 { properties.add_property(new_property); }
 341 // Constructor.
 342         cl_heap_univpoly_ring (const cl_ring& r, cl_univpoly_setops*, cl_univpoly_addops*, cl_univpoly_mulops*, cl_univpoly_modulops*, cl_univpoly_polyops*);
 343         ~cl_heap_univpoly_ring () {}
 344 };
 345 #define SUBCLASS_cl_heap_univpoly_ring() \
 346   SUBCLASS_cl_heap_ring()
 347
 348
 349 // Lookup or create the "standard" univariate polynomial ring over a ring r.
 350 extern const cl_univpoly_ring find_univpoly_ring (const cl_ring& r);
 351 //CL_REQUIRE(cl_UP_unnamed)
 352
 353 // Lookup or create a univariate polynomial ring with a named variable over r.
 354 extern const cl_univpoly_ring find_univpoly_ring (const cl_ring& r, const cl_symbol& varname);
 355 //CL_REQUIRE(cl_UP_named)
 356
 357 CL_REQUIRE(cl_UP)
 358
 359
 360 // Operations on polynomials.
 361
 362 // Output.
 363 inline void fprint (std::ostream& stream, const cl_UP& x)
 364         { x.ring()->fprint(stream,x); }
 365 CL_DEFINE_PRINT_OPERATOR(cl_UP)
 366
 367 // Add.
 368 inline const cl_UP operator+ (const cl_UP& x, const cl_UP& y)
 369         { return x.ring()->plus(x,y); }
 370
 371 // Negate.
 372 inline const cl_UP operator- (const cl_UP& x)
 373         { return x.ring()->uminus(x); }
 374
 375 // Subtract.
 376 inline const cl_UP operator- (const cl_UP& x, const cl_UP& y)
 377         { return x.ring()->minus(x,y); }
 378
 379 // Equality.
 380 inline bool operator== (const cl_UP& x, const cl_UP& y)
 381         { return x.ring()->equal(x,y); }
 382 inline bool operator!= (const cl_UP& x, const cl_UP& y)
 383         { return !x.ring()->equal(x,y); }
 384
 385 // Compare against 0.
 386 inline bool zerop (const cl_UP& x)
 387         { return x.ring()->zerop(x); }
 388
 389 // Multiply.
 390 inline const cl_UP operator* (const cl_UP& x, const cl_UP& y)
 391         { return x.ring()->mul(x,y); }
 392
 393 // Squaring.
 394 inline const cl_UP square (const cl_UP& x)
 395         { return x.ring()->square(x); }
 396
 397 // Exponentiation x^y, where y > 0.
 398 inline const cl_UP expt_pos (const cl_UP& x, const cl_I& y)
 399         { return x.ring()->expt_pos(x,y); }
 400
 401 // Scalar multiplication.
 402 #if 0 // less efficient
 403 inline const cl_UP operator* (const cl_I& x, const cl_UP& y)
 404         { return y.ring()->mul(y.ring()->canonhom(x),y); }
 405 inline const cl_UP operator* (const cl_UP& x, const cl_I& y)
 406         { return x.ring()->mul(x.ring()->canonhom(y),x); }
 407 #endif
 408 inline const cl_UP operator* (const cl_I& x, const cl_UP& y)
 409         { return y.ring()->scalmul(y.ring()->basering()->canonhom(x),y); }
 410 inline const cl_UP operator* (const cl_UP& x, const cl_I& y)
 411         { return x.ring()->scalmul(x.ring()->basering()->canonhom(y),x); }
 412 inline const cl_UP operator* (const cl_ring_element& x, const cl_UP& y)
 413         { return y.ring()->scalmul(x,y); }
 414 inline const cl_UP operator* (const cl_UP& x, const cl_ring_element& y)
 415         { return x.ring()->scalmul(y,x); }
 416
 417 // Degree.
 418 inline sintL degree (const cl_UP& x)
 419         { return x.ring()->degree(x); }
 420
 421 // Low degree.
 422 inline sintL ldegree (const cl_UP& x)
 423         { return x.ring()->ldegree(x); }
 424
 425 // Coefficient.
 426 inline const cl_ring_element coeff (const cl_UP& x, uintL index)
 427         { return x.ring()->coeff(x,index); }
 428
 429 // Destructive modification.
 430 inline void set_coeff (cl_UP& x, uintL index, const cl_ring_element& y)
 431         { x.ring()->set_coeff(x,index,y); }
 432 inline void finalize (cl_UP& x)
 433         { x.ring()->finalize(x); }
 434 inline void cl_UP::set_coeff (uintL index, const cl_ring_element& y)
 435         { ring()->set_coeff(*this,index,y); }
 436 inline void cl_UP::finalize ()
 437         { ring()->finalize(*this); }
 438
 439 // Evaluation. (No extension of the base ring allowed here for now.)
 440 inline const cl_ring_element cl_UP::operator() (const cl_ring_element& y) const
 441 {
 442         return ring()->eval(*this,y);
 443 }
 444
 445 // Derivative.
 446 extern const cl_UP deriv (const cl_UP& x);
 447
 448
 449 // Ring of uninitialized elements.
 450 // Any operation results in a run-time error.
 451
 452 extern const cl_univpoly_ring cl_no_univpoly_ring;
 453 extern cl_class cl_class_no_univpoly_ring;
 454 CL_REQUIRE(cl_UP_no_ring)
 455
 456 inline cl_univpoly_ring::cl_univpoly_ring ()
 457         : cl_ring (as_cl_private_thing(cl_no_univpoly_ring)) {}
 458 inline _cl_UP::_cl_UP ()
 459         : rep ((cl_private_thing) cl_combine(cl_FN_tag,0)) {}
 460 inline cl_UP::cl_UP ()
 461         : _cl_UP (), _ring () {}
 462
 463
 464 // Debugging support.
 465 #ifdef CL_DEBUG
 466 extern int cl_UP_debug_module;
 467 CL_FORCE_LINK(cl_UP_debug_dummy, cl_UP_debug_module)
 468 #endif
 469
 470 }  // namespace cln
 471
 472 #endif /* _CL_UNIVPOLY_H */
 473
 474 namespace cln {
 475
 476 // Templates for univariate polynomials of complex/real/rational/integers.
 477
 478 #ifdef notyet
 479 // Unfortunately, this is not usable now, because of gcc-2.7 bugs:
 480 // - A template inline function is not inline in the first function that
 481 //   uses it.
 482 // - Argument matching bug: User-defined conversions are not tried (or
 483 //   tried with too low priority) for template functions w.r.t. normal
 484 //   functions. For example, a call expt_pos(cl_UP_specialized<cl_N>,int)
 485 //   is compiled as expt_pos(const cl_UP&, const cl_I&) instead of
 486 //   expt_pos(const cl_UP_specialized<cl_N>&, const cl_I&).
 487 // It will, however, be usable when gcc-2.8 is released.
 488
 489 #if defined(_CL_UNIVPOLY_COMPLEX_H) || defined(_CL_UNIVPOLY_REAL_H) || defined(_CL_UNIVPOLY_RATIONAL_H) || defined(_CL_UNIVPOLY_INTEGER_H)
 490 #ifndef _CL_UNIVPOLY_AUX_H
 491
 492 // Normal univariate polynomials with stricter static typing:
 493 // `class T' instead of `cl_ring_element'.
 494
 495 template <class T> class cl_univpoly_specialized_ring;
 496 template <class T> class cl_UP_specialized;
 497 template <class T> class cl_heap_univpoly_specialized_ring;
 498
 499 template <class T>
 500 class cl_univpoly_specialized_ring : public cl_univpoly_ring {
 501 public:
 502         // Default constructor.
 503         cl_univpoly_specialized_ring () : cl_univpoly_ring () {}
 504         // Copy constructor.
 505         cl_univpoly_specialized_ring (const cl_univpoly_specialized_ring&);
 506         // Assignment operator.
 507         cl_univpoly_specialized_ring& operator= (const cl_univpoly_specialized_ring&);
 508         // Automatic dereferencing.
 509         cl_heap_univpoly_specialized_ring<T>* operator-> () const
 510         { return (cl_heap_univpoly_specialized_ring<T>*)heappointer; }
 511 };
 512 // Copy constructor and assignment operator.
 513 template <class T>
 514 _CL_DEFINE_COPY_CONSTRUCTOR2(cl_univpoly_specialized_ring<T>,cl_univpoly_specialized_ring,cl_univpoly_ring)
 515 template <class T>
 516 CL_DEFINE_ASSIGNMENT_OPERATOR(cl_univpoly_specialized_ring<T>,cl_univpoly_specialized_ring<T>)
 517
 518 template <class T>
 519 class cl_UP_specialized : public cl_UP {
 520 public:
 521         const cl_univpoly_specialized_ring<T>& ring () const { return The(cl_univpoly_specialized_ring<T>)(_ring); }
 522         // Conversion.
 523         CL_DEFINE_CONVERTER(cl_ring_element)
 524         // Destructive modification.
 525         void set_coeff (uintL index, const T& y);
 526         void finalize();
 527         // Evaluation.
 528         const T operator() (const T& y) const;
 529 public: // Ability to place an object at a given address.
 530         void* operator new (size_t size) { return malloc_hook(size); }
 531         void* operator new (size_t size, void* ptr) { (void)size; return ptr; }
 532         void operator delete (void* ptr) { free_hook(ptr); }
 533 };
 534
 535 template <class T>
 536 class cl_heap_univpoly_specialized_ring : public cl_heap_univpoly_ring {
 537         SUBCLASS_cl_heap_univpoly_ring()
 538         // High-level operations.
 539         void fprint (std::ostream& stream, const cl_UP_specialized<T>& x)
 540         {
 541                 cl_heap_univpoly_ring::fprint(stream,x);
 542         }
 543         bool equal (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 544         {
 545                 return cl_heap_univpoly_ring::equal(x,y);
 546         }
 547         const cl_UP_specialized<T> zero ()
 548         {
 549                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::zero());
 550         }
 551         bool zerop (const cl_UP_specialized<T>& x)
 552         {
 553                 return cl_heap_univpoly_ring::zerop(x);
 554         }
 555         const cl_UP_specialized<T> plus (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 556         {
 557                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::plus(x,y));
 558         }
 559         const cl_UP_specialized<T> minus (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 560         {
 561                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::minus(x,y));
 562         }
 563         const cl_UP_specialized<T> uminus (const cl_UP_specialized<T>& x)
 564         {
 565                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::uminus(x));
 566         }
 567         const cl_UP_specialized<T> one ()
 568         {
 569                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::one());
 570         }
 571         const cl_UP_specialized<T> canonhom (const cl_I& x)
 572         {
 573                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::canonhom(x));
 574         }
 575         const cl_UP_specialized<T> mul (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 576         {
 577                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::mul(x,y));
 578         }
 579         const cl_UP_specialized<T> square (const cl_UP_specialized<T>& x)
 580         {
 581                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::square(x));
 582         }
 583         const cl_UP_specialized<T> expt_pos (const cl_UP_specialized<T>& x, const cl_I& y)
 584         {
 585                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::expt_pos(x,y));
 586         }
 587         const cl_UP_specialized<T> scalmul (const T& x, const cl_UP_specialized<T>& y)
 588         {
 589                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::scalmul(x,y));
 590         }
 591         sintL degree (const cl_UP_specialized<T>& x)
 592         {
 593                 return cl_heap_univpoly_ring::degree(x);
 594         }
 595         sintL ldegree (const cl_UP_specialized<T>& x)
 596         {
 597                 return cl_heap_univpoly_ring::ldegree(x);
 598         }
 599         const cl_UP_specialized<T> monomial (const T& x, uintL e)
 600         {
 601                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::monomial(cl_ring_element(cl_C_ring??,x),e));
 602         }
 603         const T coeff (const cl_UP_specialized<T>& x, uintL index)
 604         {
 605                 return The(T)(cl_heap_univpoly_ring::coeff(x,index));
 606         }
 607         const cl_UP_specialized<T> create (sintL deg)
 608         {
 609                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::create(deg));
 610         }
 611         void set_coeff (cl_UP_specialized<T>& x, uintL index, const T& y)
 612         {
 613                 cl_heap_univpoly_ring::set_coeff(x,index,cl_ring_element(cl_C_ring??,y));
 614         }
 615         void finalize (cl_UP_specialized<T>& x)
 616         {
 617                 cl_heap_univpoly_ring::finalize(x);
 618         }
 619         const T eval (const cl_UP_specialized<T>& x, const T& y)
 620         {
 621                 return The(T)(cl_heap_univpoly_ring::eval(x,cl_ring_element(cl_C_ring??,y)));
 622         }
 623 private:
 624         // No need for any constructors.
 625         cl_heap_univpoly_specialized_ring ();
 626 };
 627
 628 // Lookup of polynomial rings.
 629 template <class T>
 630 inline const cl_univpoly_specialized_ring<T> find_univpoly_ring (const cl_specialized_number_ring<T>& r)
 631 { return The(cl_univpoly_specialized_ring<T>) (find_univpoly_ring((const cl_ring&)r)); }
 632 template <class T>
 633 inline const cl_univpoly_specialized_ring<T> find_univpoly_ring (const cl_specialized_number_ring<T>& r, const cl_symbol& varname)
 634 { return The(cl_univpoly_specialized_ring<T>) (find_univpoly_ring((const cl_ring&)r,varname)); }
 635
 636 // Operations on polynomials.
 637
 638 // Add.
 639 template <class T>
 640 inline const cl_UP_specialized<T> operator+ (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 641         { return x.ring()->plus(x,y); }
 642
 643 // Negate.
 644 template <class T>
 645 inline const cl_UP_specialized<T> operator- (const cl_UP_specialized<T>& x)
 646         { return x.ring()->uminus(x); }
 647
 648 // Subtract.
 649 template <class T>
 650 inline const cl_UP_specialized<T> operator- (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 651         { return x.ring()->minus(x,y); }
 652
 653 // Multiply.
 654 template <class T>
 655 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 656         { return x.ring()->mul(x,y); }
 657
 658 // Squaring.
 659 template <class T>
 660 inline const cl_UP_specialized<T> square (const cl_UP_specialized<T>& x)
 661         { return x.ring()->square(x); }
 662
 663 // Exponentiation x^y, where y > 0.
 664 template <class T>
 665 inline const cl_UP_specialized<T> expt_pos (const cl_UP_specialized<T>& x, const cl_I& y)
 666         { return x.ring()->expt_pos(x,y); }
 667
 668 // Scalar multiplication.
 669 // Need more discrimination on T ??
 670 template <class T>
 671 inline const cl_UP_specialized<T> operator* (const cl_I& x, const cl_UP_specialized<T>& y)
 672         { return y.ring()->mul(y.ring()->canonhom(x),y); }
 673 template <class T>
 674 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const cl_I& y)
 675         { return x.ring()->mul(x.ring()->canonhom(y),x); }
 676 template <class T>
 677 inline const cl_UP_specialized<T> operator* (const T& x, const cl_UP_specialized<T>& y)
 678         { return y.ring()->scalmul(x,y); }
 679 template <class T>
 680 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const T& y)
 681         { return x.ring()->scalmul(y,x); }
 682
 683 // Coefficient.
 684 template <class T>
 685 inline const T coeff (const cl_UP_specialized<T>& x, uintL index)
 686         { return x.ring()->coeff(x,index); }
 687
 688 // Destructive modification.
 689 template <class T>
 690 inline void set_coeff (cl_UP_specialized<T>& x, uintL index, const T& y)
 691         { x.ring()->set_coeff(x,index,y); }
 692 template <class T>
 693 inline void finalize (cl_UP_specialized<T>& x)
 694         { x.ring()->finalize(x); }
 695 template <class T>
 696 inline void cl_UP_specialized<T>::set_coeff (uintL index, const T& y)
 697         { ring()->set_coeff(*this,index,y); }
 698 template <class T>
 699 inline void cl_UP_specialized<T>::finalize ()
 700         { ring()->finalize(*this); }
 701
 702 // Evaluation. (No extension of the base ring allowed here for now.)
 703 template <class T>
 704 inline const T cl_UP_specialized<T>::operator() (const T& y) const
 705 {
 706         return ring()->eval(*this,y);
 707 }
 708
 709 // Derivative.
 710 template <class T>
 711 inline const cl_UP_specialized<T> deriv (const cl_UP_specialized<T>& x)
 712         { return The(cl_UP_specialized<T>)(deriv((const cl_UP&)x)); }
 713
 714
 715 #endif /* _CL_UNIVPOLY_AUX_H */
 716 #endif
 717
 718 #endif /* notyet */
 719
 720 }  // namespace cln