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         cl_boolean (* 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         cl_boolean (* 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         cl_boolean _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         cl_boolean _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)) cl_abort();
 235                 _fprint(stream,x);
 236         }
 237         cl_boolean equal (const cl_UP& x, const cl_UP& y)
 238         {
 239                 if (!(x.ring() == this)) cl_abort();
 240                 if (!(y.ring() == this)) cl_abort();
 241                 return _equal(x,y);
 242         }
 243         const cl_UP zero ()
 244         {
 245                 return cl_UP(this,_zero());
 246         }
 247         cl_boolean zerop (const cl_UP& x)
 248         {
 249                 if (!(x.ring() == this)) cl_abort();
 250                 return _zerop(x);
 251         }
 252         const cl_UP plus (const cl_UP& x, const cl_UP& y)
 253         {
 254                 if (!(x.ring() == this)) cl_abort();
 255                 if (!(y.ring() == this)) cl_abort();
 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)) cl_abort();
 261                 if (!(y.ring() == this)) cl_abort();
 262                 return cl_UP(this,_minus(x,y));
 263         }
 264         const cl_UP uminus (const cl_UP& x)
 265         {
 266                 if (!(x.ring() == this)) cl_abort();
 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)) cl_abort();
 280                 if (!(y.ring() == this)) cl_abort();
 281                 return cl_UP(this,_mul(x,y));
 282         }
 283         const cl_UP square (const cl_UP& x)
 284         {
 285                 if (!(x.ring() == this)) cl_abort();
 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)) cl_abort();
 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)) cl_abort();
 296                 return cl_UP(this,_scalmul(x,y));
 297         }
 298         sintL degree (const cl_UP& x)
 299         {
 300                 if (!(x.ring() == this)) cl_abort();
 301                 return _degree(x);
 302         }
 303         sintL ldegree (const cl_UP& x)
 304         {
 305                 if (!(x.ring() == this)) cl_abort();
 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)) cl_abort();
 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)) cl_abort();
 324                 _set_coeff(x,index,y);
 325         }
 326         void finalize (cl_UP& x)
 327         {
 328                 if (!(x.ring() == this)) cl_abort();
 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)) cl_abort();
 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 // This class is intented to be subclassable, hence needs a virtual destructor.
 344         virtual ~cl_heap_univpoly_ring () {}
 345 private:
 346         virtual void dummy ();
 347 };
 348 #define SUBCLASS_cl_heap_univpoly_ring() \
 349   SUBCLASS_cl_heap_ring()
 350
 351
 352 // Lookup or create the "standard" univariate polynomial ring over a ring r.
 353 extern const cl_univpoly_ring find_univpoly_ring (const cl_ring& r);
 354 //CL_REQUIRE(cl_UP_unnamed)
 355
 356 // Lookup or create a univariate polynomial ring with a named variable over r.
 357 extern const cl_univpoly_ring find_univpoly_ring (const cl_ring& r, const cl_symbol& varname);
 358 //CL_REQUIRE(cl_UP_named)
 359
 360 CL_REQUIRE(cl_UP)
 361
 362 // Runtime typing support.
 363 extern cl_class cl_class_univpoly_ring;
 364
 365
 366 // Operations on polynomials.
 367
 368 // Output.
 369 inline void fprint (std::ostream& stream, const cl_UP& x)
 370         { x.ring()->fprint(stream,x); }
 371 CL_DEFINE_PRINT_OPERATOR(cl_UP)
 372
 373 // Add.
 374 inline const cl_UP operator+ (const cl_UP& x, const cl_UP& y)
 375         { return x.ring()->plus(x,y); }
 376
 377 // Negate.
 378 inline const cl_UP operator- (const cl_UP& x)
 379         { return x.ring()->uminus(x); }
 380
 381 // Subtract.
 382 inline const cl_UP operator- (const cl_UP& x, const cl_UP& y)
 383         { return x.ring()->minus(x,y); }
 384
 385 // Equality.
 386 inline bool operator== (const cl_UP& x, const cl_UP& y)
 387         { return x.ring()->equal(x,y); }
 388 inline bool operator!= (const cl_UP& x, const cl_UP& y)
 389         { return !x.ring()->equal(x,y); }
 390
 391 // Compare against 0.
 392 inline cl_boolean zerop (const cl_UP& x)
 393         { return x.ring()->zerop(x); }
 394
 395 // Multiply.
 396 inline const cl_UP operator* (const cl_UP& x, const cl_UP& y)
 397         { return x.ring()->mul(x,y); }
 398
 399 // Squaring.
 400 inline const cl_UP square (const cl_UP& x)
 401         { return x.ring()->square(x); }
 402
 403 // Exponentiation x^y, where y > 0.
 404 inline const cl_UP expt_pos (const cl_UP& x, const cl_I& y)
 405         { return x.ring()->expt_pos(x,y); }
 406
 407 // Scalar multiplication.
 408 #if 0 // less efficient
 409 inline const cl_UP operator* (const cl_I& x, const cl_UP& y)
 410         { return y.ring()->mul(y.ring()->canonhom(x),y); }
 411 inline const cl_UP operator* (const cl_UP& x, const cl_I& y)
 412         { return x.ring()->mul(x.ring()->canonhom(y),x); }
 413 #endif
 414 inline const cl_UP operator* (const cl_I& x, const cl_UP& y)
 415         { return y.ring()->scalmul(y.ring()->basering()->canonhom(x),y); }
 416 inline const cl_UP operator* (const cl_UP& x, const cl_I& y)
 417         { return x.ring()->scalmul(x.ring()->basering()->canonhom(y),x); }
 418 inline const cl_UP operator* (const cl_ring_element& x, const cl_UP& y)
 419         { return y.ring()->scalmul(x,y); }
 420 inline const cl_UP operator* (const cl_UP& x, const cl_ring_element& y)
 421         { return x.ring()->scalmul(y,x); }
 422
 423 // Degree.
 424 inline sintL degree (const cl_UP& x)
 425         { return x.ring()->degree(x); }
 426
 427 // Low degree.
 428 inline sintL ldegree (const cl_UP& x)
 429         { return x.ring()->ldegree(x); }
 430
 431 // Coefficient.
 432 inline const cl_ring_element coeff (const cl_UP& x, uintL index)
 433         { return x.ring()->coeff(x,index); }
 434
 435 // Destructive modification.
 436 inline void set_coeff (cl_UP& x, uintL index, const cl_ring_element& y)
 437         { x.ring()->set_coeff(x,index,y); }
 438 inline void finalize (cl_UP& x)
 439         { x.ring()->finalize(x); }
 440 inline void cl_UP::set_coeff (uintL index, const cl_ring_element& y)
 441         { ring()->set_coeff(*this,index,y); }
 442 inline void cl_UP::finalize ()
 443         { ring()->finalize(*this); }
 444
 445 // Evaluation. (No extension of the base ring allowed here for now.)
 446 inline const cl_ring_element cl_UP::operator() (const cl_ring_element& y) const
 447 {
 448         return ring()->eval(*this,y);
 449 }
 450
 451 // Derivative.
 452 extern const cl_UP deriv (const cl_UP& x);
 453
 454
 455 // Ring of uninitialized elements.
 456 // Any operation results in a run-time error.
 457
 458 extern const cl_univpoly_ring cl_no_univpoly_ring;
 459 extern cl_class cl_class_no_univpoly_ring;
 460 CL_REQUIRE(cl_UP_no_ring)
 461
 462 inline cl_univpoly_ring::cl_univpoly_ring ()
 463         : cl_ring (as_cl_private_thing(cl_no_univpoly_ring)) {}
 464 inline _cl_UP::_cl_UP ()
 465         : rep ((cl_private_thing) cl_combine(cl_FN_tag,0)) {}
 466 inline cl_UP::cl_UP ()
 467         : _cl_UP (), _ring () {}
 468
 469
 470 // Debugging support.
 471 #ifdef CL_DEBUG
 472 extern int cl_UP_debug_module;
 473 CL_FORCE_LINK(cl_UP_debug_dummy, cl_UP_debug_module)
 474 #endif
 475
 476 }  // namespace cln
 477
 478 #endif /* _CL_UNIVPOLY_H */
 479
 480 namespace cln {
 481
 482 // Templates for univariate polynomials of complex/real/rational/integers.
 483
 484 #ifdef notyet
 485 // Unfortunately, this is not usable now, because of gcc-2.7 bugs:
 486 // - A template inline function is not inline in the first function that
 487 //   uses it.
 488 // - Argument matching bug: User-defined conversions are not tried (or
 489 //   tried with too low priority) for template functions w.r.t. normal
 490 //   functions. For example, a call expt_pos(cl_UP_specialized<cl_N>,int)
 491 //   is compiled as expt_pos(const cl_UP&, const cl_I&) instead of
 492 //   expt_pos(const cl_UP_specialized<cl_N>&, const cl_I&).
 493 // It will, however, be usable when gcc-2.8 is released.
 494
 495 #if defined(_CL_UNIVPOLY_COMPLEX_H) || defined(_CL_UNIVPOLY_REAL_H) || defined(_CL_UNIVPOLY_RATIONAL_H) || defined(_CL_UNIVPOLY_INTEGER_H)
 496 #ifndef _CL_UNIVPOLY_AUX_H
 497
 498 // Normal univariate polynomials with stricter static typing:
 499 // `class T' instead of `cl_ring_element'.
 500
 501 template <class T> class cl_univpoly_specialized_ring;
 502 template <class T> class cl_UP_specialized;
 503 template <class T> class cl_heap_univpoly_specialized_ring;
 504
 505 template <class T>
 506 class cl_univpoly_specialized_ring : public cl_univpoly_ring {
 507 public:
 508         // Default constructor.
 509         cl_univpoly_specialized_ring () : cl_univpoly_ring () {}
 510         // Copy constructor.
 511         cl_univpoly_specialized_ring (const cl_univpoly_specialized_ring&);
 512         // Assignment operator.
 513         cl_univpoly_specialized_ring& operator= (const cl_univpoly_specialized_ring&);
 514         // Automatic dereferencing.
 515         cl_heap_univpoly_specialized_ring<T>* operator-> () const
 516         { return (cl_heap_univpoly_specialized_ring<T>*)heappointer; }
 517 };
 518 // Copy constructor and assignment operator.
 519 template <class T>
 520 _CL_DEFINE_COPY_CONSTRUCTOR2(cl_univpoly_specialized_ring<T>,cl_univpoly_specialized_ring,cl_univpoly_ring)
 521 template <class T>
 522 CL_DEFINE_ASSIGNMENT_OPERATOR(cl_univpoly_specialized_ring<T>,cl_univpoly_specialized_ring<T>)
 523
 524 template <class T>
 525 class cl_UP_specialized : public cl_UP {
 526 public:
 527         const cl_univpoly_specialized_ring<T>& ring () const { return The(cl_univpoly_specialized_ring<T>)(_ring); }
 528         // Conversion.
 529         CL_DEFINE_CONVERTER(cl_ring_element)
 530         // Destructive modification.
 531         void set_coeff (uintL index, const T& y);
 532         void finalize();
 533         // Evaluation.
 534         const T operator() (const T& y) const;
 535 public: // Ability to place an object at a given address.
 536         void* operator new (size_t size) { return malloc_hook(size); }
 537         void* operator new (size_t size, void* ptr) { (void)size; return ptr; }
 538         void operator delete (void* ptr) { free_hook(ptr); }
 539 };
 540
 541 template <class T>
 542 class cl_heap_univpoly_specialized_ring : public cl_heap_univpoly_ring {
 543         SUBCLASS_cl_heap_univpoly_ring()
 544         // High-level operations.
 545         void fprint (std::ostream& stream, const cl_UP_specialized<T>& x)
 546         {
 547                 cl_heap_univpoly_ring::fprint(stream,x);
 548         }
 549         cl_boolean equal (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 550         {
 551                 return cl_heap_univpoly_ring::equal(x,y);
 552         }
 553         const cl_UP_specialized<T> zero ()
 554         {
 555                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::zero());
 556         }
 557         cl_boolean zerop (const cl_UP_specialized<T>& x)
 558         {
 559                 return cl_heap_univpoly_ring::zerop(x);
 560         }
 561         const cl_UP_specialized<T> plus (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 562         {
 563                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::plus(x,y));
 564         }
 565         const cl_UP_specialized<T> minus (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 566         {
 567                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::minus(x,y));
 568         }
 569         const cl_UP_specialized<T> uminus (const cl_UP_specialized<T>& x)
 570         {
 571                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::uminus(x));
 572         }
 573         const cl_UP_specialized<T> one ()
 574         {
 575                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::one());
 576         }
 577         const cl_UP_specialized<T> canonhom (const cl_I& x)
 578         {
 579                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::canonhom(x));
 580         }
 581         const cl_UP_specialized<T> mul (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 582         {
 583                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::mul(x,y));
 584         }
 585         const cl_UP_specialized<T> square (const cl_UP_specialized<T>& x)
 586         {
 587                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::square(x));
 588         }
 589         const cl_UP_specialized<T> expt_pos (const cl_UP_specialized<T>& x, const cl_I& y)
 590         {
 591                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::expt_pos(x,y));
 592         }
 593         const cl_UP_specialized<T> scalmul (const T& x, const cl_UP_specialized<T>& y)
 594         {
 595                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::scalmul(x,y));
 596         }
 597         sintL degree (const cl_UP_specialized<T>& x)
 598         {
 599                 return cl_heap_univpoly_ring::degree(x);
 600         }
 601         sintL ldegree (const cl_UP_specialized<T>& x)
 602         {
 603                 return cl_heap_univpoly_ring::ldegree(x);
 604         }
 605         const cl_UP_specialized<T> monomial (const T& x, uintL e)
 606         {
 607                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::monomial(cl_ring_element(cl_C_ring??,x),e));
 608         }
 609         const T coeff (const cl_UP_specialized<T>& x, uintL index)
 610         {
 611                 return The(T)(cl_heap_univpoly_ring::coeff(x,index));
 612         }
 613         const cl_UP_specialized<T> create (sintL deg)
 614         {
 615                 return The2(cl_UP_specialized<T>)(cl_heap_univpoly_ring::create(deg));
 616         }
 617         void set_coeff (cl_UP_specialized<T>& x, uintL index, const T& y)
 618         {
 619                 cl_heap_univpoly_ring::set_coeff(x,index,cl_ring_element(cl_C_ring??,y));
 620         }
 621         void finalize (cl_UP_specialized<T>& x)
 622         {
 623                 cl_heap_univpoly_ring::finalize(x);
 624         }
 625         const T eval (const cl_UP_specialized<T>& x, const T& y)
 626         {
 627                 return The(T)(cl_heap_univpoly_ring::eval(x,cl_ring_element(cl_C_ring??,y)));
 628         }
 629 private:
 630         // No need for any constructors.
 631         cl_heap_univpoly_specialized_ring ();
 632 };
 633
 634 // Lookup of polynomial rings.
 635 template <class T>
 636 inline const cl_univpoly_specialized_ring<T> find_univpoly_ring (const cl_specialized_number_ring<T>& r)
 637 { return The(cl_univpoly_specialized_ring<T>) (find_univpoly_ring((const cl_ring&)r)); }
 638 template <class T>
 639 inline const cl_univpoly_specialized_ring<T> find_univpoly_ring (const cl_specialized_number_ring<T>& r, const cl_symbol& varname)
 640 { return The(cl_univpoly_specialized_ring<T>) (find_univpoly_ring((const cl_ring&)r,varname)); }
 641
 642 // Operations on polynomials.
 643
 644 // Add.
 645 template <class T>
 646 inline const cl_UP_specialized<T> operator+ (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 647         { return x.ring()->plus(x,y); }
 648
 649 // Negate.
 650 template <class T>
 651 inline const cl_UP_specialized<T> operator- (const cl_UP_specialized<T>& x)
 652         { return x.ring()->uminus(x); }
 653
 654 // Subtract.
 655 template <class T>
 656 inline const cl_UP_specialized<T> operator- (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 657         { return x.ring()->minus(x,y); }
 658
 659 // Multiply.
 660 template <class T>
 661 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const cl_UP_specialized<T>& y)
 662         { return x.ring()->mul(x,y); }
 663
 664 // Squaring.
 665 template <class T>
 666 inline const cl_UP_specialized<T> square (const cl_UP_specialized<T>& x)
 667         { return x.ring()->square(x); }
 668
 669 // Exponentiation x^y, where y > 0.
 670 template <class T>
 671 inline const cl_UP_specialized<T> expt_pos (const cl_UP_specialized<T>& x, const cl_I& y)
 672         { return x.ring()->expt_pos(x,y); }
 673
 674 // Scalar multiplication.
 675 // Need more discrimination on T ??
 676 template <class T>
 677 inline const cl_UP_specialized<T> operator* (const cl_I& x, const cl_UP_specialized<T>& y)
 678         { return y.ring()->mul(y.ring()->canonhom(x),y); }
 679 template <class T>
 680 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const cl_I& y)
 681         { return x.ring()->mul(x.ring()->canonhom(y),x); }
 682 template <class T>
 683 inline const cl_UP_specialized<T> operator* (const T& x, const cl_UP_specialized<T>& y)
 684         { return y.ring()->scalmul(x,y); }
 685 template <class T>
 686 inline const cl_UP_specialized<T> operator* (const cl_UP_specialized<T>& x, const T& y)
 687         { return x.ring()->scalmul(y,x); }
 688
 689 // Coefficient.
 690 template <class T>
 691 inline const T coeff (const cl_UP_specialized<T>& x, uintL index)
 692         { return x.ring()->coeff(x,index); }
 693
 694 // Destructive modification.
 695 template <class T>
 696 inline void set_coeff (cl_UP_specialized<T>& x, uintL index, const T& y)
 697         { x.ring()->set_coeff(x,index,y); }
 698 template <class T>
 699 inline void finalize (cl_UP_specialized<T>& x)
 700         { x.ring()->finalize(x); }
 701 template <class T>
 702 inline void cl_UP_specialized<T>::set_coeff (uintL index, const T& y)
 703         { ring()->set_coeff(*this,index,y); }
 704 template <class T>
 705 inline void cl_UP_specialized<T>::finalize ()
 706         { ring()->finalize(*this); }
 707
 708 // Evaluation. (No extension of the base ring allowed here for now.)
 709 template <class T>
 710 inline const T cl_UP_specialized<T>::operator() (const T& y) const
 711 {
 712         return ring()->eval(*this,y);
 713 }
 714
 715 // Derivative.
 716 template <class T>
 717 inline const cl_UP_specialized<T> deriv (const cl_UP_specialized<T>& x)
 718         { return The(cl_UP_specialized<T>)(deriv((const cl_UP&)x)); }
 719
 720
 721 #endif /* _CL_UNIVPOLY_AUX_H */
 722 #endif
 723
 724 #endif /* notyet */
 725
 726 }  // namespace cln