From c597eb5534a61a742ac4f2792b5b1760d34a794a Mon Sep 17 00:00:00 2001 From: Richard Kreckel Date: Fri, 5 May 2000 18:01:35 +0000 Subject: [PATCH] - Upgraded texinfo.tex to newer version 1999-10-01.07, which also triggered lots of style changes. - Documented use of external GMP. - Fixed some index entries. --- doc/cln.dvi | Bin 257596 -> 258328 bytes doc/cln.html | 946 +++--- doc/cln.info | 224 +- doc/cln.ps | 8242 +++++++++++++++++++++++----------------------- doc/cln.tex | 58 +- doc/cln.texi | 70 +- doc/cln_1.html | 2 +- doc/cln_10.html | 28 +- doc/cln_11.html | 26 +- doc/cln_12.html | 24 +- doc/cln_13.html | 4 +- doc/cln_2.html | 45 +- doc/cln_3.html | 60 +- doc/cln_4.html | 448 +-- doc/cln_5.html | 18 +- doc/cln_6.html | 4 +- doc/cln_7.html | 68 +- doc/cln_8.html | 28 +- doc/cln_9.html | 78 +- doc/cln_toc.html | 139 +- doc/texinfo.tex | 4769 +++++++++++++++++---------- 21 files changed, 8430 insertions(+), 6851 deletions(-) diff --git a/doc/cln.dvi b/doc/cln.dvi index 086cf54ac849ccff0928188b6bc52f3035b1a310..00de7ca85f3131f997e90b4c356130f51826522b 100644 GIT binary patch literal 258328 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 Qd#!(V)Er;vd<*^e|8(Y=d;kCd literal 257596 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 - + CLN, a Class Library for Numbers @@ -21,99 +21,102 @@
  • 2.2 Building the library -
  • 2.3 Installing the library -
  • 2.4 Cleaning up + +
  • 2.3 Installing the library +
  • 2.4 Cleaning up -
  • 3. Ordinary number types +
  • 3. Ordinary number types -
  • 4. Functions on numbers +
  • 4. Functions on numbers -
  • 5. Input/Output +
  • 5. Input/Output -
  • 6. Rings -
  • 7. Modular integers +
  • 6. Rings +
  • 7. Modular integers -
  • 8. Symbolic data types +
  • 8. Symbolic data types -
  • 9. Univariate polynomials +
  • 9. Univariate polynomials -
  • 10. Internals +
  • 10. Internals -
  • 11. Using the library +
  • 11. Using the library -
  • 12. Customizing +
  • 12. Customizing -
  • Index +
  • Index

    @@ -316,21 +319,23 @@ of static and global variables, a feature which I could implement for GNU g++ only. -

    -

    2.1.2 Make utility

    +

    + +

    To build CLN, you also need to have GNU make installed. -

    -

    2.1.3 Sed utility

    +

    + +

    To build CLN on HP-UX, you also need to have GNU sed installed. @@ -466,11 +471,40 @@ library. -

    2.3 Installing the library

    +

    2.2.1 Using the GNU MP Library

    +

    +Starting with version 1.0.4, CLN may be configured to make use of a +preinstalled gmp library. Please make sure that you have at +least gmp version 3.0 installed since earlier versions are +unsupported and likely not to work. Enabling this feature by calling +configure with the option `--with-gmp' is known to be quite +a boost for CLN's performance. + + +

    +If you have installed the gmp library and its header file in +some place where your compiler cannot find it by default, you must help +configure by setting CPPFLAGS and LDFLAGS. Here is +an example: + + + +

    +$ CC="gcc" CFLAGS="-O2" CXX="g++" CXXFLAGS="-O2 -fno-exceptions" \
+  CPPFLAGS="-I/opt/gmp/include" LDFLAGS="-L/opt/gmp/lib" ./configure --with-gmp
+
    + + + +

    2.3 Installing the library

    +

    + + +

    As with any autoconfiguring GNU software, installation is as easy as this: @@ -496,7 +530,7 @@ the --prefix=... option. -

    2.4 Cleaning up

    +

    2.4 Cleaning up

    You can remove system-dependent files generated by make through @@ -519,7 +553,7 @@ $ make distclean -

    3. Ordinary number types

    +

    3. Ordinary number types

    CLN implements the following class hierarchy: @@ -555,8 +589,8 @@ Rational number Floating-point number

    - + The base class cl_number is an abstract base class. It is not useful to declare a variable of this type except if you want to completely disable compile-time type checking and use run-time type @@ -564,24 +598,24 @@ checking instead.

    - + The class cl_N comprises real and complex numbers. There is no special class for complex numbers since complex numbers with imaginary part 0 are automatically converted to real numbers.

    - + The class cl_R comprises real numbers of different kinds. It is an abstract class.

    - + The class cl_RA comprises exact real numbers: rational numbers, including integers. There is no special class for non-integral rational numbers since rational numbers with denominator 1 are automatically converted @@ -589,16 +623,16 @@ to integers.

    - + The class cl_F implements floating-point approximations to real numbers. It is an abstract class. -

    3.1 Exact numbers

    +

    3.1 Exact numbers

    - +

    @@ -640,9 +674,9 @@ is completely transparent. -

    3.2 Floating-point numbers

    +

    3.2 Floating-point numbers

    - +

    @@ -654,7 +688,7 @@ CLN implements ordinary floating-point numbers, with mantissa and exponent.

    - + The elementary operations (+, -, *, /, ...) only return approximate results. For example, the value of the expression (cl_F) 0.3 + (cl_F) 0.4 prints as `0.70000005', not as @@ -685,7 +719,7 @@ Floating point numbers come in four flavors:

    • - + Short floats, type cl_SF. They have 1 sign bit, 8 exponent bits (including the exponent's sign), and 17 mantissa bits (including the "hidden" bit). @@ -693,7 +727,7 @@ They don't consume heap allocation.
    • - + Single floats, type cl_FF. They have 1 sign bit, 8 exponent bits (including the exponent's sign), and 24 mantissa bits (including the "hidden" bit). @@ -702,7 +736,7 @@ This corresponds closely to the C/C++ type `float'.
    • - + Double floats, type cl_DF. They have 1 sign bit, 11 exponent bits (including the exponent's sign), and 53 mantissa bits (including the "hidden" bit). @@ -711,7 +745,7 @@ This corresponds closely to the C/C++ type `double'.
    • - + Long floats, type cl_LF. They have 1 sign bit, 32 exponent bits (including the exponent's sign), and n mantissa bits (including the "hidden" bit), where n >= 64. @@ -732,7 +766,7 @@ with larger exponent range.

      - + As a user of CLN, you can forget about the differences between the four floating-point types and just declare all your floating-point variables as being of type cl_F. This has the advantage that @@ -747,9 +781,9 @@ the floating point contagion rule happened to change in the future.) -

      3.3 Complex numbers

      +

      3.3 Complex numbers

      - +

      @@ -766,9 +800,9 @@ through application of sqrt or transcendental functions. -

      3.4 Conversions

      +

      3.4 Conversions

      - +

      @@ -827,7 +861,7 @@ Conversions from `const char *' are provided for the classes cl_R, cl_N. The easiest way to specify a value which is outside of the range of the C++ built-in types is therefore to specify it as a string, like this: - + 

          cl_I order_of_rubiks_cube_group = "43252003274489856000";
@@ -847,16 +881,16 @@ the functions
 
 
      int cl_I_to_int (const cl_I& x)
 
      
-
+
 
      unsigned int cl_I_to_uint (const cl_I& x)
 
      
-
+
 
      long cl_I_to_long (const cl_I& x)
 
      
-
+
 
      unsigned long cl_I_to_ulong (const cl_I& x)
 
      
-
+
 Returns x as element of the C type ctype. If x is not
 representable in the range of ctype, a runtime error occurs.
 
@@ -873,10 +907,10 @@ the functions
 
 
      float cl_float_approx (const type& x)
 
      
-
+
 
      double cl_double_approx (const type& x)
 
      
-
+
 Returns an approximation of x of C type ctype.
 If abs(x) is too close to 0 (underflow), 0 is returned.
 If abs(x) is too large (overflow), an IEEE infinity is returned.
@@ -887,10 +921,10 @@ Conversions from any class to any of its subclasses ("derived classes" in
 C++ terminology) are not provided. Instead, you can assert and check
 that a value belongs to a certain subclass, and return it as element of that
 class, using the `As' and `The' macros.
-
+
 As(type)(value) checks that value belongs to
 type and returns it as such.
-
+
 The(type)(value) assumes that value belongs to
 type and returns it as such. It is your responsibility to ensure
 that this assumption is valid.
@@ -907,7 +941,7 @@ Example:
 
 
 
-
      4. Functions on numbers
      
+
      4. Functions on numbers
      
 
 
      
 Each of the number classes declares its mathematical operations in the
@@ -917,7 +951,7 @@ objects of type cl_I, it should #include <cl_integer.h
 
 
 
-
      4.1 Constructing numbers
      
+
      4.1 Constructing numbers
      
 
 
      
 Here is how to create number objects "from nothing".
@@ -925,37 +959,37 @@ Here is how to create number objects "from nothing".
 
 
 
-
      4.1.1 Constructing integers
      
+
      4.1.1 Constructing integers
      
 
 
      
 cl_I objects are most easily constructed from C integers and from
-strings. See section 3.4 Conversions.
+strings. See section 3.4 Conversions.
 
 
 
 
-
      4.1.2 Constructing rational numbers
      
+
      4.1.2 Constructing rational numbers
      
 
 
      
 cl_RA objects can be constructed from strings. The syntax
-for rational numbers is described in section 5.1 Internal and printed representation.
+for rational numbers is described in section 5.1 Internal and printed representation.
 Another standard way to produce a rational number is through application
 of `operator /' or `recip' on integers.
 
 
 
 
-
      4.1.3 Constructing floating-point numbers
      
+
      4.1.3 Constructing floating-point numbers
      
 
 
      
 cl_F objects with low precision are most easily constructed from
-C `float' and `double'. See section 3.4 Conversions.
+C `float' and `double'. See section 3.4 Conversions.
 
 
 
      
 To construct a cl_F with high precision, you can use the conversion
 from `const char *', but you have to specify the desired precision
-within the string. (See section 5.1 Internal and printed representation.)
+within the string. (See section 5.1 Internal and printed representation.)
 Example:
 
 
      @@ -969,7 +1003,7 @@ will set `e' to the given value, with a precision of 40 decimal dig
 
      
 The programmatic way to construct a cl_F with high precision is
 through the cl_float conversion function, see
-section 4.11.1 Conversion to floating-point numbers. For example, to compute
+section 4.11.1 Conversion to floating-point numbers. For example, to compute
 e to 40 decimal places, first construct 1.0 to 40 decimal places
 and then apply the exponential function:
 
@@ -980,7 +1014,7 @@ and then apply the exponential function:
 
 
 
-
      4.1.4 Constructing complex numbers
      
+
      4.1.4 Constructing complex numbers
      
 
 
      
 Non-real cl_N objects are normally constructed through the function
@@ -990,12 +1024,12 @@ Non-real cl_N objects are normally constructed through the function
 
      
 
 
      
-See section 4.4 Elementary complex functions.
+See section 4.4 Elementary complex functions.
 
 
 
 
-
      4.2 Elementary functions
      
+
      4.2 Elementary functions
      
 
 
      
 Each of the classes cl_N, cl_R, cl_RA, cl_I,
@@ -1007,12 +1041,12 @@ defines the following operations:
 
 
      type operator + (const type&, const type&)
 
      
-
+
 Addition.
 
 
      type operator - (const type&, const type&)
 
      
-
+
 Subtraction.
 
 
      type operator - (const type&)
@@ -1021,22 +1055,22 @@ Returns the negative of the argument.
 
 
      type plus1 (const type& x)
 
      
-
+
 Returns x + 1.
 
 
      type minus1 (const type& x)
 
      
-
+
 Returns x - 1.
 
 
      type operator * (const type&, const type&)
 
      
-
+
 Multiplication.
 
 
      type square (const type& x)
 
      
-
+
 Returns x * x.
 
 
@@ -1050,12 +1084,12 @@ defines the following operations:
 
 
      type operator / (const type&, const type&)
 
      
-
+
 Division.
 
 
      type recip (const type&)
 
      
-
+
 Returns the reciprocal of the argument.
 
 
@@ -1063,7 +1097,7 @@ Returns the reciprocal of the argument.
 The class cl_I doesn't define a `/' operation because
 in the C/C++ language this operator, applied to integral types,
 denotes the `floor' or `truncate' operation (which one of these,
-is implementation dependent). (See section 4.6 Rounding functions)
+is implementation dependent). (See section 4.6 Rounding functions.)
 Instead, cl_I defines an "exact quotient" function:
 
 
@@ -1071,7 +1105,7 @@ Instead, cl_I defines an "exact quotient" function:
 
 
      cl_I exquo (const cl_I& x, const cl_I& y)
 
      
-
+
 Checks that y divides x, and returns the quotient x/y.
 
 
@@ -1083,14 +1117,14 @@ The following exponentiation functions are defined:
 
 
      cl_I expt_pos (const cl_I& x, const cl_I& y)
 
      
-
+
 
      cl_RA expt_pos (const cl_RA& x, const cl_I& y)
 
      
 y must be > 0. Returns x^y.
 
 
      cl_RA expt (const cl_RA& x, const cl_I& y)
 
      
-
+
 
      cl_R expt (const cl_R& x, const cl_I& y)
 
      
 
      cl_N expt (const cl_N& x, const cl_I& y)
@@ -1108,7 +1142,7 @@ defines the following operation:
 
 
      type abs (const type& x)
 
      
-
+
 Returns the absolute value of x.
 This is x if x >= 0, and -x if x <= 0.
 
@@ -1134,7 +1168,7 @@ defines the following operation:
 
 
      type signum (const type& x)
 
      
-
+
 Returns the sign of x, in the same number format as x.
 This is defined as x / abs(x) if x is non-zero, and
 x if x is zero. If x is real, the value is either
@@ -1143,7 +1177,7 @@ This is defined as x / abs(x) if x is non-zero, and
 
 
 
-
      4.3 Elementary rational functions
      
+
      4.3 Elementary rational functions
      
 
 
      
 Each of the classes cl_RA, cl_I defines the following operations:
@@ -1153,12 +1187,12 @@ Each of the classes cl_RA, cl_I defines the following
 
 
      cl_I numerator (const type& x)
 
      
-
+
 Returns the numerator of x.
 
 
      cl_I denominator (const type& x)
 
      
-
+
 Returns the denominator of x.
 
 
@@ -1169,7 +1203,7 @@ a way that they have no factor in common and the denominator is positive.
 
 
 
-
      4.4 Elementary complex functions
      
+
      4.4 Elementary complex functions
      
 
 
      
 The class cl_N defines the following operation:
@@ -1179,7 +1213,7 @@ The class cl_N defines the following operation:
 
 
      cl_N complex (const cl_R& a, const cl_R& b)
 
      
-
+
 Returns the complex number a+bi, that is, the complex number with
 real part a and imaginary part b.
 
@@ -1192,17 +1226,17 @@ Each of the classes cl_N, cl_R defines the following o
 
 
      cl_R realpart (const type& x)
 
      
-
+
 Returns the real part of x.
 
 
      cl_R imagpart (const type& x)
 
      
-
+
 Returns the imaginary part of x.
 
 
      type conjugate (const type& x)
 
      
-
+
 Returns the complex conjugate of x.
 
 
@@ -1222,9 +1256,9 @@ We have the relations
 
 
 
-
      4.5 Comparisons
      
+
      4.5 Comparisons
      
 
      
-
+
 
 
 
      
@@ -1237,22 +1271,22 @@ defines the following operations:
 
 
      bool operator == (const type&, const type&)
 
      
-
+
 
      bool operator != (const type&, const type&)
 
      
-
+
 Comparison, as in C and C++.
 
 
      uint32 cl_equal_hashcode (const type&)
 
      
-
+
 Returns a 32-bit hash code that is the same for any two numbers which are
 the same according to ==. This hash code depends on the number's value,
 not its type or precision.
 
 
      cl_boolean zerop (const type& x)
 
      
-
+
 Compare against zero: x == 0
 
 
@@ -1266,42 +1300,42 @@ defines the following operations:
 
 
      cl_signean cl_compare (const type& x, const type& y)
 
      
-
+
 Compares x and y. Returns +1 if x>y,
 -1 if x<y, 0 if x=y.
 
 
      bool operator <= (const type&, const type&)
 
      
-
+
 
      bool operator < (const type&, const type&)
 
      
-
+
 
      bool operator >= (const type&, const type&)
 
      
-
+
 
      bool operator > (const type&, const type&)
 
      
-
+
 Comparison, as in C and C++.
 
 
      cl_boolean minusp (const type& x)
 
      
-
+
 Compare against zero: x < 0
 
 
      cl_boolean plusp (const type& x)
 
      
-
+
 Compare against zero: x > 0
 
 
      type max (const type& x, const type& y)
 
      
-
+
 Return the maximum of x and y.
 
 
      type min (const type& x, const type& y)
 
      
-
+
 Return the minimum of x and y.
 
 
@@ -1316,9 +1350,9 @@ there is no floating point number whose value is exactly 1/3.
 
 
 
-
      4.6 Rounding functions
      
+
      4.6 Rounding functions
      
 
      
-
+
 
 
 
      
@@ -1389,19 +1423,19 @@ defines the following operations:
 
 
      cl_I floor1 (const type& x)
 
      
-
+
 Returns floor(x).
 
      cl_I ceiling1 (const type& x)
 
      
-
+
 Returns ceiling(x).
 
      cl_I truncate1 (const type& x)
 
      
-
+
 Returns truncate(x).
 
      cl_I round1 (const type& x)
 
      
-
+
 Returns round(x).
 
 
@@ -1490,16 +1524,16 @@ defines the following operations:
 
      
 
      type_div_t floor2 (const type& x, const type& y)
 
      
-
+
 
      type_div_t ceiling2 (const type& x, const type& y)
 
      
-
+
 
      type_div_t truncate2 (const type& x, const type& y)
 
      
-
+
 
      type_div_t round2 (const type& x, const type& y)
 
      
-
+
 
 
 
      
@@ -1518,16 +1552,16 @@ defines the following operations:
 
 
      type ffloor (const type& x)
 
      
-
+
 
      type fceiling (const type& x)
 
      
-
+
 
      type ftruncate (const type& x)
 
      
-
+
 
      type fround (const type& x)
 
      
-
+
 
 
 
      
@@ -1559,6 +1593,11 @@ and the remainder. The suffix `2' indicates this.
 Each of the classes
 cl_F, cl_SF, cl_FF, cl_DF, cl_LF
 defines the following operations:
+
+
+
+
+
 
 
 
      
@@ -1567,19 +1606,20 @@ defines the following operations:
 
      
 
      type_fdiv_t ffloor2 (const type& x)
 
      
-
+
 
      type_fdiv_t fceiling2 (const type& x)
 
      
-
+
 
      type_fdiv_t ftruncate2 (const type& x)
 
      
-
+
 
      type_fdiv_t fround2 (const type& x)
 
      
-
+
 
      
 
      
 and similarly for class cl_R, but with quotient type cl_F.
+
 
 
 
      
@@ -1631,15 +1671,15 @@ The classes cl_R, cl_I define the following operations
 
 
      type mod (const type& x, const type& y)
 
      
-
+
 
      type rem (const type& x, const type& y)
 
      
-
+
 
 
 
 
-
      4.7 Roots
      
+
      4.7 Roots
      
 
 
      
 Each of the classes cl_R,
@@ -1651,7 +1691,7 @@ defines the following operation:
 
 
      type sqrt (const type& x)
 
      
-
+
 x must be >= 0. This function returns the square root of x,
 normalized to be >= 0. If x is the square of a rational number,
 sqrt(x) will be a rational number, else it will return a
@@ -1666,7 +1706,7 @@ The classes cl_RA, cl_I define the following operation
 
 
      cl_boolean sqrtp (const type& x, type* root)
 
      
-
+
 This tests whether x is a perfect square. If so, it returns true
 and the exact square root in *root, else it returns false.
 
@@ -1679,7 +1719,7 @@ Furthermore, for integers, similarly:
 
 
      cl_boolean isqrt (const type& x, type* root)
 
      
-
+
 x should be >= 0. This function sets *root to
 floor(sqrt(x)) and returns the same value as sqrtp:
 the boolean value (expt(*root,2) == x).
@@ -1694,7 +1734,7 @@ define the following operation:
 
 
      cl_boolean rootp (const type& x, const cl_I& n, type* root)
 
      
-
+
 x must be >= 0. n must be > 0.
 This tests whether x is an nth power of a rational number.
 If so, it returns true and the exact root in *root, else it returns
@@ -1710,7 +1750,7 @@ for class cl_N:
 
 
      cl_N sqrt (const cl_N& z)
 
      
-
+
 Returns the square root of z, as defined by the formula
 sqrt(z) = exp(log(z)/2). Conversion to a floating-point type
 or to a complex number are done if necessary. The range of the result is the
@@ -1722,9 +1762,9 @@ The result is an exact number only if z is an exact number.
 
 
 
-
      4.8 Transcendental functions
      
+
      4.8 Transcendental functions
      
 
      
-
+
 
 
 
      
@@ -1736,13 +1776,13 @@ For example, cos(0) = 1 returns the rational number 1.
 
 
 
-
      4.8.1 Exponential and logarithmic functions
      
+
      4.8.1 Exponential and logarithmic functions
      
 
 
      
 
 
      cl_R exp (const cl_R& x)
 
      
-
+
 
      cl_N exp (const cl_N& x)
 
      
 Returns the exponential function of x. This is e^x where
@@ -1751,12 +1791,12 @@ is the entire complex plane excluding 0.
 
 
      cl_R ln (const cl_R& x)
 
      
-
+
 x must be > 0. Returns the (natural) logarithm of x.
 
 
      cl_N log (const cl_N& x)
 
      
-
+
 Returns the (natural) logarithm of x. If x is real and positive,
 this is ln(x). In general, log(x) = log(abs(x)) + i*phase(x).
 The range of the result is the strip in the complex plane
@@ -1764,7 +1804,7 @@ The range of the result is the strip in the complex plane
 
 
      cl_R phase (const cl_N& x)
 
      
-
+
 Returns the angle part of x in its polar representation as a
 complex number. That is, phase(x) = atan(realpart(x),imagpart(x)).
 This is also the imaginary part of log(x).
@@ -1786,7 +1826,7 @@ Returns the logarithm of a with respect to base b.
 
 
      cl_N expt (const cl_N& x, const cl_N& y)
 
      
-
+
 Exponentiation: Returns x^y = exp(y*log(x)).
 
      
 
@@ -1798,7 +1838,7 @@ The constant e = exp(1) = 2.71828... is returned by the following functions:
 
 
      cl_F cl_exp1 (cl_float_format_t f)
 
      
-
+
 Returns e as a float of format f.
 
 
      cl_F cl_exp1 (const cl_F& y)
@@ -1812,13 +1852,13 @@ Returns e as a float of format cl_default_float_format.
 
 
 
-
      4.8.2 Trigonometric functions
      
+
      4.8.2 Trigonometric functions
      
 
 
      
 
 
      cl_R sin (const cl_R& x)
 
      
-
+
 Returns sin(x). The range of the result is the interval
 -1 <= sin(x) <= 1.
 
@@ -1828,7 +1868,7 @@ Returns sin(z). The range of the result is the entire complex plane
 
 
      cl_R cos (const cl_R& x)
 
      
-
+
 Returns cos(x). The range of the result is the interval
 -1 <= cos(x) <= 1.
 
@@ -1838,31 +1878,31 @@ Returns cos(z). The range of the result is the entire complex plane
 
 
      struct cl_cos_sin_t { cl_R cos; cl_R sin; };
 
      
-
+
 
      cl_cos_sin_t cl_cos_sin (const cl_R& x)
 
      
 Returns both sin(x) and cos(x). This is more efficient than
-
+
 computing them separately. The relation cos^2 + sin^2 = 1 will
 hold only approximately.
 
 
      cl_R tan (const cl_R& x)
 
      
-
+
 
      cl_N tan (const cl_N& x)
 
      
 Returns tan(x) = sin(x)/cos(x).
 
 
      cl_N cis (const cl_R& x)
 
      
-
+
 
      cl_N cis (const cl_N& x)
 
      
 Returns exp(i*x). The name `cis' means "cos + i sin", because
 e^(i*x) = cos(x) + i*sin(x).
 
-
-
+
+
 
      cl_N asin (const cl_N& z)
 
      
 Returns arcsin(z). This is defined as
@@ -1875,7 +1915,7 @@ with realpart = pi/2 and imagpart > 0.
 
 
      cl_N acos (const cl_N& z)
 
      
-
+
 Returns arccos(z). This is defined as
 arccos(z) = pi/2 - arcsin(z) = log(z+i*sqrt(1-z^2))/i
 and satisfies arccos(-z) = pi - arccos(z).
@@ -1884,8 +1924,8 @@ The range of the result is the strip in the complex domain
 with realpart = 0 and imagpart < 0 and the numbers
 with realpart = pi and imagpart > 0.
 
-
-
+
+
 
      cl_R atan (const cl_R& x, const cl_R& y)
 
      
 Returns the angle of the polar representation of the complex number
@@ -1914,8 +1954,8 @@ with realpart = pi/2 and imagpart <= 0.
 
      
 
 
      
-
-
+
+
 Archimedes' constant pi = 3.14... is returned by the following functions:
 
 
@@ -1923,7 +1963,7 @@ Archimedes' constant pi = 3.14... is returned by the following functions:
 
 
      cl_F cl_pi (cl_float_format_t f)
 
      
-
+
 Returns pi as a float of format f.
 
 
      cl_F cl_pi (const cl_F& y)
@@ -1937,13 +1977,13 @@ Returns pi as a float of format cl_default_float_format.
 
 
 
-
      4.8.3 Hyperbolic functions
      
+
      4.8.3 Hyperbolic functions
      
 
 
      
 
 
      cl_R sinh (const cl_R& x)
 
      
-
+
 Returns sinh(x).
 
 
      cl_N sinh (const cl_N& z)
@@ -1952,7 +1992,7 @@ Returns sinh(z). The range of the result is the entire complex plan
 
 
      cl_R cosh (const cl_R& x)
 
      
-
+
 Returns cosh(x). The range of the result is the interval
 cosh(x) >= 1.
 
@@ -1962,24 +2002,24 @@ Returns cosh(z). The range of the result is the entire complex plan
 
 
      struct cl_cosh_sinh_t { cl_R cosh; cl_R sinh; };
 
      
-
+
 
      cl_cosh_sinh_t cl_cosh_sinh (const cl_R& x)
 
      
-
+
 Returns both sinh(x) and cosh(x). This is more efficient than
 computing them separately. The relation cosh^2 - sinh^2 = 1 will
 hold only approximately.
 
 
      cl_R tanh (const cl_R& x)
 
      
-
+
 
      cl_N tanh (const cl_N& x)
 
      
 Returns tanh(x) = sinh(x)/cosh(x).
 
 
      cl_N asinh (const cl_N& z)
 
      
-
+
 Returns arsinh(z). This is defined as
 arsinh(z) = log(z+sqrt(1+z^2)) and satisfies
 arsinh(-z) = -arsinh(z).
@@ -1990,7 +2030,7 @@ with imagpart = pi/2 and realpart < 0.
 
 
      cl_N acosh (const cl_N& z)
 
      
-
+
 Returns arcosh(z). This is defined as
 arcosh(z) = 2*log(sqrt((z+1)/2)+sqrt((z-1)/2)).
 The range of the result is the half-strip in the complex domain
@@ -1999,7 +2039,7 @@ excluding the numbers with realpart = 0 and -pi < imagpar
 
 
      cl_N atanh (const cl_N& z)
 
      
-
+
 Returns artanh(z). This is defined as
 artanh(z) = (log(1+z)-log(1-z)) / 2 and satisfies
 artanh(-z) = -artanh(z). The range of the result is
@@ -2011,9 +2051,9 @@ with imagpart = pi/2 and realpart >= 0.
 
 
 
-
      4.8.4 Euler gamma
      
+
      4.8.4 Euler gamma
      
 
      
-
+
 
 
 
      
@@ -2024,7 +2064,7 @@ Euler's constant C = 0.577... is returned by the following functions:
 
 
      cl_F cl_eulerconst (cl_float_format_t f)
 
      
-
+
 Returns Euler's constant as a float of format f.
 
 
      cl_F cl_eulerconst (const cl_F& y)
@@ -2038,14 +2078,14 @@ Returns Euler's constant as a float of format cl_default_float_format
 Catalan's constant G = 0.915... is returned by the following functions:
-
+
 
 
 
      
 
 
      cl_F cl_catalanconst (cl_float_format_t f)
 
      
-
+
 Returns Catalan's constant as a float of format f.
 
 
      cl_F cl_catalanconst (const cl_F& y)
@@ -2059,9 +2099,9 @@ Returns Catalan's constant as a float of format cl_default_float_format4.8.5 Riemann zeta
+
      4.8.5 Riemann zeta
      
 
      
-
+
 
 
 
      
@@ -2073,7 +2113,7 @@ following functions:
 
 
      cl_F cl_zeta (int s, cl_float_format_t f)
 
      
-
+
 Returns Riemann's zeta function at s as a float of format f.
 
 
      cl_F cl_zeta (int s, const cl_F& y)
@@ -2088,11 +2128,11 @@ Returns Riemann's zeta function at s as a float of format
 
 
 
-
      4.9 Functions on integers
      
+
      4.9 Functions on integers
      
 
 
 
-
      4.9.1 Logical functions
      
+
      4.9.1 Logical functions
      
 
 
      
 Integers, when viewed as in two's complement notation, can be thought as
@@ -2113,69 +2153,69 @@ on each of the bit positions in parallel.
 
 
      cl_I lognot (const cl_I& x)
 
      
-
+
 
      cl_I operator ~ (const cl_I& x)
 
      
-
+
 Logical not, like ~x in C. This is the same as -1-x.
 
 
      cl_I logand (const cl_I& x, const cl_I& y)
 
      
-
+
 
      cl_I operator & (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical and, like x & y in C.
 
 
      cl_I logior (const cl_I& x, const cl_I& y)
 
      
-
+
 
      cl_I operator | (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical (inclusive) or, like x | y in C.
 
 
      cl_I logxor (const cl_I& x, const cl_I& y)
 
      
-
+
 
      cl_I operator ^ (const cl_I& x, const cl_I& y)
 
      
-
+
 Exclusive or, like x ^ y in C.
 
 
      cl_I logeqv (const cl_I& x, const cl_I& y)
 
      
-
+
 Bitwise equivalence, like ~(x ^ y) in C.
 
 
      cl_I lognand (const cl_I& x, const cl_I& y)
 
      
-
+
 Bitwise not and, like ~(x & y) in C.
 
 
      cl_I lognor (const cl_I& x, const cl_I& y)
 
      
-
+
 Bitwise not or, like ~(x | y) in C.
 
 
      cl_I logandc1 (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical and, complementing the first argument, like ~x & y in C.
 
 
      cl_I logandc2 (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical and, complementing the second argument, like x & ~y in C.
 
 
      cl_I logorc1 (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical or, complementing the first argument, like ~x | y in C.
 
 
      cl_I logorc2 (const cl_I& x, const cl_I& y)
 
      
-
+
 Logical or, complementing the second argument, like x | ~y in C.
 
      
 
@@ -2185,7 +2225,7 @@ These operations are all available though the function
 
 
      cl_I boole (cl_boole op, const cl_I& x, const cl_I& y)
 
      
-
+
 
      
 
      
 where op must have one of the 16 values (each one stands for a function
@@ -2194,13 +2234,6 @@ which combines two bits into one bit): boole_clr, boole_setboole_and, boole_ior, boole_xor, boole_eqv,
 boole_nand, boole_nor, boole_andc1, boole_andc2,
 boole_orc1, boole_orc2.
-
-
-
-
-
-
-
 
 
 
@@ -2209,6 +2242,13 @@ which combines two bits into one bit): boole_clr, boole_set
 
 
+
+
+
+
+
+
+
 
 
 
      
@@ -2219,19 +2259,19 @@ Other functions that view integers as bit strings:
 
 
      cl_boolean logtest (const cl_I& x, const cl_I& y)
 
      
-
+
 Returns true if some bit is set in both x and y, i.e. if
 logand(x,y) != 0.
 
 
      cl_boolean logbitp (const cl_I& n, const cl_I& x)
 
      
-
+
 Returns true if the nth bit (from the right) of x is set.
 Bit 0 is the least significant bit.
 
 
      uintL logcount (const cl_I& x)
 
      
-
+
 Returns the number of one bits in x, if x >= 0, or
 the number of zero bits in x, if x < 0.
 
@@ -2245,7 +2285,7 @@ struct cl_byte { uintL size; uintL position; };

      - + represents the bit interval containing the bits position...position+size-1 of an integer. The constructor cl_byte(size,position) constructs a cl_byte. @@ -2255,19 +2295,19 @@ The constructor cl_byte(size,position) constructs a cl_bytecl_I ldb (const cl_I& n, const cl_byte& b)

      - + extracts the bits of n described by the bit interval b and returns them as a nonnegative integer with b.size bits.
      cl_boolean ldb_test (const cl_I& n, const cl_byte& b)
      - + Returns true if some bit described by the bit interval b is set in n.
      cl_I dpb (const cl_I& newbyte, const cl_I& n, const cl_byte& b)
      - + Returns n, with the bits described by the bit interval b replaced by newbyte. Only the lowest b.size bits of newbyte are relevant. @@ -2282,13 +2322,13 @@ functions are their counterparts without shifting:
      cl_I mask_field (const cl_I& n, const cl_byte& b)
      - + returns an integer with the bits described by the bit interval b copied from the corresponding bits in n, the other bits zero.
      cl_I deposit_field (const cl_I& newbyte, const cl_I& n, const cl_byte& b)
      - + returns an integer where the bits described by the bit interval b come from newbyte and the other bits come from n. @@ -2319,39 +2359,39 @@ for common arithmetic operations:
      cl_boolean oddp (const cl_I& x)
      - + Returns true if the least significant bit of x is 1. Equivalent to mod(x,2) != 0.
      cl_boolean evenp (const cl_I& x)
      - + Returns true if the least significant bit of x is 0. Equivalent to mod(x,2) == 0.
      cl_I operator << (const cl_I& x, const cl_I& n)
      - + Shifts x by n bits to the left. n should be >=0. Equivalent to x * expt(2,n).
      cl_I operator >> (const cl_I& x, const cl_I& n)
      - + Shifts x by n bits to the right. n should be >=0. Bits shifted out to the right are thrown away. Equivalent to floor(x / expt(2,n)).
      cl_I ash (const cl_I& x, const cl_I& y)
      - + Shifts x by y bits to the left (if y>=0) or by -y bits to the right (if y<=0). In other words, this returns floor(x * expt(2,y)).
      uintL integer_length (const cl_I& x)
      - + Returns the number of bits (excluding the sign bit) needed to represent x in two's complement notation. This is the smallest n >= 0 such that -2^n <= x < 2^n. If x > 0, this is the unique n > 0 such that @@ -2359,14 +2399,14 @@ in two's complement notation. This is the smallest n >= 0 such that
      uintL ord2 (const cl_I& x)
      - + x must be non-zero. This function returns the number of 0 bits at the right of x in two's complement notation. This is the largest n >= 0 such that 2^n divides x.
      uintL power2p (const cl_I& x)
      - + x must be > 0. This function checks whether x is a power of 2. If x = 2^(n-1), it returns n. Else it returns 0. (See also the function logp.) @@ -2374,13 +2414,13 @@ If x = 2^(n-1), it returns n. Else it returns 0. -

      4.9.2 Number theoretic functions

      +

      4.9.2 Number theoretic functions

      uint32 gcd (uint32 a, uint32 b)
      - +
      cl_I gcd (const cl_I& a, const cl_I& b)
      This function returns the greatest common divisor of a and b, @@ -2388,7 +2428,7 @@ normalized to be >= 0.
      cl_I xgcd (const cl_I& a, const cl_I& b, cl_I* u, cl_I* v)
      - + This function ("extended gcd") returns the greatest common divisor g of a and b and at the same time the representation of g as an integral linear combination of a and b: @@ -2400,13 +2440,13 @@ value, in the following sense: If a and b are non-zero
      cl_I lcm (const cl_I& a, const cl_I& b)
      - + This function returns the least common multiple of a and b, normalized to be >= 0.
      cl_boolean logp (const cl_I& a, const cl_I& b, cl_RA* l)
      - +
      cl_boolean logp (const cl_RA& a, const cl_RA& b, cl_RA* l)
      a must be > 0. b must be >0 and != 1. If log(a,b) is @@ -2416,26 +2456,26 @@ it returns false. -

      4.9.3 Combinatorial functions

      +

      4.9.3 Combinatorial functions

      cl_I factorial (uintL n)
      - + n must be a small integer >= 0. This function returns the factorial n! = 1*2*...*n.
      cl_I doublefactorial (uintL n)
      - + n must be a small integer >= 0. This function returns the doublefactorial n!! = 1*3*...*n or n!! = 2*4*...*n, respectively.
      cl_I binomial (uintL n, uintL k)
      - + n and k must be small integers >= 0. This function returns the binomial coefficient (n choose k) = n! / k! (n-k)! @@ -2444,7 +2484,7 @@ for 0 <= k <= n, 0 else. -

      4.10 Functions on floating-point numbers

      +

      4.10 Functions on floating-point numbers

      Recall that a floating-point number consists of a sign s, an @@ -2462,7 +2502,7 @@ defines the following operations.

      type scale_float (const type& x, sintL delta)
      - +
      type scale_float (const type& x, const cl_I& delta)
      Returns x*2^delta. This is more efficient than an explicit multiplication @@ -2478,32 +2518,32 @@ representation of floating-point numbers.
      sintL float_exponent (const type& x)
      - + Returns the exponent e of x. For x = 0.0, this is 0. For x non-zero, this is the unique integer with 2^(e-1) <= abs(x) < 2^e.
      sintL float_radix (const type& x)
      - + Returns the base of the floating-point representation. This is always 2.
      type float_sign (const type& x)
      - + Returns the sign s of x as a float. The value is 1 for x >= 0, -1 for x < 0.
      uintL float_digits (const type& x)
      - + Returns the number of mantissa bits in the floating-point representation of x, including the hidden bit. The value only depends on the type of x, not on its value.
      uintL float_precision (const type& x)
      - + Returns the number of significant mantissa bits in the floating-point representation of x. Since denormalized numbers are not supported, this is the same as float_digits(x) if x is non-zero, and @@ -2512,11 +2552,11 @@ this is the same as float_digits(x) if x is non-zero,

      The complete internal representation of a float is encoded in the type - - - - - + + + + + cl_decoded_float (or cl_decoded_sfloat, cl_decoded_ffloat, cl_decoded_dfloat, cl_decoded_lfloat, respectively), defined by @@ -2534,7 +2574,7 @@ and returned by the function

      cl_decoded_typefloat decode_float (const type& x)
      - + For x non-zero, this returns (-1)^s, e, m with x = (-1)^s * 2^e * m and 0.5 <= m < 1.0. For x = 0, it returns (-1)^s=1, e=0, m=0. @@ -2545,7 +2585,7 @@ it returns (-1)^s=1, e=0, m=0. A complete decoding in terms of integers is provided as type 
      -struct cl_idecoded_float {
+struct cl_idecoded_float {
         cl_I mantissa; cl_I exponent; cl_I sign;
 };
      @@ -2558,7 +2598,7 @@ by the following function:
      cl_idecoded_float integer_decode_float (const type& x)
      - + For x non-zero, this returns (-1)^s, e, m with x = (-1)^s * 2^e * m and m an integer with float_digits(x) bits. For x = 0, it returns (-1)^s=1, e=0, m=0. @@ -2574,7 +2614,7 @@ Some other function, implemented only for class cl_F:
      cl_F float_sign (const cl_F& x, const cl_F& y)
      - + This returns a floating point number whose precision and absolute value is that of y and whose sign is that of x. If x is zero, it is treated as positive. Same for y. @@ -2582,24 +2622,25 @@ zero, it is treated as positive. Same for y. -

      4.11 Conversion functions

      +

      4.11 Conversion functions

      - + -

      4.11.1 Conversion to floating-point numbers

      +

      4.11.1 Conversion to floating-point numbers

      The type cl_float_format_t describes a floating-point format. +

      cl_float_format_t cl_float_format (uintL n)
      - + Returns the smallest float format which guarantees at least n decimal digits in the mantissa (after the decimal point). @@ -2609,7 +2650,7 @@ Returns the floating point format of x.
      cl_float_format_t cl_default_float_format
      - + Global variable: the default float format used when converting rational numbers to floats.
      @@ -2625,7 +2666,7 @@ defines the following operations:
      cl_F cl_float (const type&x, cl_float_format_t f)
      - + Returns x as a float of format f.
      cl_F cl_float (const type&x, const cl_F& y)
      @@ -2648,40 +2689,40 @@ Every floating-point format has some characteristic numbers:
      cl_F most_positive_float (cl_float_format_t f)
      - + Returns the largest (most positive) floating point number in float format f.
      cl_F most_negative_float (cl_float_format_t f)
      - + Returns the smallest (most negative) floating point number in float format f.
      cl_F least_positive_float (cl_float_format_t f)
      - + Returns the least positive floating point number (i.e. > 0 but closest to 0) in float format f.
      cl_F least_negative_float (cl_float_format_t f)
      - + Returns the least negative floating point number (i.e. < 0 but closest to 0) in float format f.
      cl_F float_epsilon (cl_float_format_t f)
      - + Returns the smallest floating point number e > 0 such that 1+e != 1.
      cl_F float_negative_epsilon (cl_float_format_t f)
      - + Returns the smallest floating point number e > 0 such that 1-e != 1.
      -

      4.11.2 Conversion to rational numbers

      +

      4.11.2 Conversion to rational numbers

      Each of the classes cl_R, cl_RA, cl_F @@ -2692,7 +2733,7 @@ defines the following operation:

      cl_RA rational (const type& x)
      - + Returns the value of x as an exact number. If x is already an exact number, this is x. If x is a floating-point number, the value is a rational number whose denominator is a power of 2. @@ -2707,7 +2748,7 @@ the function
      cl_RA rationalize (const cl_R& x)
      - + If x is a floating-point number, it actually represents an interval of real numbers, and this function returns the rational number with smallest denominator (and smallest numerator, in magnitude) @@ -2731,7 +2772,7 @@ If x is any float, one has -

      4.12 Random number generators

      +

      4.12 Random number generators

      A random generator is a machine which produces (pseudo-)random numbers. @@ -2749,7 +2790,8 @@ a complicated but deterministic way.

      The global variable - + + 

       cl_random_state cl_default_random_state
@@ -2766,14 +2808,14 @@ below are called without cl_random_state argument.
 
      
 
      uint32 random32 ()
 
      
-
+
 Returns a random unsigned 32-bit number. All bits are equally random.
 
 
      cl_I random_I (cl_random_state& randomstate, const cl_I& n)
 
      
 
      cl_I random_I (const cl_I& n)
 
      
-
+
 n must be an integer > 0. This function returns a random integer x
 in the range 0 <= x < n.
 
@@ -2781,7 +2823,7 @@ in the range 0 <= x < n.
 
      
 
      cl_F random_F (const cl_F& n)
 
      
-
+
 n must be a float > 0. This function returns a random floating-point
 number of the same format as n in the range 0 <= x < n.
 
@@ -2789,16 +2831,16 @@ number of the same format as n in the range 0 <= x <
 
      
 
      cl_R random_R (const cl_R& n)
 
      
-
+
 Behaves like random_I if n is an integer and like random_F
 if n is a float.
      -

      4.13 Obfuscating operators

      +

      4.13 Obfuscating operators

      - +

      @@ -2814,7 +2856,7 @@ to get happy, then add

      - + to the beginning of your source files, before the inclusion of any CLN include files. This flag will enable the following operators: @@ -2828,16 +2870,16 @@ For the classes cl_N, cl_R, cl_RA,

      type& operator += (type&, const type&)
      - +
      type& operator -= (type&, const type&)
      - +
      type& operator *= (type&, const type&)
      - +
      type& operator /= (type&, const type&)
      - +

      @@ -2854,19 +2896,19 @@ For the class cl_I:

      type& operator &= (type&, const type&)
      - +
      type& operator |= (type&, const type&)
      - +
      type& operator ^= (type&, const type&)
      - +
      type& operator <<= (type&, const type&)
      - +
      type& operator >>= (type&, const type&)
      - +

      @@ -2878,7 +2920,7 @@ For the classes cl_N, cl_R, cl_RA,

      type& operator ++ (type& x)
      - + The prefix operator ++x.
      void operator ++ (type& x, int) @@ -2887,7 +2929,7 @@ The postfix operator x++.
      type& operator -- (type& x)
      - + The prefix operator --x.
      void operator -- (type& x, int) @@ -2903,16 +2945,16 @@ efficient. -

      5. Input/Output

      +

      5. Input/Output

      - + -

      5.1 Internal and printed representation

      +

      5.1 Internal and printed representation

      - +

      @@ -2927,9 +2969,9 @@ Several external representations may denote the same number, for example,

      Converting an internal to an external representation is called "printing", - + converting an external to an internal representation is called "reading". - + In CLN, it is always true that conversion of an internal to an external representation and then back to an internal representation will yield the same internal representation. Symbolically: read(print(x)) == x. @@ -3009,7 +3051,7 @@ In Common Lisp notation: #C(realpart imagpart)5.2 Input functions +

      5.2 Input functions

      Including <cl_io.h> defines a type cl_istream, which is @@ -3161,7 +3203,7 @@ precision corresponding to their number of significant digits. -

      5.3 Output functions

      +

      5.3 Output functions

      Including <cl_io.h> defines a type cl_ostream, which is @@ -3316,7 +3358,7 @@ used by the function fprint. -

      6. Rings

      +

      6. Rings

      CLN has a class of abstract rings. @@ -3415,16 +3457,16 @@ Tests whether the given number is an element of the number ring R. -

      7. Modular integers

      +

      7. Modular integers

      - + -

      7.1 Modular integer rings

      +

      7.1 Modular integer rings

      - +

      @@ -3452,6 +3494,10 @@ The class of modular integer rings is <cl_modinteger.h> +

      + + +

      and the class of all modular integers (elements of modular integer rings) is @@ -3471,11 +3517,11 @@ Modular integer rings are constructed using the function

      cl_modint_ring cl_find_modint_ring (const cl_I& N)
      - + This function returns the modular ring `Z/NZ'. It takes care of finding out about special cases of N, like powers of two and odd numbers for which Montgomery multiplication will be a win, - + and precomputes any necessary auxiliary data for computing modulo N. There is a cache table of rings, indexed by N (or, more precisely, by abs(N)). This ensures that the precomputation costs are reduced @@ -3490,10 +3536,10 @@ Modular integer rings can be compared for equality:
      bool operator== (const cl_modint_ring&, const cl_modint_ring&)
      - +
      bool operator!= (const cl_modint_ring&, const cl_modint_ring&)
      - + These compare two modular integer rings for equality. Two different calls to cl_find_modint_ring with the same argument necessarily return the same ring because it is memoized in the cache table. @@ -3501,7 +3547,7 @@ same ring because it is memoized in the cache table. -

      7.2 Functions on modular integers

      +

      7.2 Functions on modular integers

      Given a modular integer ring R, the following members can be used. @@ -3511,27 +3557,27 @@ Given a modular integer ring R, the following members can be used.

      cl_I R->modulus
      - + This is the ring's modulus, normalized to be nonnegative: abs(N).
      cl_MI R->zero()
      - + This returns 0 mod N.
      cl_MI R->one()
      - + This returns 1 mod N.
      cl_MI R->canonhom (const cl_I& x)
      - + This returns x mod N.
      cl_I R->retract (const cl_MI& x)
      - + This is a partial inverse function to R->canonhom. It returns the standard representative (>=0, <N) of x. @@ -3539,7 +3585,7 @@ standard representative (>=0, <N) of x
      cl_MI R->random()
      - + This returns a random integer modulo N. @@ -3551,18 +3597,18 @@ The following operations are defined on modular integers.
      cl_modint_ring x.ring ()
      - + Returns the ring to which the modular integer x belongs.
      cl_MI operator+ (const cl_MI&, const cl_MI&)
      - + Returns the sum of two modular integers. One of the arguments may also be a plain integer.
      cl_MI operator- (const cl_MI&, const cl_MI&)
      - + Returns the difference of two modular integers. One of the arguments may also be a plain integer. @@ -3572,61 +3618,61 @@ Returns the negative of a modular integer.
      cl_MI operator* (const cl_MI&, const cl_MI&)
      - + Returns the product of two modular integers. One of the arguments may also be a plain integer.
      cl_MI square (const cl_MI&)
      - + Returns the square of a modular integer.
      cl_MI recip (const cl_MI& x)
      - + Returns the reciprocal x^-1 of a modular integer x. x must be coprime to the modulus, otherwise an error message is issued.
      cl_MI div (const cl_MI& x, const cl_MI& y)
      - + Returns the quotient x*y^-1 of two modular integers x, y. y must be coprime to the modulus, otherwise an error message is issued.
      cl_MI expt_pos (const cl_MI& x, const cl_I& y)
      - + y must be > 0. Returns x^y.
      cl_MI expt (const cl_MI& x, const cl_I& y)
      - + Returns x^y. If y is negative, x must be coprime to the modulus, else an error message is issued.
      cl_MI operator<< (const cl_MI& x, const cl_I& y)
      - + Returns x*2^y.
      cl_MI operator>> (const cl_MI& x, const cl_I& y)
      - + Returns x*2^-y. When y is positive, the modulus must be odd, or an error message is issued.
      bool operator== (const cl_MI&, const cl_MI&)
      - +
      bool operator!= (const cl_MI&, const cl_MI&)
      - + Compares two modular integers, belonging to the same modular integer ring, for equality.
      cl_boolean zerop (const cl_MI& x)
      - + Returns true if x is 0 mod N. @@ -3639,19 +3685,19 @@ input/output).
      void fprint (cl_ostream stream, const cl_MI& x)
      - +
      cl_ostream operator<< (cl_ostream stream, const cl_MI& x)
      - + Prints the modular integer x on the stream. The output may depend on the global printer settings in the variable cl_default_print_flags. -

      8. Symbolic data types

      +

      8. Symbolic data types

      - +

      @@ -3660,9 +3706,9 @@ CLN implements two symbolic (non-numeric) data types: strings and symbols. -

      8.1 Strings

      +

      8.1 Strings

      - +

      @@ -3688,7 +3734,7 @@ Strings are constructed through the following constructors:

      cl_string (const char * s)
      - + Returns an immutable copy of the (zero-terminated) C string s.
      cl_string (const char * ptr, unsigned long len) @@ -3709,30 +3755,30 @@ Assignment from cl_string and const char *.
      s.length()
      - +
      strlen(s)
      - + Returns the length of the string s.
      s[i]
      - + Returns the ith character of the string s. i must be in the range 0 <= i < s.length().
      bool equal (const cl_string& s1, const cl_string& s2)
      - + Compares two strings for equality. One of the arguments may also be a plain const char *. -

      8.2 Symbols

      +

      8.2 Symbols

      - +

      @@ -3752,7 +3798,7 @@ Symbols are constructed through the following constructor:

      cl_symbol (const cl_string& s)
      - + Looks up or creates a new symbol with a given name. @@ -3769,21 +3815,21 @@ Conversion to cl_string: Returns the string which names the symbol
      bool equal (const cl_symbol& sym1, const cl_symbol& sym2)
      - + Compares two symbols for equality. This is very fast. -

      9. Univariate polynomials

      +

      9. Univariate polynomials

      - - + + -

      9.1 Univariate polynomial rings

      +

      9.1 Univariate polynomial rings

      CLN implements univariate polynomials (polynomials in one variable) over an @@ -3891,7 +3937,7 @@ return the same polynomial ring.

      cl_univpoly_complex_ring cl_find_univpoly_ring (const cl_complex_ring& R)
      - +
      cl_univpoly_complex_ring cl_find_univpoly_ring (const cl_complex_ring& R, const cl_symbol& varname)
      cl_univpoly_real_ring cl_find_univpoly_ring (const cl_real_ring& R) @@ -3916,7 +3962,7 @@ only the return type is more specific, according to the base ring's type. -

      9.2 Functions on univariate polynomials

      +

      9.2 Functions on univariate polynomials

      Given a univariate polynomial ring R, the following members can be used. @@ -3926,33 +3972,33 @@ Given a univariate polynomial ring R, the following members can be

      cl_ring R->basering()
      - + This returns the base ring, as passed to `cl_find_univpoly_ring'.
      cl_UP R->zero()
      - + This returns 0 in R, a polynomial of degree -1.
      cl_UP R->one()
      - + This returns 1 in R, a polynomial of degree <= 0.
      cl_UP R->canonhom (const cl_I& x)
      - + This returns x in R, a polynomial of degree <= 0.
      cl_UP R->monomial (const cl_ring_element& x, uintL e)
      - + This returns a sparse polynomial: x * X^e, where X is the indeterminate.
      cl_UP R->create (sintL degree)
      - + Creates a new polynomial with a given degree. The zero polynomial has degree -1. After creating the polynomial, you should put in the coefficients, using the set_coeff member function, and then call the finalize @@ -3967,14 +4013,14 @@ The following are the only destructive operations on univariate polynomials.
      void set_coeff (cl_UP& x, uintL index, const cl_ring_element& y)
      - + This changes the coefficient of X^index in x to be y. After changing a polynomial and before applying any "normal" operation on it, you should call its finalize member function.
      void finalize (cl_UP& x)
      - + This function marks the endpoint of destructive modifications of a polynomial. It normalizes the internal representation so that subsequent computations have less overhead. Doing normal computations on unnormalized polynomials may @@ -3989,17 +4035,17 @@ The following operations are defined on univariate polynomials.
      cl_univpoly_ring x.ring ()
      - + Returns the ring to which the univariate polynomial x belongs.
      cl_UP operator+ (const cl_UP&, const cl_UP&)
      - + Returns the sum of two univariate polynomials.
      cl_UP operator- (const cl_UP&, const cl_UP&)
      - + Returns the difference of two univariate polynomials.
      cl_UP operator- (const cl_UP&) @@ -4008,54 +4054,54 @@ Returns the negative of a univariate polynomial.
      cl_UP operator* (const cl_UP&, const cl_UP&)
      - + Returns the product of two univariate polynomials. One of the arguments may also be a plain integer or an element of the base ring.
      cl_UP square (const cl_UP&)
      - + Returns the square of a univariate polynomial.
      cl_UP expt_pos (const cl_UP& x, const cl_I& y)
      - + y must be > 0. Returns x^y.
      bool operator== (const cl_UP&, const cl_UP&)
      - +
      bool operator!= (const cl_UP&, const cl_UP&)
      - + Compares two univariate polynomials, belonging to the same univariate polynomial ring, for equality.
      cl_boolean zerop (const cl_UP& x)
      - + Returns true if x is 0 in R.
      sintL degree (const cl_UP& x)
      - + Returns the degree of the polynomial. The zero polynomial has degree -1.
      cl_ring_element coeff (const cl_UP& x, uintL index)
      - + Returns the coefficient of X^index in the polynomial x.
      cl_ring_element x (const cl_ring_element& y)
      - + Evaluation: If x is a polynomial and y belongs to the base ring, then `x(y)' returns the value of the substitution of y into x.
      cl_UP deriv (const cl_UP& x)
      - + Returns the derivative of the polynomial x with respect to the indeterminate X. @@ -4069,10 +4115,10 @@ input/output).
      void fprint (cl_ostream stream, const cl_UP& x)
      - +
      cl_ostream operator<< (cl_ostream stream, const cl_UP& x)
      - + Prints the univariate polynomial x on the stream. The output may depend on the global printer settings in the variable cl_default_print_flags. @@ -4080,7 +4126,7 @@ depend on the global printer settings in the variable -

      9.3 Special polynomials

      +

      9.3 Special polynomials

      The following functions return special polynomials. @@ -4090,26 +4136,26 @@ The following functions return special polynomials.

      cl_UP_I cl_tschebychev (sintL n)
      - - + + Returns the n-th Tchebychev polynomial (n >= 0).
      cl_UP_I cl_hermite (sintL n)
      - - + + Returns the n-th Hermite polynomial (n >= 0).
      cl_UP_RA cl_legendre (sintL n)
      - - + + Returns the n-th Legendre polynomial (n >= 0).
      cl_UP_I cl_laguerre (sintL n)
      - - + + Returns the n-th Laguerre polynomial (n >= 0). @@ -4121,13 +4167,13 @@ of these polynomials from their definition can be found in the -

      10. Internals

      +

      10. Internals

      -

      10.1 Why C++ ?

      +

      10.1 Why C++ ?

      - +

      @@ -4142,7 +4188,7 @@ Efficiency: It compiles to machine code.

    • - + Portability: It runs on all platforms supporting a C++ compiler. Because of the availability of GNU C++, this includes all currently used 32-bit and 64-bit platforms, independently of the quality of the vendor's C++ compiler. @@ -4174,7 +4220,7 @@ in a high-level language. -

      10.2 Memory efficiency

      +

      10.2 Memory efficiency

      In order to save memory allocations, CLN implements: @@ -4188,8 +4234,8 @@ Object sharing: An operation like x+0 returns x withou it.

    • - - + + Garbage collection: A reference counting mechanism makes sure that any number object's storage is freed immediately when the last reference to the object is gone. @@ -4203,7 +4249,7 @@ on the heap. -

      10.3 Speed efficiency

      +

      10.3 Speed efficiency

      Speed efficiency is obtained by the combination of the following tricks @@ -4234,9 +4280,9 @@ algorithm. For very large numbers (more than 12000 decimal digits), CLN uses Schönhage-Strassen - -multiplication, which is an asymptotically -optimal multiplication algorithm. + +multiplication, which is an asymptotically optimal multiplication +algorithm.

    • These fast multiplication algorithms also give improvements in the speed @@ -4245,9 +4291,9 @@ of division and radix conversion. -

      10.4 Garbage collection

      +

      10.4 Garbage collection

      - +

      @@ -4271,7 +4317,7 @@ cached, whereas undue memory consumption through cached rings is avoided. -

      11. Using the library

      +

      11. Using the library

      For the following discussion, we will assume that you have installed @@ -4283,9 +4329,9 @@ environment variables, or directly substitute the appropriate values. -

      11.1 Compiler options

      +

      11.1 Compiler options

      - +

      @@ -4322,10 +4368,10 @@ linking a CLN application it is sufficient to give the flag -lcln. -

      11.2 Include files

      +

      11.2 Include files

      - - + +

      @@ -4518,11 +4564,11 @@ Includes all of the above. -

      11.3 An Example

      +

      11.3 An Example

      A function which computes the nth Fibonacci number can be written as follows. - + @@ -4606,9 +4652,9 @@ contains this implementation together with an even faster algorithm. -

      11.4 Debugging support

      +

      11.4 Debugging support

      - +

      @@ -4642,7 +4688,7 @@ CLN offers a function cl_print, callable from the debugger, for printing number objects. In order to get this function, you have to define the macro `CL_DEBUG' and then include all the header files for which you want cl_print debugging support. For example: - + 

       #define CL_DEBUG
@@ -4669,7 +4715,7 @@ only with number objects and similar. Therefore CLN offers a member function
 debug_print() on all CLN types. The same macro `CL_DEBUG'
 is needed for this member function to be implemented. Under gdb,
 you call it like this:
-
+
 
 
       (gdb) print s
@@ -4689,14 +4735,14 @@ Unfortunately, this feature does not seem to work under all circumstances.
 
 
 
-
      12. Customizing
      
+
      12. Customizing
      
 
      
-
+
 
 
 
 
-
      12.1 Error handling
      
+
      12.1 Error handling
      
 
 
      
 When a fatal error occurs, an error message is output to the standard error
@@ -4711,15 +4757,15 @@ void cl_abort (void);
 
      
 
 
      
-
+
 This function must not return control to its caller.
 
 
 
 
-
      12.2 Floating-point underflow
      
+
      12.2 Floating-point underflow
      
 
      
-
+
 
 
 
      
@@ -4740,17 +4786,17 @@ will be generated instead.  The default value of
 
 
 
-
      12.3 Customizing I/O
      
+
      12.3 Customizing I/O
      
 
 
      
 The output of the function fprint may be customized by changing the
 value of the global variable cl_default_print_flags.
-
+
 
 
 
 
-
      12.4 Customizing the memory allocator
      
+
      12.4 Customizing the memory allocator
      
 
 
      
 Every memory allocation of CLN is done through the function pointer
@@ -4769,8 +4815,8 @@ void (*cl_free_hook) (void* ptr)      = ...;

      - - + + The cl_malloc_hook function must not return a NULL pointer. @@ -4782,7 +4828,7 @@ global variables. -

      Index

      +

      Index

      Jump to: @@ -4790,7 +4836,7 @@ Jump to:

      -This document was generated on 4 May 2000 using +This document was generated on 5 May 2000 using texi2html 1.56k. diff --git a/doc/cln.info b/doc/cln.info index 2adcbc2..0729cfe 100644 --- a/doc/cln.info +++ b/doc/cln.info @@ -1,5 +1,4 @@ -This is Info file cln.info, produced by Makeinfo version 1.68 from the -input file cln.texi. +This is cln.info, produced by makeinfo version 4.0 from cln.texi. This file documents CLN, a Class Library for Numbers. @@ -41,7 +40,8 @@ File: cln.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir) * Customizing:: * Index:: - -- The Detailed Node Listing -- + + --- The Detailed Node Listing --- Installation @@ -56,6 +56,10 @@ Prerequisites * Make utility:: * Sed utility:: +Building the library + +* Using the GNU MP Library:: + Ordinary number types * Exact numbers:: @@ -384,6 +388,30 @@ If you use `g++' version egcs-2.91.x (egcs-1.1) on Sparc, you cannot use `--enable-shared' because `g++' would miscompile parts of the library. +* Menu: + +* Using the GNU MP Library:: + + +File: cln.info, Node: Using the GNU MP Library, Prev: Building the library, Up: Building the library + +Using the GNU MP Library +------------------------ + +Starting with version 1.0.4, CLN may be configured to make use of a +preinstalled `gmp' library. Please make sure that you have at least +`gmp' version 3.0 installed since earlier versions are unsupported and +likely not to work. Enabling this feature by calling `configure' with +the option `--with-gmp' is known to be quite a boost for CLN's +performance. + +If you have installed the `gmp' library and its header file in some +place where your compiler cannot find it by default, you must help +`configure' by setting `CPPFLAGS' and `LDFLAGS'. Here is an example: + + $ CC="gcc" CFLAGS="-O2" CXX="g++" CXXFLAGS="-O2 -fno-exceptions" \ + CPPFLAGS="-I/opt/gmp/include" LDFLAGS="-L/opt/gmp/lib" ./configure --with-gmp +  File: cln.info, Node: Installing the library, Next: Cleaning up, Prev: Building the library, Up: Installation @@ -812,7 +840,7 @@ Each of the classes `cl_N', `cl_R', `cl_RA', `cl_F', `cl_SF', `cl_FF', The class `cl_I' doesn't define a `/' operation because in the C/C++ language this operator, applied to integral types, denotes the `floor' or `truncate' operation (which one of these, is implementation -dependent). (*Note Rounding functions::) Instead, `cl_I' defines an +dependent). (*Note Rounding functions::.) Instead, `cl_I' defines an "exact quotient" function: `cl_I exquo (const cl_I& x, const cl_I& y)' @@ -2002,7 +2030,8 @@ with the macro CL_IO_STDIO being defined, `cl_istream' is the same as `istream&'. The variable - `cl_istream cl_stdin' contains the standard input stream. + `cl_istream cl_stdin' +contains the standard input stream. These are the simple input functions: @@ -2102,10 +2131,12 @@ CLN with the macro CL_IO_STDIO being defined, `cl_ostream' is the same as `ostream&'. The variable - `cl_ostream cl_stdout' contains the standard output stream. + `cl_ostream cl_stdout' +contains the standard output stream. The variable - `cl_ostream cl_stderr' contains the standard error output stream. + `cl_ostream cl_stderr' +contains the standard error output stream. These are the simple output functions: @@ -3282,7 +3313,7 @@ Index * acosh (): Hyperbolic functions. * advocacy: Why C++ ?. * Archimedes' constant: Trigonometric functions. -* As() (): Conversions. +* As()(): Conversions. * ash (): Logical functions. * asin: Trigonometric functions. * asin (): Trigonometric functions. @@ -3332,17 +3363,21 @@ Index * cl_default_print_flags: Customizing I/O. * cl_default_random_state: Random number generators. * cl_DF: Floating-point numbers. +* cl_DF_fdiv_t: Rounding functions. * cl_double_approx (): Conversions. * cl_equal_hashcode (): Comparisons. * cl_eulerconst (): Euler gamma. * cl_F <1>: Floating-point numbers. * cl_F: Ordinary number types. +* cl_F_fdiv_t: Rounding functions. * cl_FF: Floating-point numbers. +* cl_FF_fdiv_t: Rounding functions. * cl_find_modint_ring (): Modular integer rings. * cl_find_univpoly_ring (): Univariate polynomial rings. -* cl_float: Conversion to floating-point numbers. +* cl_float (): Conversion to floating-point numbers. * cl_float_approx (): Conversions. * cl_float_format (): Conversion to floating-point numbers. +* cl_float_format_t: Conversion to floating-point numbers. * cl_free_hook (): Customizing the memory allocator. * cl_hermite (): Special polynomials. * cl_I_to_int (): Conversions. @@ -3353,13 +3388,18 @@ Index * cl_laguerre (): Special polynomials. * cl_legendre (): Special polynomials. * cl_LF: Floating-point numbers. +* cl_LF_fdiv_t: Rounding functions. * cl_malloc_hook (): Customizing the memory allocator. +* cl_modint_ring: Modular integer rings. * cl_N: Ordinary number types. * cl_number: Ordinary number types. -* cl_pi: Trigonometric functions. +* cl_pi (): Trigonometric functions. * cl_R: Ordinary number types. +* cl_R_fdiv_t: Rounding functions. * cl_RA: Ordinary number types. +* cl_random_state: Random number generators. * cl_SF: Floating-point numbers. +* cl_SF_fdiv_t: Rounding functions. * cl_string (): Strings. * cl_symbol (): Symbols. * cl_tschebychev (): Special polynomials. @@ -3389,7 +3429,6 @@ Index * dpb (): Logical functions. * equal () <1>: Symbols. * equal (): Strings. -* etract (): Functions on modular integers. * Euler's constant: Euler gamma. * evenp (): Logical functions. * exact number: Exact numbers. @@ -3428,6 +3467,7 @@ Index * garbage collection <1>: Garbage collection. * garbage collection: Memory efficiency. * gcd (): Number theoretic functions. +* GMP <1>: Using the GNU MP Library. * GMP: Introduction. * header files: Include files. * Hermite polynomial: Special polynomials. @@ -3464,7 +3504,7 @@ Index * logp (): Number theoretic functions. * logtest (): Logical functions. * logxor (): Logical functions. -* make: C++ compiler. +* make: Make utility. * mask_field (): Logical functions. * max (): Comparisons. * min (): Comparisons. @@ -3551,10 +3591,11 @@ Index * reference counting: Memory efficiency. * rem (): Rounding functions. * representation: Internal and printed representation. +* retract (): Functions on modular integers. * Riemann's zeta: Riemann zeta. * ring: Modular integer rings. -* ring (): Functions on univariate polynomials. -* ring(): Functions on modular integers. +* ring () <1>: Functions on univariate polynomials. +* ring (): Functions on modular integers. * rootp (): Roots. * round1 (): Rounding functions. * round2 (): Rounding functions. @@ -3562,9 +3603,9 @@ Index * rounding error: Floating-point numbers. * Rubik's cube: Conversions. * scale_float (): Functions on floating-point numbers. -* Schönhage-Strassen: Speed efficiency. +* Schönhage-Strassen multiplication <1>: Speed efficiency. * Schönhage-Strassen multiplication: Introduction. -* sed: Make utility. +* sed: Sed utility. * set_coeff (): Functions on univariate polynomials. * signum (): Elementary functions. * sin (): Trigonometric functions. @@ -3580,7 +3621,7 @@ Index * symbolic type: Symbolic data types. * tan (): Trigonometric functions. * tanh (): Hyperbolic functions. -* The() (): Conversions. +* The()(): Conversions. * transcendental functions: Transcendental functions. * truncate1 (): Rounding functions. * truncate2 (): Rounding functions. @@ -3598,79 +3639,80 @@ Index  Tag Table: -Node: Top957 -Node: Introduction3124 -Node: Installation5646 -Node: Prerequisites5940 -Node: C++ compiler6138 -Node: Make utility6853 -Node: Sed utility7039 -Node: Building the library7359 -Node: Installing the library10541 -Node: Cleaning up11264 -Node: Ordinary number types11589 -Node: Exact numbers13936 -Node: Floating-point numbers15101 -Node: Complex numbers18680 -Node: Conversions19177 -Node: Functions on numbers22643 -Node: Constructing numbers23346 -Node: Constructing integers23718 -Node: Constructing rational numbers24008 -Node: Constructing floating-point numbers24483 -Node: Constructing complex numbers25603 -Node: Elementary functions25967 -Node: Elementary rational functions28434 -Node: Elementary complex functions29006 -Node: Comparisons29834 -Node: Rounding functions31733 -Node: Roots37510 -Node: Transcendental functions39391 -Node: Exponential and logarithmic functions39947 -Node: Trigonometric functions41964 -Node: Hyperbolic functions45315 -Node: Euler gamma47388 -Node: Riemann zeta48304 -Node: Functions on integers48860 -Node: Logical functions49148 -Node: Number theoretic functions55101 -Node: Combinatorial functions56468 -Node: Functions on floating-point numbers57146 -Node: Conversion functions60377 -Node: Conversion to floating-point numbers60657 -Node: Conversion to rational numbers62880 -Node: Random number generators63934 -Node: Obfuscating operators65608 -Node: Input/Output67338 -Node: Internal and printed representation67548 -Node: Input functions70090 -Node: Output functions74641 -Node: Rings78377 -Node: Modular integers80301 -Node: Modular integer rings80501 -Node: Functions on modular integers82591 -Node: Symbolic data types85601 -Node: Strings85864 -Node: Symbols86929 -Node: Univariate polynomials87831 -Node: Univariate polynomial rings88089 -Node: Functions on univariate polynomials93043 -Node: Special polynomials96824 -Node: Internals97544 -Node: Why C++ ?97758 -Node: Memory efficiency99258 -Node: Speed efficiency99956 -Node: Garbage collection101040 -Node: Using the library101867 -Node: Compiler options102401 -Node: Include files103319 -Node: An Example106960 -Node: Debugging support110110 -Node: Customizing112460 -Node: Error handling112688 -Node: Floating-point underflow113262 -Node: Customizing I/O113901 -Node: Customizing the memory allocator114194 -Node: Index115151 +Node: Top931 +Node: Introduction3153 +Node: Installation5675 +Node: Prerequisites5969 +Node: C++ compiler6167 +Node: Make utility6882 +Node: Sed utility7068 +Node: Building the library7388 +Node: Using the GNU MP Library10609 +Node: Installing the library11487 +Node: Cleaning up12210 +Node: Ordinary number types12535 +Node: Exact numbers14882 +Node: Floating-point numbers16047 +Node: Complex numbers19626 +Node: Conversions20123 +Node: Functions on numbers23589 +Node: Constructing numbers24292 +Node: Constructing integers24664 +Node: Constructing rational numbers24954 +Node: Constructing floating-point numbers25429 +Node: Constructing complex numbers26549 +Node: Elementary functions26913 +Node: Elementary rational functions29382 +Node: Elementary complex functions29954 +Node: Comparisons30782 +Node: Rounding functions32681 +Node: Roots38458 +Node: Transcendental functions40339 +Node: Exponential and logarithmic functions40895 +Node: Trigonometric functions42912 +Node: Hyperbolic functions46263 +Node: Euler gamma48336 +Node: Riemann zeta49252 +Node: Functions on integers49808 +Node: Logical functions50096 +Node: Number theoretic functions56049 +Node: Combinatorial functions57416 +Node: Functions on floating-point numbers58094 +Node: Conversion functions61325 +Node: Conversion to floating-point numbers61605 +Node: Conversion to rational numbers63828 +Node: Random number generators64882 +Node: Obfuscating operators66556 +Node: Input/Output68286 +Node: Internal and printed representation68496 +Node: Input functions71038 +Node: Output functions75589 +Node: Rings79325 +Node: Modular integers81249 +Node: Modular integer rings81449 +Node: Functions on modular integers83539 +Node: Symbolic data types86549 +Node: Strings86812 +Node: Symbols87877 +Node: Univariate polynomials88779 +Node: Univariate polynomial rings89037 +Node: Functions on univariate polynomials93991 +Node: Special polynomials97772 +Node: Internals98492 +Node: Why C++ ?98706 +Node: Memory efficiency100206 +Node: Speed efficiency100904 +Node: Garbage collection101988 +Node: Using the library102815 +Node: Compiler options103349 +Node: Include files104267 +Node: An Example107908 +Node: Debugging support111058 +Node: Customizing113408 +Node: Error handling113636 +Node: Floating-point underflow114210 +Node: Customizing I/O114849 +Node: Customizing the memory allocator115142 +Node: Index116099  End Tag Table diff --git a/doc/cln.ps b/doc/cln.ps index 1241843..1fd3583 100644 --- a/doc/cln.ps +++ b/doc/cln.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 %%Creator: dvips(k) 5.86 Copyright 1999 Radical Eye Software %%Title: cln.dvi -%%Pages: 74 +%%Pages: 59 %%PageOrder: Ascend %%BoundingBox: 0 0 596 842 %%EndComments @@ -9,7 +9,7 @@ %DVIPSCommandLine: /usr/local/teTeX/bin/ix86-linux-libc6/dvips -D600 -o %+ cln.ps cln.dvi %DVIPSParameters: dpi=600, compressed -%DVIPSSource: TeX output 2000.05.04:2122 +%DVIPSSource: TeX output 2000.05.05:1954 %%BeginProcSet: texc.pro %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -221,9 +221,9 @@ FF8026FFFC0313FCA226207F9F29>I<3A7FFF807FF8A23A07F8001FE00003EC0F80ED07 5AEB0003007E130FB6FCA21C207E9F22>I<001C1370003E13F8387F01FC00FF13FEA200 7F13FC383E00F8001C1370170879B226>127 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fd cmsl9 9 1 -/Fd 1 47 df<123C127E12FFA312FE127C12380808798715>46 D -E +%DVIPSBitmapFont: Fd cmti9 9 1 +/Fd 1 47 df<121C123E127F12FFA212FE127C12380808778718>46 +D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fe cmtt9 9 63 /Fe 63 127 df<123C127E12FFAF127EAE123C1200A7123C127E12FFA4127E123C082F71 @@ -365,15 +365,28 @@ FE4814FFA490380001FEEC03FCEC07F8EC0FF0001EEB1FE0C7EA3FC0EC7F80ECFF00495A C0000F130F381FFE1F393FFF7F80397FBFFF0038FE1FFE486C5A00F813F0387003C01A0A 7AAD27>126 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Ff cmtt12 14.4 1 -/Ff 1 44 df<157815FC4A7EB3A2003FB812E04817F0B912F8A46C17F06C17E0C7D801FE +%DVIPSBitmapFont: Ff cmmi10 10.95 2 +/Ff 2 80 df<49B592B512F082A290C76D913807FE00DA01BFED01F0705D039F6F5AA291 +26031FF04A5A150F82150702066D4AC7FC1503A26F7E020C16068281834A017F5CA2707E +A24A6E5B161F83160F4A6E5B1607A2834A01035C8316018349486D5CA21880177F49C8EB +C180173F18E1171F010604E3C8FCEF0FF3A218FB49ED07FEA21703A2496F5AA301381500 +6001FC1678EA03FE267FFFF01538B56C15304A15104C3E7DBD49>78 +DI E +%EndDVIPSBitmapFont +%DVIPSBitmapFont: Fg cmtt12 14.4 1 +/Fg 1 44 df<157815FC4A7EB3A2003FB812E04817F0B912F8A46C17F06C17E0C7D801FE C8FCB3A26E5A157835347CBE3E>43 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fg cmsy7 7 1 -/Fg 1 1 df0 D E +%DVIPSBitmapFont: Fh cmsy7 7 1 +/Fh 1 1 df0 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fh cmr7 7 5 -/Fh 5 55 df<1238127C12FEA6127CAA1238AA12101200A51238127C12FEA3127C123807 +%DVIPSBitmapFont: Fi cmr7 7 5 +/Fi 5 55 df<1238127C12FEA6127CAA1238AA12101200A51238127C12FEA3127C123807 297BA813>33 D<1306130C13181330136013E0EA01C0EA0380A2EA07005A120E121EA212 1C123CA35AA512F85AAB7E1278A57EA3121C121EA2120E120F7EEA0380A2EA01C0EA00E0 136013301318130C13060F3B7AAB1A>40 D<12C012607E7E7E120E7EEA0380A2EA01C013 @@ -384,8 +397,8 @@ E01200B3AB487EB512F8A215267BA521>49 D54 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fi cmmi7 7 3 -/Fi 3 111 df<1238127C12FEA3127C123807077A8614>58 D<1378EA07FC5BEA0078A3 +%DVIPSBitmapFont: Fj cmmi7 7 3 +/Fj 3 111 df<1238127C12FEA3127C123807077A8614>58 D<1378EA07FC5BEA0078A3 5BA4485AA43903C00780EC1FC0EC3860EC60E0380780C1EB8103138290388401C0D80F18 C7FC5B13E07FEA1FFE381E3F80EB07C06D7EEA3C011560A30078EBC0C01303903801C180 A200F0EBE300EB00FE0060133C1B297CA723>107 D<3907C01FC0390FE07FE03918F0E0 @@ -393,8 +406,8 @@ F03930718078EB7B00D8607E1338017C133C01781338D8C0F813785B1200A248485BA34A 5AEA03C01660EC03C0A23A07800780C0A2ED8180ED8300390F000386EC01FC00066D5A23 1B7D9929>110 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fj cmex10 10 2 -/Fj 2 2 df<1430147014E0EB01C0EB0380A2EB0700130E131E131C133C5BA25BA2485A +%DVIPSBitmapFont: Fk cmex10 10 2 +/Fk 2 2 df<1430147014E0EB01C0EB0380A2EB0700130E131E131C133C5BA25BA2485A A212035B1207A2485AA348C7FCA45A123EA3127EA5127CA212FCB3A2127CA2127EA5123E A3123F7EA46C7EA36C7EA212037F1201A26C7EA21378A27F131C131E130E7FEB0380A2EB 01C0EB00E0147014301462738226>0 D<124012E012707E7EA27E7E7F12037F6C7EA26C @@ -402,8 +415,8 @@ A3123F7EA46C7EA36C7EA212037F1201A26C7EA21378A27F131C131E130E7FEB0380A2EB 1307A514C0A3130F1480A4EB1F00A3133EA2133C137C1378A25BA2485AA2485A5B120790 C7FC120E5AA25A5A5A124014627C8226>I E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fk cmsl10 10.95 20 -/Fk 20 122 dfI E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fl cmtt12 13.14 1 -/Fl 1 44 df43 D E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fm cmbx12 13.14 42 -/Fm 42 123 df<923803FFF0037FEBFE7C0203B612FC141F91397FFE001FDAFFE0133F01 +%DVIPSBitmapFont: Fn cmbx12 13.14 45 +/Fn 45 123 df<923803FFF0037FEBFE7C0203B612FC141F91397FFE001FDAFFE0133F01 030180137F4990C7FC495A4A14FF4948147F495AA24A143F017F151FAFB9FCA526007FF0 C7121FB3B3A2003FB5D8E00FB512F8A53D4D7ECC44>13 D45 D @@ -520,102 +533,114 @@ F01303033F02FE13074AB7EA800F0207EEE01F021F903AFC003FF03F027F01C0903807FC CB59>67 D69 D72 -D76 DII82 DI<003FBB12C0A5DA80019038F8001FD9F800160148487113E001C0183F49181F -90C7170FA2007E1907A3007C1903A500FC1AF0481901A5C894C7FCB3B3A749B812F8A54C -4A7CC955>I97 -DI<913807FF80 -027F13F80103B512FE010FECFF804948C613C0D97FF0EB1FE04948EB3FF04849137F4849 -EBFFF84890C7FCA2485A121F49EC7FF0123FEE3FE0EE0F80484891C7FCA312FFAB127FA2 -7FA2123FA2001F163E7F120F6D157C6C6D14FC6C16F86C6DEB01F06C01F013076D6CEB0F -E06DB4EB7F80010F90B51200010314FCD9007F13F0020790C7FC2F337CB137>IIIIII<13FC487E3807FF80A2487F487FA66C5B6C5BA2D801FEC7FC6C5A90C8FCACEB7F -C0B5FCA512037EB3B3B61280A5194D7BCC22>I107 -DII<903A7FC001FF80B5010F13F0033F13FC4B13FF9126C1FE077F9138C3F0030003 -9026C7C0017F6C1480DACF008002DE7F02DC8114F8A25CA35CB3AAB6D8C07FEBFFE0A53B -317BB044>I<913807FF80027F13F80103B6FC010F15C090261FFE017F903A7FF0003FF8 -D9FFC0EB0FFC48496D7E4890C76C7E4817804980000F17C048486E13E0A2003F17F04915 -7FA2007F17F8A400FF17FCAB007F17F8A36C6CEDFFF0A3001F17E06D5C000F17C06C6C4A -13806C17006C6D495A6C01E0EB1FFC6D6C495A903A3FFE01FFF0010FB612C0010392C7FC -D9007F13F80207138036337DB13D>I<90397FC007FEB590383FFFE002C1B512F802C714 -FE913ACFF80FFF809126FFC0037F000391C713F06C01FC6E7E4A143F4A814A6E7E170F84 -198083A219C0A283A219E0AA19C05FA31980A24D1300A24D5A804D5A6E4A5A6E4A5A6E49 -5B6E6C485B9126EFF01F5B02E7B548C7FC02E114F8DAE07F13C0DB0FFCC8FC92CAFCAFB6 -12C0A53B467CB044>I<9039FF801FC0B5EB7FF8913881FFFE02837FDA87E11380EC8F83 -0003D99F0713C06C139E14BC14B814F84A6C1380A26F13009138E0007C93C7FCA35CB3A8 -B612E0A52A317CB032>114 DI<14F8A613 -01A41303A21307A2130FA2131F133F137F13FF1203000F90B512F0B7FCA426007FF8C7FC -B3A6167CAA013F14F880131FED01F090380FFE03903907FF07E06DEBFFC06D1480903900 -7FFE00EC0FF826467EC430>III120 +F13FF819FF1803183FBBFCA262A3494A7CC951>69 D71 +DI76 +DII80 D82 +DI<003FBB12C0A5DA80019038F8001FD9 +F800160148487113E001C0183F49181F90C7170FA2007E1907A3007C1903A500FC1AF048 +1901A5C894C7FCB3B3A749B812F8A54C4A7CC955>II97 DI<913807FF80027F13F80103B512FE010FECFF804948C613C0D97FF0EB1FE04948EB3F +F04849137F4849EBFFF84890C7FCA2485A121F49EC7FF0123FEE3FE0EE0F80484891C7FC +A312FFAB127FA27FA2123FA2001F163E7F120F6D157C6C6D14FC6C16F86C6DEB01F06C01 +F013076D6CEB0FE06DB4EB7F80010F90B51200010314FCD9007F13F0020790C7FC2F337C +B137>II +IIII<13FC487E3807FF80A2487F487FA66C5B6C5BA2D801FEC7FC6C +5A90C8FCACEB7FC0B5FCA512037EB3B3B61280A5194D7BCC22>I +107 DII<903A7FC001FF80B5010F13F0033F13FC4B13FF9126C1FE077F9138C3F003 +00039026C7C0017F6C1480DACF008002DE7F02DC8114F8A25CA35CB3AAB6D8C07FEBFFE0 +A53B317BB044>I<913807FF80027F13F80103B6FC010F15C090261FFE017F903A7FF000 +3FF8D9FFC0EB0FFC48496D7E4890C76C7E4817804980000F17C048486E13E0A2003F17F0 +49157FA2007F17F8A400FF17FCAB007F17F8A36C6CEDFFF0A3001F17E06D5C000F17C06C +6C4A13806C17006C6D495A6C01E0EB1FFC6D6C495A903A3FFE01FFF0010FB612C0010392 +C7FCD9007F13F80207138036337DB13D>I<90397FC007FEB590383FFFE002C1B512F802 +C714FE913ACFF80FFF809126FFC0037F000391C713F06C01FC6E7E4A143F4A814A6E7E17 +0F84198083A219C0A283A219E0AA19C05FA31980A24D1300A24D5A804D5A6E4A5A6E4A5A +6E495B6E6C485B9126EFF01F5B02E7B548C7FC02E114F8DAE07F13C0DB0FFCC8FC92CAFC +AFB612C0A53B467CB044>I<9039FF801FC0B5EB7FF8913881FFFE02837FDA87E11380EC +8F830003D99F0713C06C139E14BC14B814F84A6C1380A26F13009138E0007C93C7FCA35C +B3A8B612E0A52A317CB032>114 DI<14F8 +A61301A41303A21307A2130FA2131F133F137F13FF1203000F90B512F0B7FCA426007FF8 +C7FCB3A6167CAA013F14F880131FED01F090380FFE03903907FF07E06DEBFFC06D148090 +39007FFE00EC0FF826467EC430>III120 D<007FB500C090387FFFE0A5C601F0C73803F8006E5D017F5E6E1407013F5E6E140F011F 5E6E141FA26D6D91C7FC5F6D153E6F137E6D157C6F13FC6D5DEDF0016D5DEDF803027F5C 15FC1607DA3FFE5B160F021F5CEDFF1F6E91C8FC16BF6E13BE16FE6E5BA36E5BA26E5BA2 @@ -626,20 +651,6 @@ AF41>I<001FB712FCA4DA000113F801F84913F001E04913E05B494913C04B138048C748 5B5D5B495B4990C712F85C137F495A48491301485BA248491303484913074849130F161F 4890C7EA7FF04848EB03FFB8FCA42E307DAF37>I E %EndDVIPSBitmapFont -%DVIPSBitmapFont: Fn cmmi10 10.95 3 -/Fn 3 80 df<121E123FEA7F80EAFFC0A4EA7F80EA3F00121E0A0A798919>58 -D<49B592B512F082A290C76D913807FE00DA01BFED01F0705D039F6F5AA29126031FF04A -5A150F82150702066D4AC7FC1503A26F7E020C16068281834A017F5CA2707EA24A6E5B16 -1F83160F4A6E5B1607A2834A01035C8316018349486D5CA21880177F49C8EBC180173F18 -E1171F010604E3C8FCEF0FF3A218FB49ED07FEA21703A2496F5AA3013815006001FC1678 -EA03FE267FFFF01538B56C15304A15104C3E7DBD49>78 DI E -%EndDVIPSBitmapFont %DVIPSBitmapFont: Fo cmbx12 17.28 42 /Fo 42 123 df<19F0F001F819FC1803A2180719F8180F19F0A2181F19E0183F19C0A218 7F198018FF1900A25F60170360A2170760170F60A2171F60173F60A2177F60A217FF95C7 @@ -1708,4136 +1719,4089 @@ TeXDict begin %%EndSetup %%Page: 1 1 -1 0 bop 0 1386 a Ft(CLN,)65 b(a)g(Class)h(Library)g(for)e(Num)-5 -b(b)5 b(ers)p 0 1486 3900 34 v 0 5068 a Fs(b)l(y)45 b(Bruno)f(Haible)p -0 5141 3900 17 v eop +1 0 bop -30 1318 a Ft(CLN,)65 b(a)g(Class)h(Library)g(for)e(Num)-5 +b(b)5 b(ers)p -30 1418 3961 34 v -30 5068 a Fs(b)l(y)45 +b(Bruno)f(Haible)p -30 5141 3961 17 v eop %%Page: 2 2 -2 1 bop 0 3355 a Fr(Cop)m(yrigh)m(t)452 3352 y(c)427 -3355 y Fq(\015)30 b Fr(Bruno)g(Haible)h(1995,)i(1996,)f(1997,)g(1998,)h -(1999,)f(2000.)0 3878 y(Published)19 b(b)m(y)h(Bruno)g(Haible,)j -Fp()14 b Fr(and)20 b(Ric)m(hard)g(Krec)m(k)m -(el,)k Fp()p Fr(.)0 4152 y(P)m(ermission)g(is)h(gran) -m(ted)g(to)h(mak)m(e)f(and)f(distribute)g(v)m(erbatim)h(copies)g(of)g -(this)g(man)m(ual)f(pro)m(vided)h(the)g(cop)m(yrigh)m(t)0 -4276 y(notice)32 b(and)d(this)i(p)s(ermission)d(notice)k(are)e(preserv) -m(ed)g(on)h(all)g(copies.)0 4550 y(P)m(ermission)c(is)h(gran)m(ted)h -(to)g(cop)m(y)f(and)g(distribute)f(mo)s(di\014ed)f(v)m(ersions)i(of)h -(this)e(man)m(ual)h(under)e(the)i(conditions)0 4675 y(for)d(v)m -(erbatim)f(cop)m(ying,)k(pro)m(vided)c(that)i(the)f(en)m(tire)h -(resulting)f(deriv)m(ed)g(w)m(ork)g(is)g(distributed)f(under)g(the)h -(terms)0 4799 y(of)31 b(a)f(p)s(ermission)f(notice)i(iden)m(tical)h(to) -g(this)e(one.)0 5073 y(P)m(ermission)38 b(is)h(gran)m(ted)h(to)g(cop)m -(y)g(and)f(distribute)f(translations)i(of)f(this)g(man)m(ual)g(in)m(to) -h(another)f(language,)0 5198 y(under)27 b(the)h(ab)s(o)m(v)m(e)h -(conditions)g(for)f(mo)s(di\014ed)e(v)m(ersions,)j(except)g(that)f -(this)g(p)s(ermission)e(notice)k(ma)m(y)e(b)s(e)f(stated)0 -5322 y(in)j(a)h(translation)g(appro)m(v)m(ed)g(b)m(y)f(the)h(author.)p -eop +2 1 bop -30 4017 a Fr(Cop)m(yrigh)m(t)422 4014 y(c)397 +4017 y Fq(\015)30 b Fr(Bruno)g(Haible)h(1995,)i(1996,)f(1997,)g(1998,)h +(1999,)f(2000.)-30 4371 y(Published)21 b(b)m(y)i(Bruno)f(Haible,)k +Fp()16 b Fr(and)23 b(Ric)m(hard)f(Krec)m(k)m +(el,)27 b Fp()p Fr(.)-30 4505 y(P)m(ermission)h(is)h +(gran)m(ted)h(to)g(mak)m(e)f(and)g(distribute)f(v)m(erbatim)h(copies)h +(of)f(this)g(man)m(ual)g(pro)m(vided)f(the)i(cop)m(yrigh)m(t)-30 +4615 y(notice)i(and)d(this)i(p)s(ermission)d(notice)k(are)e(preserv)m +(ed)g(on)h(all)g(copies.)-30 4749 y(P)m(ermission)g(is)i(gran)m(ted)g +(to)g(cop)m(y)g(and)e(distribute)h(mo)s(di\014ed)e(v)m(ersions)j(of)f +(this)h(man)m(ual)e(under)g(the)h(conditions)-30 4859 +y(for)d(v)m(erbatim)g(cop)m(ying,)i(pro)m(vided)e(that)h(the)f(en)m +(tire)i(resulting)e(deriv)m(ed)g(w)m(ork)h(is)f(distributed)g(under)e +(the)j(terms)-30 4969 y(of)h(a)f(p)s(ermission)f(notice)i(iden)m(tical) +h(to)g(this)e(one.)-30 5103 y(P)m(ermission)23 b(is)i(gran)m(ted)g(to)g +(cop)m(y)g(and)e(distribute)h(translations)h(of)g(this)f(man)m(ual)g +(in)m(to)h(another)f(language,)j(under)-30 5213 y(the)37 +b(ab)s(o)m(v)m(e)i(conditions)f(for)f(mo)s(di\014ed)e(v)m(ersions,)k +(except)f(that)g(this)f(p)s(ermission)f(notice)i(ma)m(y)f(b)s(e)g +(stated)h(in)f(a)-30 5322 y(translation)31 b(appro)m(v)m(ed)g(b)m(y)f +(the)h(author.)p eop %%Page: 1 3 -1 2 bop 0 -116 a Fr(Chapter)30 b(1:)41 b(In)m(tro)s(duction)2892 -b(1)0 366 y Fo(1)80 b(In)l(tro)t(duction)0 719 y Fr(CLN)30 -b(is)g(a)h(library)f(for)g(computations)g(with)g(all)i(kinds)d(of)i(n)m -(um)m(b)s(ers.)38 b(It)30 b(has)h(a)f(ric)m(h)h(set)g(of)f(n)m(um)m(b)s -(er)e(classes:)75 993 y Fq(\017)60 b Fr(In)m(tegers)31 -b(\(with)g(unlimited)e(precision\),)75 1137 y Fq(\017)60 -b Fr(Rational)32 b(n)m(um)m(b)s(ers,)75 1281 y Fq(\017)60 -b Fr(Floating-p)s(oin)m(t)33 b(n)m(um)m(b)s(ers:)229 -1425 y Fq(\000)60 b Fr(Short)30 b(\015oat,)229 1569 y -Fq(\000)60 b Fr(Single)31 b(\015oat,)229 1713 y Fq(\000)60 -b Fr(Double)31 b(\015oat,)229 1857 y Fq(\000)60 b Fr(Long)31 -b(\015oat)g(\(with)f(unlimited)f(precision\),)75 2001 -y Fq(\017)60 b Fr(Complex)29 b(n)m(um)m(b)s(ers,)75 2145 +1 2 bop -30 -116 a Fr(Chapter)30 b(1:)41 b(In)m(tro)s(duction)2952 +b(1)-30 299 y Fo(1)80 b(In)l(tro)t(duction)-30 524 y +Fr(CLN)30 b(is)g(a)h(library)f(for)g(computations)g(with)g(all)i(kinds) +d(of)i(n)m(um)m(b)s(ers.)38 b(It)30 b(has)h(a)f(ric)m(h)h(set)g(of)f(n) +m(um)m(b)s(er)e(classes:)45 656 y Fq(\017)60 b Fr(In)m(tegers)31 +b(\(with)g(unlimited)e(precision\),)45 789 y Fq(\017)60 +b Fr(Rational)32 b(n)m(um)m(b)s(ers,)45 922 y Fq(\017)60 +b Fr(Floating-p)s(oin)m(t)33 b(n)m(um)m(b)s(ers:)199 +1054 y Fq(\000)60 b Fr(Short)30 b(\015oat,)199 1187 y +Fq(\000)60 b Fr(Single)31 b(\015oat,)199 1320 y Fq(\000)60 +b Fr(Double)31 b(\015oat,)199 1452 y Fq(\000)60 b Fr(Long)31 +b(\015oat)g(\(with)f(unlimited)f(precision\),)45 1585 +y Fq(\017)60 b Fr(Complex)29 b(n)m(um)m(b)s(ers,)45 1718 y Fq(\017)60 b Fr(Mo)s(dular)30 b(in)m(tegers)i(\(in)m(tegers)g(mo)s -(dulo)c(a)j(\014xed)f(in)m(teger\),)75 2289 y Fq(\017)60 -b Fr(Univ)-5 b(ariate)32 b(p)s(olynomials.)0 2583 y(The)38 -b(subt)m(yp)s(es)g(of)h(the)g(complex)f(n)m(um)m(b)s(ers)f(among)h -(these)h(are)g(exactly)i(the)e(t)m(yp)s(es)g(of)g(n)m(um)m(b)s(ers)d -(kno)m(wn)i(to)0 2707 y(the)29 b(Common)d(Lisp)j(language.)41 -b(Therefore)29 b Fp(CLN)f Fr(can)h(b)s(e)f(used)g(for)h(Common)d(Lisp)i -(implemen)m(tations,)h(giving)0 2832 y(`)p Fp(CLN)p Fr(')h(another)h -(meaning:)40 b(it)30 b(b)s(ecomes)g(an)g(abbreviation)h(of)g(\\Common)d -(Lisp)i(Num)m(b)s(ers".)0 3106 y(The)g(CLN)g(pac)m(k)-5 -b(age)32 b(implemen)m(ts)75 3380 y Fq(\017)60 b Fr(Elemen)m(tary)30 +(dulo)c(a)j(\014xed)f(in)m(teger\),)45 1850 y Fq(\017)60 +b Fr(Univ)-5 b(ariate)32 b(p)s(olynomials.)-30 2006 y(The)g(subt)m(yp)s +(es)f(of)h(the)h(complex)f(n)m(um)m(b)s(ers)d(among)j(these)h(are)f +(exactly)i(the)f(t)m(yp)s(es)f(of)g(n)m(um)m(b)s(ers)e(kno)m(wn)i(to)h +(the)-30 2116 y(Common)26 b(Lisp)h(language.)42 b(Therefore)28 +b Fp(CLN)f Fr(can)i(b)s(e)e(used)h(for)g(Common)d(Lisp)j(implemen)m +(tations,)g(giving)h(`)p Fp(CLN)p Fr(')-30 2225 y(another)i(meaning:)40 +b(it)30 b(b)s(ecomes)g(an)g(abbreviation)h(of)g(\\Common)d(Lisp)i(Num)m +(b)s(ers".)-30 2358 y(The)g(CLN)g(pac)m(k)-5 b(age)32 +b(implemen)m(ts)45 2491 y Fq(\017)60 b Fr(Elemen)m(tary)30 b(functions)g(\()p Fp(+)p Fr(,)h Fp(-)p Fr(,)f Fp(*)p -Fr(,)g Fp(/)p Fr(,)h Fp(sqrt)p Fr(,)e(comparisons,)h -Fn(:)15 b(:)g(:)q Fr(\),)75 3524 y Fq(\017)60 b Fr(Logical)32 +Fr(,)g Fp(/)p Fr(,)h Fp(sqrt)p Fr(,)e(comparisons,)35 +b(.)23 b(.)f(.)11 b(\),)45 2623 y Fq(\017)60 b Fr(Logical)32 b(functions)e(\(logical)j Fp(and)p Fr(,)d Fp(or)p Fr(,)g -Fp(not)p Fr(,)g Fn(:)15 b(:)g(:)q Fr(\),)75 3668 y Fq(\017)60 -b Fr(T)-8 b(ranscenden)m(tal)40 b(functions)f(\(exp)s(onen)m(tial,)k -(logarithmic,)f(trigonometric,)g(h)m(yp)s(erb)s(olic)d(functions)g(and) -180 3792 y(their)30 b(in)m(v)m(erse)i(functions\).)0 -4086 y(CLN)e(is)g(a)h(C)p Fp(++)f Fr(library)-8 b(.)40 +Fp(not)p Fr(,)35 b(.)23 b(.)f(.)11 b(\),)45 2756 y Fq(\017)60 +b Fr(T)-8 b(ranscenden)m(tal)48 b(functions)e(\(exp)s(onen)m(tial,)53 +b(logarithmic,)f(trigonometric,)g(h)m(yp)s(erb)s(olic)46 +b(functions)h(and)150 2866 y(their)30 b(in)m(v)m(erse)i(functions\).) +-30 3021 y(CLN)e(is)g(a)h(C)p Fp(++)f Fr(library)-8 b(.)40 b(Using)31 b(C)p Fp(++)e Fr(as)i(an)f(implemen)m(tation)g(language)i -(pro)m(vides)75 4360 y Fq(\017)60 b Fr(e\016ciency:)42 -b(it)31 b(compiles)f(to)h(mac)m(hine)f(co)s(de,)75 4504 -y Fq(\017)60 b Fr(t)m(yp)s(e)33 b(safet)m(y:)48 b(the)33 -b(C)p Fp(++)f Fr(compiler)h(kno)m(ws)f(ab)s(out)h(the)g(n)m(um)m(b)s -(er)e(t)m(yp)s(es)i(and)g(complains)f(if,)i(for)f(example,)180 -4628 y(y)m(ou)e(try)f(to)h(assign)g(a)g(\015oat)g(to)g(an)f(in)m(teger) -i(v)-5 b(ariable.)75 4773 y Fq(\017)60 b Fr(algebraic)32 +(pro)m(vides)45 3154 y Fq(\017)60 b Fr(e\016ciency:)42 +b(it)31 b(compiles)f(to)h(mac)m(hine)f(co)s(de,)45 3287 +y Fq(\017)60 b Fr(t)m(yp)s(e)37 b(safet)m(y:)55 b(the)38 +b(C)p Fp(++)e Fr(compiler)g(kno)m(ws)h(ab)s(out)g(the)g(n)m(um)m(b)s +(er)e(t)m(yp)s(es)i(and)f(complains)g(if,)j(for)e(example,)150 +3396 y(y)m(ou)31 b(try)f(to)h(assign)g(a)g(\015oat)g(to)g(an)f(in)m +(teger)i(v)-5 b(ariable.)45 3529 y Fq(\017)60 b Fr(algebraic)32 b(syn)m(tax:)41 b(Y)-8 b(ou)31 b(can)g(use)f(the)h Fp(+)p Fr(,)f Fp(-)p Fr(,)g Fp(*)p Fr(,)g Fp(=)p Fr(,)h Fp(==)p -Fr(,)f Fn(:)15 b(:)g(:)31 b Fr(op)s(erators)g(as)f(in)g(C)g(or)h(C)p -Fp(++)p Fr(.)0 5066 y(CLN)f(is)g(memory)f(e\016cien)m(t:)75 -5340 y Fq(\017)60 b Fr(Small)30 b(in)m(tegers)h(and)f(short)g(\015oats) -h(are)g(immediate,)e(not)i(heap)f(allo)s(cated.)p eop +Fr(,)k(.)22 b(.)h(.)41 b(op)s(erators)31 b(as)f(in)h(C)e(or)i(C)p +Fp(++)p Fr(.)-30 3685 y(CLN)f(is)g(memory)f(e\016cien)m(t:)45 +3817 y Fq(\017)60 b Fr(Small)30 b(in)m(tegers)h(and)f(short)g(\015oats) +h(are)g(immediate,)e(not)i(heap)f(allo)s(cated.)45 3950 +y Fq(\017)60 b Fr(Heap-allo)s(cated)30 b(memory)25 b(is)i(reclaimed)g +(through)f(an)h(automatic,)h(non-in)m(terruptiv)m(e)g(garbage)g +(collection.)-30 4106 y(CLN)i(is)g(sp)s(eed)g(e\016cien)m(t:)45 +4238 y Fq(\017)60 b Fr(The)31 b(k)m(ernel)h(of)f(CLN)g(has)g(b)s(een)g +(written)g(in)g(assem)m(bly)g(language)i(for)e(some)g(CPUs)f(\()p +Fp(i386)p Fr(,)h Fp(m68k)p Fr(,)g Fp(sparc)p Fr(,)150 +4348 y Fp(mips)p Fr(,)e Fp(arm)p Fr(\).)45 4481 y Fq(\017)60 +b Fr(On)38 b(all)h(CPUs,)h(CLN)e(ma)m(y)g(b)s(e)g(con\014gured)g(to)h +(use)f(the)g(sup)s(ere\016cien)m(t)h(lo)m(w-lev)m(el)i(routines)d(from) +f(GNU)150 4590 y(GMP)31 b(v)m(ersion)g(3.)45 4723 y Fq(\017)60 +b Fr(It)21 b(uses)g(Karatsuba)g(m)m(ultiplication,)j(whic)m(h)c(is)i +(signi\014can)m(tly)g(faster)f(for)g(large)h(n)m(um)m(b)s(ers)d(than)i +(the)g(standard)150 4832 y(m)m(ultiplication)31 b(algorithm.)45 +4965 y Fq(\017)60 b Fr(F)-8 b(or)61 b(v)m(ery)f(large)h(n)m(um)m(b)s +(ers)d(\(more)h(than)h(12000)i(decimal)e(digits\),)69 +b(it)60 b(uses)g(Sc)m(h\177)-45 b(onhage-Strassen)150 +5075 y(m)m(ultiplication,)33 b(whic)m(h)e(is)g(an)g(asymptotically)i +(optimal)e(m)m(ultiplication)h(algorithm,)g(for)f(m)m(ultiplication,) +150 5184 y(division)f(and)g(radix)g(con)m(v)m(ersion.)-30 +5340 y(CLN)g(aims)g(at)h(b)s(eing)f(easily)h(in)m(tegrated)h(in)m(to)g +(larger)f(soft)m(w)m(are)g(pac)m(k)-5 b(ages:)p eop %%Page: 2 4 -2 3 bop 0 -116 a Fr(Chapter)30 b(1:)41 b(In)m(tro)s(duction)2892 -b(2)75 366 y Fq(\017)60 b Fr(Heap-allo)s(cated)40 b(memory)35 -b(is)i(reclaimed)g(through)f(an)h(automatic,)j(non-in)m(terruptiv)m(e)d -(garbage)i(collec-)180 491 y(tion.)0 790 y(CLN)30 b(is)g(sp)s(eed)g -(e\016cien)m(t:)75 1064 y Fq(\017)60 b Fr(The)27 b(k)m(ernel)h(of)f -(CLN)g(has)g(b)s(een)g(written)g(in)g(assem)m(bly)g(language)h(for)f -(some)g(CPUs)g(\()p Fp(i386)p Fr(,)g Fp(m68k)p Fr(,)g -Fp(sparc)p Fr(,)180 1188 y Fp(mips)p Fr(,)i Fp(arm)p -Fr(\).)75 1338 y Fq(\017)60 b Fr(On)33 b(all)i(CPUs,)g(CLN)f(ma)m(y)g -(b)s(e)g(con\014gured)f(to)i(use)f(the)g(sup)s(ere\016cien)m(t)g(lo)m -(w-lev)m(el)j(routines)e(from)d(GNU)180 1462 y(GMP)f(v)m(ersion)g(3.)75 -1612 y Fq(\017)60 b Fr(It)28 b(uses)g(Karatsuba)g(m)m(ultiplication,)i -(whic)m(h)e(is)g(signi\014can)m(tly)i(faster)e(for)g(large)h(n)m(um)m -(b)s(ers)d(than)i(the)h(stan-)180 1736 y(dard)g(m)m(ultiplication)j -(algorithm.)75 1886 y Fq(\017)60 b Fr(F)-8 b(or)56 b(v)m(ery)f(large)h -(n)m(um)m(b)s(ers)d(\(more)i(than)f(12000)k(decimal)d(digits\),)62 -b(it)56 b(uses)e(Sc)m(h\177)-45 b(onhage-Strassen)180 -2010 y(m)m(ultiplication,)27 b(whic)m(h)d(is)g(an)h(asymptotically)g -(optimal)f(m)m(ultiplication)i(algorithm,)g(for)e(m)m(ultiplication,) -180 2135 y(division)30 b(and)g(radix)g(con)m(v)m(ersion.)0 -2434 y(CLN)g(aims)g(at)h(b)s(eing)f(easily)h(in)m(tegrated)h(in)m(to)g -(larger)f(soft)m(w)m(are)g(pac)m(k)-5 b(ages:)75 2708 -y Fq(\017)60 b Fr(The)30 b(garbage)i(collection)h(imp)s(oses)28 -b(no)j(burden)d(on)i(the)h(main)e(application.)75 2857 -y Fq(\017)60 b Fr(The)30 b(library)g(pro)m(vides)g(ho)s(oks)g(for)g +2 3 bop -30 -116 a Fr(Chapter)30 b(1:)41 b(In)m(tro)s(duction)2952 +b(2)45 299 y Fq(\017)60 b Fr(The)30 b(garbage)i(collection)h(imp)s +(oses)28 b(no)j(burden)d(on)i(the)h(main)e(application.)45 +433 y Fq(\017)60 b Fr(The)30 b(library)g(pro)m(vides)g(ho)s(oks)g(for)g (memory)f(allo)s(cation)j(and)e(exceptions.)p eop %%Page: 3 5 -3 4 bop 0 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2939 -b(3)0 366 y Fo(2)80 b(Installation)0 808 y Fr(This)30 +3 4 bop -30 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2999 +b(3)-30 299 y Fo(2)80 b(Installation)-30 526 y Fr(This)30 b(section)h(describ)s(es)f(ho)m(w)g(to)h(install)g(the)g(CLN)f(pac)m(k) --5 b(age)32 b(on)f(y)m(our)f(system.)0 1379 y Fs(2.1)68 -b(Prerequisites)0 1917 y Fm(2.1.1)63 b(C)p Fl(++)30 b -Fm(compiler)0 2204 y Fr(T)-8 b(o)27 b(build)f(CLN,)g(y)m(ou)h(need)f(a) -h(C)p Fp(++)f Fr(compiler.)39 b(Actually)-8 b(,)29 b(y)m(ou)e(need)g -(GNU)g Fp(g++)i(2.7.0)c Fr(or)i(new)m(er.)39 b(On)26 -b(HPP)-8 b(A,)0 2329 y(y)m(ou)31 b(need)f(GNU)h Fp(g++)e(2.8.0)g -Fr(or)i(new)m(er.)40 b(I)30 b(recommend)f(GNU)i Fp(g++)e(2.95)g -Fr(or)i(new)m(er.)0 2616 y(The)44 b(follo)m(wing)j(C)p -Fp(++)d Fr(features)h(are)g(used:)69 b(classes,)50 b(mem)m(b)s(er)42 -b(functions,)49 b(o)m(v)m(erloading)e(of)e(functions)g(and)0 -2741 y(op)s(erators,)31 b(constructors)f(and)g(destructors,)h(inline,)f -(const,)i(m)m(ultiple)e(inheritance,)h(templates.)0 3028 -y(The)f(follo)m(wing)i(C)p Fp(++)d Fr(features)i(are)g(not)f(used:)40 -b Fp(new)p Fr(,)30 b Fp(delete)p Fr(,)f(virtual)h(inheritance,)i -(exceptions.)0 3316 y(CLN)38 b(relies)h(on)f(semi-automatic)h(ordering) -f(of)g(initializations)j(of)e(static)g(and)f(global)i(v)-5 -b(ariables,)41 b(a)d(feature)0 3441 y(whic)m(h)30 b(I)g(could)h -(implemen)m(t)e(for)h(GNU)h(g)p Fp(++)f Fr(only)-8 b(.)0 -3978 y Fm(2.1.2)63 b(Mak)m(e)29 b(utilit)m(y)0 4266 y -Fr(T)-8 b(o)31 b(build)e(CLN,)h(y)m(ou)h(also)g(need)g(to)g(ha)m(v)m(e) -g(GNU)g Fp(make)e Fr(installed.)0 4803 y Fm(2.1.3)63 -b(Sed)30 b(utilit)m(y)0 5091 y Fr(T)-8 b(o)36 b(build)e(CLN)g(on)h -(HP-UX,)h(y)m(ou)g(also)g(need)f(to)g(ha)m(v)m(e)i(GNU)e -Fp(sed)g Fr(installed.)55 b(This)34 b(is)i(b)s(ecause)f(the)g(libto)s -(ol)0 5215 y(script,)c(whic)m(h)f(creates)i(the)f(CLN)f(library)-8 -b(,)31 b(relies)g(on)g Fp(sed)p Fr(,)f(and)g(the)g(v)m(endor's)h -Fp(sed)f Fr(utilit)m(y)h(on)g(these)g(systems)0 5340 -y(is)f(to)s(o)i(limited.)p eop +-5 b(age)32 b(on)f(y)m(our)f(system.)-30 779 y Fs(2.1)68 +b(Prerequisites)-30 1057 y Fn(2.1.1)63 b(C)p Fm(++)40 +b Fn(compiler)-30 1248 y Fr(T)-8 b(o)31 b(build)f(CLN,)g(y)m(ou)h(need) +g(a)g(C)p Fp(++)e Fr(compiler.)41 b(Actually)-8 b(,)33 +b(y)m(ou)e(need)f(GNU)i Fp(g++)d(2.7.0)g Fr(or)i(new)m(er.)41 +b(On)30 b(HPP)-8 b(A,)-30 1358 y(y)m(ou)31 b(need)f(GNU)h +Fp(g++)e(2.8.0)g Fr(or)i(new)m(er.)40 b(I)30 b(recommend)f(GNU)i +Fp(g++)e(2.95)g Fr(or)i(new)m(er.)-30 1491 y(The)g(follo)m(wing)j(C)p +Fp(++)d Fr(features)h(are)g(used:)43 b(classes,)33 b(mem)m(b)s(er)c +(functions,)k(o)m(v)m(erloading)h(of)e(functions)f(and)g(op)s(er-)-30 +1600 y(ators,)g(constructors)g(and)f(destructors,)g(inline,)h(const,)g +(m)m(ultiple)f(inheritance,)h(templates.)-30 1733 y(The)f(follo)m(wing) +i(C)p Fp(++)d Fr(features)i(are)g(not)f(used:)40 b Fp(new)p +Fr(,)30 b Fp(delete)p Fr(,)f(virtual)h(inheritance,)i(exceptions.)-30 +1866 y(CLN)23 b(relies)h(on)g(semi-automatic)f(ordering)h(of)f +(initializations)j(of)e(static)h(and)e(global)i(v)-5 +b(ariables,)25 b(a)f(feature)g(whic)m(h)-30 1976 y(I)30 +b(could)h(implemen)m(t)e(for)h(GNU)h(g)p Fp(++)f Fr(only)-8 +b(.)-30 2196 y Fn(2.1.2)63 b(Mak)m(e)40 b(utilit)m(y)-30 +2387 y Fr(T)-8 b(o)31 b(build)e(CLN,)h(y)m(ou)h(also)g(need)g(to)g(ha)m +(v)m(e)g(GNU)g Fp(make)e Fr(installed.)-30 2607 y Fn(2.1.3)63 +b(Sed)41 b(utilit)m(y)-30 2798 y Fr(T)-8 b(o)39 b(build)e(CLN)h(on)g +(HP-UX,)h(y)m(ou)g(also)g(need)f(to)h(ha)m(v)m(e)g(GNU)g +Fp(sed)e Fr(installed.)66 b(This)37 b(is)h(b)s(ecause)h(the)f(libto)s +(ol)-30 2907 y(script,)29 b(whic)m(h)g(creates)h(the)e(CLN)h(library)-8 +b(,)29 b(relies)g(on)g Fp(sed)p Fr(,)f(and)g(the)h(v)m(endor's)g +Fp(sed)f Fr(utilit)m(y)i(on)e(these)h(systems)f(is)-30 +3017 y(to)s(o)j(limited.)-30 3270 y Fs(2.2)68 b(Building)45 +b(the)g(library)-30 3461 y Fr(As)30 b(with)g(an)m(y)h(auto)s +(con\014guring)f(GNU)h(soft)m(w)m(are,)h(installation)h(is)d(as)h(easy) +g(as)f(this:)210 3589 y Fp($)47 b(./configure)210 3692 +y($)g(make)210 3796 y($)g(make)g(check)-30 3929 y Fr(If)30 +b(on)g(y)m(our)g(system,)g(`)p Fp(make)p Fr(')g(is)g(not)h(GNU)g +Fp(make)p Fr(,)e(y)m(ou)i(ha)m(v)m(e)h(to)f(use)f(`)p +Fp(gmake)p Fr(')f(instead)i(of)g(`)p Fp(make)p Fr(')e(ab)s(o)m(v)m(e.) +-30 4062 y(The)39 b Fp(configure)d Fr(command)h(c)m(hec)m(ks)k(out)e +(some)g(features)g(of)h(y)m(our)f(system)f(and)h(C)p +Fp(++)f Fr(compiler)h(and)f(builds)-30 4172 y(the)i Fp(Makefile)p +Fr(s.)66 b(The)39 b Fp(make)f Fr(command)g(builds)g(the)i(library)-8 +b(.)68 b(This)39 b(step)h(ma)m(y)f(tak)m(e)i(4)f(hours)e(on)i(an)f(a)m +(v)m(er-)-30 4281 y(age)d(w)m(orkstation.)57 b(The)35 +b Fp(make)29 b(check)34 b Fr(runs)f(some)i(test)h(to)g(c)m(hec)m(k)g +(that)g(no)f(imp)s(ortan)m(t)g(subroutine)f(has)h(b)s(een)-30 +4391 y(miscompiled.)-30 4524 y(The)30 b Fp(configure)e +Fr(command)g(accepts)k(options.)41 b(T)-8 b(o)30 b(get)i(a)f(summary)c +(of)j(them,)g(try)210 4651 y Fp($)47 b(./configure)e(--help)-30 +4784 y Fr(Some)29 b(of)i(the)g(options)f(are)h(explained)g(in)f(detail) +h(in)f(the)h(`)p Fp(INSTALL.generic)p Fr(')26 b(\014le.)-30 +4917 y(Y)-8 b(ou)21 b(can)g(sp)s(ecify)f(the)g(C)g(compiler,)i(the)f(C) +p Fp(++)e Fr(compiler)h(and)g(their)g(options)h(through)f(the)g(follo)m +(wing)i(en)m(vironmen)m(t)-30 5027 y(v)-5 b(ariables)31 +b(when)e(running)g Fp(configure)p Fr(:)-30 5183 y Fp(CC)384 +b Fr(Sp)s(eci\014es)30 b(the)g(C)g(compiler.)-30 5340 +y Fp(CFLAGS)192 b Fr(Flags)32 b(to)f(b)s(e)f(giv)m(en)h(to)g(the)g(C)f +(compiler)f(when)h(compiling)g(programs)f(\(not)i(when)e(linking\).)p +eop %%Page: 4 6 -4 5 bop 0 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2939 -b(4)0 366 y Fs(2.2)68 b(Building)31 b(the)f(library)0 -647 y Fr(As)g(with)g(an)m(y)h(auto)s(con\014guring)f(GNU)h(soft)m(w)m -(are,)h(installation)h(is)d(as)h(easy)g(as)f(this:)240 -906 y Fp($)47 b(./configure)240 1010 y($)g(make)240 1114 -y($)g(make)g(check)0 1394 y Fr(If)30 b(on)g(y)m(our)g(system,)g(`)p -Fp(make)p Fr(')g(is)g(not)h(GNU)g Fp(make)p Fr(,)e(y)m(ou)i(ha)m(v)m(e) -h(to)f(use)f(`)p Fp(gmake)p Fr(')f(instead)i(of)g(`)p -Fp(make)p Fr(')e(ab)s(o)m(v)m(e.)0 1675 y(The)34 b Fp(configure)f -Fr(command)f(c)m(hec)m(ks)37 b(out)e(some)f(features)h(of)g(y)m(our)g -(system)f(and)g(C)p Fp(++)g Fr(compiler)h(and)f(builds)0 -1799 y(the)e Fp(Makefile)p Fr(s.)42 b(The)31 b Fp(make)f -Fr(command)f(builds)i(the)g(library)-8 b(.)45 b(This)30 -b(step)i(ma)m(y)f(tak)m(e)i(4)f(hours)e(on)i(an)f(a)m(v)m(erage)0 -1924 y(w)m(orkstation.)78 b(The)42 b Fp(make)29 b(check)41 -b Fr(runs)f(some)i(test)h(to)g(c)m(hec)m(k)h(that)f(no)f(imp)s(ortan)m -(t)f(subroutine)h(has)g(b)s(een)0 2048 y(miscompiled.)0 -2329 y(The)30 b Fp(configure)e Fr(command)g(accepts)k(options.)41 -b(T)-8 b(o)30 b(get)i(a)f(summary)c(of)j(them,)g(try)240 -2588 y Fp($)47 b(./configure)e(--help)0 2868 y Fr(Some)29 -b(of)i(the)g(options)f(are)h(explained)g(in)f(detail)h(in)f(the)h(`)p -Fp(INSTALL.generic)p Fr(')26 b(\014le.)0 3149 y(Y)-8 -b(ou)28 b(can)g(sp)s(ecify)g(the)g(C)f(compiler,)h(the)g(C)p -Fp(++)f Fr(compiler)g(and)g(their)h(options)g(through)f(the)h(follo)m -(wing)i(en)m(viron-)0 3273 y(men)m(t)g(v)-5 b(ariables)31 -b(when)e(running)g Fp(configure)p Fr(:)0 3585 y Fp(CC)384 -b Fr(Sp)s(eci\014es)30 b(the)g(C)g(compiler.)0 3772 y -Fp(CFLAGS)192 b Fr(Flags)32 b(to)f(b)s(e)f(giv)m(en)h(to)g(the)g(C)f -(compiler)f(when)h(compiling)g(programs)f(\(not)i(when)e(linking\).)0 -3959 y Fp(CXX)336 b Fr(Sp)s(eci\014es)30 b(the)g(C)p -Fp(++)g Fr(compiler.)0 4146 y Fp(CXXFLAGS)96 b Fr(Flags)32 +4 5 bop -30 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2999 +b(4)-30 299 y Fp(CXX)336 b Fr(Sp)s(eci\014es)30 b(the)g(C)p +Fp(++)g Fr(compiler.)-30 466 y Fp(CXXFLAGS)96 b Fr(Flags)32 b(to)f(b)s(e)f(giv)m(en)h(to)g(the)g(C)p Fp(++)e Fr(compiler)h(when)f -(compiling)h(programs)f(\(not)i(when)f(linking\).)0 4458 -y(Examples:)240 4717 y Fp($)47 b(CC="gcc")f(CFLAGS="-O")f(CXX="g++")g -(CXXFLAGS="-O")f(./configure)240 4821 y($)j(CC="gcc)f(-V)h(2.7.2")g -(CFLAGS="-O)e(-g")h(\\)335 4925 y(CXX="g++)g(-V)h(2.7.2")f -(CXXFLAGS="-O)f(-g")i(./configure)240 5029 y($)g(CC="gcc)f(-V)h(2.8.1") -g(CFLAGS="-O)e(-fno-exceptions")e(\\)335 5132 y(CXX="g++)j(-V)h(2.8.1") -f(CXXFLAGS="-O)f(-fno-exceptions")e(./configure)240 5236 +(compiling)h(programs)f(\(not)i(when)f(linking\).)-30 +638 y(Examples:)210 774 y Fp($)47 b(CC="gcc")f(CFLAGS="-O")f(CXX="g++") +g(CXXFLAGS="-O")f(./configure)210 878 y($)j(CC="gcc)f(-V)h(2.7.2")g +(CFLAGS="-O)e(-g")h(\\)305 982 y(CXX="g++)g(-V)h(2.7.2")f(CXXFLAGS="-O) +f(-g")i(./configure)210 1086 y($)g(CC="gcc)f(-V)h(2.8.1")g(CFLAGS="-O)e +(-fno-exceptions")e(\\)305 1189 y(CXX="g++)j(-V)h(2.8.1")f +(CXXFLAGS="-O)f(-fno-exceptions")e(./configure)210 1293 y($)k(CC="gcc)f(-V)h(egcs-2.91.60")e(CFLAGS="-O2)f(-fno-exceptions")g -(\\)335 5340 y(CXX="g++)i(-V)h(egcs-2.91.60")d(CFLAGS="-O2)h -(-fno-exceptions")e(./configure)p eop -%%Page: 5 7 -5 6 bop 0 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2939 -b(5)0 366 y(Note)28 b(that)g(for)f(these)h(en)m(vironmen)m(t)e(v)-5 -b(ariables)28 b(to)g(tak)m(e)h(e\013ect,)g(y)m(ou)e(ha)m(v)m(e)i(to)f -(set)f(them)f(\(assuming)g(a)i(Bourne-)0 491 y(compatible)i(shell\))f -(on)g(the)h(same)f(line)g(as)h(the)f Fp(configure)e Fr(command.)38 -b(If)29 b(y)m(ou)g(made)f(the)i(settings)g(in)f(earlier)0 -616 y(shell)f(commands,)e(y)m(ou)i(ha)m(v)m(e)g(to)h -Fp(export)d Fr(the)h(en)m(vironmen)m(t)g(v)-5 b(ariables)29 -b(b)s(efore)e(calling)i Fp(configure)p Fr(.)37 b(In)27 -b(a)h Fp(csh)0 740 y Fr(shell,)j(y)m(ou)g(ha)m(v)m(e)g(to)g(use)f(the)h -(`)p Fp(setenv)p Fr(')e(command)f(for)i(setting)i(eac)m(h)f(of)g(the)f -(en)m(vironmen)m(t)g(v)-5 b(ariables.)0 1040 y(On)34 -b(Lin)m(ux,)i Fp(g++)e Fr(needs)g(15)i(MB)f(to)h(compile)f(the)g -(tests.)55 b(So)34 b(y)m(ou)i(should)d(b)s(etter)i(ha)m(v)m(e)h(17)g -(MB)g(sw)m(ap)e(space)0 1164 y(and)c(1)h(MB)g(ro)s(om)e(in)h($TMPDIR.)0 -1464 y(If)d(y)m(ou)h(use)g Fp(g++)e Fr(v)m(ersion)i(2.7.x,)i(don't)e -(add)f(`)p Fp(-O2)p Fr(')g(to)i(the)f(CXXFLA)m(GS,)g(b)s(ecause)g(`)p -Fp(g++)h(-O)p Fr(')f(generates)h(b)s(etter)0 1588 y(co)s(de)i(for)f -(CLN)g(than)g(`)p Fp(g++)g(-O2)p Fr('.)0 1888 y(If)40 -b(y)m(ou)i(use)e Fp(g++)g Fr(v)m(ersion)h(2.8.x)i(or)e(egcs-2.91.x)j -(\(a.k.a.)73 b(egcs-1.1\))44 b(or)d(gcc-2.95.x,)47 b(I)41 -b(recommend)d(adding)0 2012 y(`)p Fp(-fno-exceptions)p +(\\)305 1397 y(CXX="g++)i(-V)h(egcs-2.91.60")d(CFLAGS="-O2)h +(-fno-exceptions")e(./configure)-30 1540 y Fr(Note)32 +b(that)g(for)e(these)i(en)m(vironmen)m(t)e(v)-5 b(ariables)32 +b(to)f(tak)m(e)i(e\013ect,)g(y)m(ou)e(ha)m(v)m(e)h(to)f(set)h(them)e +(\(assuming)g(a)h(Bourne-)-30 1649 y(compatible)i(shell\))g(on)g(the)g +(same)f(line)h(as)g(the)g Fp(configure)d Fr(command.)46 +b(If)32 b(y)m(ou)h(made)f(the)h(settings)h(in)e(earlier)-30 +1759 y(shell)g(commands,)e(y)m(ou)i(ha)m(v)m(e)h(to)g +Fp(export)d Fr(the)i(en)m(vironmen)m(t)f(v)-5 b(ariables)33 +b(b)s(efore)e(calling)i Fp(configure)p Fr(.)43 b(In)31 +b(a)h Fp(csh)-30 1868 y Fr(shell,)f(y)m(ou)g(ha)m(v)m(e)g(to)g(use)f +(the)h(`)p Fp(setenv)p Fr(')e(command)f(for)i(setting)i(eac)m(h)f(of)g +(the)f(en)m(vironmen)m(t)g(v)-5 b(ariables.)-30 2011 +y(On)28 b(Lin)m(ux,)h Fp(g++)f Fr(needs)h(15)g(MB)h(to)g(compile)f(the) +g(tests.)41 b(So)28 b(y)m(ou)i(should)e(b)s(etter)h(ha)m(v)m(e)h(17)g +(MB)f(sw)m(ap)g(space)h(and)-30 2120 y(1)h(MB)g(ro)s(om)e(in)h +($TMPDIR.)-30 2263 y(If)h(y)m(ou)h(use)g Fp(g++)e Fr(v)m(ersion)j +(2.7.x,)g(don't)f(add)f(`)p Fp(-O2)p Fr(')g(to)i(the)f(CXXFLA)m(GS,)g +(b)s(ecause)g(`)p Fp(g++)d(-O)p Fr(')j(generates)h(b)s(etter)-30 +2372 y(co)s(de)e(for)f(CLN)g(than)g(`)p Fp(g++)g(-O2)p +Fr('.)-30 2515 y(If)44 b(y)m(ou)h(use)f Fp(g++)g Fr(v)m(ersion)h(2.8.x) +h(or)e(egcs-2.91.x)k(\(a.k.a.)85 b(egcs-1.1\))47 b(or)e(gcc-2.95.x,)52 +b(I)44 b(recommend)e(adding)-30 2625 y(`)p Fp(-fno-exceptions)p Fr(')27 b(to)k(the)f(CXXFLA)m(GS.)i(This)d(will)i(lik)m(ely)h(generate) -g(b)s(etter)e(co)s(de.)0 2312 y(If)50 b(y)m(ou)g(use)g -Fp(g++)g Fr(v)m(ersion)g(egcs-2.91.x)k(\(egcs-1.1\))f(or)d(gcc-2.95.x)k -(on)c(Sparc,)55 b(add)50 b(either)g(`)p Fp(-O)p Fr(')g(or)h(`)p -Fp(-O2)0 2437 y(-fno-schedule-insns)p Fr(')21 b(to)26 -b(the)g(CXXFLA)m(GS.)g(With)g(full)g(`)p Fp(-O2)p Fr(',)g -Fp(g++)f Fr(miscompiles)f(the)i(division)g(routines.)0 -2561 y(Also,)31 b(for)f({enable-shared)h(to)g(w)m(ork,)g(y)m(ou)g(need) -f(egcs-1.1.2)k(or)c(new)m(er.)0 2861 y(By)36 b(default,)i(only)e(a)h -(static)h(library)d(is)h(built.)58 b(Y)-8 b(ou)36 b(can)h(build)e(CLN)g -(as)i(a)f(shared)f(library)h(to)s(o,)i(b)m(y)e(calling)0 -2985 y Fp(configure)43 b Fr(with)i(the)g(option)h(`)p -Fp(--enable-shared)p Fr('.)82 b(T)-8 b(o)46 b(get)g(it)g(built)f(as)h -(a)f(shared)g(library)g(only)-8 b(,)50 b(call)0 3110 +g(b)s(etter)e(co)s(de.)-30 2767 y(If)54 b(y)m(ou)g(use)g +Fp(g++)f Fr(v)m(ersion)i(egcs-2.91.x)i(\(egcs-1.1\))h(or)c(gcc-2.95.x)j +(on)d(Sparc,)60 b(add)54 b(either)g(`)p Fp(-O)p Fr(')g(or)h(`)p +Fp(-O2)-30 2877 y(-fno-schedule-insns)p Fr(')26 b(to)32 +b(the)f(CXXFLA)m(GS.)h(With)g(full)f(`)p Fp(-O2)p Fr(',)g +Fp(g++)f Fr(miscompiles)g(the)i(division)f(routines.)-30 +2986 y(Also,)g(for)f({enable-shared)h(to)g(w)m(ork,)g(y)m(ou)g(need)f +(egcs-1.1.2)k(or)c(new)m(er.)-30 3129 y(By)44 b(default,)j(only)c(a)h +(static)h(library)e(is)h(built.)79 b(Y)-8 b(ou)44 b(can)g(build)e(CLN)h +(as)h(a)g(shared)e(library)h(to)s(o,)48 b(b)m(y)43 b(call-)-30 +3238 y(ing)c Fp(configure)e Fr(with)i(the)g(option)h(`)p +Fp(--enable-shared)p Fr('.)63 b(T)-8 b(o)40 b(get)g(it)g(built)e(as)i +(a)f(shared)g(library)g(only)-8 b(,)42 b(call)-30 3348 y Fp(configure)28 b Fr(with)i(the)g(options)h(`)p Fp(--enable-shared)c -(--disable-static)p Fr('.)0 3409 y(If)j(y)m(ou)g(use)g -Fp(g++)f Fr(v)m(ersion)i(egcs-2.91.x)i(\(egcs-1.1\))h(on)c(Sparc,)f(y)m -(ou)i(cannot)g(use)e(`)p Fp(--enable-shared)p Fr(')e(b)s(ecause)0 -3534 y Fp(g++)i Fr(w)m(ould)i(miscompile)e(parts)h(of)g(the)h(library) --8 b(.)0 4213 y Fs(2.3)68 b(Installing)32 b(the)f(library)0 -4512 y Fr(As)f(with)g(an)m(y)h(auto)s(con\014guring)f(GNU)h(soft)m(w)m -(are,)h(installation)h(is)d(as)h(easy)g(as)f(this:)240 -4791 y Fp($)47 b(make)g(install)0 5091 y Fr(The)20 b(`)p -Fp(make)29 b(install)p Fr(')19 b(command)f(installs)j(the)f(library)g -(and)g(the)g(include)g(\014les)h(in)m(to)g(public)e(places)i(\(`)p -Fp(/usr/local/lib/)p Fr(')0 5215 y(and)28 b(`)p Fp(/usr/local/include/) -p Fr(',)d(if)k(y)m(ou)h(ha)m(v)m(en't)g(sp)s(eci\014ed)f(a)g -Fp(--prefix)e Fr(option)j(to)f Fp(configure)p Fr(\).)39 -b(This)28 b(step)0 5340 y(ma)m(y)i(require)g(sup)s(eruser)e -(privileges.)p eop -%%Page: 6 8 -6 7 bop 0 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2939 -b(6)0 366 y(If)40 b(y)m(ou)i(ha)m(v)m(e)g(already)f(built)g(the)g -(library)f(and)g(wish)g(to)i(install)g(it,)i(but)c(didn't)g(sp)s(ecify) -h Fp(--prefix=)p Fn(:)15 b(:)g(:)39 b Fr(at)0 491 y(con\014gure)g -(time,)i(just)d(re-run)g Fp(configure)p Fr(,)h(giving)h(it)f(the)g -(same)g(options)g(as)g(the)g(\014rst)f(time,)j(plus)d(the)i -Fp(--)0 616 y(prefix=)p Fn(:)15 b(:)g(:)29 b Fr(option.)0 -1064 y Fs(2.4)68 b(Cleaning)32 b(up)0 1338 y Fr(Y)-8 +(--disable-static)p Fr('.)-30 3490 y(If)34 b(y)m(ou)h(use)g +Fp(g++)e Fr(v)m(ersion)j(egcs-2.91.x)h(\(egcs-1.1\))h(on)d(Sparc,)g(y)m +(ou)g(cannot)h(use)e(`)p Fp(--enable-shared)p Fr(')d(b)s(ecause)-30 +3600 y Fp(g++)e Fr(w)m(ould)i(miscompile)e(parts)h(of)g(the)h(library) +-8 b(.)-30 3840 y Fn(2.2.1)63 b(Using)42 b(the)f(GNU)g(MP)h(Library)-30 +4041 y Fr(Starting)27 b(with)g(v)m(ersion)g(1.0.4,)i(CLN)e(ma)m(y)f(b)s +(e)g(con\014gured)g(to)h(mak)m(e)g(use)f(of)h(a)g(preinstalled)g +Fp(gmp)f Fr(library)-8 b(.)40 b(Please)-30 4150 y(mak)m(e)g(sure)f +(that)h(y)m(ou)g(ha)m(v)m(e)h(at)f(least)h Fp(gmp)e Fr(v)m(ersion)h +(3.0)h(installed)f(since)g(earlier)h(v)m(ersions)f(are)g(unsupp)s +(orted)-30 4260 y(and)30 b(lik)m(ely)i(not)f(to)h(w)m(ork.)41 +b(Enabling)31 b(this)f(feature)h(b)m(y)g(calling)h Fp(configure)c +Fr(with)j(the)f(option)i(`)p Fp(--with-gmp)p Fr(')c(is)-30 +4369 y(kno)m(wn)i(to)h(b)s(e)f(quite)h(a)f(b)s(o)s(ost)g(for)g(CLN's)g +(p)s(erformance.)-30 4512 y(If)35 b(y)m(ou)g(ha)m(v)m(e)i(installed)f +(the)f Fp(gmp)f Fr(library)h(and)f(its)i(header)f(\014le)g(in)g(some)g +(place)h(where)e(y)m(our)i(compiler)e(cannot)-30 4622 +y(\014nd)27 b(it)j(b)m(y)f(default,)h(y)m(ou)f(m)m(ust)f(help)h +Fp(configure)d Fr(b)m(y)j(setting)h Fp(CPPFLAGS)d Fr(and)h +Fp(LDFLAGS)p Fr(.)38 b(Here)30 b(is)f(an)g(example:)210 +4758 y Fp($)47 b(CC="gcc")f(CFLAGS="-O2")e(CXX="g++")i(CXXFLAGS="-O2)e +(-fno-exceptions")f(\\)305 4862 y(CPPFLAGS="-I/opt/gmp/inclu)o(de")e +(LDFLAGS="-L/opt/gmp/lib")g(./configure)k(--with-gmp)-30 +5139 y Fs(2.3)68 b(Installing)47 b(the)e(library)-30 +5340 y Fr(As)30 b(with)g(an)m(y)h(auto)s(con\014guring)f(GNU)h(soft)m +(w)m(are,)h(installation)h(is)d(as)h(easy)g(as)f(this:)p +eop +%%Page: 5 7 +5 6 bop -30 -116 a Fr(Chapter)30 b(2:)41 b(Installation)2999 +b(5)210 299 y Fp($)47 b(make)g(install)-30 433 y Fr(The)66 +b(`)p Fp(make)30 b(install)p Fr(')65 b(command)f(installs)k(the)f +(library)f(and)h(the)g(include)f(\014les)h(in)m(to)h(public)e(places) +-30 543 y(\(`)p Fp(/usr/local/lib/)p Fr(')41 b(and)j(`)p +Fp(/usr/local/include/)p Fr(',)f(if)i(y)m(ou)g(ha)m(v)m(en't)g(sp)s +(eci\014ed)f(a)h Fp(--prefix)d Fr(option)j(to)-30 653 +y Fp(configure)p Fr(\).)39 b(This)29 b(step)i(ma)m(y)f(require)g(sup)s +(eruser)e(privileges.)-30 787 y(If)42 b(y)m(ou)g(ha)m(v)m(e)i(already)f +(built)f(the)g(library)g(and)g(wish)f(to)i(install)g(it,)j(but)c +(didn't)f(sp)s(ecify)h Fp(--prefix=...)d Fr(at)-30 897 +y(con\014gure)j(time,)k(just)c(re-run)f Fp(configure)p +Fr(,)i(giving)h(it)f(the)g(same)f(options)g(as)h(the)g(\014rst)f(time,) +j(plus)d(the)h Fp(--)-30 1006 y(prefix=...)28 b Fr(option.)-30 +1264 y Fs(2.4)68 b(Cleaning)46 b(up)-30 1456 y Fr(Y)-8 b(ou)31 b(can)g(remo)m(v)m(e)f(system-dep)s(enden)m(t)f(\014les)i -(generated)g(b)m(y)f Fp(make)f Fr(through)240 1591 y -Fp($)47 b(make)g(clean)0 1865 y Fr(Y)-8 b(ou)28 b(can)f(remo)m(v)m(e)h -(all)g(\014les)f(generated)h(b)m(y)f Fp(make)p Fr(,)g(th)m(us)g(rev)m -(erting)h(to)g(a)g(virgin)f(distribution)f(of)i(CLN,)f(through)240 -2118 y Fp($)47 b(make)g(distclean)p eop +(generated)g(b)m(y)f Fp(make)f Fr(through)210 1585 y +Fp($)47 b(make)g(clean)-30 1719 y Fr(Y)-8 b(ou)31 b(can)g(remo)m(v)m(e) +f(all)i(\014les)e(generated)h(b)m(y)g Fp(make)p Fr(,)e(th)m(us)h(rev)m +(erting)h(to)h(a)e(virgin)h(distribution)e(of)i(CLN,)f(through)210 +1848 y Fp($)47 b(make)g(distclean)p eop +%%Page: 6 8 +6 7 bop -30 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 +b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2517 b(6)-30 299 y Fo(3)80 +b(Ordinary)55 b(n)l(um)l(b)t(er)c(t)l(yp)t(es)-30 539 +y Fr(CLN)30 b(implemen)m(ts)f(the)h(follo)m(wing)i(class)f(hierarc)m(h) +m(y:)1355 670 y Fp(Number)1308 773 y(cl_number)1212 877 +y()1451 981 y(|)1451 1085 y(|)1021 1189 +y(Real)47 b(or)g(complex)f(number)1355 1292 y(cl_N)1212 +1396 y()1451 1500 y(|)1451 1604 y(|)1212 +1707 y(Real)h(number)1355 1811 y(cl_R)1260 1915 y()1451 +2019 y(|)496 2123 y(+-------------------+-----)o(---)o(----)o(----)o +(---)o(+)496 2226 y(|)1861 b(|)210 2330 y(Rational)46 +b(number)1000 b(Floating-point)44 b(number)401 2434 y(cl_RA)1669 +b(cl_F)210 2538 y()1237 b()496 +2641 y(|)1861 b(|)496 2745 y(|)859 b(+-------------+----------)o(---+)o +(---)o(----)o(----)o(--+)353 2849 y(Integer)714 b(|)620 +b(|)h(|)f(|)401 2953 y(cl_I)572 b(Short-Float)140 b(Single-Float)92 +b(Double-Float)140 b(Long-Float)258 3057 y()378 +b(cl_SF)428 b(cl_FF)g(cl_DF)g(cl_LF)1117 3160 y()44 +b()g()g()-30 3297 +y Fr(The)28 b(base)h(class)h Fp(cl_number)c Fr(is)j(an)g(abstract)g +(base)g(class.)41 b(It)29 b(is)g(not)g(useful)f(to)i(declare)f(a)h(v)-5 +b(ariable)29 b(of)g(this)g(t)m(yp)s(e)-30 3406 y(except)g(if)f(y)m(ou)g +(w)m(an)m(t)h(to)g(completely)f(disable)g(compile-time)g(t)m(yp)s(e)h +(c)m(hec)m(king)g(and)f(use)f(run-time)g(t)m(yp)s(e)h(c)m(hec)m(king) +-30 3516 y(instead.)-30 3653 y(The)h(class)i Fp(cl_N)d +Fr(comprises)h(real)h(and)f(complex)g(n)m(um)m(b)s(ers.)39 +b(There)29 b(is)g(no)h(sp)s(ecial)g(class)h(for)e(complex)g(n)m(um)m(b) +s(ers)-30 3762 y(since)i(complex)f(n)m(um)m(b)s(ers)e(with)i(imaginary) +g(part)g Fp(0)g Fr(are)h(automatically)h(con)m(v)m(erted)g(to)f(real)g +(n)m(um)m(b)s(ers.)-30 3899 y(The)f(class)h Fp(cl_R)e +Fr(comprises)h(real)h(n)m(um)m(b)s(ers)d(of)i(di\013eren)m(t)h(kinds.) +40 b(It)30 b(is)h(an)f(abstract)h(class.)-30 4035 y(The)37 +b(class)g Fp(cl_RA)f Fr(comprises)g(exact)j(real)f(n)m(um)m(b)s(ers:)51 +b(rational)39 b(n)m(um)m(b)s(ers,)d(including)h(in)m(tegers.)62 +b(There)37 b(is)g(no)-30 4145 y(sp)s(ecial)31 b(class)f(for)g(non-in)m +(tegral)i(rational)f(n)m(um)m(b)s(ers)d(since)i(rational)h(n)m(um)m(b)s +(ers)d(with)i(denominator)f Fp(1)h Fr(are)g(auto-)-30 +4254 y(matically)h(con)m(v)m(erted)h(to)f(in)m(tegers.)-30 +4391 y(The)f(class)h Fp(cl_F)e Fr(implemen)m(ts)g(\015oating-p)s(oin)m +(t)j(appro)m(ximations)e(to)h(real)g(n)m(um)m(b)s(ers.)38 +b(It)31 b(is)f(an)g(abstract)i(class.)-30 4653 y Fs(3.1)68 +b(Exact)46 b(n)l(um)l(b)t(ers)-30 4848 y Fr(Some)24 b(n)m(um)m(b)s(ers) +f(are)j(represen)m(ted)g(as)f(exact)i(n)m(um)m(b)s(ers:)36 +b(there)26 b(is)f(no)h(loss)f(of)h(information)f(when)f(suc)m(h)h(a)h +(n)m(um)m(b)s(er)-30 4957 y(is)43 b(con)m(v)m(erted)i(from)d(its)h +(mathematical)h(v)-5 b(alue)44 b(to)g(its)f(in)m(ternal)h(represen)m +(tation.)80 b(On)43 b(exact)i(n)m(um)m(b)s(ers,)f(the)-30 +5067 y(elemen)m(tary)31 b(op)s(erations)g(\()p Fp(+)p +Fr(,)f Fp(-)p Fr(,)g Fp(*)p Fr(,)h Fp(/)p Fr(,)f(comparisons,)35 +b(.)23 b(.)f(.)11 b(\))31 b(compute)e(the)i(completely)g(correct)h +(result.)-30 5203 y(In)e(CLN,)g(the)g(exact)i(n)m(um)m(b)s(ers)c(are:) +45 5340 y Fq(\017)60 b Fr(rational)32 b(n)m(um)m(b)s(ers)c(\(including) +i(in)m(tegers\),)p eop %%Page: 7 9 -7 8 bop 0 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 -b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2457 b(7)0 366 y Fo(3)80 -b(Ordinary)32 b(n)l(um)l(b)t(er)27 b(t)l(yp)t(es)0 809 -y Fr(CLN)j(implemen)m(ts)f(the)h(follo)m(wing)i(class)f(hierarc)m(h)m -(y:)1385 1076 y Fp(Number)1338 1180 y(cl_number)1242 -1283 y()1481 1387 y(|)1481 1491 y(|)1051 -1595 y(Real)47 b(or)g(complex)f(number)1385 1698 y(cl_N)1242 -1802 y()1481 1906 y(|)1481 2010 y(|)1242 -2114 y(Real)h(number)1385 2217 y(cl_R)1290 2321 y()1481 -2425 y(|)526 2529 y(+-------------------+-----)o(---)o(----)o(----)o -(---)o(+)526 2632 y(|)1861 b(|)240 2736 y(Rational)46 -b(number)1000 b(Floating-point)44 b(number)431 2840 y(cl_RA)1669 -b(cl_F)240 2944 y()1237 b()526 -3048 y(|)1861 b(|)526 3151 y(|)859 b(+-------------+----------)o(---+)o -(---)o(----)o(----)o(--+)383 3255 y(Integer)714 b(|)620 -b(|)h(|)f(|)431 3359 y(cl_I)572 b(Short-Float)140 b(Single-Float)92 -b(Double-Float)140 b(Long-Float)288 3463 y()378 -b(cl_SF)428 b(cl_FF)g(cl_DF)g(cl_LF)1147 3566 y()44 -b()g()g()0 3854 -y Fr(The)36 b(base)g(class)h Fp(cl_number)d Fr(is)i(an)g(abstract)h -(base)f(class.)59 b(It)36 b(is)g(not)h(useful)e(to)i(declare)g(a)g(v)-5 -b(ariable)37 b(of)f(this)0 3979 y(t)m(yp)s(e)f(except)i(if)e(y)m(ou)g -(w)m(an)m(t)h(to)g(completely)g(disable)g(compile-time)f(t)m(yp)s(e)g -(c)m(hec)m(king)i(and)e(use)g(run-time)f(t)m(yp)s(e)0 -4103 y(c)m(hec)m(king)e(instead.)0 4391 y(The)25 b(class)h -Fp(cl_N)f Fr(comprises)f(real)i(and)f(complex)g(n)m(um)m(b)s(ers.)37 -b(There)25 b(is)g(no)h(sp)s(ecial)g(class)g(for)f(complex)g(n)m(um)m(b) -s(ers)0 4515 y(since)31 b(complex)f(n)m(um)m(b)s(ers)e(with)i -(imaginary)g(part)g Fp(0)g Fr(are)h(automatically)h(con)m(v)m(erted)g -(to)f(real)g(n)m(um)m(b)s(ers.)0 4803 y(The)f(class)h -Fp(cl_R)e Fr(comprises)h(real)h(n)m(um)m(b)s(ers)d(of)i(di\013eren)m(t) -h(kinds.)40 b(It)30 b(is)h(an)f(abstract)h(class.)0 5091 -y(The)41 b(class)i Fp(cl_RA)e Fr(comprises)f(exact)k(real)e(n)m(um)m(b) -s(ers:)62 b(rational)43 b(n)m(um)m(b)s(ers,)f(including)g(in)m(tegers.) -76 b(There)42 b(is)0 5215 y(no)34 b(sp)s(ecial)g(class)h(for)f(non-in)m -(tegral)h(rational)h(n)m(um)m(b)s(ers)31 b(since)j(rational)i(n)m(um)m -(b)s(ers)31 b(with)j(denominator)f Fp(1)h Fr(are)0 5340 -y(automatically)e(con)m(v)m(erted)g(to)f(in)m(tegers.)p -eop -%%Page: 8 10 -8 9 bop 0 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 -b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2457 b(8)0 366 y(The)30 -b(class)h Fp(cl_F)e Fr(implemen)m(ts)g(\015oating-p)s(oin)m(t)j(appro)m -(ximations)e(to)h(real)g(n)m(um)m(b)s(ers.)38 b(It)31 -b(is)f(an)g(abstract)i(class.)0 802 y Fs(3.1)68 b(Exact)31 -b(n)l(um)l(b)t(ers)0 1076 y Fr(Some)42 b(n)m(um)m(b)s(ers)e(are)j -(represen)m(ted)f(as)h(exact)h(n)m(um)m(b)s(ers:)63 b(there)42 -b(is)h(no)f(loss)h(of)g(information)f(when)f(suc)m(h)i(a)0 -1200 y(n)m(um)m(b)s(er)25 b(is)i(con)m(v)m(erted)i(from)d(its)h -(mathematical)h(v)-5 b(alue)28 b(to)g(its)f(in)m(ternal)h(represen)m -(tation.)41 b(On)26 b(exact)j(n)m(um)m(b)s(ers,)0 1325 -y(the)i(elemen)m(tary)f(op)s(erations)h(\()p Fp(+)p Fr(,)g -Fp(-)p Fr(,)f Fp(*)p Fr(,)g Fp(/)p Fr(,)h(comparisons,)e -Fn(:)15 b(:)g(:)q Fr(\))31 b(compute)f(the)g(completely)h(correct)h -(result.)0 1599 y(In)e(CLN,)g(the)g(exact)i(n)m(um)m(b)s(ers)c(are:)75 -1873 y Fq(\017)60 b Fr(rational)32 b(n)m(um)m(b)s(ers)c(\(including)i -(in)m(tegers\),)75 2019 y Fq(\017)60 b Fr(complex)30 -b(n)m(um)m(b)s(ers)e(whose)i(real)h(and)f(imaginary)g(parts)g(are)h(b)s -(oth)e(rational)j(n)m(um)m(b)s(ers.)0 2314 y(Rational)26 -b(n)m(um)m(b)s(ers)d(are)i(alw)m(a)m(ys)h(normalized)e(to)i(the)f(form) -e Fk(n)m(umerator)7 b Fp(/)p Fk(denominator)29 b Fr(where)24 -b(the)h(n)m(umerator)0 2439 y(and)e(denominator)f(are)i(coprime)e(in)m -(tegers)i(and)f(the)g(denominator)g(is)g(p)s(ositiv)m(e.)39 -b(If)23 b(the)g(resulting)h(denominator)0 2564 y(is)30 -b Fp(1)p Fr(,)h(the)f(rational)i(n)m(um)m(b)s(er)c(is)i(con)m(v)m -(erted)i(to)f(an)g(in)m(teger.)0 2838 y(Small)d(in)m(tegers)j(\(t)m -(ypically)g(in)e(the)g(range)h Fp(-2^30)p Fn(:)15 b(:)g(:)p -Fp(2^30-1)p Fr(,)28 b(for)h(32-bit)h(mac)m(hines\))f(are)h(esp)s -(ecially)g(e\016cien)m(t,)0 2962 y(b)s(ecause)c(they)g(consume)f(no)h -(heap)g(allo)s(cation.)41 b(Otherwise)26 b(the)g(distinction)h(b)s(et)m -(w)m(een)f(these)h(immediate)e(in)m(te-)0 3087 y(gers)31 -b(\(called)h(\\\014xn)m(ums"\))d(and)g(heap)i(allo)s(cated)h(in)m -(tegers)g(\(called)g(\\bign)m(ums"\))d(is)i(completely)g(transparen)m -(t.)0 3522 y Fs(3.2)68 b(Floating-p)t(oin)l(t)32 b(n)l(um)l(b)t(ers)0 -3796 y Fr(Not)37 b(all)g(real)g(n)m(um)m(b)s(ers)d(can)j(b)s(e)e -(represen)m(ted)i(exactly)-8 b(.)60 b(\(There)36 b(is)h(an)f(easy)h -(mathematical)f(pro)s(of)g(for)g(this:)0 3920 y(Only)31 -b(a)h(coun)m(table)h(set)f(of)g(n)m(um)m(b)s(ers)d(can)j(b)s(e)f -(stored)g(exactly)j(in)d(a)h(computer,)f(ev)m(en)h(if)g(one)g(assumes)e -(that)i(it)0 4045 y(has)f(unlimited)e(storage.)45 b(But)31 -b(there)g(are)g(uncoun)m(tably)g(man)m(y)f(real)i(n)m(um)m(b)s(ers.\)) -41 b(So)31 b(some)f(appro)m(ximation)h(is)0 4169 y(needed.)40 +7 8 bop -30 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 +b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2517 b(7)45 299 y Fq(\017)60 +b Fr(complex)30 b(n)m(um)m(b)s(ers)e(whose)i(real)h(and)f(imaginary)g +(parts)g(are)h(b)s(oth)e(rational)j(n)m(um)m(b)s(ers.)-30 +463 y(Rational)g(n)m(um)m(b)s(ers)27 b(are)k(alw)m(a)m(ys)h(normalized) +e(to)g(the)h(form)e Fl(n)m(umerator)7 b Fp(/)p Fl(denominator)34 +b Fr(where)29 b(the)i(n)m(umerator)-30 573 y(and)c(denominator)h(are)g +(coprime)f(in)m(tegers)j(and)d(the)h(denominator)g(is)g(p)s(ositiv)m +(e.)41 b(If)27 b(the)i(resulting)f(denominator)-30 682 +y(is)i Fp(1)p Fr(,)h(the)f(rational)i(n)m(um)m(b)s(er)c(is)i(con)m(v)m +(erted)i(to)f(an)g(in)m(teger.)-30 820 y(Small)g(in)m(tegers)i(\(t)m +(ypically)h(in)d(the)h(range)g Fp(-2^30)6 b Fr(.)20 b(.)j(.)11 +b Fp(2^30-1)p Fr(,)30 b(for)i(32-bit)h(mac)m(hines\))e(are)h(esp)s +(ecially)h(e\016cien)m(t,)-30 930 y(b)s(ecause)e(they)g(consume)f(no)h +(heap)g(allo)s(cation.)45 b(Otherwise)31 b(the)g(distinction)h(b)s(et)m +(w)m(een)g(these)g(immediate)e(in)m(te-)-30 1039 y(gers)h(\(called)h +(\\\014xn)m(ums"\))d(and)g(heap)i(allo)s(cated)h(in)m(tegers)g +(\(called)g(\\bign)m(ums"\))d(is)i(completely)g(transparen)m(t.)-30 +1305 y Fs(3.2)68 b(Floating-p)t(oin)l(t)46 b(n)l(um)l(b)t(ers)-30 +1501 y Fr(Not)41 b(all)f(real)h(n)m(um)m(b)s(ers)c(can)j(b)s(e)f +(represen)m(ted)h(exactly)-8 b(.)71 b(\(There)40 b(is)g(an)g(easy)g +(mathematical)g(pro)s(of)f(for)h(this:)-30 1611 y(Only)34 +b(a)i(coun)m(table)g(set)f(of)g(n)m(um)m(b)s(ers)e(can)i(b)s(e)f +(stored)h(exactly)i(in)d(a)i(computer,)f(ev)m(en)g(if)g(one)g(assumes)f +(that)h(it)-30 1720 y(has)f(unlimited)g(storage.)54 b(But)35 +b(there)g(are)g(uncoun)m(tably)f(man)m(y)g(real)h(n)m(um)m(b)s(ers.\)) +51 b(So)34 b(some)g(appro)m(ximation)h(is)-30 1830 y(needed.)40 b(CLN)30 b(implemen)m(ts)f(ordinary)h(\015oating-p)s(oin)m(t)h(n)m(um)m -(b)s(ers,)e(with)h(man)m(tissa)g(and)g(exp)s(onen)m(t.)0 -4443 y(The)c(elemen)m(tary)i(op)s(erations)f(\()p Fp(+)p -Fr(,)g Fp(-)p Fr(,)h Fp(*)p Fr(,)f Fp(/)p Fr(,)h Fn(:)15 -b(:)g(:)q Fr(\))27 b(only)g(return)e(appro)m(ximate)i(results.)40 -b(F)-8 b(or)27 b(example,)g(the)g(v)-5 b(alue)0 4568 -y(of)31 b(the)h(expression)f Fp(\(cl_F\))d(0.3)i(+)g(\(cl_F\))f(0.4)h -Fr(prin)m(ts)h(as)g(`)p Fp(0.70000005)p Fr(',)e(not)j(as)f(`)p -Fp(0.7)p Fr('.)43 b(Rounding)30 b(errors)0 4692 y(lik)m(e)i(this)e(one) -h(are)f(inevitable)i(when)d(computing)h(with)g(\015oating-p)s(oin)m(t)i -(n)m(um)m(b)s(ers.)0 4966 y(Nev)m(ertheless,)41 b(CLN)36 -b(rounds)g(the)h(\015oating-p)s(oin)m(t)i(results)e(of)g(the)g(op)s -(erations)h Fp(+)p Fr(,)h Fp(-)p Fr(,)f Fp(*)p Fr(,)h -Fp(/)p Fr(,)g Fp(sqrt)d Fr(according)0 5091 y(to)c(the)f(\\round-to-ev) -m(en")h(rule:)42 b(It)31 b(\014rst)f(computes)g(the)h(exact)h -(mathematical)f(result)g(and)g(then)f(returns)g(the)0 -5215 y(\015oating-p)s(oin)m(t)37 b(n)m(um)m(b)s(er)c(whic)m(h)i(is)h -(nearest)g(to)h(this.)56 b(If)35 b(t)m(w)m(o)i(\015oating-p)s(oin)m(t)g -(n)m(um)m(b)s(ers)c(are)j(equally)g(distan)m(t)0 5340 -y(from)29 b(the)h(ideal)i(result,)e(the)h(one)f(with)g(a)h -Fp(0)f Fr(in)g(its)h(least)h(signi\014can)m(t)f(man)m(tissa)f(bit)h(is) -f(c)m(hosen.)p eop -%%Page: 9 11 -9 10 bop 0 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 -b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2457 b(9)0 366 y(Similarly)-8 -b(,)48 b(testing)d(\015oating)g(p)s(oin)m(t)f(n)m(um)m(b)s(ers)e(for)i -(equalit)m(y)i(`)p Fp(x)30 b(==)g(y)p Fr(')44 b(is)h(gam)m(bling)f -(with)g(random)e(errors.)0 491 y(Better)32 b(c)m(hec)m(k)g(for)e(`)p -Fp(abs\(x)f(-)h(y\))g(<)g(epsilon)p Fr(')f(for)h(some)f(w)m(ell-c)m -(hosen)k Fp(epsilon)p Fr(.)0 850 y(Floating)f(p)s(oin)m(t)f(n)m(um)m(b) -s(ers)d(come)i(in)g(four)g(\015a)m(v)m(ors:)75 1209 y -Fq(\017)60 b Fr(Short)24 b(\015oats,)j(t)m(yp)s(e)d Fp(cl_SF)p -Fr(.)38 b(They)24 b(ha)m(v)m(e)i(1)f(sign)g(bit,)h(8)f(exp)s(onen)m(t)f -(bits)h(\(including)g(the)g(exp)s(onen)m(t's)f(sign\),)180 -1333 y(and)30 b(17)h(man)m(tissa)f(bits)h(\(including)f(the)g -(\\hidden")g(bit\).)41 b(They)30 b(don't)h(consume)e(heap)h(allo)s -(cation.)75 1568 y Fq(\017)60 b Fr(Single)40 b(\015oats,)i(t)m(yp)s(e)e -Fp(cl_FF)p Fr(.)66 b(They)39 b(ha)m(v)m(e)h(1)g(sign)g(bit,)h(8)f(exp)s -(onen)m(t)g(bits)f(\(including)g(the)h(exp)s(onen)m(t's)180 -1692 y(sign\),)j(and)c(24)h(man)m(tissa)g(bits)g(\(including)f(the)h -(\\hidden")f(bit\).)69 b(In)39 b(CLN,)h(they)g(are)g(represen)m(ted)g -(as)180 1817 y(IEEE)g(single-precision)h(\015oating)g(p)s(oin)m(t)g(n)m -(um)m(b)s(ers.)68 b(This)39 b(corresp)s(onds)g(closely)j(to)f(the)f -(C/C)p Fp(++)g Fr(t)m(yp)s(e)180 1941 y(`)p Fp(float)p -Fr('.)75 2176 y Fq(\017)60 b Fr(Double)34 b(\015oats,)i(t)m(yp)s(e)e -Fp(cl_DF)p Fr(.)50 b(They)34 b(ha)m(v)m(e)h(1)f(sign)g(bit,)h(11)g(exp) -s(onen)m(t)f(bits)g(\(including)g(the)g(exp)s(onen)m(t's)180 -2300 y(sign\),)43 b(and)c(53)h(man)m(tissa)g(bits)g(\(including)f(the)h -(\\hidden")f(bit\).)69 b(In)39 b(CLN,)h(they)g(are)g(represen)m(ted)g -(as)180 2425 y(IEEE)d(double-precision)g(\015oating)h(p)s(oin)m(t)f(n)m -(um)m(b)s(ers.)59 b(This)36 b(corresp)s(onds)g(closely)j(to)f(the)f -(C/C)p Fp(++)g Fr(t)m(yp)s(e)180 2549 y(`)p Fp(double)p -Fr('.)75 2784 y Fq(\017)60 b Fr(Long)23 b(\015oats,)i(t)m(yp)s(e)e -Fp(cl_LF)p Fr(.)37 b(They)22 b(ha)m(v)m(e)i(1)f(sign)g(bit,)i(32)e(exp) -s(onen)m(t)g(bits)g(\(including)f(the)h(exp)s(onen)m(t's)g(sign\),)180 -2908 y(and)k(n)h(man)m(tissa)g(bits)g(\(including)g(the)g(\\hidden")g -(bit\),)h(where)e(n)h Fp(>)p Fr(=)f(64.)41 b(The)28 b(precision)g(of)g -(a)h(long)f(\015oat)180 3033 y(is)i(unlimited,)g(but)f(once)i(created,) +(b)s(ers,)e(with)h(man)m(tissa)g(and)g(exp)s(onen)m(t.)-30 +1968 y(The)e(elemen)m(tary)i(op)s(erations)f(\()p Fp(+)p +Fr(,)h Fp(-)p Fr(,)f Fp(*)p Fr(,)g Fp(/)p Fr(,)35 b(.)22 +b(.)h(.)11 b(\))29 b(only)g(return)f(appro)m(ximate)h(results.)40 +b(F)-8 b(or)30 b(example,)f(the)g(v)-5 b(alue)-30 2077 +y(of)36 b(the)g(expression)f Fp(\(cl_F\))29 b(0.3)g(+)i(\(cl_F\))d(0.4) +35 b Fr(prin)m(ts)g(as)h(`)p Fp(0.70000005)p Fr(',)f(not)h(as)g(`)p +Fp(0.7)p Fr('.)57 b(Rounding)34 b(errors)-30 2187 y(lik)m(e)e(this)e +(one)h(are)f(inevitable)i(when)d(computing)h(with)g(\015oating-p)s(oin) +m(t)i(n)m(um)m(b)s(ers.)-30 2325 y(Nev)m(ertheless,)46 +b(CLN)40 b(rounds)g(the)h(\015oating-p)s(oin)m(t)h(results)f(of)h(the)f +(op)s(erations)g Fp(+)p Fr(,)j Fp(-)p Fr(,)g Fp(*)p Fr(,)f +Fp(/)p Fr(,)h Fp(sqrt)c Fr(according)-30 2434 y(to)c(the)f +(\\round-to-ev)m(en")h(rule:)50 b(It)35 b(\014rst)f(computes)g(the)h +(exact)h(mathematical)f(result)g(and)g(then)f(returns)g(the)-30 +2544 y(\015oating-p)s(oin)m(t)26 b(n)m(um)m(b)s(er)c(whic)m(h)j(is)f +(nearest)h(to)h(this.)38 b(If)25 b(t)m(w)m(o)h(\015oating-p)s(oin)m(t)g +(n)m(um)m(b)s(ers)c(are)j(equally)g(distan)m(t)g(from)-30 +2653 y(the)31 b(ideal)g(result,)f(the)h(one)g(with)f(a)g +Fp(0)g Fr(in)g(its)h(least)h(signi\014can)m(t)f(man)m(tissa)f(bit)h(is) +f(c)m(hosen.)-30 2791 y(Similarly)-8 b(,)26 b(testing)h(\015oating)f(p) +s(oin)m(t)f(n)m(um)m(b)s(ers)e(for)i(equalit)m(y)i(`)p +Fp(x)j(==)g(y)p Fr(')25 b(is)g(gam)m(bling)h(with)f(random)e(errors.)38 +b(Better)-30 2901 y(c)m(hec)m(k)32 b(for)e(`)p Fp(abs\(x)f(-)h(y\))g(<) +g(epsilon)p Fr(')f(for)h(some)g(w)m(ell-c)m(hosen)i Fp(epsilon)p +Fr(.)-30 3039 y(Floating)g(p)s(oin)m(t)f(n)m(um)m(b)s(ers)d(come)i(in)g +(four)g(\015a)m(v)m(ors:)45 3176 y Fq(\017)60 b Fr(Short)28 +b(\015oats,)i(t)m(yp)s(e)g Fp(cl_SF)p Fr(.)38 b(They)29 +b(ha)m(v)m(e)h(1)f(sign)g(bit,)h(8)f(exp)s(onen)m(t)g(bits)g +(\(including)g(the)g(exp)s(onen)m(t's)g(sign\),)150 3286 +y(and)h(17)h(man)m(tissa)f(bits)h(\(including)f(the)g(\\hidden")g +(bit\).)41 b(They)30 b(don't)h(consume)e(heap)h(allo)s(cation.)45 +3422 y Fq(\017)60 b Fr(Single)43 b(\015oats,)k(t)m(yp)s(e)c +Fp(cl_FF)p Fr(.)78 b(They)42 b(ha)m(v)m(e)i(1)g(sign)f(bit,)j(8)e(exp)s +(onen)m(t)f(bits)g(\(including)g(the)g(exp)s(onen)m(t's)150 +3532 y(sign\),)29 b(and)e(24)i(man)m(tissa)e(bits)h(\(including)g(the)g +(\\hidden")f(bit\).)40 b(In)27 b(CLN,)h(they)g(are)g(represen)m(ted)g +(as)g(IEEE)150 3641 y(single-precision)k(\015oating)f(p)s(oin)m(t)f(n)m +(um)m(b)s(ers.)39 b(This)29 b(corresp)s(onds)g(closely)j(to)f(the)g +(C/C)p Fp(++)e Fr(t)m(yp)s(e)i(`)p Fp(float)p Fr('.)45 +3777 y Fq(\017)60 b Fr(Double)38 b(\015oats,)i(t)m(yp)s(e)e +Fp(cl_DF)p Fr(.)61 b(They)37 b(ha)m(v)m(e)i(1)f(sign)f(bit,)j(11)e(exp) +s(onen)m(t)g(bits)g(\(including)f(the)h(exp)s(onen)m(t's)150 +3887 y(sign\),)29 b(and)e(53)i(man)m(tissa)e(bits)h(\(including)g(the)g +(\\hidden")f(bit\).)40 b(In)27 b(CLN,)h(they)g(are)g(represen)m(ted)g +(as)g(IEEE)150 3997 y(double-precision)i(\015oating)i(p)s(oin)m(t)e(n)m +(um)m(b)s(ers.)38 b(This)30 b(corresp)s(onds)f(closely)j(to)f(the)g +(C/C)p Fp(++)e Fr(t)m(yp)s(e)i(`)p Fp(double)p Fr('.)45 +4133 y Fq(\017)60 b Fr(Long)27 b(\015oats,)i(t)m(yp)s(e)e +Fp(cl_LF)p Fr(.)38 b(They)27 b(ha)m(v)m(e)h(1)g(sign)f(bit,)h(32)g(exp) +s(onen)m(t)f(bits)g(\(including)g(the)g(exp)s(onen)m(t's)g(sign\),)150 +4242 y(and)k(n)g(man)m(tissa)g(bits)h(\(including)f(the)h(\\hidden")f +(bit\),)i(where)e(n)g Fp(>)p Fr(=)g(64.)45 b(The)31 b(precision)g(of)h +(a)g(long)g(\015oat)150 4352 y(is)e(unlimited,)g(but)f(once)i(created,) h(a)f(long)g(\015oat)g(has)f(a)h(\014xed)f(precision.)40 -b(\(No)32 b(\\lazy)g(recomputation".\))0 3501 y(Of)27 -b(course,)h(computations)f(with)g(long)g(\015oats)h(are)g(more)e(exp)s -(ensiv)m(e)h(than)g(those)h(with)f(smaller)g(\015oating-p)s(oin)m(t)0 -3626 y(formats.)0 3985 y(CLN)40 b(do)s(es)g(not)h(implemen)m(t)e -(features)h(lik)m(e)i(NaNs,)i(denormalized)c(n)m(um)m(b)s(ers)e(and)h -(gradual)i(under\015o)m(w.)69 b(If)0 4109 y(the)31 b(exp)s(onen)m(t)h -(range)f(of)g(some)g(\015oating-p)s(oin)m(t)h(t)m(yp)s(e)g(is)f(to)s(o) -h(limited)f(for)g(y)m(our)g(application,)i(c)m(ho)s(ose)f(another)0 -4234 y(\015oating-p)s(oin)m(t)g(t)m(yp)s(e)e(with)g(larger)h(exp)s -(onen)m(t)g(range.)0 4593 y(As)i(a)g(user)f(of)h(CLN,)g(y)m(ou)g(can)g -(forget)h(ab)s(out)f(the)g(di\013erences)g(b)s(et)m(w)m(een)g(the)g -(four)g(\015oating-p)s(oin)m(t)h(t)m(yp)s(es)f(and)0 -4717 y(just)i(declare)i(all)g(y)m(our)e(\015oating-p)s(oin)m(t)i(v)-5 -b(ariables)37 b(as)f(b)s(eing)f(of)h(t)m(yp)s(e)g Fp(cl_F)p -Fr(.)56 b(This)35 b(has)h(the)g(adv)-5 b(an)m(tage)37 -b(that)0 4842 y(when)27 b(y)m(ou)h(c)m(hange)h(the)f(precision)f(of)h -(some)f(computation)h(\(sa)m(y)-8 b(,)30 b(from)c Fp(cl_DF)h -Fr(to)h Fp(cl_LF)p Fr(\),)f(y)m(ou)i(don't)e(ha)m(v)m(e)i(to)0 -4966 y(c)m(hange)h(the)g(co)s(de,)g(only)f(the)h(precision)f(of)g(the)h -(initial)g(v)-5 b(alues.)41 b(Also,)30 b(man)m(y)f(transcenden)m(tal)h -(functions)f(ha)m(v)m(e)0 5091 y(b)s(een)f(declared)i(as)f(returning)g -(a)g Fp(cl_F)f Fr(when)g(the)i(argumen)m(t)e(is)i(a)f -Fp(cl_F)p Fr(,)g(but)f(suc)m(h)h(declarations)i(are)e(missing)0 -5215 y(for)g(the)g(t)m(yp)s(es)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p -Fr(,)f Fp(cl_DF)p Fr(,)h Fp(cl_LF)p Fr(.)39 b(\(Suc)m(h)29 -b(declarations)h(w)m(ould)f(b)s(e)f(wrong)g(if)h(the)g(\015oating)h(p)s -(oin)m(t)0 5340 y(con)m(tagion)j(rule)d(happ)s(ened)e(to)j(c)m(hange)h -(in)e(the)h(future.\))p eop -%%Page: 10 12 -10 11 bop 0 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 -b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2411 b(10)0 366 y Fs(3.3)68 -b(Complex)31 b(n)l(um)l(b)t(ers)0 654 y Fr(Complex)25 -b(n)m(um)m(b)s(ers,)g(as)i(implemen)m(ted)e(b)m(y)h(the)h(class)g -Fp(cl_N)p Fr(,)f(ha)m(v)m(e)h(a)g(real)g(part)f(and)g(an)g(imaginary)g -(part,)i(b)s(oth)0 778 y(real)38 b(n)m(um)m(b)s(ers.)59 -b(A)38 b(complex)f(n)m(um)m(b)s(er)e(whose)i(imaginary)g(part)g(is)g -(the)h(exact)h(n)m(um)m(b)s(er)c Fp(0)i Fr(is)g(automatically)0 -903 y(con)m(v)m(erted)32 b(to)f(a)g(real)g(n)m(um)m(b)s(er.)0 -1190 y(Complex)h(n)m(um)m(b)s(ers)e(can)k(arise)f(from)e(real)j(n)m(um) -m(b)s(ers)c(alone,)35 b(for)e(example)g(through)f(application)i(of)f -Fp(sqrt)f Fr(or)0 1315 y(transcenden)m(tal)f(functions.)0 -1883 y Fs(3.4)68 b(Con)l(v)l(ersions)0 2170 y Fr(Con)m(v)m(ersions)42 -b(from)d(an)m(y)j(class)f(to)h(an)m(y)g(its)f(sup)s(erclasses)g -(\(\\base)h(classes")g(in)f(C)p Fp(++)f Fr(terminology\))i(is)f(done)0 -2295 y(automatically)-8 b(.)0 2582 y(Con)m(v)m(ersions)24 -b(from)e(the)i(C)f(built-in)h(t)m(yp)s(es)f(`)p Fp(long)p -Fr(')g(and)h(`)p Fp(unsigned)k(long)p Fr(')23 b(are)h(pro)m(vided)f -(for)g(the)h(classes)h Fp(cl_I)p Fr(,)0 2706 y Fp(cl_RA)p -Fr(,)k Fp(cl_R)p Fr(,)h Fp(cl_N)f Fr(and)h Fp(cl_number)p -Fr(.)0 2994 y(Con)m(v)m(ersions)h(from)e(the)i(C)f(built-in)g(t)m(yp)s -(es)g(`)p Fp(int)p Fr(')g(and)g(`)p Fp(unsigned)f(int)p -Fr(')h(are)g(pro)m(vided)g(for)h(the)f(classes)i Fp(cl_I)p -Fr(,)0 3118 y Fp(cl_RA)p Fr(,)h Fp(cl_R)p Fr(,)g Fp(cl_N)f -Fr(and)g Fp(cl_number)p Fr(.)47 b(Ho)m(w)m(ev)m(er,)36 -b(these)e(con)m(v)m(ersions)g(emphasize)e(e\016ciency)-8 -b(.)51 b(Their)33 b(range)0 3243 y(is)d(therefore)h(limited:)49 -3530 y Fq(\000)60 b Fr(The)30 b(con)m(v)m(ersion)i(from)c(`)p +b(\(No)32 b(\\lazy)g(recomputation".\))-30 4516 y(Of)f(course,)i +(computations)e(with)h(long)g(\015oats)h(are)f(more)f(exp)s(ensiv)m(e)h +(than)f(those)i(with)e(smaller)h(\015oating-p)s(oin)m(t)-30 +4626 y(formats.)-30 4764 y(CLN)44 b(do)s(es)g(not)h(implemen)m(t)f +(features)g(lik)m(e)i(NaNs,)j(denormalized)44 b(n)m(um)m(b)s(ers)f(and) +h(gradual)g(under\015o)m(w.)82 b(If)-30 4873 y(the)36 +b(exp)s(onen)m(t)f(range)h(of)f(some)g(\015oating-p)s(oin)m(t)i(t)m(yp) +s(e)e(is)h(to)s(o)g(limited)f(for)g(y)m(our)g(application,)j(c)m(ho)s +(ose)f(another)-30 4983 y(\015oating-p)s(oin)m(t)32 b(t)m(yp)s(e)e +(with)g(larger)h(exp)s(onen)m(t)g(range.)-30 5121 y(As)37 +b(a)g(user)e(of)i(CLN,)g(y)m(ou)g(can)g(forget)g(ab)s(out)f(the)h +(di\013erences)g(b)s(et)m(w)m(een)g(the)g(four)f(\015oating-p)s(oin)m +(t)i(t)m(yp)s(es)f(and)-30 5230 y(just)i(declare)h(all)g(y)m(our)g +(\015oating-p)s(oin)m(t)g(v)-5 b(ariables)40 b(as)g(b)s(eing)f(of)g(t)m +(yp)s(e)h Fp(cl_F)p Fr(.)66 b(This)39 b(has)g(the)g(adv)-5 +b(an)m(tage)41 b(that)-30 5340 y(when)30 b(y)m(ou)i(c)m(hange)h(the)f +(precision)f(of)h(some)f(computation)g(\(sa)m(y)-8 b(,)34 +b(from)c Fp(cl_DF)g Fr(to)i Fp(cl_LF)p Fr(\),)f(y)m(ou)h(don't)f(ha)m +(v)m(e)i(to)p eop +%%Page: 8 10 +8 9 bop -30 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 +b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2517 b(8)-30 299 y(c)m(hange)34 +b(the)g(co)s(de,)g(only)f(the)g(precision)h(of)f(the)g(initial)i(v)-5 +b(alues.)49 b(Also,)35 b(man)m(y)d(transcenden)m(tal)i(functions)f(ha)m +(v)m(e)-30 408 y(b)s(een)f(declared)i(as)f(returning)f(a)h +Fp(cl_F)f Fr(when)g(the)h(argumen)m(t)f(is)h(a)g Fp(cl_F)p +Fr(,)g(but)f(suc)m(h)g(declarations)j(are)e(missing)-30 +518 y(for)f(the)h(t)m(yp)s(es)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p +Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)p Fr(.)45 b(\(Suc)m(h)33 +b(declarations)h(w)m(ould)e(b)s(e)g(wrong)g(if)h(the)f(\015oating)i(p)s +(oin)m(t)-30 628 y(con)m(tagion)f(rule)d(happ)s(ened)e(to)j(c)m(hange)h +(in)e(the)h(future.\))-30 941 y Fs(3.3)68 b(Complex)46 +b(n)l(um)l(b)t(ers)-30 1156 y Fr(Complex)29 b(n)m(um)m(b)s(ers,)f(as)j +(implemen)m(ted)e(b)m(y)h(the)g(class)h Fp(cl_N)p Fr(,)e(ha)m(v)m(e)j +(a)f(real)f(part)h(and)e(an)h(imaginary)g(part,)h(b)s(oth)-30 +1266 y(real)42 b(n)m(um)m(b)s(ers.)70 b(A)41 b(complex)g(n)m(um)m(b)s +(er)e(whose)i(imaginary)f(part)h(is)h(the)f(exact)h(n)m(um)m(b)s(er)d +Fp(0)i Fr(is)g(automatically)-30 1375 y(con)m(v)m(erted)32 +b(to)f(a)g(real)g(n)m(um)m(b)s(er.)-30 1532 y(Complex)36 +b(n)m(um)m(b)s(ers)f(can)i(arise)h(from)d(real)j(n)m(um)m(b)s(ers)d +(alone,)40 b(for)d(example)g(through)f(application)j(of)e +Fp(sqrt)f Fr(or)-30 1642 y(transcenden)m(tal)31 b(functions.)-30 +1955 y Fs(3.4)68 b(Con)l(v)l(ersions)-30 2170 y Fr(Con)m(v)m(ersions)46 +b(from)e(an)m(y)h(class)i(to)f(an)m(y)f(its)h(sup)s(erclasses)f +(\(\\base)h(classes")h(in)e(C)p Fp(++)g Fr(terminology\))h(is)f(done) +-30 2280 y(automatically)-8 b(.)-30 2437 y(Con)m(v)m(ersions)28 +b(from)f(the)h(C)f(built-in)h(t)m(yp)s(es)g(`)p Fp(long)p +Fr(')f(and)h(`)p Fp(unsigned)g(long)p Fr(')f(are)i(pro)m(vided)e(for)h +(the)g(classes)h Fp(cl_I)p Fr(,)-30 2546 y Fp(cl_RA)p +Fr(,)g Fp(cl_R)p Fr(,)h Fp(cl_N)f Fr(and)h Fp(cl_number)p +Fr(.)-30 2703 y(Con)m(v)m(ersions)35 b(from)e(the)i(C)g(built-in)f(t)m +(yp)s(es)h(`)p Fp(int)p Fr(')f(and)h(`)p Fp(unsigned)28 +b(int)p Fr(')34 b(are)h(pro)m(vided)g(for)f(the)h(classes)h +Fp(cl_I)p Fr(,)-30 2813 y Fp(cl_RA)p Fr(,)30 b Fp(cl_R)p +Fr(,)h Fp(cl_N)e Fr(and)i Fp(cl_number)p Fr(.)40 b(Ho)m(w)m(ev)m(er,)34 +b(these)e(con)m(v)m(ersions)g(emphasize)f(e\016ciency)-8 +b(.)44 b(Their)30 b(range)i(is)-30 2922 y(therefore)f(limited:)19 +3079 y Fq(\000)60 b Fr(The)30 b(con)m(v)m(ersion)i(from)c(`)p Fp(int)p Fr(')i(w)m(orks)h(only)f(if)h(the)f(argumen)m(t)g(is)g Fp(<)g Fr(2)p Fp(^)p Fr(29)i(and)e Fp(>)g Fr(-2)p Fp(^)p -Fr(29.)49 3693 y Fq(\000)60 b Fr(The)30 b(con)m(v)m(ersion)i(from)c(`)p +Fr(29.)19 3225 y Fq(\000)60 b Fr(The)30 b(con)m(v)m(ersion)i(from)c(`)p Fp(unsigned)h(int)p Fr(')h(w)m(orks)g(only)g(if)h(the)f(argumen)m(t)g -(is)h Fp(<)f Fr(2)p Fp(^)p Fr(29.)0 4018 y(In)g(a)g(declaration)i(lik)m -(e)g(`)p Fp(cl_I)d(x)h(=)g(10;)p Fr(')g(the)g(C)p Fp(++)f -Fr(compiler)h(is)h(able)f(to)h(do)f(the)h(con)m(v)m(ersion)g(of)g -Fp(10)f Fr(from)e(`)p Fp(int)p Fr(')0 4143 y(to)43 b(`)p -Fp(cl_I)p Fr(')e(at)i(compile)g(time)e(already)-8 b(.)78 -b(On)41 b(the)h(other)h(hand,)h(co)s(de)f(lik)m(e)g(`)p -Fp(cl_I)30 b(x)g(=)g(1000000000;)p Fr(')39 b(is)j(in)0 -4267 y(error.)g(So,)31 b(if)g(y)m(ou)g(w)m(an)m(t)h(to)g(b)s(e)e(sure)g -(that)h(an)g(`)p Fp(int)p Fr(')g(whose)f(magnitude)h(is)f(not)i(guaran) -m(teed)g(to)f(b)s(e)f Fp(<)h Fr(2)p Fp(^)p Fr(29)h(is)0 -4392 y(correctly)j(con)m(v)m(erted)f(to)g(a)g(`)p Fp(cl_I)p -Fr(',)f(\014rst)f(con)m(v)m(ert)j(it)f(to)g(a)f(`)p Fp(long)p -Fr('.)48 b(Similarly)-8 b(,)34 b(if)f(a)h(large)g(`)p -Fp(unsigned)28 b(int)p Fr(')33 b(is)0 4516 y(to)e(b)s(e)f(con)m(v)m -(erted)i(to)f(a)g(`)p Fp(cl_I)p Fr(',)f(\014rst)f(con)m(v)m(ert)j(it)f -(to)g(an)f(`)p Fp(unsigned)f(long)p Fr('.)0 4804 y(Con)m(v)m(ersions)h -(from)f(the)h(C)f(built-in)h(t)m(yp)s(e)g(`)p Fp(float)p -Fr(')f(are)h(pro)m(vided)g(for)f(the)h(classes)h Fp(cl_FF)p -Fr(,)e Fp(cl_F)p Fr(,)g Fp(cl_R)p Fr(,)g Fp(cl_N)0 4928 -y Fr(and)h Fp(cl_number)p Fr(.)0 5215 y(Con)m(v)m(ersions)d(from)e(the) -i(C)f(built-in)g(t)m(yp)s(e)h(`)p Fp(double)p Fr(')e(are)i(pro)m(vided) -g(for)f(the)h(classes)g Fp(cl_DF)p Fr(,)f Fp(cl_F)p Fr(,)h -Fp(cl_R)p Fr(,)f Fp(cl_N)0 5340 y Fr(and)k Fp(cl_number)p -Fr(.)p eop -%%Page: 11 13 -11 12 bop 0 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 -b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2411 b(11)0 366 y(Con)m(v)m(ersions)35 -b(from)f(`)p Fp(const)29 b(char)g(*)p Fr(')35 b(are)g(pro)m(vided)g -(for)f(the)i(classes)f Fp(cl_I)p Fr(,)h Fp(cl_RA)p Fr(,)e -Fp(cl_SF)p Fr(,)h Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)0 -491 y Fp(cl_LF)p Fr(,)e Fp(cl_F)p Fr(,)h Fp(cl_R)p Fr(,)g -Fp(cl_N)p Fr(.)50 b(The)33 b(easiest)i(w)m(a)m(y)g(to)g(sp)s(ecify)e(a) -h(v)-5 b(alue)34 b(whic)m(h)g(is)g(outside)g(of)g(the)g(range)g(of)g -(the)0 616 y(C)p Fp(++)29 b Fr(built-in)i(t)m(yp)s(es)f(is)g(therefore) -h(to)g(sp)s(ecify)f(it)h(as)g(a)g(string,)f(lik)m(e)i(this:)383 -869 y Fp(cl_I)47 b(order_of_rubiks_cube_gro)o(up)41 b(=)48 -b("43252003274489856000";)0 1143 y Fr(Note)32 b(that)f(this)f(con)m(v)m -(ersion)i(is)e(done)g(at)h(run)m(time,)f(not)g(at)h(compile-time.)0 -1417 y(Con)m(v)m(ersions)h(from)f Fp(cl_I)g Fr(to)h(the)g(C)g(built-in) -g(t)m(yp)s(es)g(`)p Fp(int)p Fr(',)g(`)p Fp(unsigned)c(int)p -Fr(',)k(`)p Fp(long)p Fr(',)g(`)p Fp(unsigned)d(long)p -Fr(')i(are)0 1541 y(pro)m(vided)f(through)g(the)g(functions)0 -1840 y Fp(int)f(cl_I_to_int)f(\(const)g(cl_I&)h(x\))0 -1965 y(unsigned)f(int)i(cl_I_to_uint)d(\(const)h(cl_I&)h(x\))0 -2089 y(long)g(cl_I_to_long)e(\(const)i(cl_I&)g(x\))0 -2214 y(unsigned)f(long)h(cl_I_to_ulong)e(\(const)i(cl_I&)g(x\))480 -2338 y Fr(Returns)37 b Fp(x)h Fr(as)h(elemen)m(t)f(of)h(the)f(C)g(t)m -(yp)s(e)g Fk(ct)m(yp)s(e)p Fr(.)65 b(If)38 b Fp(x)f Fr(is)i(not)f -(represen)m(table)h(in)f(the)g(range)h(of)480 2463 y -Fk(ct)m(yp)s(e)p Fr(,)31 b(a)g(run)m(time)e(error)h(o)s(ccurs.)0 -2762 y(Con)m(v)m(ersions)35 b(from)e(the)h(classes)i -Fp(cl_I)p Fr(,)e Fp(cl_RA)p Fr(,)g Fp(cl_SF)p Fr(,)g -Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)h Fp(cl_LF)p Fr(,)f -Fp(cl_F)f Fr(and)h Fp(cl_R)f Fr(to)i(the)f(C)0 2886 y(built-in)c(t)m -(yp)s(es)h(`)p Fp(float)p Fr(')e(and)h(`)p Fp(double)p -Fr(')f(are)i(pro)m(vided)f(through)f(the)i(functions)0 -3185 y Fp(float)e(cl_float_approx)d(\(const)j Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))0 3310 y(double)f(cl_double_approx)d(\(const)i -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))480 3434 y Fr(Returns)25 -b(an)h(appro)m(ximation)g(of)g Fp(x)f Fr(of)h(C)g(t)m(yp)s(e)g -Fk(ct)m(yp)s(e)p Fr(.)39 b(If)26 b Fp(abs\(x\))e Fr(is)i(to)s(o)g -(close)i(to)e(0)g(\(under\015o)m(w\),)480 3559 y(0)31 -b(is)f(returned.)40 b(If)30 b Fp(abs\(x\))e Fr(is)j(to)s(o)g(large)g -(\(o)m(v)m(er\015o)m(w\),)i(an)d(IEEE)g(in\014nit)m(y)g(is)h(returned.) -0 3858 y(Con)m(v)m(ersions)g(from)e(an)m(y)i(class)g(to)g(an)m(y)g(of)g +(is)h Fp(<)f Fr(2)p Fp(^)p Fr(29.)-30 3418 y(In)j(a)h(declaration)i +(lik)m(e)f(`)p Fp(cl_I)29 b(x)h(=)g(10;)p Fr(')j(the)h(C)p +Fp(++)f Fr(compiler)g(is)h(able)h(to)f(do)g(the)g(con)m(v)m(ersion)h +(of)f Fp(10)f Fr(from)f(`)p Fp(int)p Fr(')-30 3528 y(to)f(`)p +Fp(cl_I)p Fr(')f(at)i(compile)e(time)g(already)-8 b(.)43 +b(On)30 b(the)g(other)h(hand,)f(co)s(de)h(lik)m(e)h(`)p +Fp(cl_I)d(x)h(=)g(1000000000;)p Fr(')e(is)j(in)f(error.)-30 +3637 y(So,)f(if)f(y)m(ou)g(w)m(an)m(t)h(to)g(b)s(e)e(sure)g(that)i(an)f +(`)p Fp(int)p Fr(')f(whose)h(magnitude)f(is)h(not)h(guaran)m(teed)g(to) +f(b)s(e)g Fp(<)f Fr(2)p Fp(^)p Fr(29)i(is)g(correctly)-30 +3747 y(con)m(v)m(erted)45 b(to)f(a)g(`)p Fp(cl_I)p Fr(',)i(\014rst)c +(con)m(v)m(ert)j(it)f(to)g(a)g(`)p Fp(long)p Fr('.)79 +b(Similarly)-8 b(,)47 b(if)c(a)h(large)g(`)p Fp(unsigned)28 +b(int)p Fr(')43 b(is)g(to)i(b)s(e)-30 3856 y(con)m(v)m(erted)32 +b(to)f(a)g(`)p Fp(cl_I)p Fr(',)f(\014rst)f(con)m(v)m(ert)j(it)f(to)g +(an)g(`)p Fp(unsigned)d(long)p Fr('.)-30 4013 y(Con)m(v)m(ersions)34 +b(from)e(the)i(C)g(built-in)f(t)m(yp)s(e)h(`)p Fp(float)p +Fr(')f(are)h(pro)m(vided)f(for)h(the)g(classes)g Fp(cl_FF)p +Fr(,)g Fp(cl_F)p Fr(,)f Fp(cl_R)p Fr(,)h Fp(cl_N)-30 +4123 y Fr(and)c Fp(cl_number)p Fr(.)-30 4280 y(Con)m(v)m(ersions)h +(from)e(the)i(C)f(built-in)h(t)m(yp)s(e)g(`)p Fp(double)p +Fr(')e(are)i(pro)m(vided)g(for)f(the)h(classes)h Fp(cl_DF)p +Fr(,)d Fp(cl_F)p Fr(,)h Fp(cl_R)p Fr(,)g Fp(cl_N)-30 +4389 y Fr(and)g Fp(cl_number)p Fr(.)-30 4546 y(Con)m(v)m(ersions)40 +b(from)e(`)p Fp(const)29 b(char)g(*)p Fr(')40 b(are)g(pro)m(vided)f +(for)g(the)h(classes)g Fp(cl_I)p Fr(,)h Fp(cl_RA)p Fr(,)g +Fp(cl_SF)p Fr(,)f Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)-30 +4656 y Fp(cl_LF)p Fr(,)26 b Fp(cl_F)p Fr(,)h Fp(cl_R)p +Fr(,)g Fp(cl_N)p Fr(.)38 b(The)27 b(easiest)h(w)m(a)m(y)g(to)g(sp)s +(ecify)e(a)i(v)-5 b(alue)27 b(whic)m(h)g(is)g(outside)g(of)g(the)g +(range)h(of)f(the)g(C)p Fp(++)-30 4765 y Fr(built-in)j(t)m(yp)s(es)h +(is)f(therefore)h(to)g(sp)s(ecify)f(it)h(as)g(a)f(string,)h(lik)m(e)h +(this:)353 4917 y Fp(cl_I)47 b(order_of_rubiks_cube_gro)o(up)41 +b(=)48 b("43252003274489856000";)-30 5073 y Fr(Note)32 +b(that)f(this)f(con)m(v)m(ersion)i(is)e(done)g(at)h(run)m(time,)f(not)g +(at)h(compile-time.)-30 5230 y(Con)m(v)m(ersions)37 b(from)e +Fp(cl_I)h Fr(to)h(the)g(C)f(built-in)h(t)m(yp)s(es)f(`)p +Fp(int)p Fr(',)i(`)p Fp(unsigned)29 b(int)p Fr(',)38 +b(`)p Fp(long)p Fr(',)f(`)p Fp(unsigned)29 b(long)p Fr(')36 +b(are)-30 5340 y(pro)m(vided)30 b(through)g(the)g(functions)p +eop +%%Page: 9 11 +9 10 bop -30 -116 a Fr(Chapter)30 b(3:)41 b(Ordinary)29 +b(n)m(um)m(b)s(er)f(t)m(yp)s(es)2517 b(9)-30 299 y Fp(int)29 +b(cl_I_to_int)f(\(const)g(cl_I&)h(x\))-30 408 y(unsigned)f(int)i +(cl_I_to_uint)d(\(const)h(cl_I&)h(x\))-30 518 y(long)g(cl_I_to_long)e +(\(const)i(cl_I&)g(x\))-30 628 y(unsigned)f(long)h(cl_I_to_ulong)e +(\(const)i(cl_I&)g(x\))450 737 y Fr(Returns)d Fp(x)g +Fr(as)h(elemen)m(t)h(of)f(the)g(C)f(t)m(yp)s(e)h Fl(ct)m(yp)s(e)p +Fr(.)40 b(If)27 b Fp(x)f Fr(is)h(not)g(represen)m(table)g(in)g(the)g +(range)g(of)g Fl(ct)m(yp)s(e)p Fr(,)450 847 y(a)k(run)m(time)e(error)h +(o)s(ccurs.)-30 1006 y(Con)m(v)m(ersions)38 b(from)f(the)h(classes)h +Fp(cl_I)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_SF)p Fr(,)f +Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)g Fp(cl_LF)p Fr(,)f +Fp(cl_F)f Fr(and)h Fp(cl_R)e Fr(to)j(the)f(C)-30 1116 +y(built-in)30 b(t)m(yp)s(es)h(`)p Fp(float)p Fr(')e(and)h(`)p +Fp(double)p Fr(')f(are)i(pro)m(vided)f(through)f(the)i(functions)-30 +1275 y Fp(float)e(cl_float_approx)d(\(const)j Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))-30 1385 y(double)f(cl_double_approx)d(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 1494 y Fr(Returns)e(an)h(appro)m +(ximation)f(of)h Fp(x)g Fr(of)g(C)f(t)m(yp)s(e)h Fl(ct)m(yp)s(e)p +Fr(.)41 b(If)29 b Fp(abs\(x\))f Fr(is)i(to)s(o)h(close)g(to)f(0)g +(\(under\015o)m(w\),)450 1604 y(0)h(is)f(returned.)40 +b(If)30 b Fp(abs\(x\))e Fr(is)j(to)s(o)g(large)g(\(o)m(v)m(er\015o)m +(w\),)i(an)d(IEEE)g(in\014nit)m(y)g(is)h(returned.)-30 +1763 y(Con)m(v)m(ersions)k(from)e(an)m(y)i(class)g(to)g(an)m(y)g(of)g (its)g(sub)s(classes)f(\(\\deriv)m(ed)h(classes")h(in)e(C)p -Fp(++)g Fr(terminology\))h(are)g(not)0 3982 y(pro)m(vided.)40 -b(Instead,)31 b(y)m(ou)f(can)h(assert)g(and)e(c)m(hec)m(k)j(that)f(a)g -(v)-5 b(alue)31 b(b)s(elongs)f(to)h(a)f(certain)i(sub)s(class,)d(and)h -(return)0 4107 y(it)38 b(as)f(elemen)m(t)h(of)g(that)f(class,)j(using)d -(the)h(`)p Fp(As)p Fr(')f(and)g(`)p Fp(The)p Fr(')f(macros.)61 -b Fp(As\()p Fk(t)m(yp)s(e)5 b Fp(\)\()p Fk(v)-5 b(alue)5 -b Fp(\))37 b Fr(c)m(hec)m(ks)i(that)e Fk(v)-5 b(alue)0 -4231 y Fr(b)s(elongs)29 b(to)h Fk(t)m(yp)s(e)35 b Fr(and)29 -b(returns)f(it)i(as)f(suc)m(h.)40 b Fp(The\()p Fk(t)m(yp)s(e)5 -b Fp(\)\()p Fk(v)-5 b(alue)5 b Fp(\))29 b Fr(assumes)f(that)i -Fk(v)-5 b(alue)35 b Fr(b)s(elongs)29 b(to)h Fk(t)m(yp)s(e)35 -b Fr(and)0 4356 y(returns)29 b(it)i(as)g(suc)m(h.)40 +Fp(++)g Fr(terminology\))h(are)g(not)-30 1873 y(pro)m(vided.)40 +b(Instead,)29 b(y)m(ou)f(can)h(assert)g(and)e(c)m(hec)m(k)j(that)f(a)g +(v)-5 b(alue)29 b(b)s(elongs)f(to)h(a)g(certain)g(sub)s(class,)f(and)g +(return)f(it)-30 1983 y(as)f(elemen)m(t)h(of)f(that)h(class,)h(using)d +(the)h(`)p Fp(As)p Fr(')g(and)g(`)p Fp(The)p Fr(')f(macros.)39 +b Fp(As\()p Fl(t)m(yp)s(e)5 b Fp(\)\()p Fl(v)-5 b(alue)5 +b Fp(\))25 b Fr(c)m(hec)m(ks)j(that)e Fl(v)-5 b(alue)32 +b Fr(b)s(elongs)-30 2092 y(to)d Fl(t)m(yp)s(e)k Fr(and)28 +b(returns)f(it)i(as)f(suc)m(h.)40 b Fp(The\()p Fl(t)m(yp)s(e)5 +b Fp(\)\()p Fl(v)-5 b(alue)5 b Fp(\))27 b Fr(assumes)g(that)i +Fl(v)-5 b(alue)33 b Fr(b)s(elongs)28 b(to)h Fl(t)m(yp)s(e)34 +b Fr(and)27 b(returns)g(it)-30 2202 y(as)k(suc)m(h.)40 b(It)31 b(is)f(y)m(our)g(resp)s(onsibilit)m(y)h(to)g(ensure)e(that)i -(this)g(assumption)d(is)j(v)-5 b(alid.)41 b(Example:)383 -4609 y Fp(cl_I)47 b(x)g(=)h Fn(:)15 b(:)g(:)q Fp(;)383 -4713 y(if)47 b(\(!\(x)g(>=)g(0\)\))g(abort\(\);)383 4816 -y(cl_I)g(ten_x)f(=)i(The\(cl_I\)\(expt\(10,x\)\);)41 -b(//)48 b(If)f(x)g(>=)g(0,)h(10^x)e(is)h(an)h(integer.)1004 -4920 y(//)f(In)g(general,)f(it)h(would)f(be)h(a)h(rational)d(number.)p -eop +(this)g(assumption)d(is)j(v)-5 b(alid.)41 b(Example:)353 +2330 y Fp(cl_I)47 b(x)g(=)h(...)o(;)353 2434 y(if)f(\(!\(x)g(>=)g +(0\)\))g(abort\(\);)353 2538 y(cl_I)g(ten_x)f(=)i +(The\(cl_I\)\(expt\(10,x\)\);)41 b(//)48 b(If)f(x)g(>=)g(0,)h(10^x)e +(is)h(an)h(integer.)974 2642 y(//)f(In)g(general,)f(it)h(would)f(be)h +(a)h(rational)d(number.)p eop +%%Page: 10 12 +10 11 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(10)-30 299 y Fo(4)80 b(F)-13 +b(unctions)53 b(on)g(n)l(um)l(b)t(ers)-30 600 y Fr(Eac)m(h)36 +b(of)g(the)g(n)m(um)m(b)s(er)d(classes)k(declares)f(its)g(mathematical) +g(op)s(erations)g(in)f(the)h(corresp)s(onding)e(include)i(\014le.)-30 +709 y(F)-8 b(or)31 b(example,)f(if)g(y)m(our)g(co)s(de)g(op)s(erates)h +(with)e(ob)5 b(jects)31 b(of)f(t)m(yp)s(e)h Fp(cl_I)p +Fr(,)e(it)h(should)f Fp(#include)g()p Fr(.)-30 +1022 y Fs(4.1)68 b(Constructing)45 b(n)l(um)l(b)t(ers)-30 +1237 y Fr(Here)31 b(is)f(ho)m(w)h(to)g(create)h(n)m(um)m(b)s(er)c(ob)5 +b(jects)31 b(\\from)e(nothing".)-30 1505 y Fn(4.1.1)63 +b(Constructing)41 b(in)m(tegers)-30 1720 y Fp(cl_I)28 +b Fr(ob)5 b(jects)30 b(are)f(most)g(easily)h(constructed)f(from)f(C)g +(in)m(tegers)i(and)f(from)f(strings.)40 b(See)29 b(Section)h(3.4)g +([Con)m(v)m(er-)-30 1830 y(sions],)h(page)g(8.)-30 2098 +y Fn(4.1.2)63 b(Constructing)41 b(rational)g(n)m(um)m(b)s(ers)-30 +2313 y Fp(cl_RA)e Fr(ob)5 b(jects)41 b(can)g(b)s(e)f(constructed)h +(from)e(strings.)71 b(The)40 b(syn)m(tax)h(for)f(rational)i(n)m(um)m(b) +s(ers)c(is)j(describ)s(ed)e(in)-30 2423 y(Section)44 +b(5.1)g([In)m(ternal)g(and)f(prin)m(ted)g(represen)m(tation],)48 +b(page)c(28.)80 b(Another)44 b(standard)e(w)m(a)m(y)i(to)g(pro)s(duce)f +(a)-30 2532 y(rational)32 b(n)m(um)m(b)s(er)c(is)i(through)g +(application)h(of)g(`)p Fp(operator)d(/)p Fr(')j(or)f(`)p +Fp(recip)p Fr(')f(on)i(in)m(tegers.)-30 2801 y Fn(4.1.3)63 +b(Constructing)41 b(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers)-30 +3016 y Fp(cl_F)h Fr(ob)5 b(jects)45 b(with)f(lo)m(w)h(precision)f(are)g +(most)g(easily)h(constructed)g(from)d(C)i(`)p Fp(float)p +Fr(')f(and)h(`)p Fp(double)p Fr('.)81 b(See)-30 3125 +y(Section)31 b(3.4)h([Con)m(v)m(ersions],)f(page)g(8.)-30 +3282 y(T)-8 b(o)34 b(construct)h(a)f Fp(cl_F)e Fr(with)i(high)g +(precision,)h(y)m(ou)f(can)g(use)g(the)g(con)m(v)m(ersion)h(from)d(`)p +Fp(const)d(char)h(*)p Fr(',)k(but)g(y)m(ou)-30 3392 y(ha)m(v)m(e)e(to)f +(sp)s(ecify)f(the)h(desired)f(precision)h(within)f(the)h(string.)41 +b(\(See)32 b(Section)f(5.1)h([In)m(ternal)f(and)f(prin)m(ted)g(repre-) +-30 3501 y(sen)m(tation],)i(page)g(28.\))41 b(Example:)353 +3652 y Fp(cl_F)47 b(e)g(=)h("0.27182818284590452353)o(6028)o(7471)o +(352)o(6624)o(9775)o(724)o(7093)o(6999)o(6e+)o(1_40)o(";)-30 +3809 y Fr(will)31 b(set)g(`)p Fp(e)p Fr(')f(to)h(the)g(giv)m(en)g(v)-5 +b(alue,)31 b(with)f(a)h(precision)g(of)f(40)h(decimal)g(digits.)-30 +3966 y(The)e(programmatic)g(w)m(a)m(y)h(to)h(construct)f(a)g +Fp(cl_F)e Fr(with)i(high)f(precision)h(is)f(through)g(the)h +Fp(cl_float)e Fr(con)m(v)m(ersion)-30 4075 y(function,)c(see)e(Section) +h(4.11.1)h([Con)m(v)m(ersion)f(to)f(\015oating-p)s(oin)m(t)i(n)m(um)m +(b)s(ers],)d(page)i(25.)39 b(F)-8 b(or)22 b(example,)i(to)f(compute)-30 +4185 y Fp(e)43 b Fr(to)h(40)g(decimal)f(places,)k(\014rst)c(construct)g +(1.0)h(to)g(40)g(decimal)f(places)h(and)f(then)g(apply)g(the)g(exp)s +(onen)m(tial)-30 4294 y(function:)353 4445 y Fp(cl_float_format_t)g +(precision)j(=)h(cl_float_format\(40\);)353 4549 y(cl_F)g(e)g(=)h +(exp\(cl_float\(1,precisio)o(n\)\);)-30 4818 y Fn(4.1.4)63 +b(Constructing)41 b(complex)f(n)m(um)m(b)s(ers)-30 5032 +y Fr(Non-real)31 b Fp(cl_N)f Fr(ob)5 b(jects)31 b(are)g(normally)e +(constructed)i(through)e(the)i(function)353 5183 y Fp(cl_N)47 +b(complex)f(\(const)g(cl_R&)g(realpart,)f(const)i(cl_R&)f(imagpart\)) +-30 5340 y Fr(See)31 b(Section)g(4.4)g([Elemen)m(tary)g(complex)f +(functions],)g(page)h(12.)p eop +%%Page: 11 13 +11 12 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(11)-30 299 y Fs(4.2)68 +b(Elemen)l(tary)47 b(functions)-30 491 y Fr(Eac)m(h)27 +b(of)f(the)h(classes)g Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)g +Fp(cl_RA)p Fr(,)g Fp(cl_I)p Fr(,)g Fp(cl_F)p Fr(,)g Fp(cl_SF)p +Fr(,)g Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)f +Fr(de\014nes)g(the)h(follo)m(wing)-30 601 y(op)s(erations:)-30 +760 y Fl(t)m(yp)s(e)36 b Fp(operator)28 b(+)i(\(const)e +Fl(t)m(yp)s(e)5 b Fp(&,)31 b(const)d Fl(t)m(yp)s(e)5 +b Fp(&\))450 870 y Fr(Addition.)-30 1029 y Fl(t)m(yp)s(e)36 +b Fp(operator)28 b(-)i(\(const)e Fl(t)m(yp)s(e)5 b Fp(&,)31 +b(const)d Fl(t)m(yp)s(e)5 b Fp(&\))450 1139 y Fr(Subtraction.)-30 +1298 y Fl(t)m(yp)s(e)36 b Fp(operator)28 b(-)i(\(const)e +Fl(t)m(yp)s(e)5 b Fp(&\))450 1407 y Fr(Returns)29 b(the)i(negativ)m(e)i +(of)d(the)h(argumen)m(t.)-30 1567 y Fl(t)m(yp)s(e)36 +b Fp(plus1)29 b(\(const)f Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 +1676 y Fr(Returns)e Fp(x)h(+)h(1)p Fr(.)-30 1835 y Fl(t)m(yp)s(e)36 +b Fp(minus1)28 b(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 1945 y Fr(Returns)f Fp(x)h(-)h(1)p Fr(.)-30 +2104 y Fl(t)m(yp)s(e)36 b Fp(operator)28 b(*)i(\(const)e +Fl(t)m(yp)s(e)5 b Fp(&,)31 b(const)d Fl(t)m(yp)s(e)5 +b Fp(&\))450 2214 y Fr(Multiplication.)-30 2373 y Fl(t)m(yp)s(e)36 +b Fp(square)28 b(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 2483 y Fr(Returns)f Fp(x)h(*)h(x)p Fr(.)-30 +2642 y(Eac)m(h)43 b(of)g(the)f(classes)i Fp(cl_N)p Fr(,)h +Fp(cl_R)p Fr(,)f Fp(cl_RA)p Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p +Fr(,)g Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)f Fp(cl_LF)d +Fr(de\014nes)h(the)g(follo)m(wing)-30 2751 y(op)s(erations:)-30 +2911 y Fl(t)m(yp)s(e)36 b Fp(operator)28 b(/)i(\(const)e +Fl(t)m(yp)s(e)5 b Fp(&,)31 b(const)d Fl(t)m(yp)s(e)5 +b Fp(&\))450 3020 y Fr(Division.)-30 3179 y Fl(t)m(yp)s(e)36 +b Fp(recip)29 b(\(const)f Fl(t)m(yp)s(e)5 b Fp(&\))450 +3289 y Fr(Returns)29 b(the)i(recipro)s(cal)g(of)g(the)f(argumen)m(t.) +-30 3448 y(The)h(class)h Fp(cl_I)d Fr(do)s(esn't)i(de\014ne)g(a)g(`)p +Fp(/)p Fr(')h(op)s(eration)f(b)s(ecause)g(in)g(the)g(C/C)p +Fp(++)g Fr(language)h(this)f(op)s(erator,)h(applied)-30 +3558 y(to)j(in)m(tegral)h(t)m(yp)s(es,)g(denotes)f(the)g(`)p +Fp(floor)p Fr(')e(or)h(`)p Fp(truncate)p Fr(')f(op)s(eration)i(\(whic)m +(h)g(one)f(of)h(these,)h(is)f(implemen)m(ta-)-30 3667 +y(tion)g(dep)s(enden)m(t\).)51 b(\(See)35 b(Section)g(4.6)g([Rounding)f +(functions],)h(page)g(13.\))53 b(Instead,)36 b Fp(cl_I)d +Fr(de\014nes)g(an)h(\\exact)-30 3777 y(quotien)m(t")e(function:)-30 +3936 y Fp(cl_I)d(exquo)g(\(const)g(cl_I&)g(x,)h(const)e(cl_I&)h(y\))450 +4046 y Fr(Chec)m(ks)i(that)g Fp(y)f Fr(divides)g Fp(x)p +Fr(,)g(and)g(returns)f(the)h(quotien)m(t)i Fp(x)p Fr(/)p +Fp(y)p Fr(.)-30 4205 y(The)e(follo)m(wing)i(exp)s(onen)m(tiation)f +(functions)f(are)h(de\014ned:)-30 4364 y Fp(cl_I)e(expt_pos)f(\(const)h +(cl_I&)g(x,)h(const)f(cl_I&)g(y\))-30 4474 y(cl_RA)g(expt_pos)f +(\(const)h(cl_RA&)f(x,)i(const)f(cl_I&)g(y\))450 4583 +y(y)h Fr(m)m(ust)f(b)s(e)h Fp(>)g Fr(0.)41 b(Returns)30 +b Fp(x^y)p Fr(.)-30 4742 y Fp(cl_RA)f(expt)g(\(const)g(cl_RA&)f(x,)i +(const)f(cl_I&)g(y\))-30 4852 y(cl_R)g(expt)g(\(const)g(cl_R&)g(x,)h +(const)f(cl_I&)g(y\))-30 4962 y(cl_N)g(expt)g(\(const)g(cl_N&)g(x,)h +(const)f(cl_I&)g(y\))450 5071 y Fr(Returns)g Fp(x^y)p +Fr(.)-30 5230 y(Eac)m(h)43 b(of)g(the)f(classes)i Fp(cl_R)p +Fr(,)h Fp(cl_RA)p Fr(,)f Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)f +Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)f +Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)-30 5340 +y(op)s(eration:)p eop %%Page: 12 14 -12 13 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(12)0 366 y Fo(4)80 b(F)-13 -b(unctions)29 b(on)h(n)l(um)l(b)t(ers)0 754 y Fr(Eac)m(h)i(of)f(the)g -(n)m(um)m(b)s(er)e(classes)i(declares)h(its)g(mathematical)f(op)s -(erations)g(in)g(the)g(corresp)s(onding)f(include)h(\014le.)0 -879 y(F)-8 b(or)26 b(example,)g(if)g(y)m(our)f(co)s(de)g(op)s(erates)h -(with)f(ob)5 b(jects)26 b(of)f(t)m(yp)s(e)h Fp(cl_I)p -Fr(,)f(it)h(should)e Fp(#include)29 b()p -Fr(.)0 1353 y Fs(4.1)68 b(Constructing)31 b(n)l(um)l(b)t(ers)0 -1630 y Fr(Here)g(is)f(ho)m(w)h(to)g(create)h(n)m(um)m(b)s(er)c(ob)5 -b(jects)31 b(\\from)e(nothing".)0 2071 y Fm(4.1.1)63 -b(Constructing)30 b(in)m(tegers)0 2348 y Fp(cl_I)i Fr(ob)5 -b(jects)33 b(are)g(most)f(easily)i(constructed)f(from)e(C)i(in)m -(tegers)h(and)e(from)f(strings.)48 b(See)32 b(Section)i(3.4)g([Con-)0 -2472 y(v)m(ersions],)d(page)g(10.)0 2913 y Fm(4.1.2)63 -b(Constructing)30 b(rational)h(n)m(um)m(b)s(ers)0 3190 -y Fp(cl_RA)k Fr(ob)5 b(jects)38 b(can)f(b)s(e)f(constructed)h(from)e -(strings.)60 b(The)37 b(syn)m(tax)g(for)f(rational)i(n)m(um)m(b)s(ers)d -(is)i(describ)s(ed)e(in)0 3314 y(Section)40 b(5.1)h([In)m(ternal)f(and) -e(prin)m(ted)h(represen)m(tation],)k(page)e(37.)68 b(Another)39 -b(standard)g(w)m(a)m(y)h(to)g(pro)s(duce)f(a)0 3439 y(rational)32 -b(n)m(um)m(b)s(er)c(is)i(through)g(application)h(of)g(`)p -Fp(operator)d(/)p Fr(')j(or)f(`)p Fp(recip)p Fr(')f(on)i(in)m(tegers.)0 -3880 y Fm(4.1.3)63 b(Constructing)30 b(\015oating-p)s(oin)m(t)i(n)m(um) -m(b)s(ers)0 4157 y Fp(cl_F)39 b Fr(ob)5 b(jects)41 b(with)f(lo)m(w)i -(precision)e(are)h(most)f(easily)h(constructed)g(from)e(C)h(`)p -Fp(float)p Fr(')f(and)h(`)p Fp(double)p Fr('.)70 b(See)0 -4281 y(Section)31 b(3.4)h([Con)m(v)m(ersions],)f(page)g(10.)0 -4558 y(T)-8 b(o)42 b(construct)g(a)h Fp(cl_F)d Fr(with)i(high)f -(precision,)k(y)m(ou)d(can)h(use)e(the)h(con)m(v)m(ersion)h(from)d(`)p -Fp(const)30 b(char)f(*)p Fr(',)45 b(but)0 4683 y(y)m(ou)33 -b(ha)m(v)m(e)h(to)f(sp)s(ecify)f(the)g(desired)g(precision)h(within)f -(the)h(string.)47 b(\(See)33 b(Section)g(5.1)g([In)m(ternal)h(and)d -(prin)m(ted)0 4807 y(represen)m(tation],)h(page)f(37.\))42 -b(Example:)383 5063 y Fp(cl_F)47 b(e)g(=)h("0.27182818284590452353)o -(6028)o(7471)o(352)o(6624)o(9775)o(724)o(7093)o(6999)o(6e+)o(1_40)o(";) -0 5340 y Fr(will)31 b(set)g(`)p Fp(e)p Fr(')f(to)h(the)g(giv)m(en)g(v) --5 b(alue,)31 b(with)f(a)h(precision)g(of)f(40)h(decimal)g(digits.)p -eop +12 13 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(12)-30 299 y Fl(t)m(yp)s(e)36 +b Fp(abs)29 b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 +408 y Fr(Returns)f(the)i(absolute)g(v)-5 b(alue)31 b(of)f +Fp(x)p Fr(.)41 b(This)29 b(is)i Fp(x)f Fr(if)g Fp(x)g(>=)g(0)p +Fr(,)g(and)g Fp(-x)g Fr(if)g Fp(x)g(<=)g(0)p Fr(.)-30 +588 y(The)g(class)h Fp(cl_N)e Fr(implemen)m(ts)g(this)h(as)h(follo)m +(ws:)-30 767 y Fp(cl_R)e(abs)h(\(const)e(cl_N)i(x\))450 +877 y Fr(Returns)f(the)i(absolute)g(v)-5 b(alue)31 b(of)f +Fp(x)p Fr(.)-30 1057 y(Eac)m(h)d(of)f(the)h(classes)g +Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_I)p +Fr(,)g Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)f Fr(de\014nes)g(the)h(follo)m(wing) +-30 1166 y(op)s(eration:)-30 1346 y Fl(t)m(yp)s(e)36 +b Fp(signum)28 b(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 1455 y Fr(Returns)f(the)h(sign)g(of)g Fp(x)p +Fr(,)g(in)f(the)i(same)e(n)m(um)m(b)s(er)e(format)j(as)g +Fp(x)p Fr(.)40 b(This)29 b(is)h(de\014ned)f(as)h Fp(x)g(/)g(abs\(x\))e +Fr(if)450 1565 y Fp(x)i Fr(is)g(non-zero,)i(and)d Fp(x)h +Fr(if)h Fp(x)f Fr(is)g(zero.)42 b(If)30 b Fp(x)g Fr(is)g(real,)h(the)g +(v)-5 b(alue)31 b(is)f(either)h(0)g(or)f(1)h(or)f(-1.)-30 +1856 y Fs(4.3)68 b(Elemen)l(tary)47 b(rational)f(functions)-30 +2062 y Fr(Eac)m(h)31 b(of)g(the)f(classes)i Fp(cl_RA)p +Fr(,)d Fp(cl_I)g Fr(de\014nes)g(the)i(follo)m(wing)h(op)s(erations:)-30 +2241 y Fp(cl_I)d(numerator)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 2351 y Fr(Returns)f(the)i(n)m(umerator)e(of)i +Fp(x)p Fr(.)-30 2524 y Fp(cl_I)e(denominator)f(\(const)g +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 2633 y Fr(Returns)e(the)i +(denominator)f(of)g Fp(x)p Fr(.)-30 2813 y(The)g(n)m(umerator)g(and)g +(denominator)g(of)h(a)g(rational)h(n)m(um)m(b)s(er)c(are)k(normalized)e +(in)g(suc)m(h)h(a)g(w)m(a)m(y)g(that)h(they)f(ha)m(v)m(e)-30 +2922 y(no)f(factor)i(in)e(common)e(and)i(the)h(denominator)e(is)i(p)s +(ositiv)m(e.)-30 3213 y Fs(4.4)68 b(Elemen)l(tary)47 +b(complex)e(functions)-30 3419 y Fr(The)30 b(class)h +Fp(cl_N)e Fr(de\014nes)h(the)g(follo)m(wing)i(op)s(eration:)-30 +3599 y Fp(cl_N)d(complex)g(\(const)f(cl_R&)h(a,)h(const)f(cl_R&)g(b\)) +450 3708 y Fr(Returns)35 b(the)h(complex)g(n)m(um)m(b)s(er)e +Fp(a+bi)p Fr(,)i(that)h(is,)g(the)f(complex)g(n)m(um)m(b)s(er)e(with)h +(real)i(part)f Fp(a)g Fr(and)450 3818 y(imaginary)30 +b(part)g Fp(b)p Fr(.)-30 3997 y(Eac)m(h)h(of)g(the)f(classes)i +Fp(cl_N)p Fr(,)d Fp(cl_R)g Fr(de\014nes)h(the)g(follo)m(wing)i(op)s +(erations:)-30 4177 y Fp(cl_R)d(realpart)f(\(const)h +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 4286 y Fr(Returns)f(the)i(real)g +(part)f(of)h Fp(x)p Fr(.)-30 4459 y Fp(cl_R)e(imagpart)f(\(const)h +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 4569 y Fr(Returns)f(the)i +(imaginary)f(part)g(of)h Fp(x)p Fr(.)-30 4742 y Fl(t)m(yp)s(e)36 +b Fp(conjugate)27 b(\(const)i Fl(t)m(yp)s(e)5 b Fp(&)31 +b(x\))450 4851 y Fr(Returns)e(the)i(complex)f(conjugate)i(of)e +Fp(x)p Fr(.)-30 5031 y(W)-8 b(e)32 b(ha)m(v)m(e)f(the)g(relations)150 +5179 y Fp(x)f(=)g(complex\(realpart\(x\),)25 b(imagpart\(x\)\))150 +5320 y(conjugate\(x\))i(=)j(complex\(realpart\(x\),)25 +b(-imagpart\(x\)\))p eop %%Page: 13 15 -13 14 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(13)0 366 y(The)25 b(programmatic)f(w)m -(a)m(y)j(to)f(construct)f(a)h Fp(cl_F)e Fr(with)h(high)g(precision)h -(is)f(through)g(the)h Fp(cl_float)d Fr(con)m(v)m(ersion)0 -491 y(function,)29 b(see)h(Section)g(4.11.1)i([Con)m(v)m(ersion)e(to)g -(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers],)c(page)j(32.)42 -b(F)-8 b(or)30 b(example,)f(to)h(com-)0 616 y(pute)d -Fp(e)f Fr(to)i(40)f(decimal)g(places,)i(\014rst)d(construct)h(1.0)h(to) -g(40)f(decimal)g(places)h(and)e(then)g(apply)h(the)g(exp)s(onen)m(tial) -0 740 y(function:)383 993 y Fp(cl_float_format_t)43 b(precision)j(=)h -(cl_float_format\(40\);)383 1097 y(cl_F)g(e)g(=)h -(exp\(cl_float\(1,precisio)o(n\)\);)0 1505 y Fm(4.1.4)63 -b(Constructing)30 b(complex)g(n)m(um)m(b)s(ers)0 1779 -y Fr(Non-real)h Fp(cl_N)f Fr(ob)5 b(jects)31 b(are)g(normally)e -(constructed)i(through)e(the)i(function)383 2032 y Fp(cl_N)47 -b(complex)f(\(const)g(cl_R&)g(realpart,)f(const)i(cl_R&)f(imagpart\))0 -2306 y Fr(See)31 b(Section)g(4.4)g([Elemen)m(tary)g(complex)f -(functions],)g(page)h(15.)0 2748 y Fs(4.2)68 b(Elemen)l(tary)32 -b(functions)0 3022 y Fr(Eac)m(h)22 b(of)g(the)g(classes)h -Fp(cl_N)p Fr(,)g Fp(cl_R)p Fr(,)f Fp(cl_RA)p Fr(,)g Fp(cl_I)p -Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p -Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)f Fr(de\014nes)g(the)g(follo)m(wing)0 -3146 y(op)s(erations:)0 3443 y Fk(t)m(yp)s(e)36 b Fp(operator)28 -b(+)i(\(const)e Fk(t)m(yp)s(e)5 b Fp(&,)31 b(const)d -Fk(t)m(yp)s(e)5 b Fp(&\))480 3568 y Fr(Addition.)0 3739 -y Fk(t)m(yp)s(e)36 b Fp(operator)28 b(-)i(\(const)e Fk(t)m(yp)s(e)5 -b Fp(&,)31 b(const)d Fk(t)m(yp)s(e)5 b Fp(&\))480 3863 -y Fr(Subtraction.)0 4034 y Fk(t)m(yp)s(e)36 b Fp(operator)28 -b(-)i(\(const)e Fk(t)m(yp)s(e)5 b Fp(&\))480 4159 y Fr(Returns)29 -b(the)i(negativ)m(e)i(of)d(the)h(argumen)m(t.)0 4329 -y Fk(t)m(yp)s(e)36 b Fp(plus1)29 b(\(const)f Fk(t)m(yp)s(e)5 -b Fp(&)31 b(x\))480 4454 y Fr(Returns)e Fp(x)h(+)h(1)p -Fr(.)0 4625 y Fk(t)m(yp)s(e)36 b Fp(minus1)28 b(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 4749 y Fr(Returns)f -Fp(x)h(-)h(1)p Fr(.)0 4920 y Fk(t)m(yp)s(e)36 b Fp(operator)28 -b(*)i(\(const)e Fk(t)m(yp)s(e)5 b Fp(&,)31 b(const)d -Fk(t)m(yp)s(e)5 b Fp(&\))480 5045 y Fr(Multiplication.)0 -5215 y Fk(t)m(yp)s(e)36 b Fp(square)28 b(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 5340 y Fr(Returns)f Fp(x)h(*)h(x)p -Fr(.)p eop +13 14 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(13)-30 299 y Fs(4.5)68 +b(Comparisons)-30 489 y Fr(Eac)m(h)27 b(of)f(the)h(classes)g +Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_I)p +Fr(,)g Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)f Fr(de\014nes)g(the)h(follo)m(wing) +-30 598 y(op)s(erations:)-30 752 y Fp(bool)j(operator)f(==)i(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 862 y(bool)29 b(operator)f(!=)i(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))450 971 y Fr(Comparison,)29 b(as)i(in)f(C)g(and)f(C)p +Fp(++)p Fr(.)-30 1125 y Fp(uint32)g(cl_equal_hashcode)c(\(const)k +Fl(t)m(yp)s(e)5 b Fp(&\))450 1235 y Fr(Returns)35 b(a)h(32-bit)h(hash)e +(co)s(de)h(that)g(is)g(the)g(same)f(for)h(an)m(y)g(t)m(w)m(o)h(n)m(um)m +(b)s(ers)c(whic)m(h)i(are)i(the)f(same)450 1345 y(according)24 +b(to)h Fp(==)p Fr(.)38 b(This)22 b(hash)h(co)s(de)h(dep)s(ends)e(on)h +(the)h(n)m(um)m(b)s(er's)d(v)-5 b(alue,)26 b(not)d(its)h(t)m(yp)s(e)g +(or)g(precision.)-30 1499 y Fp(cl_boolean)k(zerop)h(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 1608 y Fr(Compare)e(against)j +(zero:)41 b Fp(x)30 b(==)g(0)-30 1762 y Fr(Eac)m(h)43 +b(of)g(the)f(classes)i Fp(cl_R)p Fr(,)h Fp(cl_RA)p Fr(,)f +Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)h Fp(cl_DF)p Fr(,)f Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing) +-30 1872 y(op)s(erations:)-30 2026 y Fp(cl_signean)28 +b(cl_compare)f(\(const)i Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))450 2135 y Fr(Compares)f +Fp(x)h Fr(and)g Fp(y)p Fr(.)40 b(Returns)30 b Fp(+)p +Fr(1)g(if)g Fp(x>y)p Fr(,)g(-1)h(if)g Fp(x=)i(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2618 y(bool)29 b(operator)f(>)i(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))450 2727 y Fr(Comparison,)29 b(as)i(in)f(C)g(and)f(C)p +Fp(++)p Fr(.)-30 2881 y Fp(cl_boolean)f(minusp)g(\(const)h +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 2991 y Fr(Compare)f(against)j +(zero:)41 b Fp(x)30 b(<)g(0)-30 3145 y(cl_boolean)e(plusp)h(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 3255 y Fr(Compare)e(against)j +(zero:)41 b Fp(x)30 b(>)g(0)-30 3408 y Fl(t)m(yp)s(e)36 +b Fp(max)29 b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))450 3518 y Fr(Return)g(the)g(maxim)m +(um)d(of)k Fp(x)f Fr(and)g Fp(y)p Fr(.)-30 3672 y Fl(t)m(yp)s(e)36 +b Fp(min)29 b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))450 3782 y Fr(Return)g(the)g(minim)m +(um)d(of)j Fp(x)g Fr(and)g Fp(y)p Fr(.)-30 3936 y(When)35 +b(a)g(\015oating)h(p)s(oin)m(t)f(n)m(um)m(b)s(er)d(and)i(a)i(rational)g +(n)m(um)m(b)s(er)c(are)k(compared,)f(the)g(\015oat)h(is)f(\014rst)f +(con)m(v)m(erted)i(to)-30 4045 y(a)f(rational)h(n)m(um)m(b)s(er)c +(using)i(the)h(function)f Fp(rational)p Fr(.)51 b(Since)35 +b(a)g(\015oating)g(p)s(oin)m(t)g(n)m(um)m(b)s(er)d(actually)k(represen) +m(ts)-30 4155 y(an)h(in)m(terv)-5 b(al)39 b(of)e(real)h(n)m(um)m(b)s +(ers,)f(the)h(result)f(migh)m(t)g(b)s(e)g(surprising.)60 +b(F)-8 b(or)38 b(example,)h Fp(\(cl_F\)\(cl_R\)"1/3")26 +b(==)-30 4264 y(\(cl_R\)"1/3")h Fr(returns)i(false)i(b)s(ecause)g +(there)f(is)h(no)f(\015oating)h(p)s(oin)m(t)g(n)m(um)m(b)s(er)d(whose)i +(v)-5 b(alue)31 b(is)f(exactly)i Fp(1/3)p Fr(.)-30 4513 +y Fs(4.6)68 b(Rounding)45 b(functions)-30 4703 y Fr(When)40 +b(a)g(real)h(n)m(um)m(b)s(er)d(is)i(to)h(b)s(e)f(con)m(v)m(erted)h(to)g +(an)f(in)m(teger,)45 b(there)40 b(is)g(no)g(\\b)s(est")h(rounding.)69 +b(The)39 b(desired)-30 4813 y(rounding)27 b(function)g(dep)s(ends)f(on) +i(the)g(application.)41 b(The)28 b(Common)d(Lisp)i(and)g(ISO)g(Lisp)g +(standards)g(o\013er)i(four)-30 4923 y(rounding)g(functions:)-30 +5076 y Fp(floor\(x\))96 b Fr(This)30 b(is)g(the)h(largest)g(in)m(teger) +h Fp(<)p Fr(=)p Fp(x)p Fr(.)-30 5230 y Fp(ceiling\(x\))450 +5340 y Fr(This)e(is)g(the)h(smallest)f(in)m(teger)i Fp(>)p +Fr(=)p Fp(x)p Fr(.)p eop %%Page: 14 16 -14 15 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(14)0 366 y(Eac)m(h)39 -b(of)g(the)g(classes)h Fp(cl_N)p Fr(,)g Fp(cl_R)p Fr(,)f -Fp(cl_RA)p Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)f -Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)g Fp(cl_LF)d Fr(de\014nes)h(the)g -(follo)m(wing)0 491 y(op)s(erations:)0 796 y Fk(t)m(yp)s(e)e -Fp(operator)28 b(/)i(\(const)e Fk(t)m(yp)s(e)5 b Fp(&,)31 -b(const)d Fk(t)m(yp)s(e)5 b Fp(&\))480 921 y Fr(Division.)0 -1101 y Fk(t)m(yp)s(e)36 b Fp(recip)29 b(\(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))480 1225 y Fr(Returns)29 b(the)i(recipro)s(cal)g(of)g(the)f -(argumen)m(t.)0 1530 y(The)d(class)g Fp(cl_I)f Fr(do)s(esn't)h -(de\014ne)g(a)g(`)p Fp(/)p Fr(')g(op)s(eration)h(b)s(ecause)f(in)g(the) -g(C/C)p Fp(++)f Fr(language)j(this)e(op)s(erator,)h(applied)0 -1655 y(to)j(in)m(tegral)h(t)m(yp)s(es,)f(denotes)f(the)h(`)p -Fp(floor)p Fr(')e(or)h(`)p Fp(truncate)p Fr(')f(op)s(eration)i(\(whic)m -(h)f(one)h(of)f(these,)h(is)g(implemen)m(ta-)0 1780 y(tion)j(dep)s -(enden)m(t\).)48 b(\(See)34 b(Section)f(4.6)i([Rounding)d(functions],)i -(page)g(17\))g(Instead,)g Fp(cl_I)e Fr(de\014nes)g(an)h(\\exact)0 -1904 y(quotien)m(t")f(function:)0 2209 y Fp(cl_I)d(exquo)g(\(const)g -(cl_I&)g(x,)h(const)e(cl_I&)h(y\))480 2334 y Fr(Chec)m(ks)i(that)g -Fp(y)f Fr(divides)g Fp(x)p Fr(,)g(and)g(returns)f(the)h(quotien)m(t)i -Fp(x)p Fr(/)p Fp(y)p Fr(.)0 2638 y(The)e(follo)m(wing)i(exp)s(onen)m -(tiation)f(functions)f(are)h(de\014ned:)0 2943 y Fp(cl_I)e(expt_pos)f -(\(const)h(cl_I&)g(x,)h(const)f(cl_I&)g(y\))0 3068 y(cl_RA)g(expt_pos)f -(\(const)h(cl_RA&)f(x,)i(const)f(cl_I&)g(y\))480 3193 -y(y)h Fr(m)m(ust)f(b)s(e)h Fp(>)g Fr(0.)41 b(Returns)30 -b Fp(x^y)p Fr(.)0 3373 y Fp(cl_RA)f(expt)g(\(const)g(cl_RA&)f(x,)i -(const)f(cl_I&)g(y\))0 3497 y(cl_R)g(expt)g(\(const)g(cl_R&)g(x,)h -(const)f(cl_I&)g(y\))0 3622 y(cl_N)g(expt)g(\(const)g(cl_N&)g(x,)h -(const)f(cl_I&)g(y\))480 3747 y Fr(Returns)g Fp(x^y)p -Fr(.)0 4052 y(Eac)m(h)39 b(of)g(the)g(classes)h Fp(cl_R)p -Fr(,)g Fp(cl_RA)p Fr(,)f Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)g -Fp(cl_SF)p Fr(,)f Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)g -Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)0 4176 y(op)s(eration:)0 -4481 y Fk(t)m(yp)s(e)e Fp(abs)29 b(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 4606 y Fr(Returns)f(the)i(absolute)g(v)-5 -b(alue)31 b(of)f Fp(x)p Fr(.)41 b(This)29 b(is)i Fp(x)f -Fr(if)g Fp(x)g(>=)g(0)p Fr(,)g(and)g Fp(-x)g Fr(if)g -Fp(x)g(<=)g(0)p Fr(.)0 4911 y(The)g(class)h Fp(cl_N)e -Fr(implemen)m(ts)g(this)h(as)h(follo)m(ws:)0 5215 y Fp(cl_R)e(abs)h -(\(const)e(cl_N)i(x\))480 5340 y Fr(Returns)f(the)i(absolute)g(v)-5 -b(alue)31 b(of)f Fp(x)p Fr(.)p eop -%%Page: 15 17 -15 16 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(15)0 366 y(Eac)m(h)22 -b(of)g(the)g(classes)h Fp(cl_N)p Fr(,)g Fp(cl_R)p Fr(,)f -Fp(cl_RA)p Fr(,)g Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_SF)p -Fr(,)f Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)f -Fr(de\014nes)g(the)g(follo)m(wing)0 491 y(op)s(eration:)0 -798 y Fk(t)m(yp)s(e)36 b Fp(signum)28 b(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 922 y Fr(Returns)g(the)i(sign)f(of)g -Fp(x)p Fr(,)h(in)f(the)g(same)g(n)m(um)m(b)s(er)e(format)h(as)i -Fp(x)p Fr(.)42 b(This)31 b(is)g(de\014ned)f(as)i Fp(x)e(/)g(abs\(x\)) -480 1047 y Fr(if)g Fp(x)g Fr(is)h(non-zero,)g(and)f Fp(x)g -Fr(if)g Fp(x)g Fr(is)h(zero.)41 b(If)30 b Fp(x)g Fr(is)g(real,)i(the)e -(v)-5 b(alue)31 b(is)g(either)f(0)h(or)f(1)h(or)g(-1.)0 -1531 y Fs(4.3)68 b(Elemen)l(tary)32 b(rational)g(functions)0 -1808 y Fr(Eac)m(h)f(of)g(the)f(classes)i Fp(cl_RA)p Fr(,)d -Fp(cl_I)g Fr(de\014nes)g(the)i(follo)m(wing)h(op)s(erations:)0 -2115 y Fp(cl_I)d(numerator)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 2240 y Fr(Returns)f(the)i(n)m(umerator)e(of)i -Fp(x)p Fr(.)0 2422 y Fp(cl_I)e(denominator)f(\(const)g -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))480 2546 y Fr(Returns)e(the)i -(denominator)f(of)g Fp(x)p Fr(.)0 2853 y(The)c(n)m(umerator)h(and)f -(denominator)g(of)h(a)h(rational)g(n)m(um)m(b)s(er)c(are)k(normalized)e -(in)h(suc)m(h)g(a)g(w)m(a)m(y)h(that)g(they)f(ha)m(v)m(e)0 -2978 y(no)j(factor)i(in)e(common)e(and)i(the)h(denominator)e(is)i(p)s -(ositiv)m(e.)0 3462 y Fs(4.4)68 b(Elemen)l(tary)32 b(complex)f -(functions)0 3739 y Fr(The)f(class)h Fp(cl_N)e Fr(de\014nes)h(the)g -(follo)m(wing)i(op)s(eration:)0 4046 y Fp(cl_N)d(complex)g(\(const)f -(cl_R&)h(a,)h(const)f(cl_R&)g(b\))480 4171 y Fr(Returns)i(the)h -(complex)f(n)m(um)m(b)s(er)f Fp(a+bi)p Fr(,)h(that)i(is,)f(the)g -(complex)g(n)m(um)m(b)s(er)d(with)j(real)g(part)g Fp(a)g -Fr(and)480 4295 y(imaginary)e(part)g Fp(b)p Fr(.)0 4602 -y(Eac)m(h)h(of)g(the)f(classes)i Fp(cl_N)p Fr(,)d Fp(cl_R)g -Fr(de\014nes)h(the)g(follo)m(wing)i(op)s(erations:)0 -4909 y Fp(cl_R)d(realpart)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 5033 y Fr(Returns)f(the)i(real)g(part)f(of)h -Fp(x)p Fr(.)0 5215 y Fp(cl_R)e(imagpart)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 5340 y Fr(Returns)f(the)i(imaginary)f(part)g(of)h -Fp(x)p Fr(.)p eop -%%Page: 16 18 -16 17 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(16)0 366 y Fk(t)m(yp)s(e)36 -b Fp(conjugate)27 b(\(const)i Fk(t)m(yp)s(e)5 b Fp(&)31 -b(x\))480 491 y Fr(Returns)e(the)i(complex)f(conjugate)i(of)e -Fp(x)p Fr(.)0 795 y(W)-8 b(e)32 b(ha)m(v)m(e)f(the)g(relations)180 -1071 y Fp(x)f(=)g(complex\(realpart\(x\),)25 b(imagpart\(x\)\))180 -1223 y(conjugate\(x\))i(=)j(complex\(realpart\(x\),)25 -b(-imagpart\(x\)\))0 1693 y Fs(4.5)68 b(Comparisons)0 -1969 y Fr(Eac)m(h)22 b(of)g(the)g(classes)h Fp(cl_N)p -Fr(,)g Fp(cl_R)p Fr(,)f Fp(cl_RA)p Fr(,)g Fp(cl_I)p Fr(,)h -Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p Fr(,)g -Fp(cl_DF)p Fr(,)g Fp(cl_LF)f Fr(de\014nes)g(the)g(follo)m(wing)0 -2094 y(op)s(erations:)0 2397 y Fp(bool)29 b(operator)f(==)i(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 2522 y(bool)29 b(operator)f(!=)i(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))480 2646 y Fr(Comparison,)29 b(as)i(in)f(C)g(and)f(C)p -Fp(++)p Fr(.)0 2825 y Fp(uint32)g(cl_equal_hashcode)c(\(const)k -Fk(t)m(yp)s(e)5 b Fp(&\))480 2950 y Fr(Returns)31 b(a)h(32-bit)i(hash)d -(co)s(de)h(that)h(is)f(the)g(same)f(for)h(an)m(y)g(t)m(w)m(o)i(n)m(um)m -(b)s(ers)29 b(whic)m(h)j(are)g(the)h(same)480 3075 y(according)e(to)g -Fp(==)p Fr(.)40 b(This)29 b(hash)g(co)s(de)i(dep)s(ends)d(on)i(the)g(n) -m(um)m(b)s(er's)e(v)-5 b(alue,)31 b(not)f(its)g(t)m(yp)s(e)g(or)h -(preci-)480 3199 y(sion.)0 3378 y Fp(cl_boolean)d(zerop)h(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))480 3503 y Fr(Compare)e(against)j -(zero:)41 b Fp(x)30 b(==)g(0)0 3806 y Fr(Eac)m(h)39 b(of)g(the)g -(classes)h Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)f Fp(cl_I)p -Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p -Fr(,)h Fp(cl_DF)p Fr(,)g Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)0 -3931 y(op)s(erations:)0 4235 y Fp(cl_signean)28 b(cl_compare)f(\(const) -i Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))480 4359 y Fr(Compares)f Fp(x)h Fr(and)g -Fp(y)p Fr(.)40 b(Returns)30 b Fp(+)p Fr(1)g(if)g Fp(x>y)p -Fr(,)g(-1)h(if)g Fp(x=)i(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 4912 y(bool)29 b(operator)f(>)i(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))480 5036 y Fr(Comparison,)29 b(as)i(in)f(C)g(and)f(C)p -Fp(++)p Fr(.)0 5215 y Fp(cl_boolean)f(minusp)g(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 5340 y Fr(Compare)f(against)j -(zero:)41 b Fp(x)30 b(<)g(0)p eop -%%Page: 17 19 -17 18 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(17)0 366 y Fp(cl_boolean)28 -b(plusp)h(\(const)f Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))480 -491 y Fr(Compare)e(against)j(zero:)41 b Fp(x)30 b(>)g(0)0 -656 y Fk(t)m(yp)s(e)36 b Fp(max)29 b(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))480 -780 y Fr(Return)g(the)g(maxim)m(um)d(of)k Fp(x)f Fr(and)g -Fp(y)p Fr(.)0 945 y Fk(t)m(yp)s(e)36 b Fp(min)29 b(\(const)g -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))480 1069 y Fr(Return)g(the)g(minim)m(um)d(of)j -Fp(x)g Fr(and)g Fp(y)p Fr(.)0 1363 y(When)h(a)h(\015oating)g(p)s(oin)m -(t)f(n)m(um)m(b)s(er)e(and)h(a)i(rational)g(n)m(um)m(b)s(er)d(are)j -(compared,)f(the)g(\015oat)h(is)f(\014rst)f(con)m(v)m(erted)j(to)0 -1488 y(a)e(rational)h(n)m(um)m(b)s(er)c(using)i(the)h(function)f -Fp(rational)p Fr(.)39 b(Since)31 b(a)g(\015oating)g(p)s(oin)m(t)g(n)m -(um)m(b)s(er)d(actually)k(represen)m(ts)0 1612 y(an)h(in)m(terv)-5 -b(al)34 b(of)g(real)g(n)m(um)m(b)s(ers,)d(the)j(result)f(migh)m(t)g(b)s -(e)f(surprising.)48 b(F)-8 b(or)34 b(example,)g Fp -(\(cl_F\)\(cl_R\)"1/3")26 b(==)0 1737 y(\(cl_R\)"1/3")h -Fr(returns)i(false)i(b)s(ecause)g(there)f(is)h(no)f(\015oating)h(p)s -(oin)m(t)g(n)m(um)m(b)s(er)d(whose)i(v)-5 b(alue)31 b(is)f(exactly)i -Fp(1/3)p Fr(.)0 2166 y Fs(4.6)68 b(Rounding)30 b(functions)0 -2440 y Fr(When)37 b(a)g(real)h(n)m(um)m(b)s(er)d(is)i(to)h(b)s(e)e(con) -m(v)m(erted)j(to)e(an)g(in)m(teger,)k(there)c(is)g(no)g(\\b)s(est")g -(rounding.)60 b(The)36 b(desired)0 2564 y(rounding)g(function)g(dep)s -(ends)f(on)i(the)g(application.)61 b(The)36 b(Common)e(Lisp)j(and)f -(ISO)g(Lisp)g(standards)g(o\013er)0 2689 y(four)30 b(rounding)f -(functions:)0 2983 y Fp(floor\(x\))96 b Fr(This)30 b(is)g(the)h -(largest)g(in)m(teger)h Fp(<)p Fr(=)p Fp(x)p Fr(.)0 3148 -y Fp(ceiling\(x\))480 3272 y Fr(This)e(is)g(the)h(smallest)f(in)m -(teger)i Fp(>)p Fr(=)p Fp(x)p Fr(.)0 3437 y Fp(truncate\(x\))480 -3561 y Fr(Among)e(the)g(in)m(tegers)i(b)s(et)m(w)m(een)f(0)g(and)e +14 15 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(14)-30 299 y Fp(truncate\(x\))450 +408 y Fr(Among)30 b(the)g(in)m(tegers)i(b)s(et)m(w)m(een)f(0)g(and)e Fp(x)h Fr(\(inclusiv)m(e\))i(the)f(one)g(nearest)f(to)i -Fp(x)p Fr(.)0 3726 y Fp(round\(x\))96 b Fr(The)29 b(in)m(teger)h -(nearest)f(to)h Fp(x)p Fr(.)40 b(If)29 b Fp(x)f Fr(is)h(exactly)i -(halfw)m(a)m(y)f(b)s(et)m(w)m(een)g(t)m(w)m(o)g(in)m(tegers,)h(c)m(ho)s -(ose)f(the)f(ev)m(en)480 3850 y(one.)0 4144 y(These)h(functions)g(ha)m -(v)m(e)i(di\013eren)m(t)e(adv)-5 b(an)m(tages:)0 4418 -y Fp(floor)38 b Fr(and)g Fp(ceiling)g Fr(are)h(translation)h(in)m(v)-5 -b(arian)m(t:)60 b Fp(floor\(x+n\))28 b(=)i(floor\(x\))e(+)i(n)39 -b Fr(and)f Fp(ceiling\(x+n\))27 b(=)0 4543 y(ceiling\(x\))h(+)i(n)g +Fp(x)p Fr(.)-30 566 y Fp(round\(x\))96 b Fr(The)32 b(in)m(teger)i +(nearest)g(to)f Fp(x)p Fr(.)48 b(If)32 b Fp(x)g Fr(is)h(exactly)i +(halfw)m(a)m(y)e(b)s(et)m(w)m(een)h(t)m(w)m(o)g(in)m(tegers,)h(c)m(ho)s +(ose)e(the)g(ev)m(en)450 676 y(one.)-30 833 y(These)d(functions)g(ha)m +(v)m(e)i(di\013eren)m(t)e(adv)-5 b(an)m(tages:)-30 967 +y Fp(floor)44 b Fr(and)i Fp(ceiling)e Fr(are)i(translation)h(in)m(v)-5 +b(arian)m(t:)73 b Fp(floor\(x+n\))27 b(=)j(floor\(x\))e(+)i(n)46 +b Fr(and)f Fp(ceiling\(x+n\))27 b(=)-30 1076 y(ceiling\(x\))h(+)i(n)g Fr(for)g(ev)m(ery)h Fp(x)f Fr(and)g(ev)m(ery)h(in)m(teger)h -Fp(n)p Fr(.)0 4817 y(On)46 b(the)h(other)g(hand,)j Fp(truncate)44 -b Fr(and)i Fp(round)f Fr(are)i(symmetric:)72 b Fp(truncate\(-x\))27 -b(=)j(-truncate\(x\))44 b Fr(and)0 4941 y Fp(round\(-x\))28 -b(=)i(-round\(x\))p Fr(,)38 b(and)g(furthermore)e Fp(round)h -Fr(is)h(un)m(biased:)57 b(on)38 b(the)h(\\a)m(v)m(erage",)44 -b(it)39 b(rounds)d(do)m(wn)0 5066 y(exactly)c(as)f(often)g(as)f(it)h -(rounds)e(up.)0 5340 y(The)h(functions)g(are)h(related)g(lik)m(e)h -(this:)p eop -%%Page: 18 20 -18 19 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(18)180 366 y Fp(ceiling\(m/n\))27 -b(=)j(floor\(\(m+n-1\)/n\))c(=)k(floor\(\(m-1\)/n\)+1)g -Fr(for)35 b(rational)h(n)m(um)m(b)s(ers)c Fp(m/n)i Fr(\()p -Fp(m)p Fr(,)i Fp(n)f Fr(in-)180 491 y(tegers,)d Fp(n>)p -Fr(0\),)e(and)180 646 y Fp(truncate\(x\))d(=)j(sign\(x\))f(*)h -(floor\(abs\(x\)\))0 957 y Fr(Eac)m(h)24 b(of)f(the)h(classes)g -Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_F)p Fr(,)f Fp(cl_SF)p -Fr(,)h Fp(cl_FF)p Fr(,)f Fp(cl_DF)p Fr(,)h Fp(cl_LF)e -Fr(de\014nes)g(the)i(follo)m(wing)g(op)s(erations:)0 -1268 y Fp(cl_I)29 b(floor1)g(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 1392 y Fr(Returns)f Fp(floor\(x\))p -Fr(.)0 1578 y Fp(cl_I)g(ceiling1)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 1703 y Fr(Returns)f Fp(ceiling\(x\))p -Fr(.)0 1889 y Fp(cl_I)g(truncate1)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 2014 y Fr(Returns)f Fp(truncate\(x\))p -Fr(.)0 2200 y Fp(cl_I)g(round1)g(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 2324 y Fr(Returns)f Fp(round\(x\))p -Fr(.)0 2635 y(Eac)m(h)39 b(of)g(the)g(classes)h Fp(cl_R)p -Fr(,)g Fp(cl_RA)p Fr(,)f Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)g -Fp(cl_SF)p Fr(,)f Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)g -Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)0 2760 y(op)s(erations:)0 -3070 y Fp(cl_I)29 b(floor1)g(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))480 -3195 y Fr(Returns)f Fp(floor\(x/y\))p Fr(.)0 3381 y Fp(cl_I)g(ceiling1) -f(\(const)h Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f -Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))480 3505 y Fr(Returns)f -Fp(ceiling\(x/y\))p Fr(.)0 3692 y Fp(cl_I)g(truncate1)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))480 3816 y Fr(Returns)f Fp(truncate\(x/y\))p -Fr(.)0 4002 y Fp(cl_I)g(round1)g(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))480 -4127 y Fr(Returns)f Fp(round\(x/y\))p Fr(.)0 4437 y(These)41 -b(functions)g(are)h(called)h(`)p Fp(floor1)p Fr(',)g -Fn(:)15 b(:)g(:)42 b Fr(here)g(instead)f(of)h(`)p Fp(floor)p -Fr(',)i Fn(:)15 b(:)g(:)q Fr(,)44 b(b)s(ecause)d(on)h(some)f(systems,)0 -4562 y(system)30 b(dep)s(enden)m(t)f(include)h(\014les)g(de\014ne)g(`)p -Fp(floor)p Fr(')f(and)h(`)p Fp(ceiling)p Fr(')f(as)i(macros.)0 -4842 y(In)k(man)m(y)g(cases,)j(one)e(needs)g(b)s(oth)f(the)h(quotien)m -(t)h(and)e(the)h(remainder)e(of)i(a)g(division.)57 b(It)36 -b(is)g(more)e(e\016cien)m(t)0 4966 y(to)j(compute)e(b)s(oth)g(at)i(the) -f(same)f(time)g(than)h(to)h(p)s(erform)c(t)m(w)m(o)k(divisions,)h(one)e -(for)f(quotien)m(t)i(and)f(the)g(next)0 5091 y(one)h(for)g(the)h -(remainder.)59 b(The)37 b(follo)m(wing)h(functions)f(therefore)g -(return)g(a)g(structure)g(con)m(taining)h(b)s(oth)f(the)0 -5215 y(quotien)m(t)28 b(and)e(the)h(remainder.)38 b(The)27 -b(su\016x)e(`)p Fp(2)p Fr(')i(indicates)h(the)f(n)m(um)m(b)s(er)e(of)i -(\\return)f(v)-5 b(alues".)40 b(The)27 b(remainder)0 -5340 y(is)j(de\014ned)g(as)g(follo)m(ws:)p eop -%%Page: 19 21 -19 20 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(19)75 366 y Fq(\017)60 +Fp(n)p Fr(.)-30 1210 y(On)51 b(the)h(other)h(hand,)j +Fp(truncate)50 b Fr(and)h Fp(round)g Fr(are)h(symmetric:)83 +b Fp(truncate\(-x\))27 b(=)j(-truncate\(x\))49 b Fr(and)-30 +1319 y Fp(round\(-x\))28 b(=)i(-round\(x\))p Fr(,)44 +b(and)f(furthermore)e Fp(round)g Fr(is)j(un)m(biased:)65 +b(on)44 b(the)f(\\a)m(v)m(erage",)50 b(it)44 b(rounds)d(do)m(wn)-30 +1429 y(exactly)32 b(as)f(often)g(as)f(it)h(rounds)e(up.)-30 +1563 y(The)h(functions)g(are)h(related)g(lik)m(e)h(this:)150 +1696 y Fp(ceiling\(m/n\))27 b(=)j(floor\(\(m+n-1\)/n\))c(=)k +(floor\(\(m-1\)/n\)+1)f Fr(for)j(rational)j(n)m(um)m(b)s(ers)30 +b Fp(m/n)i Fr(\()p Fp(m)p Fr(,)i Fp(n)f Fr(in)m(te-)150 +1806 y(gers,)e Fp(n>)p Fr(0\),)g(and)150 1939 y Fp(truncate\(x\))c(=)j +(sign\(x\))f(*)h(floor\(abs\(x\)\))-30 2097 y Fr(Eac)m(h)f(of)f(the)g +(classes)h Fp(cl_R)p Fr(,)e Fp(cl_RA)p Fr(,)h Fp(cl_F)p +Fr(,)f Fp(cl_SF)p Fr(,)h Fp(cl_FF)p Fr(,)f Fp(cl_DF)p +Fr(,)g Fp(cl_LF)g Fr(de\014nes)g(the)h(follo)m(wing)h(op)s(erations:) +-30 2254 y Fp(cl_I)g(floor1)g(\(const)g Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 2364 y Fr(Returns)f Fp(floor\(x\))p +Fr(.)-30 2521 y Fp(cl_I)g(ceiling1)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 2631 y Fr(Returns)f Fp(ceiling\(x\))p +Fr(.)-30 2789 y Fp(cl_I)g(truncate1)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 2898 y Fr(Returns)f Fp(truncate\(x\))p +Fr(.)-30 3056 y Fp(cl_I)g(round1)g(\(const)g Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 3165 y Fr(Returns)f Fp(round\(x\))p +Fr(.)-30 3323 y(Eac)m(h)43 b(of)g(the)f(classes)i Fp(cl_R)p +Fr(,)h Fp(cl_RA)p Fr(,)f Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)f +Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)f +Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)-30 3432 +y(op)s(erations:)-30 3590 y Fp(cl_I)29 b(floor1)g(\(const)g +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 +b Fp(&)30 b(y\))450 3700 y Fr(Returns)f Fp(floor\(x/y\))p +Fr(.)-30 3857 y Fp(cl_I)g(ceiling1)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))450 +3967 y Fr(Returns)f Fp(ceiling\(x/y\))p Fr(.)-30 4124 +y Fp(cl_I)g(truncate1)f(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))450 4234 +y Fr(Returns)f Fp(truncate\(x/y\))p Fr(.)-30 4391 y Fp(cl_I)g(round1)g +(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 +b Fp(&)30 b(y\))450 4501 y Fr(Returns)f Fp(round\(x/y\))p +Fr(.)-30 4658 y(These)41 b(functions)g(are)h(called)h(`)p +Fp(floor1)p Fr(',)48 b(.)23 b(.)f(.)52 b(here)42 b(instead)f(of)h(`)p +Fp(floor)p Fr(',)49 b(.)22 b(.)h(.)11 b(,)44 b(b)s(ecause)e(on)f(some)g +(systems,)-30 4768 y(system)30 b(dep)s(enden)m(t)f(include)h(\014les)g +(de\014ne)g(`)p Fp(floor)p Fr(')f(and)h(`)p Fp(ceiling)p +Fr(')f(as)i(macros.)-30 4902 y(In)h(man)m(y)g(cases,)j(one)e(needs)g(b) +s(oth)f(the)h(quotien)m(t)i(and)d(the)h(remainder)e(of)j(a)f(division.) +49 b(It)33 b(is)g(more)f(e\016cien)m(t)i(to)-30 5011 +y(compute)h(b)s(oth)h(at)h(the)f(same)g(time)f(than)h(to)h(p)s(erform)d +(t)m(w)m(o)j(divisions,)h(one)e(for)g(quotien)m(t)i(and)d(the)h(next)h +(one)-30 5121 y(for)28 b(the)g(remainder.)38 b(The)27 +b(follo)m(wing)j(functions)d(therefore)i(return)d(a)j(structure)e(con)m +(taining)i(b)s(oth)f(the)g(quotien)m(t)-30 5230 y(and)g(the)g +(remainder.)38 b(The)28 b(su\016x)f(`)p Fp(2)p Fr(')h(indicates)h(the)g +(n)m(um)m(b)s(er)c(of)k(\\return)e(v)-5 b(alues".)41 +b(The)27 b(remainder)g(is)h(de\014ned)-30 5340 y(as)j(follo)m(ws:)p +eop +%%Page: 15 17 +15 16 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(15)45 299 y Fq(\017)60 b Fr(for)30 b(the)h(computation)f(of)h Fp(quotient)d(=)i(floor\(x\))p -Fr(,)e Fp(remainder)g(=)i(x)g(-)g(quotient)p Fr(,)75 -540 y Fq(\017)60 b Fr(for)30 b(the)h(computation)f(of)h +Fr(,)e Fp(remainder)g(=)i(x)g(-)g(quotient)p Fr(,)45 +441 y Fq(\017)60 b Fr(for)30 b(the)h(computation)f(of)h Fp(quotient)d(=)i(floor\(x,y\))p Fr(,)e Fp(remainder)f(=)j(x)g(-)g -(quotient*y)p Fr(,)0 888 y(and)g(similarly)g(for)g(the)g(other)h(three) -g(op)s(erations.)0 1186 y(Eac)m(h)24 b(of)f(the)h(classes)g -Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_F)p Fr(,)f Fp(cl_SF)p -Fr(,)h Fp(cl_FF)p Fr(,)f Fp(cl_DF)p Fr(,)h Fp(cl_LF)e -Fr(de\014nes)g(the)i(follo)m(wing)g(op)s(erations:)0 -1534 y Fp(struct)29 b Fk(t)m(yp)s(e)5 b Fp(_div_t)29 -b({)h(cl_I)f(quotient;)f Fk(t)m(yp)s(e)35 b Fp(remainder;)28 -b(};)0 1659 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 b(floor2)g(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))0 1783 y Fk(t)m(yp)s(e)5 -b Fp(_div_t)29 b(ceiling2)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))0 1908 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 -b(truncate2)f(\(const)h Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))0 -2032 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 b(round2)g(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))0 2330 y Fr(Eac)m(h)39 -b(of)g(the)g(classes)h Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)f -Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)f Fp(cl_FF)p -Fr(,)h Fp(cl_DF)p Fr(,)g Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing)0 -2455 y(op)s(erations:)0 2803 y Fp(struct)29 b Fk(t)m(yp)s(e)5 -b Fp(_div_t)29 b({)h(cl_I)f(quotient;)f Fk(t)m(yp)s(e)35 -b Fp(remainder;)28 b(};)0 2927 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 -b(floor2)g(\(const)f Fk(t)m(yp)s(e)5 b Fp(&)31 b(x,)e(const)g -Fk(t)m(yp)s(e)5 b Fp(&)31 b(y\))0 3052 y Fk(t)m(yp)s(e)5 -b Fp(_div_t)29 b(ceiling2)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 -3176 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 b(truncate2)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))0 3301 y Fk(t)m(yp)s(e)5 b Fp(_div_t)29 -b(round2)g(\(const)f Fk(t)m(yp)s(e)5 b Fp(&)31 b(x,)e(const)g -Fk(t)m(yp)s(e)5 b Fp(&)31 b(y\))0 3599 y Fr(Sometimes,)24 -b(one)h(w)m(an)m(ts)f(the)h(quotien)m(t)g(as)f(a)h(\015oating-p)s(oin)m -(t)g(n)m(um)m(b)s(er)d(\(of)i(the)h(same)e(format)h(as)g(the)g(argumen) -m(t,)0 3724 y(if)30 b(the)h(argumen)m(t)f(is)g(a)h(\015oat\))g(instead) -g(of)f(as)h(an)f(in)m(teger.)42 b(The)30 b(pre\014x)g(`)p -Fp(f)p Fr(')g(indicates)h(this.)0 4022 y(Eac)m(h)g(of)g(the)f(classes)i -Fp(cl_F)p Fr(,)d Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g -Fp(cl_DF)p Fr(,)h Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g(op)s -(erations:)0 4370 y Fk(t)m(yp)s(e)36 b Fp(ffloor)28 b(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))0 4494 y Fk(t)m(yp)s(e)36 -b Fp(fceiling)28 b(\(const)g Fk(t)m(yp)s(e)5 b Fp(&)31 -b(x\))0 4619 y Fk(t)m(yp)s(e)36 b Fp(ftruncate)27 b(\(const)i -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))0 4743 y Fk(t)m(yp)s(e)36 -b Fp(fround)28 b(\(const)h Fk(t)m(yp)s(e)5 b Fp(&)30 -b(x\))0 5042 y Fr(and)g(similarly)g(for)g(class)h Fp(cl_R)p -Fr(,)e(but)h(with)g(return)f(t)m(yp)s(e)i Fp(cl_F)p Fr(.)0 -5340 y(The)f(class)h Fp(cl_R)e Fr(de\014nes)h(the)g(follo)m(wing)i(op)s -(erations:)p eop -%%Page: 20 22 -20 21 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(20)0 366 y Fp(cl_F)29 -b(ffloor)g(\(const)g Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f -Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 491 y(cl_F)f(fceiling)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))0 616 y(cl_F)f(ftruncate)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 -b Fp(&)30 b(y\))0 740 y(cl_F)f(fround)g(\(const)g Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 -1024 y Fr(These)25 b(functions)h(also)g(exist)h(in)e(v)m(ersions)h -(whic)m(h)g(return)e(b)s(oth)h(the)h(quotien)m(t)h(and)e(the)h -(remainder.)38 b(The)25 b(su\016x)0 1149 y(`)p Fp(2)p -Fr(')31 b(indicates)g(this.)0 1433 y(Eac)m(h)g(of)g(the)f(classes)i -Fp(cl_F)p Fr(,)d Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g -Fp(cl_DF)p Fr(,)h Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g(op)s -(erations:)0 1752 y Fp(struct)e Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)28 -b({)i Fk(t)m(yp)s(e)36 b Fp(quotient;)28 b Fk(t)m(yp)s(e)36 -b Fp(remainder;)27 b(};)0 1876 y Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)29 -b(ffloor2)f(\(const)h Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))0 -2001 y Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)29 b(fceiling2)f(\(const)g -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))0 2126 y Fk(t)m(yp)s(e)5 -b Fp(_fdiv_t)29 b(ftruncate2)e(\(const)i Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))0 2250 y Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)29 -b(fround2)f(\(const)h Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))0 -2534 y Fr(and)g(similarly)g(for)g(class)h Fp(cl_R)p Fr(,)e(but)h(with)g -(quotien)m(t)i(t)m(yp)s(e)e Fp(cl_F)p Fr(.)0 2818 y(The)g(class)h -Fp(cl_R)e Fr(de\014nes)h(the)g(follo)m(wing)i(op)s(erations:)0 -3137 y Fp(struct)d Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)28 b({)i(cl_F)g -(quotient;)d(cl_R)j(remainder;)d(};)0 3262 y Fk(t)m(yp)s(e)5 -b Fp(_fdiv_t)29 b(ffloor2)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 -3386 y Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)29 b(fceiling2)f(\(const)g -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x,)e(const)g Fk(t)m(yp)s(e)5 -b Fp(&)31 b(y\))0 3511 y Fk(t)m(yp)s(e)5 b Fp(_fdiv_t)29 -b(ftruncate2)e(\(const)i Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f -Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 3635 y Fk(t)m(yp)s(e)5 -b Fp(_fdiv_t)29 b(fround2)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(const)f Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 -3920 y Fr(Other)i(applications)h(need)f(only)g(the)h(remainder)d(of)j -(a)f(division.)47 b(The)31 b(remainder)g(of)h(`)p Fp(floor)p -Fr(')g(and)f(`)p Fp(ffloor)p Fr(')0 4044 y(is)37 b(called)h(`)p -Fp(mod)p Fr(')e(\(abbreviation)h(of)g(\\mo)s(dulo"\).)59 -b(The)36 b(remainder)g(`)p Fp(truncate)p Fr(')e(and)i(`)p -Fp(ftruncate)p Fr(')f(is)i(called)0 4169 y(`)p Fp(rem)p -Fr(')30 b(\(abbreviation)h(of)g(\\remainder"\).)75 4453 -y Fq(\017)60 b Fp(mod\(x,y\))28 b(=)i(floor2\(x,y\).remainder)25 -b(=)30 b(x)g(-)g(floor\(x/y\)*y)75 4612 y Fq(\017)60 -b Fp(rem\(x,y\))28 b(=)i(truncate2\(x,y\).remainder)24 -b(=)30 b(x)g(-)g(truncate\(x/y\)*y)0 4931 y Fr(If)g Fp(x)f -Fr(and)h Fp(y)f Fr(are)i(b)s(oth)e Fp(>)p Fr(=)g(0,)i -Fp(mod\(x,y\))d(=)i(rem\(x,y\))e(>=)i(0)p Fr(.)41 b(In)29 -b(general,)i Fp(mod\(x,y\))d Fr(has)i(the)g(sign)g(of)g -Fp(y)g Fr(or)g(is)0 5056 y(zero,)h(and)f Fp(rem\(x,y\))e -Fr(has)i(the)h(sign)f(of)h Fp(x)f Fr(or)g(is)h(zero.)0 -5340 y(The)f(classes)h Fp(cl_R)p Fr(,)f Fp(cl_I)f Fr(de\014ne)h(the)g +(quotient*y)p Fr(,)-30 624 y(and)g(similarly)g(for)g(the)g(other)h +(three)g(op)s(erations.)-30 774 y(Eac)m(h)e(of)f(the)g(classes)h +Fp(cl_R)p Fr(,)e Fp(cl_RA)p Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p +Fr(,)h Fp(cl_FF)p Fr(,)f Fp(cl_DF)p Fr(,)g Fp(cl_LF)g +Fr(de\014nes)g(the)h(follo)m(wing)h(op)s(erations:)-30 +957 y Fp(struct)g Fl(t)m(yp)s(e)5 b Fp(_div_t)29 b({)h(cl_I)f +(quotient;)f Fl(t)m(yp)s(e)35 b Fp(remainder;)28 b(};)-30 +1066 y Fl(t)m(yp)s(e)5 b Fp(_div_t)29 b(floor2)g(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))-30 1176 y Fl(t)m(yp)s(e)5 +b Fp(_div_t)29 b(ceiling2)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))-30 1286 y Fl(t)m(yp)s(e)5 b Fp(_div_t)29 +b(truncate2)f(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))-30 +1395 y Fl(t)m(yp)s(e)5 b Fp(_div_t)29 b(round2)g(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))-30 1545 y Fr(Eac)m(h)43 +b(of)g(the)f(classes)i Fp(cl_R)p Fr(,)h Fp(cl_RA)p Fr(,)f +Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)h Fp(cl_DF)p Fr(,)f Fp(cl_LF)d Fr(de\014nes)h(the)g(follo)m(wing) +-30 1655 y(op)s(erations:)-30 1838 y Fp(struct)29 b Fl(t)m(yp)s(e)5 +b Fp(_div_t)29 b({)h(cl_I)f(quotient;)f Fl(t)m(yp)s(e)35 +b Fp(remainder;)28 b(};)-30 1947 y Fl(t)m(yp)s(e)5 b +Fp(_div_t)29 b(floor2)g(\(const)f Fl(t)m(yp)s(e)5 b Fp(&)31 +b(x,)e(const)g Fl(t)m(yp)s(e)5 b Fp(&)31 b(y\))-30 2057 +y Fl(t)m(yp)s(e)5 b Fp(_div_t)29 b(ceiling2)f(\(const)h +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 +b Fp(&)30 b(y\))-30 2166 y Fl(t)m(yp)s(e)5 b Fp(_div_t)29 +b(truncate2)f(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 2276 y Fl(t)m(yp)s(e)5 +b Fp(_div_t)29 b(round2)g(\(const)f Fl(t)m(yp)s(e)5 b +Fp(&)31 b(x,)e(const)g Fl(t)m(yp)s(e)5 b Fp(&)31 b(y\))-30 +2426 y Fr(Sometimes,)d(one)g(w)m(an)m(ts)h(the)f(quotien)m(t)h(as)g(a)f +(\015oating-p)s(oin)m(t)i(n)m(um)m(b)s(er)c(\(of)i(the)h(same)e(format) +h(as)g(the)g(argumen)m(t,)-30 2536 y(if)i(the)h(argumen)m(t)f(is)g(a)h +(\015oat\))g(instead)g(of)f(as)h(an)f(in)m(teger.)42 +b(The)30 b(pre\014x)g(`)p Fp(f)p Fr(')g(indicates)h(this.)-30 +2686 y(Eac)m(h)g(of)g(the)f(classes)i Fp(cl_F)p Fr(,)d +Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)h +Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g(op)s(erations:)-30 +2868 y Fl(t)m(yp)s(e)36 b Fp(ffloor)28 b(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))-30 2978 y Fl(t)m(yp)s(e)36 b Fp(fceiling)28 +b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))-30 3088 +y Fl(t)m(yp)s(e)36 b Fp(ftruncate)27 b(\(const)i Fl(t)m(yp)s(e)5 +b Fp(&)31 b(x\))-30 3197 y Fl(t)m(yp)s(e)36 b Fp(fround)28 +b(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))-30 3347 +y Fr(and)g(similarly)g(for)g(class)h Fp(cl_R)p Fr(,)e(but)h(with)g +(return)f(t)m(yp)s(e)i Fp(cl_F)p Fr(.)-30 3497 y(The)f(class)h +Fp(cl_R)e Fr(de\014nes)h(the)g(follo)m(wing)i(op)s(erations:)-30 +3680 y Fp(cl_F)d(ffloor)g(\(const)g Fl(t)m(yp)s(e)5 b +Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 +3790 y(cl_F)f(fceiling)f(\(const)h Fl(t)m(yp)s(e)5 b +Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 +3899 y(cl_F)f(ftruncate)f(\(const)h Fl(t)m(yp)s(e)5 b +Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 +4009 y(cl_F)f(fround)g(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x,)g(const)f Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 4159 +y Fr(These)g(functions)f(also)i(exist)g(in)e(v)m(ersions)h(whic)m(h)g +(return)f(b)s(oth)g(the)h(quotien)m(t)h(and)e(the)i(remainder.)39 +b(The)29 b(su\016x)-30 4269 y(`)p Fp(2)p Fr(')i(indicates)g(this.)-30 +4419 y(Eac)m(h)g(of)g(the)f(classes)i Fp(cl_F)p Fr(,)d +Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)h +Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g(op)s(erations:)-30 +4601 y Fp(struct)e Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)28 b({)i +Fl(t)m(yp)s(e)36 b Fp(quotient;)28 b Fl(t)m(yp)s(e)36 +b Fp(remainder;)27 b(};)-30 4711 y Fl(t)m(yp)s(e)5 b +Fp(_fdiv_t)29 b(ffloor2)f(\(const)h Fl(t)m(yp)s(e)5 b +Fp(&)30 b(x\))-30 4821 y Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)29 +b(fceiling2)f(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))-30 +4930 y Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)29 b(ftruncate2)e(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))-30 5040 y Fl(t)m(yp)s(e)5 +b Fp(_fdiv_t)29 b(fround2)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))-30 5190 y Fr(and)g(similarly)g(for)g(class)h +Fp(cl_R)p Fr(,)e(but)h(with)g(quotien)m(t)i(t)m(yp)s(e)e +Fp(cl_F)p Fr(.)-30 5340 y(The)g(class)h Fp(cl_R)e Fr(de\014nes)h(the)g (follo)m(wing)i(op)s(erations:)p eop -%%Page: 21 23 -21 22 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(21)0 366 y Fk(t)m(yp)s(e)36 -b Fp(mod)29 b(\(const)g Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f -Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 491 y Fk(t)m(yp)s(e)36 -b Fp(rem)29 b(\(const)g Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f -Fk(t)m(yp)s(e)5 b Fp(&)30 b(y\))0 906 y Fs(4.7)68 b(Ro)t(ots)0 -1180 y Fr(Eac)m(h)31 b(of)g(the)f(classes)i Fp(cl_R)p -Fr(,)d Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)h Fp(cl_FF)p +%%Page: 16 18 +16 17 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(16)-30 299 y Fp(struct)29 +b Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)28 b({)i(cl_F)g(quotient;)d(cl_R)j +(remainder;)d(};)-30 408 y Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)29 +b(ffloor2)f(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 518 y Fl(t)m(yp)s(e)5 +b Fp(_fdiv_t)29 b(fceiling2)f(\(const)g Fl(t)m(yp)s(e)5 +b Fp(&)31 b(x,)e(const)g Fl(t)m(yp)s(e)5 b Fp(&)31 b(y\))-30 +628 y Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)29 b(ftruncate2)e(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f Fl(t)m(yp)s(e)5 +b Fp(&)30 b(y\))-30 737 y Fl(t)m(yp)s(e)5 b Fp(_fdiv_t)29 +b(fround2)f(\(const)h Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 868 y Fr(Other)g(applications)h +(need)f(only)g(the)h(remainder)e(of)h(a)h(division.)40 +b(The)30 b(remainder)f(of)h(`)p Fp(floor)p Fr(')f(and)h(`)p +Fp(ffloor)p Fr(')f(is)-30 978 y(called)k(`)p Fp(mod)p +Fr(')e(\(abbreviation)h(of)g(\\mo)s(dulo"\).)43 b(The)31 +b(remainder)f(`)p Fp(truncate)p Fr(')g(and)h(`)p Fp(ftruncate)p +Fr(')e(is)j(called)g(`)p Fp(rem)p Fr(')-30 1087 y(\(abbreviation)f(of)g +(\\remainder"\).)45 1218 y Fq(\017)60 b Fp(mod\(x,y\))28 +b(=)i(floor2\(x,y\).remainder)25 b(=)30 b(x)g(-)g(floor\(x/y\)*y)45 +1349 y Fq(\017)60 b Fp(rem\(x,y\))28 b(=)i(truncate2\(x,y\).remainder) +24 b(=)30 b(x)g(-)g(truncate\(x/y\)*y)-30 1501 y Fr(If)j +Fp(x)f Fr(and)h Fp(y)f Fr(are)i(b)s(oth)e Fp(>)p Fr(=)g(0,)j +Fp(mod\(x,y\))28 b(=)i(rem\(x,y\))e(>=)i(0)p Fr(.)48 +b(In)32 b(general,)j Fp(mod\(x,y\))c Fr(has)i(the)g(sign)g(of)g +Fp(y)g Fr(or)g(is)-30 1611 y(zero,)e(and)f Fp(rem\(x,y\))e +Fr(has)i(the)h(sign)f(of)h Fp(x)f Fr(or)g(is)h(zero.)-30 +1742 y(The)f(classes)h Fp(cl_R)p Fr(,)f Fp(cl_I)f Fr(de\014ne)h(the)g +(follo)m(wing)i(op)s(erations:)-30 1894 y Fl(t)m(yp)s(e)k +Fp(mod)29 b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 2004 y Fl(t)m(yp)s(e)36 +b Fp(rem)29 b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f +Fl(t)m(yp)s(e)5 b Fp(&)30 b(y\))-30 2229 y Fs(4.7)68 +b(Ro)t(ots)-30 2418 y Fr(Eac)m(h)31 b(of)g(the)f(classes)i +Fp(cl_R)p Fr(,)d Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)h Fp(cl_FF)p Fr(,)f Fp(cl_DF)p Fr(,)g Fp(cl_LF)g Fr(de\014nes)g(the)i(follo)m(wing)h -(op)s(eration:)0 1476 y Fk(t)m(yp)s(e)k Fp(sqrt)29 b(\(const)g -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 1601 y(x)35 b Fr(m)m(ust)f(b)s(e)g -Fp(>)p Fr(=)h(0.)55 b(This)35 b(function)g(returns)e(the)j(square)f(ro) -s(ot)g(of)g Fp(x)p Fr(,)i(normalized)d(to)i(b)s(e)f Fp(>)p -Fr(=)f(0.)480 1725 y(If)c Fp(x)h Fr(is)g(the)g(square)f(of)h(a)g -(rational)h(n)m(um)m(b)s(er,)d Fp(sqrt\(x\))g Fr(will)i(b)s(e)f(a)i -(rational)g(n)m(um)m(b)s(er,)d(else)i(it)h(will)480 1850 -y(return)d(a)i(\015oating-p)s(oin)m(t)h(appro)m(ximation.)0 -2146 y(The)e(classes)h Fp(cl_RA)p Fr(,)e Fp(cl_I)h Fr(de\014ne)f(the)i -(follo)m(wing)h(op)s(eration:)0 2442 y Fp(cl_boolean)c(sqrtp)h(\(const) -f Fk(t)m(yp)s(e)5 b Fp(&)31 b(x,)e Fk(t)m(yp)s(e)5 b -Fp(*)31 b(root\))480 2567 y Fr(This)25 b(tests)i(whether)f -Fp(x)g Fr(is)g(a)g(p)s(erfect)g(square.)39 b(If)26 b(so,)i(it)e -(returns)f(true)h(and)g(the)g(exact)i(square)e(ro)s(ot)480 -2691 y(in)k Fp(*root)p Fr(,)f(else)i(it)g(returns)f(false.)0 -2988 y(F)-8 b(urthermore,)30 b(for)g(in)m(tegers,)i(similarly:)0 -3284 y Fp(cl_boolean)c(isqrt)h(\(const)f Fk(t)m(yp)s(e)5 -b Fp(&)31 b(x,)e Fk(t)m(yp)s(e)5 b Fp(*)31 b(root\))480 -3408 y(x)f Fr(should)g(b)s(e)g Fp(>)p Fr(=)g(0.)42 b(This)30 -b(function)h(sets)g Fp(*root)e Fr(to)i Fp(floor\(sqrt\(x\)\))c -Fr(and)j(returns)g(the)h(same)480 3533 y(v)-5 b(alue)31 +(op)s(eration:)-30 2570 y Fl(t)m(yp)s(e)k Fp(sqrt)29 +b(\(const)g Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 2680 +y(x)e Fr(m)m(ust)g(b)s(e)g Fp(>)p Fr(=)h(0.)40 b(This)28 +b(function)h(returns)e(the)i(square)g(ro)s(ot)g(of)g +Fp(x)p Fr(,)g(normalized)f(to)i(b)s(e)e Fp(>)p Fr(=)g(0.)41 +b(If)28 b Fp(x)450 2789 y Fr(is)g(the)g(square)f(of)h(a)g(rational)h(n) +m(um)m(b)s(er,)d Fp(sqrt\(x\))g Fr(will)i(b)s(e)f(a)h(rational)h(n)m +(um)m(b)s(er,)d(else)j(it)f(will)g(return)450 2899 y(a)j(\015oating-p)s +(oin)m(t)g(appro)m(ximation.)-30 3051 y(The)f(classes)h +Fp(cl_RA)p Fr(,)e Fp(cl_I)h Fr(de\014ne)f(the)i(follo)m(wing)h(op)s +(eration:)-30 3203 y Fp(cl_boolean)c(sqrtp)h(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x,)e Fl(t)m(yp)s(e)5 b Fp(*)31 +b(root\))450 3313 y Fr(This)e(tests)i(whether)e Fp(x)g +Fr(is)h(a)h(p)s(erfect)e(square.)41 b(If)29 b(so,)i(it)f(returns)f +(true)g(and)h(the)g(exact)h(square)f(ro)s(ot)450 3423 +y(in)g Fp(*root)p Fr(,)f(else)i(it)g(returns)f(false.)-30 +3575 y(F)-8 b(urthermore,)30 b(for)g(in)m(tegers,)i(similarly:)-30 +3727 y Fp(cl_boolean)c(isqrt)h(\(const)f Fl(t)m(yp)s(e)5 +b Fp(&)31 b(x,)e Fl(t)m(yp)s(e)5 b Fp(*)31 b(root\))450 +3837 y(x)j Fr(should)g(b)s(e)f Fp(>)p Fr(=)h(0.)53 b(This)34 +b(function)g(sets)h Fp(*root)e Fr(to)i Fp(floor\(sqrt\(x\)\))c +Fr(and)j(returns)f(the)i(same)450 3946 y(v)-5 b(alue)31 b(as)f Fp(sqrtp)p Fr(:)40 b(the)30 b(b)s(o)s(olean)h(v)-5 -b(alue)31 b Fp(\(expt\(*root,2\))26 b(==)k(x\))p Fr(.)0 -3829 y(F)-8 b(or)31 b Fp(n)p Fr(th)f(ro)s(ots,)h(the)f(classes)i +b(alue)31 b Fp(\(expt\(*root,2\))26 b(==)k(x\))p Fr(.)-30 +4098 y(F)-8 b(or)31 b Fp(n)p Fr(th)f(ro)s(ots,)h(the)f(classes)i Fp(cl_RA)p Fr(,)d Fp(cl_I)g Fr(de\014ne)h(the)g(follo)m(wing)i(op)s -(eration:)0 4125 y Fp(cl_boolean)c(rootp)h(\(const)f -Fk(t)m(yp)s(e)5 b Fp(&)31 b(x,)e(const)g(cl_I&)g(n,)h -Fk(t)m(yp)s(e)5 b Fp(*)30 b(root\))480 4250 y(x)36 b -Fr(m)m(ust)f(b)s(e)g Fp(>)p Fr(=)g(0.)58 b Fp(n)36 b -Fr(m)m(ust)f(b)s(e)g Fp(>)h Fr(0.)58 b(This)35 b(tests)i(whether)e -Fp(x)h Fr(is)g(an)g Fp(n)p Fr(th)f(p)s(o)m(w)m(er)h(of)g(a)h(rational) -480 4374 y(n)m(um)m(b)s(er.)h(If)30 b(so,)h(it)g(returns)e(true)h(and)g +(eration:)-30 4251 y Fp(cl_boolean)c(rootp)h(\(const)f +Fl(t)m(yp)s(e)5 b Fp(&)31 b(x,)e(const)g(cl_I&)g(n,)h +Fl(t)m(yp)s(e)5 b Fp(*)30 b(root\))450 4360 y(x)38 b +Fr(m)m(ust)g(b)s(e)f Fp(>)p Fr(=)h(0.)66 b Fp(n)38 b +Fr(m)m(ust)f(b)s(e)h Fp(>)g Fr(0.)66 b(This)37 b(tests)j(whether)e +Fp(x)g Fr(is)g(an)h Fp(n)p Fr(th)f(p)s(o)m(w)m(er)g(of)h(a)g(rational) +450 4470 y(n)m(um)m(b)s(er.)f(If)30 b(so,)h(it)g(returns)e(true)h(and)g (the)h(exact)h(ro)s(ot)e(in)g Fp(*root)p Fr(,)g(else)h(it)g(returns)e -(false.)0 4670 y(The)h(only)g(square)g(ro)s(ot)h(function)f(whic)m(h)g -(accepts)i(negativ)m(e)h(n)m(um)m(b)s(ers)28 b(is)i(the)h(one)f(for)g -(class)h Fp(cl_N)p Fr(:)0 4966 y Fp(cl_N)e(sqrt)g(\(const)g(cl_N&)g -(z\))480 5091 y Fr(Returns)38 b(the)i(square)f(ro)s(ot)h(of)f -Fp(z)p Fr(,)j(as)d(de\014ned)g(b)m(y)g(the)g(form)m(ula)g -Fp(sqrt\(z\))28 b(=)i(exp\(log\(z\)/2\))p Fr(.)480 5215 -y(Con)m(v)m(ersion)44 b(to)g(a)f(\015oating-p)s(oin)m(t)i(t)m(yp)s(e)e -(or)h(to)g(a)f(complex)g(n)m(um)m(b)s(er)e(are)j(done)f(if)g(necessary) --8 b(.)480 5340 y(The)31 b(range)h(of)g(the)g(result)g(is)g(the)g(righ) -m(t)g(half)g(plane)g Fp(realpart\(sqrt\(z\)\))25 b(>=)30 -b(0)h Fr(including)h(the)p eop -%%Page: 22 24 -22 23 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(22)480 366 y(p)s(ositiv)m(e)35 -b(imaginary)e(axis)h(and)g(0,)h(but)e(excluding)h(the)g(negativ)m(e)i -(imaginary)d(axis.)52 b(The)33 b(result)480 491 y(is)d(an)h(exact)h(n)m -(um)m(b)s(er)c(only)i(if)g Fp(z)g Fr(is)h(an)f(exact)i(n)m(um)m(b)s -(er.)0 930 y Fs(4.8)68 b(T)-11 b(ranscenden)l(tal)31 -b(functions)0 1204 y Fr(The)c(transcenden)m(tal)h(functions)e(return)h -(an)g(exact)h(result)f(if)g(the)h(argumen)m(t)e(is)i(exact)g(and)f(the) -g(result)g(is)g(exact)0 1329 y(as)k(w)m(ell.)44 b(Otherwise)31 -b(they)g(m)m(ust)f(return)g(inexact)i(n)m(um)m(b)s(ers)d(ev)m(en)j(if)f -(the)g(argumen)m(t)g(is)g(exact.)44 b(F)-8 b(or)32 b(example,)0 -1453 y Fp(cos\(0\))d(=)h(1)g Fr(returns)f(the)h(rational)i(n)m(um)m(b)s -(er)c Fp(1)p Fr(.)0 1860 y Fm(4.8.1)63 b(Exp)s(onen)m(tial)30 -b(and)g(logarithmic)g(functions)0 2156 y Fp(cl_R)f(exp)h(\(const)e -(cl_R&)h(x\))0 2281 y(cl_N)g(exp)h(\(const)e(cl_N&)h(x\))480 -2405 y Fr(Returns)j(the)h(exp)s(onen)m(tial)h(function)f(of)g -Fp(x)p Fr(.)48 b(This)32 b(is)h Fp(e^x)f Fr(where)g Fp(e)h -Fr(is)g(the)g(base)g(of)g(the)g(natural)480 2530 y(logarithms.)41 -b(The)29 b(range)i(of)g(the)f(result)h(is)f(the)h(en)m(tire)g(complex)f -(plane)g(excluding)h(0.)0 2700 y Fp(cl_R)e(ln)h(\(const)f(cl_R&)g(x\)) -480 2824 y(x)h Fr(m)m(ust)f(b)s(e)h Fp(>)g Fr(0.)41 b(Returns)30 -b(the)g(\(natural\))h(logarithm)g(of)f(x.)0 2994 y Fp(cl_N)f(log)h -(\(const)e(cl_N&)h(x\))480 3119 y Fr(Returns)43 b(the)i(\(natural\))f -(logarithm)h(of)f(x.)82 b(If)44 b Fp(x)f Fr(is)i(real)f(and)g(p)s -(ositiv)m(e,)49 b(this)44 b(is)g Fp(ln\(x\))p Fr(.)81 -b(In)480 3243 y(general,)34 b Fp(log\(x\))29 b(=)h(log\(abs\(x\)\))d(+) -j(i*phase\(x\))p Fr(.)45 b(The)32 b(range)g(of)h(the)g(result)f(is)h -(the)f(strip)g(in)480 3368 y(the)f(complex)f(plane)g -Fp(-pi)g(<)g(imagpart\(log\(x\)\))25 b(<=)30 b(pi)p Fr(.)0 -3538 y Fp(cl_R)f(phase)g(\(const)g(cl_N&)g(x\))480 3662 -y Fr(Returns)38 b(the)h(angle)g(part)g(of)g Fp(x)f Fr(in)g(its)h(p)s -(olar)g(represen)m(tation)g(as)g(a)g(complex)g(n)m(um)m(b)s(er.)63 -b(That)480 3787 y(is,)34 b Fp(phase\(x\))28 b(=)i -(atan\(realpart\(x\),imagpart)o(\(x\)\))o Fr(.)43 b(This)33 -b(is)g(also)h(the)f(imaginary)g(part)g(of)480 3911 y -Fp(log\(x\))p Fr(.)41 b(The)31 b(range)g(of)g(the)h(result)f(is)g(the)g -(in)m(terv)-5 b(al)32 b Fp(-pi)e(<)g(phase\(x\))e(<=)i(pi)p -Fr(.)42 b(The)31 b(result)g(will)480 4036 y(b)s(e)f(an)g(exact)i(n)m -(um)m(b)s(er)c(only)i(if)h Fp(zerop\(x\))d Fr(or)i(if)h -Fp(x)f Fr(is)g(real)h(and)f(p)s(ositiv)m(e.)0 4206 y -Fp(cl_R)f(log)h(\(const)e(cl_R&)h(a,)h(const)f(cl_R&)g(b\))480 -4330 y(a)j Fr(and)g Fp(b)g Fr(m)m(ust)g(b)s(e)g Fp(>)g -Fr(0.)48 b(Returns)31 b(the)i(logarithm)g(of)f Fp(a)g -Fr(with)h(resp)s(ect)f(to)i(base)e Fp(b)p Fr(.)47 b Fp(log\(a,b\))28 -b(=)480 4455 y(ln\(a\)/ln\(b\))p Fr(.)38 b(The)30 b(result)g(can)g(b)s +(false.)-30 4622 y(The)h(only)g(square)g(ro)s(ot)h(function)f(whic)m(h) +g(accepts)i(negativ)m(e)h(n)m(um)m(b)s(ers)28 b(is)i(the)h(one)f(for)g +(class)h Fp(cl_N)p Fr(:)-30 4774 y Fp(cl_N)e(sqrt)g(\(const)g(cl_N&)g +(z\))450 4884 y Fr(Returns)44 b(the)h(square)f(ro)s(ot)h(of)g +Fp(z)p Fr(,)j(as)d(de\014ned)f(b)m(y)g(the)h(form)m(ula)f +Fp(sqrt\(z\))28 b(=)i(exp\(log\(z\)/2\))p Fr(.)450 4994 +y(Con)m(v)m(ersion)j(to)g(a)f(\015oating-p)s(oin)m(t)i(t)m(yp)s(e)e(or) +h(to)g(a)f(complex)g(n)m(um)m(b)s(er)e(are)j(done)f(if)g(necessary)-8 +b(.)47 b(The)450 5103 y(range)25 b(of)f(the)h(result)f(is)g(the)h(righ) +m(t)g(half)f(plane)g Fp(realpart\(sqrt\(z\)\))i(>=)k(0)24 +b Fr(including)f(the)i(p)s(ositiv)m(e)450 5213 y(imaginary)k(axis)h +(and)f(0,)h(but)f(excluding)g(the)h(negativ)m(e)i(imaginary)d(axis.)40 +b(The)29 b(result)h(is)f(an)g(exact)450 5322 y(n)m(um)m(b)s(er)f(only)j +(if)f Fp(z)g Fr(is)g(an)h(exact)g(n)m(um)m(b)s(er.)p +eop +%%Page: 17 19 +17 18 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(17)-30 299 y Fs(4.8)68 +b(T)-11 b(ranscenden)l(tal)45 b(functions)-30 495 y Fr(The)30 +b(transcenden)m(tal)i(functions)f(return)f(an)g(exact)j(result)e(if)f +(the)i(argumen)m(t)e(is)h(exact)h(and)f(the)g(result)f(is)h(exact)-30 +605 y(as)j(w)m(ell.)54 b(Otherwise)34 b(they)g(m)m(ust)f(return)g +(inexact)j(n)m(um)m(b)s(ers)c(ev)m(en)j(if)f(the)g(argumen)m(t)g(is)g +(exact.)54 b(F)-8 b(or)35 b(example,)-30 714 y Fp(cos\(0\))29 +b(=)h(1)g Fr(returns)f(the)h(rational)i(n)m(um)m(b)s(er)c +Fp(1)p Fr(.)-30 946 y Fn(4.8.1)63 b(Exp)s(onen)m(tial)40 +b(and)h(logarithmic)g(functions)-30 1169 y Fp(cl_R)29 +b(exp)h(\(const)e(cl_R&)h(x\))-30 1278 y(cl_N)g(exp)h(\(const)e(cl_N&)h +(x\))450 1388 y Fr(Returns)35 b(the)i(exp)s(onen)m(tial)g(function)f +(of)g Fp(x)p Fr(.)58 b(This)36 b(is)g Fp(e^x)f Fr(where)h +Fp(e)g Fr(is)g(the)h(base)f(of)g(the)h(natural)450 1498 +y(logarithms.)k(The)29 b(range)i(of)g(the)f(result)h(is)f(the)h(en)m +(tire)g(complex)f(plane)g(excluding)h(0.)-30 1661 y Fp(cl_R)e(ln)h +(\(const)f(cl_R&)g(x\))450 1770 y(x)h Fr(m)m(ust)f(b)s(e)h +Fp(>)g Fr(0.)41 b(Returns)30 b(the)g(\(natural\))h(logarithm)g(of)f(x.) +-30 1933 y Fp(cl_N)f(log)h(\(const)e(cl_N&)h(x\))450 +2043 y Fr(Returns)g(the)g(\(natural\))h(logarithm)g(of)f(x.)41 +b(If)29 b Fp(x)g Fr(is)g(real)h(and)f(p)s(ositiv)m(e,)i(this)e(is)h +Fp(ln\(x\))p Fr(.)39 b(In)29 b(general,)450 2153 y Fp(log\(x\))g(=)h +(log\(abs\(x\)\))d(+)j(i*phase\(x\))p Fr(.)35 b(The)21 +b(range)i(of)f(the)g(result)f(is)h(the)g(strip)g(in)f(the)h(complex)450 +2262 y(plane)30 b Fp(-pi)g(<)g(imagpart\(log\(x\)\))c(<=)k(pi)p +Fr(.)-30 2425 y Fp(cl_R)f(phase)g(\(const)g(cl_N&)g(x\))450 +2535 y Fr(Returns)41 b(the)i(angle)h(part)e(of)g Fp(x)g +Fr(in)h(its)f(p)s(olar)g(represen)m(tation)i(as)f(a)f(complex)g(n)m(um) +m(b)s(er.)75 b(That)450 2644 y(is,)41 b Fp(phase\(x\))29 +b(=)h(atan\(realpart\(x\),imagpa)o(rt\()o(x\)\))p Fr(.)60 +b(This)38 b(is)h(also)h(the)f(imaginary)g(part)g(of)450 +2754 y Fp(log\(x\))p Fr(.)52 b(The)35 b(range)g(of)g(the)g(result)g(is) +g(the)g(in)m(terv)-5 b(al)36 b Fp(-pi)29 b(<)h(phase\(x\))e(<=)i(pi)p +Fr(.)54 b(The)34 b(result)h(will)450 2864 y(b)s(e)30 +b(an)g(exact)i(n)m(um)m(b)s(er)c(only)i(if)h Fp(zerop\(x\))d +Fr(or)i(if)h Fp(x)f Fr(is)g(real)h(and)f(p)s(ositiv)m(e.)-30 +3027 y Fp(cl_R)f(log)h(\(const)e(cl_R&)h(a,)h(const)f(cl_R&)g(b\))450 +3136 y(a)35 b Fr(and)g Fp(b)g Fr(m)m(ust)f(b)s(e)h Fp(>)g +Fr(0.)56 b(Returns)35 b(the)g(logarithm)h(of)f Fp(a)g +Fr(with)h(resp)s(ect)f(to)h(base)g Fp(b)p Fr(.)55 b Fp(log\(a,b\))28 +b(=)450 3246 y(ln\(a\)/ln\(b\))p Fr(.)38 b(The)30 b(result)g(can)g(b)s (e)g(exact)i(only)f(if)f Fp(a)g(=)g(1)g Fr(or)g(if)h -Fp(a)f Fr(and)g Fp(b)g Fr(are)g(b)s(oth)g(rational.)0 -4624 y Fp(cl_N)f(log)h(\(const)e(cl_N&)h(a,)h(const)f(cl_N&)g(b\))480 -4749 y Fr(Returns)g(the)i(logarithm)f(of)h Fp(a)f Fr(with)g(resp)s(ect) +Fp(a)f Fr(and)g Fp(b)g Fr(are)g(b)s(oth)g(rational.)-30 +3409 y Fp(cl_N)f(log)h(\(const)e(cl_N&)h(a,)h(const)f(cl_N&)g(b\))450 +3518 y Fr(Returns)g(the)i(logarithm)f(of)h Fp(a)f Fr(with)g(resp)s(ect) g(to)i(base)e Fp(b)p Fr(.)40 b Fp(log\(a,b\))29 b(=)h -(log\(a\)/log\(b\))p Fr(.)0 4919 y Fp(cl_N)f(expt)g(\(const)g(cl_N&)g -(x,)h(const)f(cl_N&)g(y\))480 5043 y Fr(Exp)s(onen)m(tiation:)42 -b(Returns)29 b Fp(x^y)g(=)h(exp\(y*log\(x\)\))p Fr(.)0 -5340 y(The)g(constan)m(t)i(e)e(=)g(exp\(1\))i(=)e(2.71828)p -Fn(:)15 b(:)g(:)34 b Fr(is)c(returned)g(b)m(y)g(the)g(follo)m(wing)i -(functions:)p eop -%%Page: 23 25 -23 24 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(23)0 366 y Fp(cl_F)29 -b(cl_exp1)g(\(cl_float_format_t)c(f\))480 491 y Fr(Returns)k(e)i(as)g -(a)g(\015oat)g(of)f(format)g Fp(f)p Fr(.)0 657 y Fp(cl_F)f(cl_exp1)g -(\(const)f(cl_F&)h(y\))480 782 y Fr(Returns)g(e)i(in)f(the)h(\015oat)g -(format)f(of)g Fp(y)p Fr(.)0 948 y Fp(cl_F)f(cl_exp1)g(\(void\))480 -1073 y Fr(Returns)g(e)i(as)g(a)g(\015oat)g(of)f(format)g -Fp(cl_default_float_format)p Fr(.)0 1472 y Fm(4.8.2)63 -b(T)-10 b(rigonometric)30 b(functions)0 1767 y Fp(cl_R)f(sin)h(\(const) -e(cl_R&)h(x\))480 1892 y Fr(Returns)g Fp(sin\(x\))p Fr(.)39 -b(The)30 b(range)h(of)g(the)f(result)g(is)h(the)f(in)m(terv)-5 -b(al)32 b Fp(-1)e(<=)f(sin\(x\))g(<=)h(1)p Fr(.)0 2058 -y Fp(cl_N)f(sin)h(\(const)e(cl_N&)h(z\))480 2183 y Fr(Returns)g +(log\(a\)/log\(b\))p Fr(.)-30 3682 y Fp(cl_N)f(expt)g(\(const)g(cl_N&)g +(x,)h(const)f(cl_N&)g(y\))450 3791 y Fr(Exp)s(onen)m(tiation:)42 +b(Returns)29 b Fp(x^y)g(=)h(exp\(y*log\(x\)\))p Fr(.)-30 +3956 y(The)g(constan)m(t)i(e)e(=)g(exp\(1\))i(=)e(2.71828)6 +b(.)24 b(.)f(.)41 b(is)31 b(returned)e(b)m(y)h(the)h(follo)m(wing)h +(functions:)-30 4121 y Fp(cl_F)d(cl_exp1)g(\(cl_float_format_t)c(f\)) +450 4231 y Fr(Returns)k(e)i(as)g(a)g(\015oat)g(of)f(format)g +Fp(f)p Fr(.)-30 4394 y Fp(cl_F)f(cl_exp1)g(\(const)f(cl_F&)h(y\))450 +4503 y Fr(Returns)g(e)i(in)f(the)h(\015oat)g(format)f(of)g +Fp(y)p Fr(.)-30 4666 y Fp(cl_F)f(cl_exp1)g(\(void\))450 +4776 y Fr(Returns)g(e)i(as)g(a)g(\015oat)g(of)f(format)g +Fp(cl_default_float_format)p Fr(.)-30 5007 y Fn(4.8.2)63 +b(T)-10 b(rigonometric)41 b(functions)-30 5230 y Fp(cl_R)29 +b(sin)h(\(const)e(cl_R&)h(x\))450 5340 y Fr(Returns)g +Fp(sin\(x\))p Fr(.)39 b(The)30 b(range)h(of)g(the)f(result)g(is)h(the)f +(in)m(terv)-5 b(al)32 b Fp(-1)e(<=)f(sin\(x\))g(<=)h(1)p +Fr(.)p eop +%%Page: 18 20 +18 19 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(18)-30 299 y Fp(cl_N)29 +b(sin)h(\(const)e(cl_N&)h(z\))450 408 y Fr(Returns)g Fp(sin\(z\))p Fr(.)39 b(The)30 b(range)h(of)g(the)f(result)g(is)h(the)f -(en)m(tire)i(complex)e(plane.)0 2349 y Fp(cl_R)f(cos)h(\(const)e(cl_R&) -h(x\))480 2474 y Fr(Returns)g Fp(cos\(x\))p Fr(.)39 b(The)30 -b(range)h(of)g(the)f(result)g(is)h(the)f(in)m(terv)-5 -b(al)32 b Fp(-1)e(<=)f(cos\(x\))g(<=)h(1)p Fr(.)0 2640 -y Fp(cl_N)f(cos)h(\(const)e(cl_N&)h(x\))480 2764 y Fr(Returns)g +(en)m(tire)i(complex)e(plane.)-30 562 y Fp(cl_R)f(cos)h(\(const)e +(cl_R&)h(x\))450 671 y Fr(Returns)g Fp(cos\(x\))p Fr(.)39 +b(The)30 b(range)h(of)g(the)f(result)g(is)h(the)f(in)m(terv)-5 +b(al)32 b Fp(-1)e(<=)f(cos\(x\))g(<=)h(1)p Fr(.)-30 825 +y Fp(cl_N)f(cos)h(\(const)e(cl_N&)h(x\))450 934 y Fr(Returns)g Fp(cos\(z\))p Fr(.)39 b(The)30 b(range)h(of)g(the)f(result)g(is)h(the)f -(en)m(tire)i(complex)e(plane.)0 2931 y Fp(struct)f(cl_cos_sin_t)e({)j -(cl_R)f(cos;)g(cl_R)g(sin;)h(};)0 3055 y(cl_cos_sin_t)d(cl_cos_sin)h -(\(const)g(cl_R&)h(x\))480 3180 y Fr(Returns)k(b)s(oth)h -Fp(sin\(x\))f Fr(and)g Fp(cos\(x\))p Fr(.)51 b(This)34 -b(is)g(more)g(e\016cien)m(t)i(than)e(computing)f(them)g(sepa-)480 -3304 y(rately)-8 b(.)42 b(The)30 b(relation)i Fp(cos^2)d(+)h(sin^2)e(=) -j(1)f Fr(will)g(hold)g(only)h(appro)m(ximately)-8 b(.)0 -3471 y Fp(cl_R)29 b(tan)h(\(const)e(cl_R&)h(x\))0 3595 -y(cl_N)g(tan)h(\(const)e(cl_N&)h(x\))480 3720 y Fr(Returns)g -Fp(tan\(x\))g(=)h(sin\(x\)/cos\(x\))p Fr(.)0 3886 y Fp(cl_N)f(cis)h -(\(const)e(cl_R&)h(x\))0 4011 y(cl_N)g(cis)h(\(const)e(cl_N&)h(x\))480 -4135 y Fr(Returns)h Fp(exp\(i*x\))p Fr(.)41 b(The)30 -b(name)g(`)p Fp(cis)p Fr(')h(means)f(\\cos)i Fp(+)f Fr(i)g(sin",)g(b)s -(ecause)g Fp(e^\(i*x\))e(=)h(cos\(x\))e(+)480 4260 y(i*sin\(x\))p -Fr(.)0 4426 y Fp(cl_N)h(asin)g(\(const)g(cl_N&)g(z\))480 -4551 y Fr(Returns)24 b Fp(arcsin\(z\))p Fr(.)37 b(This)24 -b(is)h(de\014ned)f(as)h Fp(arcsin\(z\))j(=)i(log\(iz+sqrt\(1-z^2\)\)/i) -20 b Fr(and)k(sat-)480 4675 y(is\014es)g Fp(arcsin\(-z\))j(=)j -(-arcsin\(z\))p Fr(.)36 b(The)23 b(range)i(of)f(the)g(result)f(is)h -(the)g(strip)g(in)f(the)h(complex)g(do-)480 4800 y(main)g -Fp(-pi/2)29 b(<=)h(realpart\(arcsin\(z\)\))25 b(<=)30 -b(pi/2)p Fr(,)25 b(excluding)g(the)h(n)m(um)m(b)s(ers)c(with)j -Fp(realpart)480 4925 y(=)30 b(-pi/2)c Fr(and)g Fp(imagpart)i(<)i(0)d -Fr(and)f(the)h(n)m(um)m(b)s(ers)e(with)i Fp(realpart)h(=)i(pi/2)25 -b Fr(and)i Fp(imagpart)h(>)i(0)p Fr(.)0 5091 y Fp(cl_N)f(acos)g -(\(const)g(cl_N&)g(z\))480 5215 y Fr(Returns)19 b Fp(arccos\(z\))p -Fr(.)35 b(This)20 b(is)g(de\014ned)f(as)i Fp(arccos\(z\))27 -b(=)j(pi/2)g(-)g(arcsin\(z\))d(=)k(log\(z+i*sqrt\(1-)480 -5340 y(z^2\)\)/i)36 b Fr(and)i(satis\014es)g Fp(arccos\(-z\))28 -b(=)i(pi)g(-)g(arccos\(z\))p Fr(.)61 b(The)38 b(range)h(of)f(the)g -(result)h(is)f(the)p eop -%%Page: 24 26 -24 25 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(24)480 366 y(strip)40 -b(in)f(the)i(complex)e(domain)g Fp(0)30 b(<=)g(realpart\(arcsin\(z\)\)) -25 b(<=)30 b(pi)p Fr(,)42 b(excluding)e(the)g(n)m(um-)480 -491 y(b)s(ers)33 b(with)g Fp(realpart)28 b(=)i(0)k Fr(and)f -Fp(imagpart)28 b(<)i(0)k Fr(and)f(the)h(n)m(um)m(b)s(ers)e(with)h -Fp(realpart)28 b(=)i(pi)k Fr(and)480 616 y Fp(imagpart)28 -b(>)i(0)p Fr(.)0 785 y Fp(cl_R)f(atan)g(\(const)g(cl_R&)g(x,)h(const)f -(cl_R&)g(y\))480 910 y Fr(Returns)37 b(the)i(angle)g(of)g(the)f(p)s -(olar)g(represen)m(tation)h(of)g(the)f(complex)g(n)m(um)m(b)s(er)e -Fp(x+iy)p Fr(.)63 b(This)38 b(is)480 1034 y Fp(atan\(y/x\))27 -b Fr(if)i Fp(x>0)p Fr(.)40 b(The)28 b(range)i(of)f(the)h(result)f(is)h -(the)f(in)m(terv)-5 b(al)31 b Fp(-pi)e(<)h(atan\(x,y\))e(<=)i(pi)p -Fr(.)39 b(The)480 1159 y(result)j(will)g(b)s(e)f(an)g(exact)i(n)m(um)m -(b)s(er)d(only)h(if)h Fp(x)30 b(>)g(0)41 b Fr(and)h Fp(y)f -Fr(is)h(the)f(exact)j Fp(0)p Fr(.)74 b(W)-10 b(ARNING:)43 -b(In)480 1283 y(Common)26 b(Lisp,)i(this)g(function)g(is)g(called)h(as) -g Fp(\(atan)g(y)h(x\))p Fr(,)e(with)g(rev)m(ersed)g(order)g(of)g -(argumen)m(ts.)0 1453 y Fp(cl_R)h(atan)g(\(const)g(cl_R&)g(x\))480 -1578 y Fr(Returns)36 b Fp(arctan\(x\))p Fr(.)59 b(This)37 -b(is)g(the)g(same)g(as)g Fp(atan\(1,x\))p Fr(.)59 b(The)37 -b(range)g(of)h(the)f(result)g(is)h(the)480 1702 y(in)m(terv)-5 -b(al)34 b Fp(-pi/2)29 b(<)h(atan\(x\))e(<)i(pi/2)p Fr(.)47 -b(The)32 b(result)g(will)h(b)s(e)f(an)h(exact)h(n)m(um)m(b)s(er)c(only) -j(if)g Fp(x)f Fr(is)h(the)480 1827 y(exact)f Fp(0)p Fr(.)0 -1996 y Fp(cl_N)d(atan)g(\(const)g(cl_N&)g(z\))480 2121 -y Fr(Returns)43 b Fp(arctan\(z\))p Fr(.)80 b(This)44 -b(is)g(de\014ned)g(as)g Fp(arctan\(z\))28 b(=)i -(\(log\(1+iz\)-log\(1-iz\)\))25 b(/)30 b(2i)480 2245 -y Fr(and)23 b(satis\014es)h Fp(arctan\(-z\))k(=)i(-arctan\(z\))p -Fr(.)35 b(The)23 b(range)h(of)g(the)g(result)f(is)h(the)g(strip)f(in)g -(the)h(com-)480 2370 y(plex)45 b(domain)f Fp(-pi/2)29 -b(<=)h(realpart\(arctan\(z\)\))25 b(<=)30 b(pi/2)p Fr(,)47 -b(excluding)e(the)h(n)m(um)m(b)s(ers)c(with)480 2494 -y Fp(realpart)28 b(=)i(-pi/2)42 b Fr(and)h Fp(imagpart)28 -b(>=)i(0)42 b Fr(and)h(the)h(n)m(um)m(b)s(ers)c(with)j -Fp(realpart)28 b(=)i(pi/2)43 b Fr(and)480 2619 y Fp(imagpart)28 -b(<=)i(0)p Fr(.)0 2915 y(Arc)m(himedes')g(constan)m(t)i(pi)e(=)g(3.14)p -Fn(:)15 b(:)g(:)33 b Fr(is)d(returned)f(b)m(y)h(the)h(follo)m(wing)h -(functions:)0 3212 y Fp(cl_F)d(cl_pi)g(\(cl_float_format_t)d(f\))480 -3336 y Fr(Returns)j(pi)i(as)f(a)h(\015oat)g(of)f(format)g -Fp(f)p Fr(.)0 3506 y Fp(cl_F)f(cl_pi)g(\(const)g(cl_F&)g(y\))480 -3631 y Fr(Returns)g(pi)i(in)f(the)g(\015oat)h(format)f(of)g -Fp(y)p Fr(.)0 3800 y Fp(cl_F)f(cl_pi)g(\(void\))480 3925 -y Fr(Returns)g(pi)i(as)f(a)h(\015oat)g(of)f(format)g -Fp(cl_default_float_format)p Fr(.)0 4331 y Fm(4.8.3)63 -b(Hyp)s(erb)s(olic)31 b(functions)0 4627 y Fp(cl_R)e(sinh)g(\(const)g -(cl_R&)g(x\))480 4752 y Fr(Returns)g Fp(sinh\(x\))p Fr(.)0 -4921 y Fp(cl_N)g(sinh)g(\(const)g(cl_N&)g(z\))480 5046 -y Fr(Returns)g Fp(sinh\(z\))p Fr(.)39 b(The)30 b(range)h(of)f(the)h -(result)f(is)h(the)f(en)m(tire)h(complex)g(plane.)0 5215 -y Fp(cl_R)e(cosh)g(\(const)g(cl_R&)g(x\))480 5340 y Fr(Returns)g -Fp(cosh\(x\))p Fr(.)39 b(The)30 b(range)h(of)f(the)h(result)f(is)h(the) -f(in)m(terv)-5 b(al)32 b Fp(cosh\(x\))c(>=)i(1)p Fr(.)p -eop -%%Page: 25 27 -25 26 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(25)0 366 y Fp(cl_N)29 -b(cosh)g(\(const)g(cl_N&)g(z\))480 491 y Fr(Returns)g -Fp(cosh\(z\))p Fr(.)39 b(The)30 b(range)h(of)f(the)h(result)f(is)h(the) -f(en)m(tire)h(complex)g(plane.)0 667 y Fp(struct)e(cl_cosh_sinh_t)d({)k -(cl_R)f(cosh;)g(cl_R)h(sinh;)e(};)0 792 y(cl_cosh_sinh_t)e -(cl_cosh_sinh)i(\(const)g(cl_R&)h(x\))480 916 y Fr(Returns)44 -b(b)s(oth)h Fp(sinh\(x\))e Fr(and)i Fp(cosh\(x\))p Fr(.)83 -b(This)44 b(is)i(more)e(e\016cien)m(t)j(than)e(computing)f(them)480 -1041 y(separately)-8 b(.)42 b(The)30 b(relation)i Fp(cosh^2)c(-)j -(sinh^2)d(=)i(1)g Fr(will)h(hold)f(only)g(appro)m(ximately)-8 -b(.)0 1217 y Fp(cl_R)29 b(tanh)g(\(const)g(cl_R&)g(x\))0 -1342 y(cl_N)g(tanh)g(\(const)g(cl_N&)g(x\))480 1466 y -Fr(Returns)g Fp(tanh\(x\))g(=)h(sinh\(x\)/cosh\(x\))p -Fr(.)0 1643 y Fp(cl_N)f(asinh)g(\(const)g(cl_N&)g(z\))480 -1767 y Fr(Returns)22 b Fp(arsinh\(z\))p Fr(.)36 b(This)22 -b(is)i(de\014ned)d(as)j Fp(arsinh\(z\))k(=)i(log\(z+sqrt\(1+z^2\)\))18 -b Fr(and)k(satis\014es)480 1892 y Fp(arsinh\(-z\))28 -b(=)i(-arsinh\(z\))p Fr(.)37 b(The)27 b(range)h(of)g(the)g(result)g(is) -g(the)g(strip)f(in)h(the)g(complex)f(domain)480 2016 -y Fp(-pi/2)i(<=)h(imagpart\(arsinh\(z\)\))25 b(<=)30 -b(pi/2)p Fr(,)39 b(excluding)f(the)h(n)m(um)m(b)s(ers)c(with)j -Fp(imagpart)28 b(=)i(-)480 2141 y(pi/2)f Fr(and)h Fp(realpart)e(>)i(0)g -Fr(and)g(the)g(n)m(um)m(b)s(ers)e(with)i Fp(imagpart)f(=)h(pi/2)f -Fr(and)h Fp(realpart)e(<)i(0)p Fr(.)0 2317 y Fp(cl_N)f(acosh)g(\(const) -g(cl_N&)g(z\))480 2442 y Fr(Returns)d Fp(arcosh\(z\))p -Fr(.)37 b(This)26 b(is)h(de\014ned)f(as)h Fp(arcosh\(z\))h(=)i -(2*log\(sqrt\(\(z+1\)/2\)+sqr)o(t\(\(z)o(-)480 2566 y(1\)/2\)\))p -Fr(.)102 b(The)51 b(range)h(of)g(the)g(result)f(is)g(the)h(half-strip)f -(in)h(the)f(complex)g(domain)g Fp(-pi)29 b(<)480 2691 -y(imagpart\(arcosh\(z\)\))c(<=)30 b(pi,)f(realpart\(arcosh\(z\)\))c(>=) -30 b(0)p Fr(,)76 b(excluding)67 b(the)f(n)m(um)m(b)s(ers)480 -2815 y(with)30 b Fp(realpart)e(=)i(0)g Fr(and)g Fp(-pi)g(<)g(imagpart)e -(<)i(0)p Fr(.)0 2991 y Fp(cl_N)f(atanh)g(\(const)g(cl_N&)g(z\))480 -3116 y Fr(Returns)38 b Fp(artanh\(z\))p Fr(.)64 b(This)39 -b(is)g(de\014ned)f(as)h Fp(artanh\(z\))28 b(=)i -(\(log\(1+z\)-log\(1-z\)\))25 b(/)30 b(2)39 b Fr(and)480 -3241 y(satis\014es)f Fp(artanh\(-z\))27 b(=)j(-artanh\(z\))p -Fr(.)58 b(The)37 b(range)g(of)g(the)g(result)g(is)g(the)h(strip)e(in)h -(the)g(com-)480 3365 y(plex)45 b(domain)f Fp(-pi/2)29 -b(<=)h(imagpart\(artanh\(z\)\))25 b(<=)30 b(pi/2)p Fr(,)47 -b(excluding)e(the)h(n)m(um)m(b)s(ers)c(with)480 3490 -y Fp(imagpart)28 b(=)i(-pi/2)42 b Fr(and)h Fp(realpart)28 -b(<=)i(0)42 b Fr(and)h(the)h(n)m(um)m(b)s(ers)c(with)j -Fp(imagpart)28 b(=)i(pi/2)43 b Fr(and)480 3614 y Fp(realpart)28 -b(>=)i(0)p Fr(.)0 4038 y Fm(4.8.4)63 b(Euler)30 b(gamma)0 -4313 y Fr(Euler's)g(constan)m(t)i(C)e(=)g(0.577)p Fn(:)15 -b(:)g(:)33 b Fr(is)e(returned)e(b)m(y)h(the)h(follo)m(wing)g -(functions:)0 4614 y Fp(cl_F)e(cl_eulerconst)e(\(cl_float_format_t)e -(f\))480 4738 y Fr(Returns)k(Euler's)i(constan)m(t)g(as)g(a)g(\015oat)g -(of)f(format)g Fp(f)p Fr(.)0 4915 y Fp(cl_F)f(cl_eulerconst)e(\(const)i -(cl_F&)g(y\))480 5039 y Fr(Returns)g(Euler's)i(constan)m(t)g(in)f(the)h -(\015oat)g(format)f(of)g Fp(y)p Fr(.)0 5215 y Fp(cl_F)f(cl_eulerconst)e -(\(void\))480 5340 y Fr(Returns)i(Euler's)i(constan)m(t)g(as)g(a)g -(\015oat)g(of)f(format)g Fp(cl_default_float_format)p +(en)m(tire)i(complex)e(plane.)-30 1088 y Fp(struct)f(cl_cos_sin_t)e({)j +(cl_R)f(cos;)g(cl_R)g(sin;)h(};)-30 1198 y(cl_cos_sin_t)d(cl_cos_sin)h +(\(const)g(cl_R&)h(x\))450 1307 y Fr(Returns)20 b(b)s(oth)h +Fp(sin\(x\))f Fr(and)h Fp(cos\(x\))p Fr(.)36 b(This)20 +b(is)i(more)e(e\016cien)m(t)j(than)e(computing)g(them)f(separately)-8 +b(.)450 1417 y(The)30 b(relation)h Fp(cos^2)e(+)h(sin^2)f(=)h(1)g +Fr(will)h(hold)f(only)h(appro)m(ximately)-8 b(.)-30 1570 +y Fp(cl_R)29 b(tan)h(\(const)e(cl_R&)h(x\))-30 1680 y(cl_N)g(tan)h +(\(const)e(cl_N&)h(x\))450 1789 y Fr(Returns)g Fp(tan\(x\))g(=)h +(sin\(x\)/cos\(x\))p Fr(.)-30 1943 y Fp(cl_N)f(cis)h(\(const)e(cl_R&)h +(x\))-30 2052 y(cl_N)g(cis)h(\(const)e(cl_N&)h(x\))450 +2162 y Fr(Returns)35 b Fp(exp\(i*x\))p Fr(.)54 b(The)35 +b(name)f(`)p Fp(cis)p Fr(')h(means)g(\\cos)i Fp(+)e Fr(i)h(sin",)h(b)s +(ecause)e Fp(e^\(i*x\))29 b(=)h(cos\(x\))e(+)450 2271 +y(i*sin\(x\))p Fr(.)-30 2425 y Fp(cl_N)h(asin)g(\(const)g(cl_N&)g(z\)) +450 2534 y Fr(Returns)j Fp(arcsin\(z\))p Fr(.)44 b(This)32 +b(is)h(de\014ned)e(as)i Fp(arcsin\(z\))27 b(=)j +(log\(iz+sqrt\(1-z^2\)\)/i)d Fr(and)32 b(sat-)450 2644 +y(is\014es)d Fp(arcsin\(-z\))e(=)j(-arcsin\(z\))p Fr(.)37 +b(The)29 b(range)g(of)g(the)g(result)f(is)h(the)g(strip)f(in)g(the)h +(complex)g(do-)450 2754 y(main)34 b Fp(-pi/2)29 b(<=)h +(realpart\(arcsin\(z\)\))25 b(<=)30 b(pi/2)p Fr(,)35 +b(excluding)g(the)h(n)m(um)m(b)s(ers)c(with)j Fp(realpart)450 +2863 y(=)30 b(-pi/2)f Fr(and)h Fp(imagpart)e(<)i(0)g +Fr(and)g(the)g(n)m(um)m(b)s(ers)e(with)i Fp(realpart)e(=)i(pi/2)g +Fr(and)f Fp(imagpart)f(>)j(0)p Fr(.)-30 3017 y Fp(cl_N)e(acos)g +(\(const)g(cl_N&)g(z\))450 3126 y Fr(Returns)101 b Fp(arccos\(z\))p +Fr(.)252 b(This)101 b(is)h(de\014ned)e(as)i Fp(arccos\(z\))28 +b(=)i(pi/2)f(-)h(arcsin\(z\))e(=)450 3236 y(log\(z+i*sqrt\(1-z^2\)\)/i) +53 b Fr(and)58 b(satis\014es)h Fp(arccos\(-z\))28 b(=)i(pi)g(-)g +(arccos\(z\))p Fr(.)123 b(The)59 b(range)450 3345 y(of)48 +b(the)g(result)g(is)g(the)h(strip)e(in)h(the)g(complex)g(domain)f +Fp(0)30 b(<=)f(realpart\(arcsin\(z\)\))d(<=)j(pi)p Fr(,)450 +3455 y(excluding)46 b(the)g(n)m(um)m(b)s(ers)d(with)i +Fp(realpart)28 b(=)i(0)46 b Fr(and)f Fp(imagpart)28 b(<)i(0)45 +b Fr(and)g(the)h(n)m(um)m(b)s(ers)d(with)450 3565 y Fp(realpart)28 +b(=)i(pi)g Fr(and)g Fp(imagpart)e(>)i(0)p Fr(.)-30 3718 +y Fp(cl_R)f(atan)g(\(const)g(cl_R&)g(x,)h(const)f(cl_R&)g(y\))450 +3828 y Fr(Returns)41 b(the)i(angle)g(of)g(the)f(p)s(olar)g(represen)m +(tation)h(of)g(the)f(complex)g(n)m(um)m(b)s(er)e Fp(x+iy)p +Fr(.)75 b(This)42 b(is)450 3937 y Fp(atan\(y/x\))31 b +Fr(if)i Fp(x>0)p Fr(.)49 b(The)33 b(range)h(of)f(the)h(result)f(is)h +(the)g(in)m(terv)-5 b(al)34 b Fp(-pi)c(<)g(atan\(x,y\))d(<=)j(pi)p +Fr(.)49 b(The)450 4047 y(result)23 b(will)g(b)s(e)f(an)g(exact)i(n)m +(um)m(b)s(er)d(only)i(if)f Fp(x)30 b(>)g(0)23 b Fr(and)f +Fp(y)g Fr(is)h(the)g(exact)h Fp(0)p Fr(.)38 b(W)-10 b(ARNING:)23 +b(In)f(Common)450 4156 y(Lisp,)30 b(this)g(function)g(is)h(called)g(as) +g Fp(\(atan)e(y)h(x\))p Fr(,)g(with)g(rev)m(ersed)h(order)e(of)i +(argumen)m(ts.)-30 4310 y Fp(cl_R)e(atan)g(\(const)g(cl_R&)g(x\))450 +4419 y Fr(Returns)40 b Fp(arctan\(x\))p Fr(.)68 b(This)40 +b(is)h(the)g(same)f(as)g Fp(atan\(1,x\))p Fr(.)69 b(The)40 +b(range)h(of)g(the)g(result)f(is)h(the)450 4529 y(in)m(terv)-5 +b(al)38 b Fp(-pi/2)29 b(<)h(atan\(x\))e(<)i(pi/2)p Fr(.)59 +b(The)36 b(result)g(will)h(b)s(e)f(an)h(exact)h(n)m(um)m(b)s(er)c(only) +j(if)g Fp(x)f Fr(is)h(the)450 4639 y(exact)32 b Fp(0)p +Fr(.)-30 4792 y Fp(cl_N)d(atan)g(\(const)g(cl_N&)g(z\))450 +4902 y Fr(Returns)51 b Fp(arctan\(z\))p Fr(.)102 b(This)52 +b(is)f(de\014ned)g(as)h Fp(arctan\(z\))28 b(=)i +(\(log\(1+iz\)-log\(1-iz\)\))25 b(/)30 b(2i)450 5011 +y Fr(and)44 b(satis\014es)h Fp(arctan\(-z\))28 b(=)i(-arctan\(z\))p +Fr(.)80 b(The)44 b(range)h(of)g(the)g(result)f(is)h(the)f(strip)g(in)h +(the)450 5121 y(complex)28 b(domain)g Fp(-pi/2)h(<=)g +(realpart\(arctan\(z\)\))d(<=)j(pi/2)p Fr(,)f(excluding)h(the)g(n)m(um) +m(b)s(ers)d(with)450 5230 y Fp(realpart)i(=)i(-pi/2)49 +b Fr(and)i Fp(imagpart)28 b(>=)i(0)50 b Fr(and)g(the)h(n)m(um)m(b)s +(ers)d(with)j Fp(realpart)28 b(=)i(pi/2)50 b Fr(and)450 +5340 y Fp(imagpart)28 b(<=)i(0)p Fr(.)p eop +%%Page: 19 21 +19 20 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(19)-30 299 y(Arc)m(himedes')30 +b(constan)m(t)i(pi)e(=)g(3.14)6 b(.)23 b(.)f(.)42 b(is)30 +b(returned)g(b)m(y)g(the)g(follo)m(wing)i(functions:)-30 +469 y Fp(cl_F)d(cl_pi)g(\(cl_float_format_t)d(f\))450 +578 y Fr(Returns)j(pi)i(as)f(a)h(\015oat)g(of)f(format)g +Fp(f)p Fr(.)-30 745 y Fp(cl_F)f(cl_pi)g(\(const)g(cl_F&)g(y\))450 +855 y Fr(Returns)g(pi)i(in)f(the)g(\015oat)h(format)f(of)g +Fp(y)p Fr(.)-30 1021 y Fp(cl_F)f(cl_pi)g(\(void\))450 +1131 y Fr(Returns)g(pi)i(as)f(a)h(\015oat)g(of)f(format)g +Fp(cl_default_float_format)p Fr(.)-30 1369 y Fn(4.8.3)63 +b(Hyp)s(erb)s(olic)42 b(functions)-30 1597 y Fp(cl_R)29 +b(sinh)g(\(const)g(cl_R&)g(x\))450 1707 y Fr(Returns)g +Fp(sinh\(x\))p Fr(.)-30 1873 y Fp(cl_N)g(sinh)g(\(const)g(cl_N&)g(z\)) +450 1983 y Fr(Returns)g Fp(sinh\(z\))p Fr(.)39 b(The)30 +b(range)h(of)f(the)h(result)f(is)h(the)f(en)m(tire)h(complex)g(plane.) +-30 2149 y Fp(cl_R)e(cosh)g(\(const)g(cl_R&)g(x\))450 +2259 y Fr(Returns)g Fp(cosh\(x\))p Fr(.)39 b(The)30 b(range)h(of)f(the) +h(result)f(is)h(the)f(in)m(terv)-5 b(al)32 b Fp(cosh\(x\))c(>=)i(1)p +Fr(.)-30 2425 y Fp(cl_N)f(cosh)g(\(const)g(cl_N&)g(z\))450 +2535 y Fr(Returns)g Fp(cosh\(z\))p Fr(.)39 b(The)30 b(range)h(of)f(the) +h(result)f(is)h(the)f(en)m(tire)h(complex)g(plane.)-30 +2701 y Fp(struct)e(cl_cosh_sinh_t)d({)k(cl_R)f(cosh;)g(cl_R)h(sinh;)e +(};)-30 2811 y(cl_cosh_sinh_t)e(cl_cosh_sinh)h(\(const)i(cl_R&)g(x\)) +450 2921 y Fr(Returns)i(b)s(oth)g Fp(sinh\(x\))f Fr(and)h +Fp(cosh\(x\))p Fr(.)43 b(This)31 b(is)h(more)f(e\016cien)m(t)i(than)f +(computing)f(them)f(sepa-)450 3030 y(rately)-8 b(.)42 +b(The)30 b(relation)i Fp(cosh^2)c(-)i(sinh^2)f(=)h(1)g +Fr(will)h(hold)f(only)g(appro)m(ximately)-8 b(.)-30 3197 +y Fp(cl_R)29 b(tanh)g(\(const)g(cl_R&)g(x\))-30 3306 +y(cl_N)g(tanh)g(\(const)g(cl_N&)g(x\))450 3416 y Fr(Returns)g +Fp(tanh\(x\))g(=)h(sinh\(x\)/cosh\(x\))p Fr(.)-30 3582 +y Fp(cl_N)f(asinh)g(\(const)g(cl_N&)g(z\))450 3692 y +Fr(Returns)h Fp(arsinh\(z\))p Fr(.)40 b(This)31 b(is)g(de\014ned)f(as)h +Fp(arsinh\(z\))d(=)i(log\(z+sqrt\(1+z^2\)\))c Fr(and)k(satis\014es)450 +3802 y Fp(arsinh\(-z\))e(=)i(-arsinh\(z\))p Fr(.)36 b(The)26 +b(range)h(of)g(the)g(result)f(is)h(the)g(strip)f(in)g(the)h(complex)f +(domain)f Fp(-)450 3911 y(pi/2)k(<=)h(imagpart\(arsinh\(z\)\))25 +b(<=)30 b(pi/2)p Fr(,)22 b(excluding)g(the)g(n)m(um)m(b)s(ers)d(with)i +Fp(imagpart)28 b(=)i(-pi/2)450 4021 y Fr(and)g Fp(realpart)e(>)i(0)g +Fr(and)g(the)g(n)m(um)m(b)s(ers)e(with)i Fp(imagpart)e(=)i(pi/2)g +Fr(and)f Fp(realpart)g(<)h(0)p Fr(.)-30 4187 y Fp(cl_N)f(acosh)g +(\(const)g(cl_N&)g(z\))450 4297 y Fr(Returns)35 b Fp(arcosh\(z\))p +Fr(.)53 b(This)35 b(is)h(de\014ned)e(as)i Fp(arcosh\(z\))28 +b(=)i(2*log\(sqrt\(\(z+1\)/2\)+sqr)o(t\(\(z)o(-)450 4406 +y(1\)/2\)\))p Fr(.)114 b(The)55 b(range)h(of)g(the)g(result)f(is)g(the) +h(half-strip)f(in)h(the)f(complex)g(domain)g Fp(-pi)29 +b(<)450 4516 y(imagpart\(arcosh\(z\)\))c(<=)30 b(pi,)f +(realpart\(arcosh\(z\)\))c(>=)30 b(0)p Fr(,)99 b(excluding)85 +b(the)g(n)m(um)m(b)s(ers)450 4626 y(with)30 b Fp(realpart)e(=)i(0)g +Fr(and)g Fp(-pi)f(<)i(imagpart)d(<)i(0)p Fr(.)-30 4792 +y Fp(cl_N)f(atanh)g(\(const)g(cl_N&)g(z\))450 4902 y +Fr(Returns)24 b Fp(artanh\(z\))p Fr(.)37 b(This)24 b(is)h(de\014ned)f +(as)h Fp(artanh\(z\))j(=)i(\(log\(1+z\)-log\(1-z\)\))25 +b(/)30 b(2)25 b Fr(and)f(sat-)450 5011 y(is\014es)29 +b Fp(artanh\(-z\))e(=)j(-artanh\(z\))p Fr(.)37 b(The)29 +b(range)g(of)g(the)g(result)f(is)h(the)g(strip)f(in)g(the)h(complex)g +(do-)450 5121 y(main)34 b Fp(-pi/2)29 b(<=)h(imagpart\(artanh\(z\)\))25 +b(<=)30 b(pi/2)p Fr(,)35 b(excluding)g(the)h(n)m(um)m(b)s(ers)c(with)j +Fp(imagpart)450 5230 y(=)30 b(-pi/2)j Fr(and)h Fp(realpart)28 +b(<=)i(0)k Fr(and)g(the)h(n)m(um)m(b)s(ers)d(with)i Fp(imagpart)28 +b(=)i(pi/2)k Fr(and)f Fp(realpart)c(>=)450 5340 y(0)p Fr(.)p eop -%%Page: 26 28 -26 27 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(26)0 366 y(Catalan's)32 -b(constan)m(t)f(G)g(=)f(0.915)p Fn(:)15 b(:)g(:)33 b -Fr(is)e(returned)e(b)m(y)h(the)h(follo)m(wing)h(functions:)0 -676 y Fp(cl_F)d(cl_catalanconst)d(\(cl_float_format_t)g(f\))480 -800 y Fr(Returns)j(Catalan's)j(constan)m(t)g(as)e(a)h(\015oat)g(of)g -(format)e Fp(f)p Fr(.)0 985 y Fp(cl_F)g(cl_catalanconst)d(\(const)j -(cl_F&)g(y\))480 1110 y Fr(Returns)g(Catalan's)j(constan)m(t)g(in)e -(the)g(\015oat)h(format)f(of)h Fp(y)p Fr(.)0 1294 y Fp(cl_F)e -(cl_catalanconst)d(\(void\))480 1419 y Fr(Returns)j(Catalan's)j -(constan)m(t)g(as)e(a)h(\015oat)g(of)g(format)e Fp -(cl_default_float_format)p Fr(.)0 1881 y Fm(4.8.5)63 -b(Riemann)29 b(zeta)0 2160 y Fr(Riemann's)g(zeta)j(function)e(at)h(an)g -(in)m(tegral)h(p)s(oin)m(t)e Fp(s>1)f Fr(is)i(returned)e(b)m(y)h(the)h -(follo)m(wing)h(functions:)0 2470 y Fp(cl_F)d(cl_zeta)g(\(int)g(s,)h -(cl_float_format_t)25 b(f\))480 2594 y Fr(Returns)k(Riemann's)h(zeta)i -(function)e(at)h Fp(s)f Fr(as)g(a)h(\015oat)g(of)g(format)e -Fp(f)p Fr(.)0 2779 y Fp(cl_F)g(cl_zeta)g(\(int)g(s,)h(const)f(cl_F&)f -(y\))480 2904 y Fr(Returns)h(Riemann's)h(zeta)i(function)e(at)h -Fp(s)f Fr(in)g(the)g(\015oat)h(format)f(of)h Fp(y)p Fr(.)0 -3088 y Fp(cl_F)e(cl_zeta)g(\(int)g(s\))480 3213 y Fr(Returns)e -(Riemann's)g(zeta)j(function)d(at)i Fp(s)f Fr(as)g(a)h(\015oat)f(of)h -(format)e Fp(cl_default_float_format)p Fr(.)0 3708 y -Fs(4.9)68 b(F)-11 b(unctions)30 b(on)g(in)l(tegers)0 -4170 y Fm(4.9.1)63 b(Logical)30 b(functions)0 4450 y -Fr(In)m(tegers,)e(when)c(view)m(ed)i(as)g(in)f(t)m(w)m(o's)i(complemen) -m(t)e(notation,)j(can)e(b)s(e)f(though)m(t)h(as)f(in\014nite)h(bit)f -(strings)g(where)0 4574 y(the)31 b(bits')f(v)-5 b(alues)31 -b(ev)m(en)m(tually)h(are)f(constan)m(t.)42 b(F)-8 b(or)31 -b(example,)431 4832 y Fp(17)47 b(=)h(......00010001)431 -4936 y(-6)f(=)h(......11111010)0 5215 y Fr(The)30 b(logical)i(op)s -(erations)f(view)f(in)m(tegers)h(as)g(suc)m(h)f(bit)g(strings)g(and)f -(op)s(erate)i(on)f(eac)m(h)h(of)g(the)f(bit)g(p)s(ositions)g(in)0 -5340 y(parallel.)p eop -%%Page: 27 29 -27 28 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(27)0 366 y Fp(cl_I)29 -b(lognot)g(\(const)g(cl_I&)f(x\))0 491 y(cl_I)h(operator)f(~)i(\(const) -f(cl_I&)g(x\))480 616 y Fr(Logical)j(not,)f(lik)m(e)h -Fp(~x)e Fr(in)g(C.)g(This)g(is)g(the)h(same)e(as)i Fp(-1-x)p -Fr(.)0 776 y Fp(cl_I)e(logand)g(\(const)g(cl_I&)f(x,)i(const)f(cl_I&)g -(y\))0 900 y(cl_I)g(operator)f(&)i(\(const)f(cl_I&)g(x,)h(const)f -(cl_I&)g(y\))480 1025 y Fr(Logical)j(and,)e(lik)m(e)i -Fp(x)e(&)g(y)g Fr(in)g(C.)0 1185 y Fp(cl_I)f(logior)g(\(const)g(cl_I&)f -(x,)i(const)f(cl_I&)g(y\))0 1309 y(cl_I)g(operator)f(|)i(\(const)f -(cl_I&)g(x,)h(const)f(cl_I&)g(y\))480 1434 y Fr(Logical)j(\(inclusiv)m -(e\))g(or,)f(lik)m(e)h Fp(x)e(|)g(y)g Fr(in)g(C.)0 1594 -y Fp(cl_I)f(logxor)g(\(const)g(cl_I&)f(x,)i(const)f(cl_I&)g(y\))0 -1718 y(cl_I)g(operator)f(^)i(\(const)f(cl_I&)g(x,)h(const)f(cl_I&)g -(y\))480 1843 y Fr(Exclusiv)m(e)i(or,)g(lik)m(e)h Fp(x)e(^)g(y)g -Fr(in)g(C.)0 2003 y Fp(cl_I)f(logeqv)g(\(const)g(cl_I&)f(x,)i(const)f -(cl_I&)g(y\))480 2127 y Fr(Bit)m(wise)j(equiv)-5 b(alence,)32 -b(lik)m(e)g Fp(~\(x)d(^)h(y\))g Fr(in)g(C.)0 2288 y Fp(cl_I)f(lognand)g -(\(const)f(cl_I&)h(x,)h(const)f(cl_I&)g(y\))480 2412 -y Fr(Bit)m(wise)j(not)f(and,)f(lik)m(e)h Fp(~\(x)f(&)g(y\))g -Fr(in)g(C.)0 2572 y Fp(cl_I)f(lognor)g(\(const)g(cl_I&)f(x,)i(const)f -(cl_I&)g(y\))480 2697 y Fr(Bit)m(wise)j(not)f(or,)f(lik)m(e)i -Fp(~\(x)d(|)h(y\))g Fr(in)g(C.)0 2857 y Fp(cl_I)f(logandc1)f(\(const)h -(cl_I&)g(x,)h(const)f(cl_I&)g(y\))480 2981 y Fr(Logical)j(and,)e +%%Page: 20 22 +20 21 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(20)-30 299 y Fn(4.8.4)63 +b(Euler)40 b(gamma)-30 498 y Fr(Euler's)30 b(constan)m(t)i(C)e(=)g +(0.577)6 b(.)24 b(.)e(.)41 b(is)31 b(returned)e(b)m(y)h(the)h(follo)m +(wing)h(functions:)-30 666 y Fp(cl_F)d(cl_eulerconst)e +(\(cl_float_format_t)e(f\))450 776 y Fr(Returns)k(Euler's)i(constan)m +(t)g(as)g(a)g(\015oat)g(of)f(format)g Fp(f)p Fr(.)-30 +942 y Fp(cl_F)f(cl_eulerconst)e(\(const)i(cl_F&)g(y\))450 +1051 y Fr(Returns)g(Euler's)i(constan)m(t)g(in)f(the)h(\015oat)g +(format)f(of)g Fp(y)p Fr(.)-30 1217 y Fp(cl_F)f(cl_eulerconst)e +(\(void\))450 1326 y Fr(Returns)i(Euler's)i(constan)m(t)g(as)g(a)g +(\015oat)g(of)f(format)g Fp(cl_default_float_format)p +Fr(.)-30 1495 y(Catalan's)i(constan)m(t)f(G)g(=)f(0.915)6 +b(.)24 b(.)e(.)42 b(is)30 b(returned)f(b)m(y)h(the)h(follo)m(wing)h +(functions:)-30 1664 y Fp(cl_F)d(cl_catalanconst)d(\(cl_float_format_t) +g(f\))450 1773 y Fr(Returns)j(Catalan's)j(constan)m(t)g(as)e(a)h +(\015oat)g(of)g(format)e Fp(f)p Fr(.)-30 1939 y Fp(cl_F)g +(cl_catalanconst)d(\(const)j(cl_F&)g(y\))450 2048 y Fr(Returns)g +(Catalan's)j(constan)m(t)g(in)e(the)g(\015oat)h(format)f(of)h +Fp(y)p Fr(.)-30 2214 y Fp(cl_F)e(cl_catalanconst)d(\(void\))450 +2324 y Fr(Returns)j(Catalan's)j(constan)m(t)g(as)e(a)h(\015oat)g(of)g +(format)e Fp(cl_default_float_format)p Fr(.)-30 2560 +y Fn(4.8.5)63 b(Riemann)39 b(zeta)-30 2759 y Fr(Riemann's)29 +b(zeta)j(function)e(at)h(an)g(in)m(tegral)h(p)s(oin)m(t)e +Fp(s>1)f Fr(is)i(returned)e(b)m(y)h(the)h(follo)m(wing)h(functions:)-30 +2927 y Fp(cl_F)d(cl_zeta)g(\(int)g(s,)h(cl_float_format_t)25 +b(f\))450 3037 y Fr(Returns)k(Riemann's)h(zeta)i(function)e(at)h +Fp(s)f Fr(as)g(a)h(\015oat)g(of)g(format)e Fp(f)p Fr(.)-30 +3203 y Fp(cl_F)g(cl_zeta)g(\(int)g(s,)h(const)f(cl_F&)f(y\))450 +3312 y Fr(Returns)h(Riemann's)h(zeta)i(function)e(at)h +Fp(s)f Fr(in)g(the)g(\015oat)h(format)f(of)h Fp(y)p Fr(.)-30 +3478 y Fp(cl_F)e(cl_zeta)g(\(int)g(s\))450 3587 y Fr(Returns)g +(Riemann's)h(zeta)i(function)e(at)h Fp(s)f Fr(as)g(a)h(\015oat)g(of)g +(format)e Fp(cl_default_float_format)p Fr(.)-30 3860 +y Fs(4.9)68 b(F)-11 b(unctions)44 b(on)h(in)l(tegers)-30 +4155 y Fn(4.9.1)63 b(Logical)40 b(functions)-30 4354 +y Fr(In)m(tegers,)31 b(when)d(view)m(ed)j(as)f(in)f(t)m(w)m(o's)i +(complemen)m(t)e(notation,)i(can)f(b)s(e)f(though)m(t)h(as)g +(in\014nite)f(bit)h(strings)f(where)-30 4463 y(the)i(bits')f(v)-5 +b(alues)31 b(ev)m(en)m(tually)h(are)f(constan)m(t.)42 +b(F)-8 b(or)31 b(example,)401 4598 y Fp(17)47 b(=)h(......00010001)401 +4702 y(-6)f(=)h(......11111010)-30 4843 y Fr(The)33 b(logical)j(op)s +(erations)e(view)g(in)m(tegers)h(as)f(suc)m(h)f(bit)h(strings)f(and)h +(op)s(erate)g(on)f(eac)m(h)i(of)f(the)g(bit)g(p)s(ositions)f(in)-30 +4952 y(parallel.)-30 5121 y Fp(cl_I)c(lognot)g(\(const)g(cl_I&)f(x\)) +-30 5230 y(cl_I)h(operator)f(~)i(\(const)f(cl_I&)g(x\))450 +5340 y Fr(Logical)j(not,)f(lik)m(e)h Fp(~x)e Fr(in)g(C.)g(This)g(is)g +(the)h(same)e(as)i Fp(-1-x)p Fr(.)p eop +%%Page: 21 23 +21 22 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(21)-30 299 y Fp(cl_I)29 +b(logand)g(\(const)g(cl_I&)f(x,)i(const)f(cl_I&)g(y\))-30 +408 y(cl_I)g(operator)f(&)i(\(const)f(cl_I&)g(x,)h(const)f(cl_I&)g(y\)) +450 518 y Fr(Logical)j(and,)e(lik)m(e)i Fp(x)e(&)g(y)g +Fr(in)g(C.)-30 673 y Fp(cl_I)f(logior)g(\(const)g(cl_I&)f(x,)i(const)f +(cl_I&)g(y\))-30 783 y(cl_I)g(operator)f(|)i(\(const)f(cl_I&)g(x,)h +(const)f(cl_I&)g(y\))450 892 y Fr(Logical)j(\(inclusiv)m(e\))g(or,)f +(lik)m(e)h Fp(x)e(|)g(y)g Fr(in)g(C.)-30 1047 y Fp(cl_I)f(logxor)g +(\(const)g(cl_I&)f(x,)i(const)f(cl_I&)g(y\))-30 1157 +y(cl_I)g(operator)f(^)i(\(const)f(cl_I&)g(x,)h(const)f(cl_I&)g(y\))450 +1267 y Fr(Exclusiv)m(e)i(or,)g(lik)m(e)h Fp(x)e(^)g(y)g +Fr(in)g(C.)-30 1422 y Fp(cl_I)f(logeqv)g(\(const)g(cl_I&)f(x,)i(const)f +(cl_I&)g(y\))450 1531 y Fr(Bit)m(wise)j(equiv)-5 b(alence,)32 +b(lik)m(e)g Fp(~\(x)d(^)h(y\))g Fr(in)g(C.)-30 1686 y +Fp(cl_I)f(lognand)g(\(const)f(cl_I&)h(x,)h(const)f(cl_I&)g(y\))450 +1796 y Fr(Bit)m(wise)j(not)f(and,)f(lik)m(e)h Fp(~\(x)f(&)g(y\))g +Fr(in)g(C.)-30 1951 y Fp(cl_I)f(lognor)g(\(const)g(cl_I&)f(x,)i(const)f +(cl_I&)g(y\))450 2060 y Fr(Bit)m(wise)j(not)f(or,)f(lik)m(e)i +Fp(~\(x)d(|)h(y\))g Fr(in)g(C.)-30 2216 y Fp(cl_I)f(logandc1)f(\(const) +h(cl_I&)g(x,)h(const)f(cl_I&)g(y\))450 2325 y Fr(Logical)j(and,)e (complemen)m(ting)g(the)h(\014rst)e(argumen)m(t,)h(lik)m(e)i -Fp(~x)e(&)g(y)g Fr(in)g(C.)0 3141 y Fp(cl_I)f(logandc2)f(\(const)h -(cl_I&)g(x,)h(const)f(cl_I&)g(y\))480 3266 y Fr(Logical)j(and,)e +Fp(~x)e(&)g(y)g Fr(in)g(C.)-30 2480 y Fp(cl_I)f(logandc2)f(\(const)h +(cl_I&)g(x,)h(const)f(cl_I&)g(y\))450 2590 y Fr(Logical)j(and,)e (complemen)m(ting)g(the)h(second)f(argumen)m(t,)g(lik)m(e)i -Fp(x)e(&)g(~y)g Fr(in)g(C.)0 3426 y Fp(cl_I)f(logorc1)g(\(const)f -(cl_I&)h(x,)h(const)f(cl_I&)g(y\))480 3550 y Fr(Logical)j(or,)f +Fp(x)e(&)g(~y)g Fr(in)g(C.)-30 2745 y Fp(cl_I)f(logorc1)g(\(const)f +(cl_I&)h(x,)h(const)f(cl_I&)g(y\))450 2854 y Fr(Logical)j(or,)f (complemen)m(ting)f(the)g(\014rst)g(argumen)m(t,)g(lik)m(e)i -Fp(~x)d(|)i(y)f Fr(in)g(C.)0 3710 y Fp(cl_I)f(logorc2)g(\(const)f -(cl_I&)h(x,)h(const)f(cl_I&)g(y\))480 3835 y Fr(Logical)j(or,)f +Fp(~x)d(|)i(y)f Fr(in)g(C.)-30 3009 y Fp(cl_I)f(logorc2)g(\(const)f +(cl_I&)h(x,)h(const)f(cl_I&)g(y\))450 3119 y Fr(Logical)j(or,)f (complemen)m(ting)f(the)g(second)h(argumen)m(t,)f(lik)m(e)i -Fp(x)e(|)g(~y)f Fr(in)h(C.)0 4127 y(These)g(op)s(erations)h(are)g(all)g -(a)m(v)-5 b(ailable)33 b(though)d(the)g(function)0 4418 -y Fp(cl_I)f(boole)g(\(cl_boole)f(op,)h(const)g(cl_I&)g(x,)h(const)f -(cl_I&)g(y\))0 4692 y Fr(where)i Fp(op)g Fr(m)m(ust)g(ha)m(v)m(e)i(one) -f(of)g(the)g(16)h(v)-5 b(alues)32 b(\(eac)m(h)h(one)f(stands)g(for)f(a) -i(function)e(whic)m(h)h(com)m(bines)f(t)m(w)m(o)i(bits)0 -4817 y(in)m(to)24 b(one)f(bit\):)38 b Fp(boole_clr)p -Fr(,)22 b Fp(boole_set)p Fr(,)h Fp(boole_1)p Fr(,)f Fp(boole_2)p -Fr(,)h Fp(boole_c1)p Fr(,)g Fp(boole_c2)p Fr(,)f Fp(boole_and)p -Fr(,)h Fp(boole_)0 4941 y(ior)p Fr(,)37 b Fp(boole_xor)p -Fr(,)e Fp(boole_eqv)p Fr(,)g Fp(boole_nand)p Fr(,)g Fp(boole_nor)p -Fr(,)g Fp(boole_andc1)p Fr(,)g Fp(boole_andc2)p Fr(,)f -Fp(boole_orc1)p Fr(,)0 5066 y Fp(boole_orc2)p Fr(.)0 -5340 y(Other)c(functions)g(that)h(view)f(in)m(tegers)i(as)f(bit)f -(strings:)p eop -%%Page: 28 30 -28 29 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(28)0 366 y Fp(cl_boolean)28 -b(logtest)g(\(const)h(cl_I&)g(x,)g(const)g(cl_I&)g(y\))480 -491 y Fr(Returns)g(true)i(if)f(some)g(bit)g(is)h(set)f(in)h(b)s(oth)e -Fp(x)h Fr(and)g Fp(y)p Fr(,)g(i.e.)42 b(if)30 b Fp(logand\(x,y\))d(!=)j -(0)p Fr(.)0 671 y Fp(cl_boolean)e(logbitp)g(\(const)h(cl_I&)g(n,)g -(const)g(cl_I&)g(x\))480 795 y Fr(Returns)f(true)g(if)g(the)h -Fp(n)p Fr(th)f(bit)g(\(from)g(the)g(righ)m(t\))h(of)g -Fp(x)f Fr(is)h(set.)40 b(Bit)30 b(0)e(is)h(the)g(least)g(signi\014can)m -(t)h(bit.)0 975 y Fp(uintL)f(logcount)f(\(const)h(cl_I&)g(x\))480 -1100 y Fr(Returns)d(the)i(n)m(um)m(b)s(er)c(of)k(one)f(bits)g(in)g -Fp(x)p Fr(,)h(if)f Fp(x)g(>)p Fr(=)f(0,)j(or)e(the)g(n)m(um)m(b)s(er)e -(of)i(zero)h(bits)f(in)g Fp(x)p Fr(,)h(if)f Fp(x)f(<)h -Fr(0.)0 1404 y(The)j(follo)m(wing)i(functions)e(op)s(erate)h(on)f(in)m -(terv)-5 b(als)31 b(of)g(bits)f(in)g(in)m(tegers.)42 -b(The)30 b(t)m(yp)s(e)240 1660 y Fp(struct)46 b(cl_byte)g({)h(uintL)g -(size;)f(uintL)g(position;)g(};)0 1937 y Fr(represen)m(ts)39 -b(the)g(bit)g(in)m(terv)-5 b(al)41 b(con)m(taining)f(the)f(bits)g -Fp(position)p Fn(:)15 b(:)g(:)o Fp(position+size-1)35 -b Fr(of)k(an)g(in)m(teger.)68 b(The)0 2061 y(constructor)31 +Fp(x)e(|)g(~y)f Fr(in)h(C.)-30 3274 y(These)g(op)s(erations)h(are)g +(all)g(a)m(v)-5 b(ailable)33 b(though)d(the)g(function)-30 +3429 y Fp(cl_I)f(boole)g(\(cl_boole)f(op,)h(const)g(cl_I&)g(x,)h(const) +f(cl_I&)g(y\))-30 3561 y Fr(where)35 b Fp(op)f Fr(m)m(ust)g(ha)m(v)m(e) +j(one)e(of)g(the)h(16)g(v)-5 b(alues)35 b(\(eac)m(h)i(one)e(stands)g +(for)g(a)g(function)g(whic)m(h)g(com)m(bines)g(t)m(w)m(o)h(bits)-30 +3671 y(in)m(to)31 b(one)g(bit\):)42 b Fp(boole_clr)p +Fr(,)28 b Fp(boole_set)p Fr(,)g Fp(boole_1)p Fr(,)h Fp(boole_2)p +Fr(,)f Fp(boole_c1)p Fr(,)h Fp(boole_c2)p Fr(,)f Fp(boole_and)p +Fr(,)h Fp(boole_)-30 3781 y(ior)p Fr(,)45 b Fp(boole_xor)p +Fr(,)f Fp(boole_eqv)p Fr(,)g Fp(boole_nand)p Fr(,)f Fp(boole_nor)p +Fr(,)h Fp(boole_andc1)p Fr(,)f Fp(boole_andc2)p Fr(,)g +Fp(boole_orc1)p Fr(,)-30 3890 y Fp(boole_orc2)p Fr(.)-30 +4023 y(Other)30 b(functions)g(that)h(view)f(in)m(tegers)i(as)f(bit)f +(strings:)-30 4178 y Fp(cl_boolean)e(logtest)g(\(const)h(cl_I&)g(x,)g +(const)g(cl_I&)g(y\))450 4287 y Fr(Returns)g(true)i(if)f(some)g(bit)g +(is)h(set)f(in)h(b)s(oth)e Fp(x)h Fr(and)g Fp(y)p Fr(,)g(i.e.)42 +b(if)30 b Fp(logand\(x,y\))d(!=)j(0)p Fr(.)-30 4442 y +Fp(cl_boolean)e(logbitp)g(\(const)h(cl_I&)g(n,)g(const)g(cl_I&)g(x\)) +450 4552 y Fr(Returns)g(true)i(if)f(the)h Fp(n)p Fr(th)e(bit)i(\(from)e +(the)i(righ)m(t\))g(of)f Fp(x)h Fr(is)f(set.)41 b(Bit)32 +b(0)e(is)h(the)f(least)i(signi\014can)m(t)f(bit.)-30 +4707 y Fp(uintL)e(logcount)f(\(const)h(cl_I&)g(x\))450 +4816 y Fr(Returns)g(the)h(n)m(um)m(b)s(er)d(of)j(one)h(bits)e(in)h +Fp(x)p Fr(,)g(if)f Fp(x)h(>)p Fr(=)f(0,)i(or)e(the)h(n)m(um)m(b)s(er)e +(of)i(zero)h(bits)e(in)h Fp(x)p Fr(,)g(if)f Fp(x)h(<)f +Fr(0.)-30 4972 y(The)h(follo)m(wing)i(functions)e(op)s(erate)h(on)f(in) +m(terv)-5 b(als)31 b(of)g(bits)f(in)g(in)m(tegers.)42 +b(The)30 b(t)m(yp)s(e)210 5098 y Fp(struct)46 b(cl_byte)g({)h(uintL)g +(size;)f(uintL)g(position;)g(};)-30 5230 y Fr(represen)m(ts)41 +b(the)h(bit)f(in)m(terv)-5 b(al)43 b(con)m(taining)g(the)e(bits)g +Fp(position)6 b Fr(.)20 b(.)i(.)12 b Fp(position+size-1)37 +b Fr(of)k(an)g(in)m(teger.)75 b(The)-30 5340 y(constructor)31 b Fp(cl_byte\(size,position\))24 b Fr(constructs)31 b(a)f -Fp(cl_byte)p Fr(.)0 2366 y Fp(cl_I)f(ldb)h(\(const)e(cl_I&)h(n,)h -(const)f(cl_byte&)f(b\))480 2490 y Fr(extracts)g(the)f(bits)f(of)h -Fp(n)f Fr(describ)s(ed)g(b)m(y)g(the)h(bit)g(in)m(terv)-5 -b(al)27 b Fp(b)g Fr(and)f(returns)f(them)g(as)i(a)g(nonnegativ)m(e)480 -2615 y(in)m(teger)32 b(with)e Fp(b.size)e Fr(bits.)0 -2794 y Fp(cl_boolean)g(ldb_test)g(\(const)g(cl_I&)h(n,)h(const)f -(cl_byte&)f(b\))480 2919 y Fr(Returns)h(true)i(if)f(some)g(bit)g -(describ)s(ed)f(b)m(y)i(the)f(bit)h(in)m(terv)-5 b(al)31 -b Fp(b)f Fr(is)h(set)g(in)f Fp(n)p Fr(.)0 3099 y Fp(cl_I)f(dpb)h -(\(const)e(cl_I&)h(newbyte,)f(const)h(cl_I&)g(n,)h(const)f(cl_byte&)f -(b\))480 3223 y Fr(Returns)f Fp(n)p Fr(,)h(with)f(the)h(bits)g(describ) -s(ed)e(b)m(y)i(the)f(bit)h(in)m(terv)-5 b(al)29 b Fp(b)e -Fr(replaced)h(b)m(y)g Fp(newbyte)p Fr(.)38 b(Only)27 -b(the)480 3348 y(lo)m(w)m(est)32 b Fp(b.size)d Fr(bits)h(of)h -Fp(newbyte)d Fr(are)j(relev)-5 b(an)m(t.)0 3652 y(The)28 -b(functions)h Fp(ldb)f Fr(and)g Fp(dpb)g Fr(implicitly)h(shift.)40 -b(The)29 b(follo)m(wing)h(functions)e(are)i(their)f(coun)m(terparts)g -(without)0 3777 y(shifting:)0 4081 y Fp(cl_I)g(mask_field)f(\(const)g -(cl_I&)h(n,)h(const)f(cl_byte&)f(b\))480 4206 y Fr(returns)j(an)g(in)m -(teger)j(with)d(the)h(bits)g(describ)s(ed)f(b)m(y)h(the)g(bit)g(in)m -(terv)-5 b(al)33 b Fp(b)e Fr(copied)i(from)d(the)i(corre-)480 -4330 y(sp)s(onding)d(bits)h(in)g Fp(n)p Fr(,)g(the)h(other)g(bits)f -(zero.)0 4510 y Fp(cl_I)f(deposit_field)e(\(const)i(cl_I&)g(newbyte,)f -(const)h(cl_I&)g(n,)g(const)g(cl_byte&)f(b\))480 4634 -y Fr(returns)34 b(an)h(in)m(teger)i(where)d(the)i(bits)f(describ)s(ed)f -(b)m(y)h(the)h(bit)f(in)m(terv)-5 b(al)36 b Fp(b)f Fr(come)g(from)f -Fp(newbyte)480 4759 y Fr(and)c(the)g(other)h(bits)f(come)h(from)d -Fp(n)p Fr(.)0 5063 y(The)i(follo)m(wing)i(relations)f(hold:)180 -5340 y Fp(ldb)e(\(n,)h(b\))g(=)g(mask_field\(n,)d(b\))i(>>)h -(b.position)p Fr(,)p eop -%%Page: 29 31 -29 30 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(29)180 366 y Fp(dpb)29 -b(\(newbyte,)f(n,)i(b\))g(=)g(deposit_field)d(\(newbyte)h(<<)h -(b.position,)f(n,)i(b\))p Fr(,)180 522 y Fp(deposit_field\(newbyte,n,)o -(b\))24 b(=)30 b(n)g(^)g(mask_field\(n,b\))c(^)31 b -(mask_field\(new_byte,b\))p Fr(.)0 832 y(The)36 b(follo)m(wing)i(op)s -(erations)f(on)g(in)m(tegers)h(as)f(bit)f(strings)h(are)g(e\016cien)m -(t)h(shortcuts)e(for)h(common)e(arithmetic)0 957 y(op)s(erations:)0 -1267 y Fp(cl_boolean)28 b(oddp)h(\(const)f(cl_I&)h(x\))480 -1392 y Fr(Returns)g(true)i(if)f(the)h(least)g(signi\014can)m(t)g(bit)g +Fp(cl_byte)p Fr(.)p eop +%%Page: 22 24 +22 23 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(22)-30 299 y Fp(cl_I)29 +b(ldb)h(\(const)e(cl_I&)h(n,)h(const)f(cl_byte&)f(b\))450 +408 y Fr(extracts)k(the)e(bits)g(of)h Fp(n)f Fr(describ)s(ed)f(b)m(y)h +(the)h(bit)f(in)m(terv)-5 b(al)32 b Fp(b)e Fr(and)g(returns)f(them)g +(as)i(a)f(nonnegativ)m(e)450 518 y(in)m(teger)i(with)e +Fp(b.size)e Fr(bits.)-30 670 y Fp(cl_boolean)g(ldb_test)g(\(const)g +(cl_I&)h(n,)h(const)f(cl_byte&)f(b\))450 780 y Fr(Returns)h(true)i(if)f +(some)g(bit)g(describ)s(ed)f(b)m(y)i(the)f(bit)h(in)m(terv)-5 +b(al)31 b Fp(b)f Fr(is)h(set)g(in)f Fp(n)p Fr(.)-30 932 +y Fp(cl_I)f(dpb)h(\(const)e(cl_I&)h(newbyte,)f(const)h(cl_I&)g(n,)h +(const)f(cl_byte&)f(b\))450 1041 y Fr(Returns)j Fp(n)p +Fr(,)h(with)f(the)h(bits)f(describ)s(ed)g(b)m(y)g(the)h(bit)g(in)m +(terv)-5 b(al)32 b Fp(b)g Fr(replaced)g(b)m(y)f Fp(newbyte)p +Fr(.)43 b(Only)31 b(the)450 1151 y(lo)m(w)m(est)h Fp(b.size)d +Fr(bits)h(of)h Fp(newbyte)d Fr(are)j(relev)-5 b(an)m(t.)-30 +1303 y(The)33 b(functions)f Fp(ldb)h Fr(and)f Fp(dpb)g +Fr(implicitly)i(shift.)49 b(The)32 b(follo)m(wing)j(functions)e(are)g +(their)g(coun)m(terparts)h(without)-30 1412 y(shifting:)-30 +1564 y Fp(cl_I)29 b(mask_field)f(\(const)g(cl_I&)h(n,)h(const)f +(cl_byte&)f(b\))450 1674 y Fr(returns)35 b(an)g(in)m(teger)j(with)d +(the)h(bits)g(describ)s(ed)f(b)m(y)h(the)g(bit)g(in)m(terv)-5 +b(al)37 b Fp(b)e Fr(copied)i(from)d(the)i(corre-)450 +1784 y(sp)s(onding)29 b(bits)h(in)g Fp(n)p Fr(,)g(the)h(other)g(bits)f +(zero.)-30 1936 y Fp(cl_I)f(deposit_field)e(\(const)i(cl_I&)g(newbyte,) +f(const)h(cl_I&)g(n,)g(const)g(cl_byte&)f(b\))450 2045 +y Fr(returns)e(an)h(in)m(teger)h(where)f(the)g(bits)g(describ)s(ed)f(b) +m(y)h(the)h(bit)f(in)m(terv)-5 b(al)28 b Fp(b)f Fr(come)g(from)e +Fp(newbyte)h Fr(and)450 2155 y(the)31 b(other)f(bits)g(come)h(from)e +Fp(n)p Fr(.)-30 2307 y(The)h(follo)m(wing)i(relations)f(hold:)150 +2438 y Fp(ldb)e(\(n,)h(b\))g(=)g(mask_field\(n,)d(b\))i(>>)h +(b.position)p Fr(,)150 2568 y Fp(dpb)f(\(newbyte,)f(n,)i(b\))g(=)g +(deposit_field)d(\(newbyte)h(<<)h(b.position,)f(n,)i(b\))p +Fr(,)150 2699 y Fp(deposit_field\(newbyte,n,)o(b\))24 +b(=)30 b(n)g(^)g(mask_field\(n,b\))c(^)31 b(mask_field\(new_byte,b\))p +Fr(.)-30 2851 y(The)41 b(follo)m(wing)h(op)s(erations)g(on)f(in)m +(tegers)i(as)e(bit)h(strings)f(are)g(e\016cien)m(t)i(shortcuts)e(for)g +(common)f(arithmetic)-30 2961 y(op)s(erations:)-30 3113 +y Fp(cl_boolean)28 b(oddp)h(\(const)f(cl_I&)h(x\))450 +3222 y Fr(Returns)g(true)i(if)f(the)h(least)g(signi\014can)m(t)g(bit)g (of)f Fp(x)g Fr(is)h(1.)41 b(Equiv)-5 b(alen)m(t)31 b(to)g -Fp(mod\(x,2\))d(!=)i(0)p Fr(.)0 1578 y Fp(cl_boolean)e(evenp)h(\(const) -f(cl_I&)h(x\))480 1702 y Fr(Returns)g(true)i(if)f(the)h(least)g -(signi\014can)m(t)g(bit)g(of)f Fp(x)g Fr(is)h(0.)41 b(Equiv)-5 -b(alen)m(t)31 b(to)g Fp(mod\(x,2\))d(==)i(0)p Fr(.)0 -1888 y Fp(cl_I)f(operator)f(<<)i(\(const)f(cl_I&)g(x,)g(const)g(cl_I&)g -(n\))480 2013 y Fr(Shifts)h Fp(x)g Fr(b)m(y)g Fp(n)g -Fr(bits)g(to)h(the)g(left.)41 b Fp(n)30 b Fr(should)g(b)s(e)f +Fp(mod\(x,2\))d(!=)i(0)p Fr(.)-30 3374 y Fp(cl_boolean)e(evenp)h +(\(const)f(cl_I&)h(x\))450 3484 y Fr(Returns)g(true)i(if)f(the)h(least) +g(signi\014can)m(t)g(bit)g(of)f Fp(x)g Fr(is)h(0.)41 +b(Equiv)-5 b(alen)m(t)31 b(to)g Fp(mod\(x,2\))d(==)i(0)p +Fr(.)-30 3636 y Fp(cl_I)f(operator)f(<<)i(\(const)f(cl_I&)g(x,)g(const) +g(cl_I&)g(n\))450 3746 y Fr(Shifts)h Fp(x)g Fr(b)m(y)g +Fp(n)g Fr(bits)g(to)h(the)g(left.)41 b Fp(n)30 b Fr(should)g(b)s(e)f Fp(>)p Fr(=0.)41 b(Equiv)-5 b(alen)m(t)31 b(to)g Fp(x)f(*)g -(expt\(2,n\))p Fr(.)0 2199 y Fp(cl_I)f(operator)f(>>)i(\(const)f(cl_I&) -g(x,)g(const)g(cl_I&)g(n\))480 2323 y Fr(Shifts)24 b -Fp(x)g Fr(b)m(y)g Fp(n)g Fr(bits)g(to)h(the)g(righ)m(t.)39 -b Fp(n)24 b Fr(should)f(b)s(e)h Fp(>)p Fr(=0.)39 b(Bits)25 -b(shifted)f(out)g(to)h(the)g(righ)m(t)g(are)f(thro)m(wn)480 -2448 y(a)m(w)m(a)m(y)-8 b(.)43 b(Equiv)-5 b(alen)m(t)31 -b(to)g Fp(floor\(x)e(/)h(expt\(2,n\)\))p Fr(.)0 2634 -y Fp(cl_I)f(ash)h(\(const)e(cl_I&)h(x,)h(const)f(cl_I&)g(y\))480 -2759 y Fr(Shifts)34 b Fp(x)h Fr(b)m(y)g Fp(y)f Fr(bits)h(to)h(the)f -(left)h(\(if)f Fp(y>)p Fr(=0\))g(or)g(b)m(y)g Fp(-y)f -Fr(bits)h(to)h(the)f(righ)m(t)h(\(if)f Fp(y<)p Fr(=0\).)54 -b(In)35 b(other)480 2883 y(w)m(ords,)30 b(this)g(returns)g -Fp(floor\(x)e(*)i(expt\(2,y\)\))p Fr(.)0 3069 y Fp(uintL)f -(integer_length)d(\(const)j(cl_I&)g(x\))480 3194 y Fr(Returns)40 -b(the)h(n)m(um)m(b)s(er)e(of)j(bits)f(\(excluding)g(the)h(sign)f(bit\)) -g(needed)g(to)h(represen)m(t)f Fp(x)g Fr(in)f(t)m(w)m(o's)480 -3318 y(complemen)m(t)28 b(notation.)41 b(This)27 b(is)i(the)f(smallest) -h(n)f Fp(>)p Fr(=)f(0)i(suc)m(h)f(that)h(-2)p Fp(^)p -Fr(n)f Fp(<)p Fr(=)g(x)g Fp(<)g Fr(2)p Fp(^)p Fr(n.)40 -b(If)28 b(x)g Fp(>)g Fr(0,)480 3443 y(this)i(is)h(the)f(unique)g(n)g +(expt\(2,n\))p Fr(.)-30 3898 y Fp(cl_I)f(operator)f(>>)i(\(const)f +(cl_I&)g(x,)g(const)g(cl_I&)g(n\))450 4007 y Fr(Shifts)e +Fp(x)g Fr(b)m(y)h Fp(n)f Fr(bits)h(to)g(the)g(righ)m(t.)41 +b Fp(n)27 b Fr(should)g(b)s(e)g Fp(>)p Fr(=0.)40 b(Bits)28 +b(shifted)g(out)g(to)g(the)g(righ)m(t)g(are)g(thro)m(wn)450 +4117 y(a)m(w)m(a)m(y)-8 b(.)43 b(Equiv)-5 b(alen)m(t)31 +b(to)g Fp(floor\(x)e(/)h(expt\(2,n\)\))p Fr(.)-30 4269 +y Fp(cl_I)f(ash)h(\(const)e(cl_I&)h(x,)h(const)f(cl_I&)g(y\))450 +4378 y Fr(Shifts)37 b Fp(x)g Fr(b)m(y)h Fp(y)f Fr(bits)h(to)g(the)g +(left)h(\(if)f Fp(y>)p Fr(=0\))f(or)h(b)m(y)g Fp(-y)f +Fr(bits)g(to)i(the)f(righ)m(t)g(\(if)g Fp(y<)p Fr(=0\).)63 +b(In)37 b(other)450 4488 y(w)m(ords,)30 b(this)g(returns)g +Fp(floor\(x)e(*)i(expt\(2,y\)\))p Fr(.)-30 4640 y Fp(uintL)f +(integer_length)d(\(const)j(cl_I&)g(x\))450 4750 y Fr(Returns)44 +b(the)i(n)m(um)m(b)s(er)d(of)j(bits)f(\(excluding)h(the)g(sign)f(bit\)) +h(needed)f(to)h(represen)m(t)f Fp(x)g Fr(in)g(t)m(w)m(o's)450 +4859 y(complemen)m(t)31 b(notation.)45 b(This)30 b(is)i(the)g(smallest) +f(n)g Fp(>)p Fr(=)g(0)h(suc)m(h)f(that)h(-2)p Fp(^)p +Fr(n)f Fp(<)p Fr(=)g(x)g Fp(<)g Fr(2)p Fp(^)p Fr(n.)44 +b(If)31 b(x)g Fp(>)g Fr(0,)450 4969 y(this)f(is)h(the)f(unique)g(n)g Fp(>)g Fr(0)g(suc)m(h)g(that)h(2)p Fp(^)p Fr(\(n-1\))h -Fp(<)p Fr(=)e(x)g Fp(<)g Fr(2)p Fp(^)p Fr(n.)0 3629 y -Fp(uintL)f(ord2)g(\(const)g(cl_I&)g(x\))480 3753 y(x)36 -b Fr(m)m(ust)g(b)s(e)g(non-zero.)61 b(This)36 b(function)g(returns)g -(the)h(n)m(um)m(b)s(er)d(of)j(0)g(bits)g(at)h(the)f(righ)m(t)g(of)g -Fp(x)f Fr(in)480 3878 y(t)m(w)m(o's)c(complemen)m(t)d(notation.)42 -b(This)30 b(is)g(the)h(largest)h(n)d Fp(>)p Fr(=)h(0)h(suc)m(h)f(that)h -(2)p Fp(^)p Fr(n)f(divides)g Fp(x)p Fr(.)0 4064 y Fp(uintL)f(power2p)f -(\(const)h(cl_I&)g(x\))480 4188 y(x)24 b Fr(m)m(ust)g(b)s(e)g -Fp(>)g Fr(0.)40 b(This)23 b(function)i(c)m(hec)m(ks)h(whether)e -Fp(x)g Fr(is)h(a)g(p)s(o)m(w)m(er)g(of)g(2.)39 b(If)24 -b Fp(x)g Fr(=)h(2)p Fp(^)p Fr(\(n-1\),)i(it)e(returns)480 -4313 y(n.)40 b(Else)31 b(it)g(returns)e(0.)41 b(\(See)31 -b(also)g(the)g(function)f Fp(logp)p Fr(.\))0 4780 y Fm(4.9.2)63 -b(Num)m(b)s(er)30 b(theoretic)g(functions)0 5091 y Fp(uint32)f(gcd)g -(\(uint32)g(a,)g(uint32)g(b\))0 5215 y(cl_I)g(gcd)h(\(const)e(cl_I&)h -(a,)h(const)f(cl_I&)g(b\))480 5340 y Fr(This)h(function)g(returns)f -(the)h(greatest)j(common)28 b(divisor)i(of)h Fp(a)f Fr(and)g -Fp(b)p Fr(,)g(normalized)g(to)h(b)s(e)f Fp(>)p Fr(=)f(0.)p -eop -%%Page: 30 32 -30 31 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(30)0 366 y Fp(cl_I)29 -b(xgcd)g(\(const)g(cl_I&)g(a,)h(const)f(cl_I&)g(b,)g(cl_I*)g(u,)h -(cl_I*)f(v\))480 491 y Fr(This)h(function)h(\(\\extended)g(gcd"\))h -(returns)e(the)h(greatest)h(common)d(divisor)i Fp(g)f -Fr(of)h Fp(a)g Fr(and)f Fp(b)h Fr(and)480 616 y(at)39 -b(the)f(same)g(time)g(the)g(represen)m(tation)i(of)e -Fp(g)g Fr(as)g(an)g(in)m(tegral)i(linear)f(com)m(bination)f(of)h -Fp(a)f Fr(and)480 740 y Fp(b)p Fr(:)53 b Fp(u)36 b Fr(and)g -Fp(v)g Fr(with)h Fp(u*a+v*b)28 b(=)i(g)p Fr(,)38 b Fp(g)e(>)p -Fr(=)g(0.)60 b Fp(u)36 b Fr(and)g Fp(v)h Fr(will)g(b)s(e)f(normalized)g -(to)h(b)s(e)f(of)h(smallest)480 865 y(p)s(ossible)g(absolute)h(v)-5 -b(alue,)40 b(in)e(the)f(follo)m(wing)i(sense:)55 b(If)37 -b Fp(a)h Fr(and)e Fp(b)i Fr(are)g(non-zero,)i(and)d Fp(abs\(a\))480 -989 y(!=)30 b(abs\(b\))p Fr(,)35 b Fp(u)g Fr(and)f Fp(v)h -Fr(will)h(satisfy)g(the)f(inequalities)i Fp(abs\(u\))29 -b(<=)g(abs\(b\)/\(2*g\))p Fr(,)34 b Fp(abs\(v\))29 b(<=)480 -1114 y(abs\(a\)/\(2*g\))p Fr(.)0 1275 y Fp(cl_I)g(lcm)h(\(const)e -(cl_I&)h(a,)h(const)f(cl_I&)g(b\))480 1400 y Fr(This)h(function)g -(returns)f(the)h(least)i(common)d(m)m(ultiple)h(of)g -Fp(a)g Fr(and)g Fp(b)p Fr(,)g(normalized)g(to)h(b)s(e)f -Fp(>)p Fr(=)g(0.)0 1562 y Fp(cl_boolean)e(logp)h(\(const)f(cl_I&)h(a,)h -(const)f(cl_I&)g(b,)h(cl_RA*)e(l\))0 1686 y(cl_boolean)g(logp)h -(\(const)f(cl_RA&)h(a,)h(const)f(cl_RA&)f(b,)i(cl_RA*)f(l\))480 -1811 y(a)35 b Fr(m)m(ust)g(b)s(e)g Fp(>)h Fr(0.)57 b -Fp(b)36 b Fr(m)m(ust)e(b)s(e)h Fp(>)p Fr(0)h(and)f(!=)h(1.)57 -b(If)36 b(log\(a,b\))i(is)d(rational)i(n)m(um)m(b)s(er,)f(this)f -(function)480 1935 y(returns)29 b(true)h(and)g(sets)h(*l)g(=)f -(log\(a,b\),)j(else)e(it)g(returns)e(false.)0 2325 y -Fm(4.9.3)63 b(Com)m(binatorial)29 b(functions)0 2618 -y Fp(cl_I)g(factorial)f(\(uintL)h(n\))480 2742 y(n)h -Fr(m)m(ust)f(b)s(e)h(a)h(small)f(in)m(teger)h Fp(>)p -Fr(=)f(0.)41 b(This)30 b(function)g(returns)f(the)i(factorial)h -Fp(n)p Fr(!)40 b(=)30 b Fp(1*2*)p Fn(:)15 b(:)g(:)p Fp(*n)p -Fr(.)0 2904 y Fp(cl_I)29 b(doublefactorial)d(\(uintL)j(n\))480 -3028 y(n)44 b Fr(m)m(ust)g(b)s(e)g(a)h(small)f(in)m(teger)i -Fp(>)p Fr(=)e(0.)84 b(This)43 b(function)i(returns)e(the)i -(doublefactorial)h Fp(n)p Fr(!!)83 b(=)480 3153 y Fp(1*3*)p -Fn(:)15 b(:)g(:)p Fp(*n)30 b Fr(or)g Fp(n)p Fr(!!)41 -b(=)30 b Fp(2*4*)p Fn(:)15 b(:)g(:)p Fp(*n)p Fr(,)30 -b(resp)s(ectiv)m(ely)-8 b(.)0 3315 y Fp(cl_I)29 b(binomial)f(\(uintL)h -(n,)h(uintL)f(k\))480 3439 y(n)36 b Fr(and)h Fp(k)f Fr(m)m(ust)g(b)s(e) -g(small)g(in)m(tegers)i Fp(>)p Fr(=)e(0.)60 b(This)36 -b(function)h(returns)e(the)i(binomial)f(co)s(e\016cien)m(t)480 -3494 y Fj(\000)518 3523 y Fi(n)520 3595 y(k)559 3494 -y Fj(\001)622 3564 y Fr(=)828 3528 y Fi(n)p Fh(!)p 728 -3543 261 4 v 728 3595 a Fi(n)p Fh(!\()p Fi(n)p Fg(\000)p -Fi(k)q Fh(\)!)1029 3564 y Fr(for)30 b(0)h Fp(<)p Fr(=)e(k)i -Fp(<)p Fr(=)e(n,)h(0)h(else.)0 4001 y Fs(4.10)68 b(F)-11 -b(unctions)30 b(on)g(\015oating-p)t(oin)l(t)i(n)l(um)l(b)t(ers)0 -4275 y Fr(Recall)27 b(that)g(a)f(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s -(er)d(consists)i(of)g(a)g(sign)g Fp(s)p Fr(,)g(an)g(exp)s(onen)m(t)g -Fp(e)f Fr(and)g(a)i(man)m(tissa)e Fp(m)p Fr(.)39 b(The)25 -b(v)-5 b(alue)0 4400 y(of)31 b(the)f(n)m(um)m(b)s(er)e(is)j -Fp(\(-1\)^s)d(*)i(2^e)g(*)g(m)p Fr(.)0 4674 y(Eac)m(h)h(of)g(the)f -(classes)i Fp(cl_F)p Fr(,)d Fp(cl_SF)p Fr(,)g Fp(cl_FF)p -Fr(,)g Fp(cl_DF)p Fr(,)h Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g -(op)s(erations.)0 4966 y Fk(t)m(yp)s(e)36 b Fp(scale_float)27 -b(\(const)i Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(sintL)f(delta\))0 -5091 y Fk(t)m(yp)s(e)36 b Fp(scale_float)27 b(\(const)i -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f(cl_I&)g(delta\))480 -5215 y Fr(Returns)35 b Fp(x*2^delta)p Fr(.)57 b(This)35 -b(is)h(more)g(e\016cien)m(t)i(than)e(an)g(explicit)i(m)m(ultiplication) -f(b)s(ecause)f(it)480 5340 y(copies)31 b Fp(x)f Fr(and)g(mo)s(di\014es) -f(the)h(exp)s(onen)m(t.)p eop -%%Page: 31 33 -31 32 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(31)0 366 y(The)31 b(follo)m(wing)j -(functions)d(pro)m(vide)h(an)g(abstract)h(in)m(terface)g(to)g(the)f -(underlying)f(represen)m(tation)i(of)f(\015oating-)0 -491 y(p)s(oin)m(t)e(n)m(um)m(b)s(ers.)0 792 y Fp(sintL)f -(float_exponent)d(\(const)j Fk(t)m(yp)s(e)5 b Fp(&)30 -b(x\))480 916 y Fr(Returns)g(the)h(exp)s(onen)m(t)g Fp(e)f -Fr(of)h Fp(x)p Fr(.)41 b(F)-8 b(or)32 b Fp(x)e(=)g(0.0)p -Fr(,)g(this)h(is)g(0.)42 b(F)-8 b(or)31 b Fp(x)g Fr(non-zero,)g(this)g -(is)g(the)g(unique)480 1041 y(in)m(teger)h(with)e Fp(2^\(e-1\))e(<=)i -(abs\(x\))f(<)h(2^e)p Fr(.)0 1217 y Fp(sintL)f(float_radix)e(\(const)i -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 1341 y Fr(Returns)f(the)i(base)g -(of)f(the)h(\015oating-p)s(oin)m(t)g(represen)m(tation.)42 -b(This)30 b(is)g(alw)m(a)m(ys)i Fp(2)p Fr(.)0 1518 y -Fk(t)m(yp)s(e)k Fp(float_sign)27 b(\(const)i Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 1642 y Fr(Returns)f(the)i(sign)f +Fp(<)p Fr(=)e(x)g Fp(<)g Fr(2)p Fp(^)p Fr(n.)-30 5121 +y Fp(uintL)f(ord2)g(\(const)g(cl_I&)g(x\))450 5230 y(x)e +Fr(m)m(ust)f(b)s(e)h(non-zero.)40 b(This)27 b(function)g(returns)f(the) +i(n)m(um)m(b)s(er)d(of)j(0)g(bits)f(at)h(the)g(righ)m(t)g(of)f +Fp(x)g Fr(in)g(t)m(w)m(o's)450 5340 y(complemen)m(t)j(notation.)42 +b(This)29 b(is)i(the)f(largest)i(n)e Fp(>)p Fr(=)f(0)i(suc)m(h)f(that)h +(2)p Fp(^)p Fr(n)f(divides)g Fp(x)p Fr(.)p eop +%%Page: 23 25 +23 24 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(23)-30 299 y Fp(uintL)29 +b(power2p)f(\(const)h(cl_I&)g(x\))450 408 y(x)f Fr(m)m(ust)e(b)s(e)i +Fp(>)f Fr(0.)41 b(This)27 b(function)g(c)m(hec)m(ks)j(whether)d +Fp(x)h Fr(is)g(a)g(p)s(o)m(w)m(er)g(of)g(2.)40 b(If)28 +b Fp(x)f Fr(=)h(2)p Fp(^)p Fr(\(n-1\),)i(it)e(returns)450 +518 y(n.)40 b(Else)31 b(it)g(returns)e(0.)41 b(\(See)31 +b(also)g(the)g(function)f Fp(logp)p Fr(.\))-30 736 y +Fn(4.9.2)63 b(Num)m(b)s(er)40 b(theoretic)h(functions)-30 +949 y Fp(uint32)29 b(gcd)g(\(uint32)g(a,)g(uint32)g(b\))-30 +1058 y(cl_I)g(gcd)h(\(const)e(cl_I&)h(a,)h(const)f(cl_I&)g(b\))450 +1168 y Fr(This)h(function)g(returns)f(the)h(greatest)j(common)28 +b(divisor)i(of)h Fp(a)f Fr(and)g Fp(b)p Fr(,)g(normalized)g(to)h(b)s(e) +f Fp(>)p Fr(=)f(0.)-30 1323 y Fp(cl_I)g(xgcd)g(\(const)g(cl_I&)g(a,)h +(const)f(cl_I&)g(b,)g(cl_I*)g(u,)h(cl_I*)f(v\))450 1433 +y Fr(This)34 b(function)h(\(\\extended)h(gcd"\))g(returns)e(the)h +(greatest)i(common)d(divisor)h Fp(g)f Fr(of)i Fp(a)e +Fr(and)h Fp(b)g Fr(and)450 1542 y(at)30 b(the)g(same)f(time)g(the)h +(represen)m(tation)g(of)g Fp(g)f Fr(as)h(an)g(in)m(tegral)h(linear)f +(com)m(bination)g(of)f Fp(a)g Fr(and)g Fp(b)p Fr(:)40 +b Fp(u)450 1652 y Fr(and)32 b Fp(v)g Fr(with)g Fp(u*a+v*b)d(=)h(g)p +Fr(,)j Fp(g)f(>)p Fr(=)g(0.)48 b Fp(u)32 b Fr(and)g Fp(v)g +Fr(will)h(b)s(e)f(normalized)g(to)h(b)s(e)f(of)h(smallest)f(p)s +(ossible)450 1761 y(absolute)d(v)-5 b(alue,)29 b(in)e(the)h(follo)m +(wing)h(sense:)40 b(If)27 b Fp(a)h Fr(and)f Fp(b)g Fr(are)i(non-zero,)g +(and)e Fp(abs\(a\))i(!=)g(abs\(b\))p Fr(,)e Fp(u)450 +1871 y Fr(and)j Fp(v)g Fr(will)h(satisfy)f(the)h(inequalities)h +Fp(abs\(u\))c(<=)i(abs\(b\)/\(2*g\))p Fr(,)d Fp(abs\(v\))i(<=)h +(abs\(a\)/\(2*g\))p Fr(.)-30 2026 y Fp(cl_I)f(lcm)h(\(const)e(cl_I&)h +(a,)h(const)f(cl_I&)g(b\))450 2136 y Fr(This)h(function)g(returns)f +(the)h(least)i(common)d(m)m(ultiple)h(of)g Fp(a)g Fr(and)g +Fp(b)p Fr(,)g(normalized)g(to)h(b)s(e)f Fp(>)p Fr(=)g(0.)-30 +2291 y Fp(cl_boolean)e(logp)h(\(const)f(cl_I&)h(a,)h(const)f(cl_I&)g +(b,)h(cl_RA*)e(l\))-30 2400 y(cl_boolean)g(logp)h(\(const)f(cl_RA&)h +(a,)h(const)f(cl_RA&)f(b,)i(cl_RA*)f(l\))450 2510 y(a)38 +b Fr(m)m(ust)g(b)s(e)f Fp(>)i Fr(0.)65 b Fp(b)38 b Fr(m)m(ust)f(b)s(e)h +Fp(>)p Fr(0)h(and)f(!=)g(1.)66 b(If)38 b(log\(a,b\))i(is)f(rational)g +(n)m(um)m(b)s(er,)g(this)f(function)450 2619 y(returns)29 +b(true)h(and)g(sets)h(*l)g(=)f(log\(a,b\),)j(else)e(it)g(returns)e +(false.)-30 2837 y Fn(4.9.3)63 b(Com)m(binatorial)40 +b(functions)-30 3050 y Fp(cl_I)29 b(factorial)f(\(uintL)h(n\))450 +3160 y(n)h Fr(m)m(ust)f(b)s(e)h(a)h(small)f(in)m(teger)h +Fp(>)p Fr(=)f(0.)41 b(This)30 b(function)g(returns)f(the)i(factorial)h +Fp(n)p Fr(!)40 b(=)30 b Fp(1*2*...)n(*n)p Fr(.)-30 3315 +y Fp(cl_I)f(doublefactorial)d(\(uintL)j(n\))450 3425 +y(n)48 b Fr(m)m(ust)e(b)s(e)i(a)g(small)f(in)m(teger)j +Fp(>)p Fr(=)d(0.)94 b(This)47 b(function)h(returns)e(the)i +(doublefactorial)i Fp(n)p Fr(!!)93 b(=)450 3534 y Fp(1*3*...)n(*n)30 +b Fr(or)g Fp(n)p Fr(!!)41 b(=)30 b Fp(2*4*...)n(*n)p +Fr(,)g(resp)s(ectiv)m(ely)-8 b(.)-30 3689 y Fp(cl_I)29 +b(binomial)f(\(uintL)h(n,)h(uintL)f(k\))450 3799 y(n)40 +b Fr(and)g Fp(k)g Fr(m)m(ust)g(b)s(e)f(small)h(in)m(tegers)i +Fp(>)p Fr(=)e(0.)71 b(This)40 b(function)g(returns)g(the)g(binomial)g +(co)s(e\016cien)m(t)450 3839 y Fk(\000)488 3868 y Fj(n)490 +3940 y(k)529 3839 y Fk(\001)592 3908 y Fr(=)798 3873 +y Fj(n)p Fi(!)p 698 3888 261 4 v 698 3940 a Fj(n)p Fi(!\()p +Fj(n)p Fh(\000)p Fj(k)q Fi(\)!)999 3908 y Fr(for)30 b(0)h +Fp(<)p Fr(=)e(k)i Fp(<)p Fr(=)e(n,)h(0)h(else.)-30 4159 +y Fs(4.10)68 b(F)-11 b(unctions)44 b(on)h(\015oating-p)t(oin)l(t)h(n)l +(um)l(b)t(ers)-30 4350 y Fr(Recall)31 b(that)f(a)f(\015oating-p)s(oin)m +(t)i(n)m(um)m(b)s(er)c(consists)j(of)f(a)h(sign)f Fp(s)p +Fr(,)h(an)f(exp)s(onen)m(t)g Fp(e)g Fr(and)g(a)g(man)m(tissa)h +Fp(m)p Fr(.)40 b(The)28 b(v)-5 b(alue)-30 4459 y(of)31 +b(the)f(n)m(um)m(b)s(er)e(is)j Fp(\(-1\)^s)d(*)i(2^e)g(*)g(m)p +Fr(.)-30 4592 y(Eac)m(h)h(of)g(the)f(classes)i Fp(cl_F)p +Fr(,)d Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g Fp(cl_DF)p +Fr(,)h Fp(cl_LF)e Fr(de\014nes)i(the)h(follo)m(wing)g(op)s(erations.) +-30 4747 y Fl(t)m(yp)s(e)36 b Fp(scale_float)27 b(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(sintL)f(delta\))-30 +4856 y Fl(t)m(yp)s(e)36 b Fp(scale_float)27 b(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(const)f(cl_I&)g(delta\))450 +4966 y Fr(Returns)40 b Fp(x*2^delta)p Fr(.)70 b(This)40 +b(is)h(more)f(e\016cien)m(t)j(than)d(an)h(explicit)i(m)m(ultiplication) +e(b)s(ecause)g(it)450 5075 y(copies)31 b Fp(x)f Fr(and)g(mo)s(di\014es) +f(the)h(exp)s(onen)m(t.)-30 5230 y(The)36 b(follo)m(wing)j(functions)d +(pro)m(vide)h(an)g(abstract)h(in)m(terface)g(to)g(the)f(underlying)f +(represen)m(tation)i(of)f(\015oating-)-30 5340 y(p)s(oin)m(t)30 +b(n)m(um)m(b)s(ers.)p eop +%%Page: 24 26 +24 25 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(24)-30 299 y Fp(sintL)29 +b(float_exponent)d(\(const)j Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 408 y Fr(Returns)j(the)g(exp)s(onen)m(t)h Fp(e)f +Fr(of)h Fp(x)p Fr(.)50 b(F)-8 b(or)34 b Fp(x)c(=)g(0.0)p +Fr(,)k(this)f(is)h(0.)50 b(F)-8 b(or)35 b Fp(x)e Fr(non-zero,)i(this)f +(is)f(the)h(unique)450 518 y(in)m(teger)e(with)e Fp(2^\(e-1\))e(<=)i +(abs\(x\))f(<)h(2^e)p Fr(.)-30 692 y Fp(sintL)f(float_radix)e(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 802 y Fr(Returns)f(the)i(base)g(of) +f(the)h(\015oating-p)s(oin)m(t)g(represen)m(tation.)42 +b(This)30 b(is)g(alw)m(a)m(ys)i Fp(2)p Fr(.)-30 976 y +Fl(t)m(yp)s(e)k Fp(float_sign)27 b(\(const)i Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 1086 y Fr(Returns)f(the)i(sign)f Fp(s)g Fr(of)h Fp(x)f Fr(as)h(a)f(\015oat.)42 b(The)30 b(v)-5 b(alue)31 b(is)f(1)h(for)f Fp(x)g(>)p Fr(=)g(0,)h(-1)g(for)f -Fp(x)g(<)g Fr(0.)0 1818 y Fp(uintL)f(float_digits)e(\(const)i -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 1943 y Fr(Returns)24 -b(the)h(n)m(um)m(b)s(er)e(of)i(man)m(tissa)g(bits)f(in)h(the)g -(\015oating-p)s(oin)m(t)h(represen)m(tation)g(of)f Fp(x)p -Fr(,)h(including)480 2067 y(the)31 b(hidden)e(bit.)40 -b(The)30 b(v)-5 b(alue)31 b(only)g(dep)s(ends)d(on)i(the)h(t)m(yp)s(e)f -(of)h Fp(x)p Fr(,)f(not)h(on)f(its)h(v)-5 b(alue.)0 2243 -y Fp(uintL)29 b(float_precision)d(\(const)j Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 2368 y Fr(Returns)21 b(the)h(n)m(um)m(b)s(er)d(of)j +Fp(x)g(<)g Fr(0.)-30 1260 y Fp(uintL)f(float_digits)e(\(const)i +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 1370 y Fr(Returns)f(the)h(n)m(um)m +(b)s(er)e(of)i(man)m(tissa)g(bits)g(in)g(the)g(\015oating-p)s(oin)m(t)h +(represen)m(tation)g(of)f Fp(x)p Fr(,)g(including)450 +1479 y(the)h(hidden)e(bit.)40 b(The)30 b(v)-5 b(alue)31 +b(only)g(dep)s(ends)d(on)i(the)h(t)m(yp)s(e)f(of)h Fp(x)p +Fr(,)f(not)h(on)f(its)h(v)-5 b(alue.)-30 1654 y Fp(uintL)29 +b(float_precision)d(\(const)j Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 1763 y Fr(Returns)c(the)h(n)m(um)m(b)s(er)d(of)j (signi\014can)m(t)h(man)m(tissa)f(bits)g(in)f(the)h(\015oating-p)s(oin) -m(t)h(represen)m(tation)g(of)f Fp(x)p Fr(.)480 2493 y(Since)32 -b(denormalized)f(n)m(um)m(b)s(ers)e(are)j(not)f(supp)s(orted,)g(this)g -(is)h(the)f(same)g(as)h Fp(float_digits\(x\))480 2617 -y Fr(if)e Fp(x)g Fr(is)h(non-zero,)g(and)f(0)g(if)h Fp(x)f -Fr(=)g(0.)0 2918 y(The)h(complete)h(in)m(ternal)h(represen)m(tation)g -(of)f(a)g(\015oat)g(is)g(enco)s(ded)f(in)h(the)g(t)m(yp)s(e)f -Fp(cl_decoded_float)d Fr(\(or)k Fp(cl_)0 3042 y(decoded_sfloat)p -Fr(,)39 b Fp(cl_decoded_ffloat)p Fr(,)f Fp(cl_decoded_dfloat)p -Fr(,)h Fp(cl_decoded_lfloat)p Fr(,)f(resp)s(ectiv)m(ely\),)0 -3167 y(de\014ned)29 b(b)m(y)240 3421 y Fp(struct)46 b(cl_decoded_)p -Fk(t)m(yp)s(e)5 b Fp(float)44 b({)622 3525 y Fk(t)m(yp)s(e)53 -b Fp(mantissa;)45 b(cl_I)i(exponent;)e Fk(t)m(yp)s(e)53 -b Fp(sign;)240 3628 y(};)0 3903 y Fr(and)30 b(returned)f(b)m(y)h(the)h -(function)0 4204 y Fp(cl_decoded_)p Fk(t)m(yp)s(e)5 b -Fp(float)26 b(decode_float)h(\(const)i Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x\))480 4329 y Fr(F)-8 b(or)38 b Fp(x)f Fr(non-zero,)j -(this)d(returns)f Fp(\(-1\)^s)p Fr(,)h Fp(e)p Fr(,)i -Fp(m)e Fr(with)g Fp(x)30 b(=)g(\(-1\)^s)f(*)h(2^e)f(*)h(m)37 -b Fr(and)g Fp(0.5)29 b(<=)h(m)g(<)480 4453 y(1.0)p Fr(.)63 -b(F)-8 b(or)39 b Fp(x)f Fr(=)g(0,)i(it)f(returns)e Fp(\(-1\)^s)p -Fr(=1,)i Fp(e)p Fr(=0,)h Fp(m)p Fr(=0.)64 b Fp(e)37 b -Fr(is)i(the)f(same)f(as)i(returned)e(b)m(y)h(the)480 -4578 y(function)30 b Fp(float_exponent)p Fr(.)0 4878 -y(A)g(complete)h(deco)s(ding)g(in)f(terms)f(of)i(in)m(tegers)g(is)g -(pro)m(vided)f(as)g(t)m(yp)s(e)240 5132 y Fp(struct)46 -b(cl_idecoded_float)d({)622 5236 y(cl_I)j(mantissa;)g(cl_I)g(exponent;) -g(cl_I)g(sign;)240 5340 y(};)p eop -%%Page: 32 34 -32 33 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(32)0 366 y(b)m(y)30 b(the)h(follo)m -(wing)h(function:)0 670 y Fp(cl_idecoded_float)26 b -(integer_decode_float)e(\(const)29 b Fk(t)m(yp)s(e)5 -b Fp(&)31 b(x\))480 794 y Fr(F)-8 b(or)33 b Fp(x)g Fr(non-zero,)h(this) -e(returns)g Fp(\(-1\)^s)p Fr(,)f Fp(e)p Fr(,)j Fp(m)e -Fr(with)g Fp(x)e(=)g(\(-1\)^s)f(*)h(2^e)f(*)h(m)j Fr(and)f -Fp(m)g Fr(an)h(in)m(teger)480 919 y(with)e Fp(float_digits\(x\))c -Fr(bits.)43 b(F)-8 b(or)32 b Fp(x)f Fr(=)g(0,)h(it)g(returns)e -Fp(\(-1\)^s)p Fr(=1,)g Fp(e)p Fr(=0,)i Fp(m)p Fr(=0.)43 -b(W)-10 b(ARNING:)480 1043 y(The)35 b(exp)s(onen)m(t)h -Fp(e)f Fr(is)h(not)g(the)g(same)f(as)h(the)g(one)g(returned)f(b)m(y)g -(the)h(functions)f Fp(decode_float)480 1168 y Fr(and)30 -b Fp(float_exponent)p Fr(.)0 1471 y(Some)f(other)i(function,)f -(implemen)m(ted)f(only)i(for)f(class)h Fp(cl_F)p Fr(:)0 -1774 y Fp(cl_F)e(float_sign)f(\(const)g(cl_F&)h(x,)h(const)f(cl_F&)g -(y\))480 1899 y Fr(This)34 b(returns)g(a)i(\015oating)g(p)s(oin)m(t)f -(n)m(um)m(b)s(er)e(whose)i(precision)h(and)e(absolute)i(v)-5 -b(alue)36 b(is)f(that)h(of)f Fp(y)480 2023 y Fr(and)30 -b(whose)g(sign)g(is)h(that)g(of)f Fp(x)p Fr(.)41 b(If)30 -b Fp(x)g Fr(is)g(zero,)h(it)g(is)g(treated)g(as)g(p)s(ositiv)m(e.)41 -b(Same)30 b(for)g Fp(y)p Fr(.)0 2491 y Fs(4.11)68 b(Con)l(v)l(ersion)32 -b(functions)0 2925 y Fm(4.11.1)63 b(Con)m(v)m(ersion)31 -b(to)f(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers)0 3201 -y Fr(The)f(t)m(yp)s(e)g Fp(cl_float_format_t)c Fr(describ)s(es)k(a)g -(\015oating-p)s(oin)m(t)i(format.)0 3505 y Fp(cl_float_format_t)26 -b(cl_float_format)g(\(uintL)j(n\))480 3629 y Fr(Returns)40 -b(the)h(smallest)g(\015oat)h(format)e(whic)m(h)h(guaran)m(tees)h(at)g -(least)g Fp(n)f Fr(decimal)g(digits)g(in)g(the)480 3754 -y(man)m(tissa)30 b(\(after)i(the)e(decimal)g(p)s(oin)m(t\).)0 -3932 y Fp(cl_float_format_t)c(cl_float_format)g(\(const)j(cl_F&)f(x\)) -480 4057 y Fr(Returns)h(the)i(\015oating)g(p)s(oin)m(t)g(format)e(of)i -Fp(x)p Fr(.)0 4236 y Fp(cl_float_format_t)26 b(cl_default_float_format) -480 4360 y Fr(Global)41 b(v)-5 b(ariable:)60 b(the)40 -b(default)g(\015oat)g(format)f(used)g(when)g(con)m(v)m(erting)i -(rational)g(n)m(um)m(b)s(ers)c(to)480 4485 y(\015oats.)0 -4788 y(T)-8 b(o)37 b(con)m(v)m(ert)i(a)f(real)f(n)m(um)m(b)s(er)e(to)j -(a)f(\015oat,)j(eac)m(h)e(of)f(the)g(t)m(yp)s(es)g Fp(cl_R)p -Fr(,)h Fp(cl_F)p Fr(,)g Fp(cl_I)p Fr(,)g Fp(cl_RA)p Fr(,)f -Fp(int)p Fr(,)h Fp(unsigned)0 4912 y(int)p Fr(,)30 b -Fp(float)p Fr(,)f Fp(double)g Fr(de\014nes)g(the)i(follo)m(wing)g(op)s -(erations:)0 5215 y Fp(cl_F)e(cl_float)f(\(const)h Fk(t)m(yp)s(e)5 -b Fp(&x,)30 b(cl_float_format_t)25 b(f\))480 5340 y Fr(Returns)k -Fp(x)h Fr(as)h(a)g(\015oat)g(of)f(format)g Fp(f)p Fr(.)p -eop -%%Page: 33 35 -33 34 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(33)0 366 y Fp(cl_F)29 -b(cl_float)f(\(const)h Fk(t)m(yp)s(e)5 b Fp(&x,)30 b(const)f(cl_F&)g -(y\))480 491 y Fr(Returns)g Fp(x)h Fr(in)h(the)f(\015oat)h(format)f(of) -g Fp(y)p Fr(.)0 667 y Fp(cl_F)f(cl_float)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&x\))480 792 y Fr(Returns)30 b Fp(x)g -Fr(as)h(a)g(\015oat)h(of)f(format)f Fp(cl_default_float_format)24 -b Fr(if)31 b(it)g(is)g(an)g(exact)h(n)m(um)m(b)s(er,)d(or)480 -916 y Fp(x)h Fr(itself)h(if)g(it)f(is)h(already)g(a)g(\015oat.)0 -1217 y(Of)f(course,)h(con)m(v)m(erting)h(a)f(n)m(um)m(b)s(er)d(to)j(a)f -(\015oat)i(can)e(lose)h(precision.)0 1491 y(Ev)m(ery)g(\015oating-p)s -(oin)m(t)g(format)f(has)g(some)g(c)m(haracteristic)j(n)m(um)m(b)s(ers:) -0 1792 y Fp(cl_F)c(most_positive_float)c(\(cl_float_format_t)h(f\))480 -1916 y Fr(Returns)j(the)i(largest)h(\(most)e(p)s(ositiv)m(e\))i +m(t)h(represen)m(tation)g(of)f Fp(x)p Fr(.)450 1873 y(Since)j +(denormalized)e(n)m(um)m(b)s(ers)g(are)h(not)h(supp)s(orted,)e(this)i +(is)f(the)h(same)f(as)h Fp(float_digits\(x\))25 b Fr(if)450 +1983 y Fp(x)30 b Fr(is)g(non-zero,)i(and)d(0)i(if)f Fp(x)h +Fr(=)f(0.)-30 2164 y(The)63 b(complete)h(in)m(ternal)h(represen)m +(tation)f(of)g(a)g(\015oat)g(is)g(enco)s(ded)f(in)h(the)g(t)m(yp)s(e)f +Fp(cl_decoded_float)-30 2274 y Fr(\(or)110 b Fp(cl_decoded_sfloat)p +Fr(,)125 b Fp(cl_decoded_ffloat)p Fr(,)g Fp(cl_decoded_dfloat)p +Fr(,)f Fp(cl_decoded_lfloat)p Fr(,)-30 2383 y(resp)s(ectiv)m(ely\),)32 +b(de\014ned)d(b)m(y)210 2527 y Fp(struct)46 b(cl_decoded_)p +Fl(t)m(yp)s(e)5 b Fp(float)44 b({)592 2631 y Fl(t)m(yp)s(e)53 +b Fp(mantissa;)45 b(cl_I)i(exponent;)e Fl(t)m(yp)s(e)53 +b Fp(sign;)210 2735 y(};)-30 2884 y Fr(and)30 b(returned)f(b)m(y)h(the) +h(function)-30 3066 y Fp(cl_decoded_)p Fl(t)m(yp)s(e)5 +b Fp(float)26 b(decode_float)h(\(const)i Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x\))450 3175 y Fr(F)-8 b(or)26 b Fp(x)e Fr(non-zero,)j +(this)d(returns)g Fp(\(-1\)^s)p Fr(,)h Fp(e)p Fr(,)g +Fp(m)g Fr(with)f Fp(x)30 b(=)g(\(-1\)^s)f(*)h(2^e)g(*)g(m)24 +b Fr(and)g Fp(0.5)30 b(<=)g(m)g(<)g(1.0)p Fr(.)450 3285 +y(F)-8 b(or)35 b Fp(x)f Fr(=)h(0,)h(it)f(returns)e Fp(\(-1\)^s)p +Fr(=1,)h Fp(e)p Fr(=0,)i Fp(m)p Fr(=0.)53 b Fp(e)34 b +Fr(is)g(the)h(same)f(as)h(returned)e(b)m(y)i(the)f(function)450 +3395 y Fp(float_exponent)p Fr(.)-30 3576 y(A)c(complete)h(deco)s(ding)g +(in)f(terms)f(of)i(in)m(tegers)g(is)g(pro)m(vided)f(as)g(t)m(yp)s(e)210 +3760 y Fp(struct)46 b(cl_idecoded_float)d({)592 3864 +y(cl_I)j(mantissa;)g(cl_I)g(exponent;)g(cl_I)g(sign;)210 +3967 y(};)-30 4117 y Fr(b)m(y)30 b(the)h(follo)m(wing)h(function:)-30 +4299 y Fp(cl_idecoded_float)26 b(integer_decode_float)e(\(const)29 +b Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))450 4408 y Fr(F)-8 +b(or)38 b Fp(x)e Fr(non-zero,)k(this)d(returns)f Fp(\(-1\)^s)p +Fr(,)h Fp(e)p Fr(,)h Fp(m)f Fr(with)g Fp(x)30 b(=)g(\(-1\)^s)e(*)i(2^e) +g(*)g(m)37 b Fr(and)f Fp(m)h Fr(an)g(in)m(teger)450 4518 +y(with)e Fp(float_digits\(x\))30 b Fr(bits.)54 b(F)-8 +b(or)36 b Fp(x)e Fr(=)h(0,)h(it)g(returns)d Fp(\(-1\)^s)p +Fr(=1,)i Fp(e)p Fr(=0,)h Fp(m)p Fr(=0.)54 b(W)-10 b(ARNING:)450 +4627 y(The)27 b(exp)s(onen)m(t)h Fp(e)f Fr(is)h(not)f(the)h(same)f(as)h +(the)g(one)g(returned)e(b)m(y)h(the)h(functions)f Fp(decode_float)e +Fr(and)450 4737 y Fp(float_exponent)p Fr(.)-30 4919 y(Some)k(other)i +(function,)f(implemen)m(ted)f(only)i(for)f(class)h Fp(cl_F)p +Fr(:)-30 5101 y Fp(cl_F)e(float_sign)f(\(const)g(cl_F&)h(x,)h(const)f +(cl_F&)g(y\))450 5210 y Fr(This)d(returns)g(a)i(\015oating)g(p)s(oin)m +(t)f(n)m(um)m(b)s(er)e(whose)h(precision)i(and)e(absolute)i(v)-5 +b(alue)28 b(is)f(that)h(of)f Fp(y)g Fr(and)450 5320 y(whose)j(sign)h +(is)f(that)h(of)f Fp(x)p Fr(.)41 b(If)30 b Fp(x)g Fr(is)g(zero,)i(it)f +(is)f(treated)h(as)g(p)s(ositiv)m(e.)42 b(Same)29 b(for)h +Fp(y)p Fr(.)p eop +%%Page: 25 27 +25 26 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(25)-30 299 y Fs(4.11)68 +b(Con)l(v)l(ersion)46 b(functions)-30 612 y Fn(4.11.1)63 +b(Con)m(v)m(ersion)41 b(to)g(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers) +-30 821 y Fr(The)30 b(t)m(yp)s(e)g Fp(cl_float_format_t)c +Fr(describ)s(es)k(a)g(\015oating-p)s(oin)m(t)i(format.)-30 +1003 y Fp(cl_float_format_t)26 b(cl_float_format)g(\(uintL)j(n\))450 +1113 y Fr(Returns)45 b(the)g(smallest)h(\015oat)g(format)f(whic)m(h)h +(guaran)m(tees)g(at)h(least)g Fp(n)e Fr(decimal)g(digits)h(in)g(the)450 +1222 y(man)m(tissa)30 b(\(after)i(the)e(decimal)g(p)s(oin)m(t\).)-30 +1397 y Fp(cl_float_format_t)c(cl_float_format)g(\(const)j(cl_F&)f(x\)) +450 1507 y Fr(Returns)h(the)i(\015oating)g(p)s(oin)m(t)g(format)e(of)i +Fp(x)p Fr(.)-30 1682 y Fp(cl_float_format_t)26 b +(cl_default_float_format)450 1792 y Fr(Global)d(v)-5 +b(ariable:)37 b(the)23 b(default)f(\015oat)g(format)g(used)f(when)g +(con)m(v)m(erting)j(rational)f(n)m(um)m(b)s(ers)c(to)k(\015oats.)-30 +1974 y(T)-8 b(o)30 b(con)m(v)m(ert)h(a)f(real)g(n)m(um)m(b)s(er)d(to)j +(a)g(\015oat,)g(eac)m(h)h(of)e(the)h(t)m(yp)s(es)f Fp(cl_R)p +Fr(,)g Fp(cl_F)p Fr(,)f Fp(cl_I)p Fr(,)h Fp(cl_RA)p Fr(,)g +Fp(int)p Fr(,)f Fp(unsigned)h(int)p Fr(,)-30 2084 y Fp(float)p +Fr(,)g Fp(double)g Fr(de\014nes)g(the)i(follo)m(wing)h(op)s(erations:) +-30 2267 y Fp(cl_F)d(cl_float)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&x,)30 b(cl_float_format_t)25 b(f\))450 2376 y Fr(Returns)k +Fp(x)h Fr(as)h(a)g(\015oat)g(of)f(format)g Fp(f)p Fr(.)-30 +2551 y Fp(cl_F)f(cl_float)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&x,)30 b(const)f(cl_F&)g(y\))450 2661 y Fr(Returns)g +Fp(x)h Fr(in)h(the)f(\015oat)h(format)f(of)g Fp(y)p Fr(.)-30 +2836 y Fp(cl_F)f(cl_float)f(\(const)h Fl(t)m(yp)s(e)5 +b Fp(&x\))450 2945 y Fr(Returns)29 b Fp(x)g Fr(as)h(a)g(\015oat)g(of)f +(format)g Fp(cl_default_float_format)23 b Fr(if)30 b(it)g(is)g(an)f +(exact)i(n)m(um)m(b)s(er,)d(or)h Fp(x)450 3055 y Fr(itself)i(if)g(it)f +(is)h(already)g(a)g(\015oat.)-30 3238 y(Of)f(course,)h(con)m(v)m +(erting)h(a)f(n)m(um)m(b)s(er)d(to)j(a)f(\015oat)i(can)e(lose)h +(precision.)-30 3388 y(Ev)m(ery)g(\015oating-p)s(oin)m(t)g(format)f +(has)g(some)g(c)m(haracteristic)j(n)m(um)m(b)s(ers:)-30 +3571 y Fp(cl_F)c(most_positive_float)c(\(cl_float_format_t)h(f\))450 +3680 y Fr(Returns)j(the)i(largest)h(\(most)e(p)s(ositiv)m(e\))i (\015oating)f(p)s(oin)m(t)f(n)m(um)m(b)s(er)e(in)i(\015oat)h(format)f -Fp(f)p Fr(.)0 2092 y Fp(cl_F)f(most_negative_float)c -(\(cl_float_format_t)h(f\))480 2217 y Fr(Returns)j(the)i(smallest)g +Fp(f)p Fr(.)-30 3855 y Fp(cl_F)f(most_negative_float)c +(\(cl_float_format_t)h(f\))450 3965 y Fr(Returns)j(the)i(smallest)g (\(most)f(negativ)m(e\))j(\015oating)e(p)s(oin)m(t)f(n)m(um)m(b)s(er)e -(in)i(\015oat)h(format)f Fp(f)p Fr(.)0 2393 y Fp(cl_F)f -(least_positive_float)c(\(cl_float_format_t)g(f\))480 -2517 y Fr(Returns)39 b(the)i(least)g(p)s(ositiv)m(e)g(\015oating)g(p)s -(oin)m(t)f(n)m(um)m(b)s(er)e(\(i.e.)71 b Fp(>)40 b Fr(0)h(but)e -(closest)j(to)f(0\))f(in)g(\015oat)480 2642 y(format)30 -b Fp(f)p Fr(.)0 2818 y Fp(cl_F)f(least_negative_float)c -(\(cl_float_format_t)g(f\))480 2943 y Fr(Returns)38 b(the)h(least)h -(negativ)m(e)h(\015oating)f(p)s(oin)m(t)f(n)m(um)m(b)s(er)d(\(i.e.)67 -b Fp(<)39 b Fr(0)g(but)f(closest)j(to)e(0\))h(in)e(\015oat)480 -3067 y(format)30 b Fp(f)p Fr(.)0 3243 y Fp(cl_F)f(float_epsilon)e -(\(cl_float_format_t)e(f\))480 3368 y Fr(Returns)k(the)i(smallest)g +(in)i(\015oat)h(format)f Fp(f)p Fr(.)-30 4140 y Fp(cl_F)f +(least_positive_float)c(\(cl_float_format_t)g(f\))450 +4249 y Fr(Returns)g(the)h(least)h(p)s(ositiv)m(e)g(\015oating)g(p)s +(oin)m(t)e(n)m(um)m(b)s(er)f(\(i.e.)40 b Fp(>)26 b Fr(0)g(but)f +(closest)i(to)g(0\))g(in)e(\015oat)i(format)450 4359 +y Fp(f)p Fr(.)-30 4534 y Fp(cl_F)i(least_negative_float)c +(\(cl_float_format_t)g(f\))450 4644 y Fr(Returns)e(the)i(least)h +(negativ)m(e)g(\015oating)g(p)s(oin)m(t)e(n)m(um)m(b)s(er)e(\(i.e.)40 +b Fp(<)24 b Fr(0)h(but)e(closest)j(to)f(0\))g(in)g(\015oat)g(format)450 +4753 y Fp(f)p Fr(.)-30 4928 y Fp(cl_F)k(float_epsilon)e +(\(cl_float_format_t)e(f\))450 5038 y Fr(Returns)k(the)i(smallest)g (\015oating)g(p)s(oin)m(t)f(n)m(um)m(b)s(er)e(e)j Fp(>)f -Fr(0)h(suc)m(h)f(that)h Fp(1+e)e(!=)h(1)p Fr(.)0 3544 -y Fp(cl_F)f(float_negative_epsilon)c(\(cl_float_format_t)g(f\))480 -3668 y Fr(Returns)k(the)i(smallest)g(\015oating)g(p)s(oin)m(t)f(n)m(um) +Fr(0)h(suc)m(h)f(that)h Fp(1+e)e(!=)h(1)p Fr(.)-30 5213 +y Fp(cl_F)f(float_negative_epsilon)24 b(\(cl_float_format_t)i(f\))450 +5322 y Fr(Returns)j(the)i(smallest)g(\015oating)g(p)s(oin)m(t)f(n)m(um) m(b)s(er)e(e)j Fp(>)f Fr(0)h(suc)m(h)f(that)h Fp(1-e)e(!=)h(1)p -Fr(.)0 4091 y Fm(4.11.2)63 b(Con)m(v)m(ersion)31 b(to)f(rational)g(n)m -(um)m(b)s(ers)0 4365 y Fr(Eac)m(h)h(of)g(the)f(classes)i -Fp(cl_R)p Fr(,)d Fp(cl_RA)p Fr(,)g Fp(cl_F)g Fr(de\014nes)h(the)g -(follo)m(wing)i(op)s(eration:)0 4666 y Fp(cl_RA)d(rational)f(\(const)h -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 4790 y Fr(Returns)g(the)h(v)-5 -b(alue)32 b(of)f Fp(x)f Fr(as)i(an)e(exact)j(n)m(um)m(b)s(er.)40 -b(If)31 b Fp(x)f Fr(is)h(already)h(an)f(exact)h(n)m(um)m(b)s(er,)d -(this)i(is)g Fp(x)p Fr(.)480 4915 y(If)f Fp(x)g Fr(is)g(a)h -(\015oating-p)s(oin)m(t)g(n)m(um)m(b)s(er,)d(the)j(v)-5 -b(alue)30 b(is)h(a)f(rational)i(n)m(um)m(b)s(er)c(whose)i(denominator)f -(is)i(a)480 5039 y(p)s(o)m(w)m(er)f(of)h(2.)0 5340 y(In)f(order)g(to)h -(con)m(v)m(ert)h(bac)m(k,)f(sa)m(y)-8 b(,)32 b Fp -(\(cl_F\)\(cl_R\)"1/3")25 b Fr(to)31 b Fp(1/3)p Fr(,)f(there)h(is)f -(the)h(function)p eop -%%Page: 34 36 -34 35 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(34)0 366 y Fp(cl_RA)29 -b(rationalize)e(\(const)i(cl_R&)g(x\))480 491 y Fr(If)i -Fp(x)h Fr(is)g(a)g(\015oating-p)s(oin)m(t)i(n)m(um)m(b)s(er,)c(it)i -(actually)i(represen)m(ts)e(an)g(in)m(terv)-5 b(al)33 -b(of)f(real)g(n)m(um)m(b)s(ers,)f(and)480 616 y(this)43 -b(function)g(returns)f(the)h(rational)i(n)m(um)m(b)s(er)40 -b(with)j(smallest)h(denominator)e(\(and)h(smallest)480 -740 y(n)m(umerator,)31 b(in)h(magnitude\))f(whic)m(h)h(lies)g(in)g -(this)g(in)m(terv)-5 b(al.)46 b(If)31 b Fp(x)h Fr(is)g(already)g(an)g -(exact)h(n)m(um)m(b)s(er,)480 865 y(this)d(function)g(returns)f -Fp(x)p Fr(.)0 1185 y(If)h Fp(x)g Fr(is)g(an)m(y)h(\015oat,)g(one)g(has) -180 1470 y Fp(cl_float\(rational\(x\),x\))24 b(=)30 b(x)180 -1630 y(cl_float\(rationalize\(x\),)o(x\))24 b(=)30 b(x)0 -2175 y Fs(4.12)68 b(Random)31 b(n)l(um)l(b)t(er)f(generators)0 -2460 y Fr(A)c(random)f(generator)j(is)e(a)h(mac)m(hine)f(whic)m(h)g -(pro)s(duces)f(\(pseudo-\)random)g(n)m(um)m(b)s(ers.)37 -b(The)26 b(include)g(\014le)g Fp()34 -b Fr(de\014nes)i(a)i(class)f Fp(cl_random_state)c Fr(whic)m(h)j(con)m -(tains)i(the)g(state)g(of)f(a)g(random)e(generator.)61 -b(If)0 2709 y(y)m(ou)31 b(mak)m(e)g(a)g(cop)m(y)h(of)f(the)g(random)e -(n)m(um)m(b)s(er)f(generator,)k(the)f(original)h(one)f(and)f(the)h(cop) -m(y)h(will)f(pro)s(duce)f(the)0 2834 y(same)g(sequence)h(of)f(random)f -(n)m(um)m(b)s(ers.)0 3118 y(The)e(follo)m(wing)i(functions)e(return)f -(\(pseudo-\)random)g(n)m(um)m(b)s(ers)f(in)i(di\013eren)m(t)h(formats.) -39 b(Calling)28 b(one)g(of)f(these)0 3243 y(mo)s(di\014es)i(the)h -(state)i(of)e(the)h(random)e(n)m(um)m(b)s(er)f(generator)j(in)f(a)h -(complicated)g(but)f(deterministic)g(w)m(a)m(y)-8 b(.)0 -3528 y(The)30 b(global)i(v)-5 b(ariable)240 3792 y Fp(cl_random_state) -44 b(cl_default_random_state)0 4076 y Fr(con)m(tains)25 -b(a)e(default)h(random)d(n)m(um)m(b)s(er)g(generator.)40 -b(It)23 b(is)h(used)e(when)h(the)g(functions)g(b)s(elo)m(w)h(are)f -(called)i(without)0 4201 y Fp(cl_random_state)h Fr(argumen)m(t.)0 -4521 y Fp(uint32)j(random32)f(\(cl_random_state&)d(randomstate\))0 -4646 y(uint32)k(random32)f(\(\))480 4770 y Fr(Returns)h(a)i(random)e -(unsigned)g(32-bit)j(n)m(um)m(b)s(er.)38 b(All)31 b(bits)f(are)h -(equally)g(random.)0 4966 y Fp(cl_I)e(random_I)f(\(cl_random_state&)e -(randomstate,)h(const)i(cl_I&)g(n\))0 5091 y(cl_I)g(random_I)f(\(const) -h(cl_I&)g(n\))480 5215 y(n)i Fr(m)m(ust)g(b)s(e)g(an)h(in)m(teger)h -Fp(>)f Fr(0.)45 b(This)31 b(function)g(returns)g(a)h(random)e(in)m -(teger)j Fp(x)f Fr(in)f(the)h(range)h Fp(0)d(<=)480 5340 -y(x)g(<)g(n)p Fr(.)p eop -%%Page: 35 37 -35 36 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(35)0 366 y Fp(cl_F)29 -b(random_F)f(\(cl_random_state&)e(randomstate,)h(const)i(cl_F&)g(n\))0 -491 y(cl_F)g(random_F)f(\(const)h(cl_F&)g(n\))480 616 -y(n)36 b Fr(m)m(ust)g(b)s(e)g(a)h(\015oat)g Fp(>)g Fr(0.)60 -b(This)36 b(function)g(returns)g(a)h(random)e(\015oating-p)s(oin)m(t)j -(n)m(um)m(b)s(er)c(of)j(the)480 740 y(same)30 b(format)f(as)i -Fp(n)f Fr(in)g(the)h(range)f Fp(0)h(<=)e(x)h(<)g(n)p -Fr(.)0 932 y Fp(cl_R)f(random_R)f(\(cl_random_state&)e(randomstate,)h -(const)i(cl_R&)g(n\))0 1057 y(cl_R)g(random_R)f(\(const)h(cl_R&)g(n\)) -480 1181 y Fr(Beha)m(v)m(es)j(lik)m(e)g Fp(random_I)c -Fr(if)i Fp(n)g Fr(is)h(an)f(in)m(teger)i(and)e(lik)m(e)h -Fp(random_F)d Fr(if)j Fp(n)f Fr(is)g(a)h(\015oat.)0 1709 -y Fs(4.13)68 b(Obfuscating)31 b(op)t(erators)0 1991 y -Fr(The)i(mo)s(difying)f(C/C)p Fp(++)h Fr(op)s(erators)h -Fp(+=)p Fr(,)g Fp(-=)p Fr(,)g Fp(*=)p Fr(,)h Fp(/=)p -Fr(,)f Fp(&=)p Fr(,)g Fp(|=)p Fr(,)g Fp(^=)p Fr(,)g Fp(<<=)p -Fr(,)g Fp(>>=)f Fr(are)h(not)g(a)m(v)-5 b(ailable)36 -b(b)m(y)e(default)0 2116 y(b)s(ecause)41 b(their)g(use)g(tends)g(to)g -(mak)m(e)g(programs)f(unreadable.)72 b(It)41 b(is)h(trivial)g(to)g(get) -g(a)m(w)m(a)m(y)h(without)e(them.)0 2240 y(Ho)m(w)m(ev)m(er,)33 -b(if)d(y)m(ou)h(feel)g(that)g(y)m(ou)g(absolutely)g(need)f(these)h(op)s -(erators)f(to)h(get)h(happ)m(y)-8 b(,)30 b(then)g(add)240 -2502 y Fp(#define)46 b(WANT_OBFUSCATING_OPERATO)o(RS)0 -2785 y Fr(to)34 b(the)g(b)s(eginning)f(of)h(y)m(our)f(source)h -(\014les,)h(b)s(efore)e(the)h(inclusion)f(of)h(an)m(y)g(CLN)f(include)g -(\014les.)51 b(This)33 b(\015ag)h(will)0 2910 y(enable)d(the)f(follo)m -(wing)i(op)s(erators:)0 3192 y(F)-8 b(or)31 b(the)g(classes)g -Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)f Fp(cl_RA)p Fr(,)g Fp(cl_F)p -Fr(,)h Fp(cl_SF)p Fr(,)f Fp(cl_FF)p Fr(,)g Fp(cl_DF)p -Fr(,)g Fp(cl_LF)p Fr(:)0 3509 y Fk(t)m(yp)s(e)5 b Fp(&)30 -b(operator)e(+=)i(\()p Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f -Fk(t)m(yp)s(e)5 b Fp(&\))0 3633 y Fk(t)m(yp)s(e)g Fp(&)30 -b(operator)e(-=)i(\()p Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f -Fk(t)m(yp)s(e)5 b Fp(&\))0 3758 y Fk(t)m(yp)s(e)g Fp(&)30 -b(operator)e(*=)i(\()p Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f -Fk(t)m(yp)s(e)5 b Fp(&\))0 3883 y Fk(t)m(yp)s(e)g Fp(&)30 -b(operator)e(/=)i(\()p Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f -Fk(t)m(yp)s(e)5 b Fp(&\))0 4165 y Fr(F)-8 b(or)31 b(the)g(class)g -Fp(cl_I)p Fr(:)0 4482 y Fk(t)m(yp)s(e)5 b Fp(&)30 b(operator)e(+=)i(\() -p Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 4606 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(-=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 4731 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(*=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 4855 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(&=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 4980 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(|=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 5104 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(^=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 5229 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(<<=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))0 5353 y Fk(t)m(yp)s(e)g Fp(&)30 b(operator)e(>>=)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fk(t)m(yp)s(e)5 -b Fp(&\))p eop -%%Page: 36 38 -36 37 bop 0 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 -b(on)f(n)m(um)m(b)s(ers)2463 b(36)0 366 y(F)-8 b(or)31 -b(the)g(classes)g Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)f Fp(cl_RA)p -Fr(,)g Fp(cl_I)p Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)g -Fp(cl_FF)p Fr(,)h Fp(cl_DF)p Fr(,)f Fp(cl_LF)p Fr(:)0 -665 y Fk(t)m(yp)s(e)5 b Fp(&)30 b(operator)e(++)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 790 y Fr(The)g(pre\014x)f(op)s -(erator)i Fp(++x)p Fr(.)0 964 y Fp(void)e(operator)f(++)i(\()p -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(int\))480 1089 y Fr(The)g(p)s -(ost\014x)f(op)s(erator)i Fp(x++)p Fr(.)0 1263 y Fk(t)m(yp)s(e)5 -b Fp(&)30 b(operator)e(--)i(\()p Fk(t)m(yp)s(e)5 b Fp(&)30 -b(x\))480 1388 y Fr(The)g(pre\014x)f(op)s(erator)i Fp(--x)p -Fr(.)0 1562 y Fp(void)e(operator)f(--)i(\()p Fk(t)m(yp)s(e)5 -b Fp(&)30 b(x,)g(int\))480 1687 y Fr(The)g(p)s(ost\014x)f(op)s(erator)i -Fp(x--)p Fr(.)0 1985 y(Note)j(that)e(b)m(y)g(using)g(these)h -(obfuscating)g(op)s(erators,)g(y)m(ou)f(w)m(ouldn't)g(gain)h -(e\016ciency:)46 b(In)31 b(CLN)h(`)p Fp(x)e(+=)g(y;)p -Fr(')i(is)0 2110 y(exactly)g(the)f(same)e(as)i(`)p Fp(x)f(=)g(x+y;)p -Fr(',)g(not)h(more)e(e\016cien)m(t.)p eop -%%Page: 37 39 -37 38 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(37)0 366 y Fo(5)80 b(Input/Output)0 933 y Fs(5.1)68 -b(In)l(ternal)32 b(and)e(prin)l(ted)g(represen)l(tation)0 -1209 y Fr(All)h(computations)f(deal)h(with)f(the)h(in)m(ternal)g -(represen)m(tations)g(of)g(the)f(n)m(um)m(b)s(ers.)0 -1484 y(Ev)m(ery)i(n)m(um)m(b)s(er)d(has)j(an)f(external)i(represen)m -(tation)g(as)f(a)g(sequence)g(of)g(ASCI)s(I)e(c)m(haracters.)46 -b(Sev)m(eral)33 b(external)0 1609 y(represen)m(tations)e(ma)m(y)f -(denote)h(the)g(same)f(n)m(um)m(b)s(er,)e(for)i(example,)g +Fr(.)p eop +%%Page: 26 28 +26 27 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(26)-30 299 y Fn(4.11.2)63 +b(Con)m(v)m(ersion)41 b(to)g(rational)g(n)m(um)m(b)s(ers)-30 +488 y Fr(Eac)m(h)31 b(of)g(the)f(classes)i Fp(cl_R)p +Fr(,)d Fp(cl_RA)p Fr(,)g Fp(cl_F)g Fr(de\014nes)h(the)g(follo)m(wing)i +(op)s(eration:)-30 639 y Fp(cl_RA)d(rational)f(\(const)h +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 749 y Fr(Returns)j(the)h(v)-5 +b(alue)35 b(of)f Fp(x)f Fr(as)h(an)g(exact)i(n)m(um)m(b)s(er.)49 +b(If)33 b Fp(x)h Fr(is)g(already)g(an)g(exact)h(n)m(um)m(b)s(er,)e +(this)h(is)g Fp(x)p Fr(.)450 858 y(If)g Fp(x)g Fr(is)g(a)g +(\015oating-p)s(oin)m(t)i(n)m(um)m(b)s(er,)d(the)h(v)-5 +b(alue)35 b(is)f(a)h(rational)g(n)m(um)m(b)s(er)d(whose)i(denominator)f +(is)i(a)450 968 y(p)s(o)m(w)m(er)30 b(of)h(2.)-30 1119 +y(In)f(order)g(to)h(con)m(v)m(ert)h(bac)m(k,)f(sa)m(y)-8 +b(,)32 b Fp(\(cl_F\)\(cl_R\)"1/3")25 b Fr(to)31 b Fp(1/3)p +Fr(,)f(there)h(is)f(the)h(function)-30 1271 y Fp(cl_RA)e(rationalize)e +(\(const)i(cl_R&)g(x\))450 1380 y Fr(If)36 b Fp(x)f Fr(is)h(a)h +(\015oating-p)s(oin)m(t)g(n)m(um)m(b)s(er,)f(it)g(actually)i(represen)m +(ts)e(an)g(in)m(terv)-5 b(al)37 b(of)f(real)h(n)m(um)m(b)s(ers,)f(and) +450 1490 y(this)d(function)g(returns)e(the)i(rational)i(n)m(um)m(b)s +(er)30 b(with)j(smallest)g(denominator)f(\(and)h(smallest)g(n)m(u-)450 +1600 y(merator,)e(in)f(magnitude\))g(whic)m(h)g(lies)i(in)e(this)h(in)m +(terv)-5 b(al.)42 b(If)30 b Fp(x)h Fr(is)f(already)i(an)e(exact)i(n)m +(um)m(b)s(er,)d(this)450 1709 y(function)h(returns)f +Fp(x)p Fr(.)-30 1861 y(If)h Fp(x)g Fr(is)g(an)m(y)h(\015oat,)g(one)g +(has)150 1991 y Fp(cl_float\(rational\(x\),x\))24 b(=)30 +b(x)150 2122 y(cl_float\(rationalize\(x\),)o(x\))24 b(=)30 +b(x)-30 2367 y Fs(4.12)68 b(Random)46 b(n)l(um)l(b)t(er)e(generators) +-30 2556 y Fr(A)31 b(random)e(generator)k(is)e(a)g(mac)m(hine)g(whic)m +(h)g(pro)s(duces)f(\(pseudo-\)random)f(n)m(um)m(b)s(ers.)41 +b(The)30 b(include)h(\014le)g Fp()c +Fr(de\014nes)h(a)i(class)g Fp(cl_random_state)25 b Fr(whic)m(h)k(con)m +(tains)h(the)g(state)h(of)e(a)h(random)d(generator.)42 +b(If)29 b(y)m(ou)-30 2775 y(mak)m(e)i(a)g(cop)m(y)h(of)f(the)h(random)d +(n)m(um)m(b)s(er)f(generator,)33 b(the)e(original)h(one)g(and)e(the)h +(cop)m(y)h(will)f(pro)s(duce)f(the)i(same)-30 2885 y(sequence)f(of)f +(random)f(n)m(um)m(b)s(ers.)-30 3015 y(The)j(follo)m(wing)i(functions)d +(return)h(\(pseudo-\)random)e(n)m(um)m(b)s(ers)g(in)i(di\013eren)m(t)h +(formats.)45 b(Calling)33 b(one)g(of)f(these)-30 3125 +y(mo)s(di\014es)d(the)h(state)i(of)e(the)h(random)e(n)m(um)m(b)s(er)f +(generator)j(in)f(a)h(complicated)g(but)f(deterministic)g(w)m(a)m(y)-8 +b(.)-30 3255 y(The)30 b(global)i(v)-5 b(ariable)210 3380 +y Fp(cl_random_state)44 b(cl_default_random_state)-30 +3511 y Fr(con)m(tains)29 b(a)f(default)f(random)f(n)m(um)m(b)s(er)f +(generator.)41 b(It)28 b(is)f(used)g(when)g(the)g(functions)h(b)s(elo)m +(w)f(are)h(called)h(without)-30 3620 y Fp(cl_random_state)d +Fr(argumen)m(t.)-30 3772 y Fp(uint32)j(random32)f(\(cl_random_state&)d +(randomstate\))-30 3881 y(uint32)k(random32)f(\(\))450 +3991 y Fr(Returns)h(a)i(random)e(unsigned)g(32-bit)j(n)m(um)m(b)s(er.) +38 b(All)31 b(bits)f(are)h(equally)g(random.)-30 4143 +y Fp(cl_I)e(random_I)f(\(cl_random_state&)e(randomstate,)h(const)i +(cl_I&)g(n\))-30 4252 y(cl_I)g(random_I)f(\(const)h(cl_I&)g(n\))450 +4362 y(n)i Fr(m)m(ust)e(b)s(e)h(an)h(in)m(teger)h Fp(>)f +Fr(0.)42 b(This)31 b(function)f(returns)g(a)h(random)e(in)m(teger)j +Fp(x)f Fr(in)f(the)h(range)g Fp(0)g(<=)e(x)450 4471 y(<)h(n)p +Fr(.)-30 4623 y Fp(cl_F)f(random_F)f(\(cl_random_state&)e(randomstate,) +h(const)i(cl_F&)g(n\))-30 4732 y(cl_F)g(random_F)f(\(const)h(cl_F&)g +(n\))450 4842 y(n)d Fr(m)m(ust)f(b)s(e)h(a)h(\015oat)g +Fp(>)f Fr(0.)40 b(This)26 b(function)g(returns)f(a)i(random)d +(\015oating-p)s(oin)m(t)k(n)m(um)m(b)s(er)c(of)j(the)g(same)450 +4952 y(format)j(as)g Fp(n)g Fr(in)g(the)h(range)g Fp(0)f(<=)f(x)i(<)f +(n)p Fr(.)-30 5103 y Fp(cl_R)f(random_R)f(\(cl_random_state&)e +(randomstate,)h(const)i(cl_R&)g(n\))-30 5213 y(cl_R)g(random_R)f +(\(const)h(cl_R&)g(n\))450 5322 y Fr(Beha)m(v)m(es)j(lik)m(e)g +Fp(random_I)c Fr(if)i Fp(n)g Fr(is)h(an)f(in)m(teger)i(and)e(lik)m(e)h +Fp(random_F)d Fr(if)j Fp(n)f Fr(is)g(a)h(\015oat.)p eop +%%Page: 27 29 +27 28 bop -30 -116 a Fr(Chapter)30 b(4:)41 b(F)-8 b(unctions)31 +b(on)f(n)m(um)m(b)s(ers)2523 b(27)-30 299 y Fs(4.13)68 +b(Obfuscating)46 b(op)t(erators)-30 491 y Fr(The)36 b(mo)s(difying)g +(C/C)p Fp(++)g Fr(op)s(erators)h Fp(+=)p Fr(,)h Fp(-=)p +Fr(,)g Fp(*=)p Fr(,)g Fp(/=)p Fr(,)g Fp(&=)p Fr(,)g Fp(|=)p +Fr(,)g Fp(^=)p Fr(,)h Fp(<<=)p Fr(,)e Fp(>>=)f Fr(are)i(not)f(a)m(v)-5 +b(ailable)39 b(b)m(y)e(default)-30 601 y(b)s(ecause)45 +b(their)f(use)g(tends)h(to)g(mak)m(e)g(programs)e(unreadable.)83 +b(It)44 b(is)h(trivial)h(to)f(get)h(a)m(w)m(a)m(y)g(without)f(them.)-30 +711 y(Ho)m(w)m(ev)m(er,)33 b(if)d(y)m(ou)h(feel)g(that)g(y)m(ou)g +(absolutely)g(need)f(these)h(op)s(erators)f(to)h(get)h(happ)m(y)-8 +b(,)30 b(then)g(add)210 839 y Fp(#define)46 b(WANT_OBFUSCATING_OPERATO) +o(RS)-30 974 y Fr(to)37 b(the)g(b)s(eginning)f(of)h(y)m(our)g(source)g +(\014les,)h(b)s(efore)f(the)g(inclusion)f(of)h(an)m(y)g(CLN)f(include)h +(\014les.)60 b(This)36 b(\015ag)h(will)-30 1083 y(enable)31 +b(the)f(follo)m(wing)i(op)s(erators:)-30 1218 y(F)-8 +b(or)31 b(the)g(classes)g Fp(cl_N)p Fr(,)f Fp(cl_R)p +Fr(,)f Fp(cl_RA)p Fr(,)g Fp(cl_F)p Fr(,)h Fp(cl_SF)p +Fr(,)f Fp(cl_FF)p Fr(,)g Fp(cl_DF)p Fr(,)g Fp(cl_LF)p +Fr(:)-30 1377 y Fl(t)m(yp)s(e)5 b Fp(&)30 b(operator)e(+=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 1487 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(-=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 1597 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(*=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 1706 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(/=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 1841 y Fr(F)-8 b(or)31 b(the)g(class)g Fp(cl_I)p +Fr(:)-30 2000 y Fl(t)m(yp)s(e)5 b Fp(&)30 b(operator)e(+=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2110 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(-=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2219 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(*=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2329 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(&=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2438 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(|=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2548 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(^=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2658 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(<<=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2767 y Fl(t)m(yp)s(e)g Fp(&)30 b(operator)e(>>=)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&,)30 b(const)f Fl(t)m(yp)s(e)5 +b Fp(&\))-30 2902 y Fr(F)-8 b(or)31 b(the)g(classes)g +Fp(cl_N)p Fr(,)f Fp(cl_R)p Fr(,)f Fp(cl_RA)p Fr(,)g Fp(cl_I)p +Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)h Fp(cl_DF)p Fr(,)f Fp(cl_LF)p Fr(:)-30 3061 y Fl(t)m(yp)s(e)5 +b Fp(&)30 b(operator)e(++)i(\()p Fl(t)m(yp)s(e)5 b Fp(&)30 +b(x\))450 3171 y Fr(The)g(pre\014x)f(op)s(erator)i Fp(++x)p +Fr(.)-30 3330 y Fp(void)e(operator)f(++)i(\()p Fl(t)m(yp)s(e)5 +b Fp(&)30 b(x,)g(int\))450 3440 y Fr(The)g(p)s(ost\014x)f(op)s(erator)i +Fp(x++)p Fr(.)-30 3599 y Fl(t)m(yp)s(e)5 b Fp(&)30 b(operator)e(--)i +(\()p Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 3709 y Fr(The)g(pre\014x)f +(op)s(erator)i Fp(--x)p Fr(.)-30 3868 y Fp(void)e(operator)f(--)i(\()p +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x,)g(int\))450 3978 y Fr(The)g(p)s +(ost\014x)f(op)s(erator)i Fp(x--)p Fr(.)-30 4137 y(Note)37 +b(that)g(b)m(y)f(using)g(these)h(obfuscating)f(op)s(erators,)i(y)m(ou)f +(w)m(ouldn't)f(gain)h(e\016ciency:)53 b(In)35 b(CLN)h(`)p +Fp(x)30 b(+=)g(y;)p Fr(')36 b(is)-30 4247 y(exactly)c(the)f(same)e(as)i +(`)p Fp(x)f(=)g(x+y;)p Fr(',)g(not)h(more)e(e\016cien)m(t.)p +eop +%%Page: 28 30 +28 29 bop -30 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2844 +b(28)-30 299 y Fo(5)80 b(Input/Output)-30 758 y Fs(5.1)68 +b(In)l(ternal)46 b(and)f(prin)l(ted)g(represen)l(tation)-30 +973 y Fr(All)31 b(computations)f(deal)h(with)f(the)h(in)m(ternal)g +(represen)m(tations)g(of)g(the)f(n)m(um)m(b)s(ers.)-30 +1130 y(Ev)m(ery)36 b(n)m(um)m(b)s(er)d(has)j(an)f(external)i(represen)m +(tation)g(as)f(a)g(sequence)g(of)g(ASCI)s(I)e(c)m(haracters.)58 +b(Sev)m(eral)37 b(external)-30 1239 y(represen)m(tations)31 +b(ma)m(y)f(denote)h(the)g(same)f(n)m(um)m(b)s(er,)e(for)i(example,)g Fp(")p Fr(20.0)p Fp(")i Fr(and)d Fp(")p Fr(20.000)p Fp(")p -Fr(.)0 1884 y(Con)m(v)m(erting)38 b(an)g(in)m(ternal)g(to)g(an)f -(external)i(represen)m(tation)f(is)g(called)g(\\prin)m(ting",)j(con)m -(v)m(erting)e(an)e(external)0 2009 y(to)43 b(an)e(in)m(ternal)i -(represen)m(tation)g(is)f(called)h(\\reading".)76 b(In)41 -b(CLN,)h(it)g(is)g(alw)m(a)m(ys)i(true)d(that)i(con)m(v)m(ersion)g(of)0 -2133 y(an)d(in)m(ternal)g(to)g(an)g(external)g(represen)m(tation)h(and) -e(then)g(bac)m(k)i(to)f(an)g(in)m(ternal)g(represen)m(tation)h(will)f -(yield)0 2258 y(the)34 b(same)e(in)m(ternal)j(represen)m(tation.)50 -b(Sym)m(b)s(olically:)d Fp(read\(print\(x\)\))27 b(==)i(x)p -Fr(.)50 b(This)33 b(is)g(called)i(\\prin)m(t-read)0 2382 -y(consistency".)0 2658 y(Di\013eren)m(t)d(t)m(yp)s(es)e(of)h(n)m(um)m -(b)s(ers)d(ha)m(v)m(e)j(di\013eren)m(t)g(external)g(represen)m(tations) -h(\(case)f(is)g(insigni\014can)m(t\):)0 2959 y(In)m(tegers)167 -b(External)30 b(represen)m(tation:)41 b Fk(sign)p Fp({)p -Fk(digit)r Fp(}+)p Fr(.)g(The)29 b(reader)g(also)i(accepts)g(the)e -(Common)e(Lisp)i(syn-)480 3084 y(taxes)39 b Fk(sign)p -Fp({)p Fk(digit)r Fp(}+.)f Fr(with)h(a)f(trailing)i(dot)e(for)h -(decimal)f(in)m(tegers)i(and)d(the)i Fp(#)p Fk(n)p Fp(R)p -Fr(,)g Fp(#b)p Fr(,)i Fp(#o)p Fr(,)f Fp(#x)480 3208 y -Fr(pre\014xes.)0 3386 y(Rational)32 b(n)m(um)m(b)s(ers)480 -3510 y(External)37 b(represen)m(tation:)56 b Fk(sign)p -Fp({)p Fk(digit)r Fp(}+/{)p Fk(digit)r Fp(}+)p Fr(.)k(The)37 -b Fp(#)p Fk(n)p Fp(R)p Fr(,)h Fp(#b)p Fr(,)g Fp(#o)p -Fr(,)h Fp(#x)d Fr(pre\014xes)g(are)i(al-)480 3635 y(lo)m(w)m(ed)32 -b(here)e(as)g(w)m(ell.)0 3812 y(Floating-p)s(oin)m(t)j(n)m(um)m(b)s -(ers)480 3937 y(External)48 b(represen)m(tation:)76 b -Fk(sign)p Fp({)p Fk(digit)r Fp(})p Fr(*)p Fk(exp)s(onen)m(t)50 -b Fr(or)d Fk(sign)p Fp({)p Fk(digit)r Fp(})p Fr(*)p Fp(.{)p -Fk(digit)r Fp(})p Fr(*)p Fk(exp)s(onen)m(t)k Fr(or)480 -4061 y Fk(sign)p Fp({)p Fk(digit)r Fp(})p Fr(*)p Fp(.{)p -Fk(digit)r Fp(}+)p Fr(.)40 b(A)26 b(precision)g(sp)s(eci\014er)f(of)h -(the)h(form)p 2684 4061 28 4 v 57 w Fk(prec)k Fr(ma)m(y)26 -b(b)s(e)f(app)s(ended.)37 b(There)480 4186 y(m)m(ust)h(b)s(e)h(at)i -(least)g(one)e(digit)i(in)e(the)h(non-exp)s(onen)m(t)f(part.)69 -b(The)39 b(exp)s(onen)m(t)g(has)h(the)f(syn)m(tax)480 -4310 y Fk(expmark)m(er)d(expsign)30 b Fp({)p Fk(digit)r -Fp(}+)p Fr(.)41 b(The)30 b(exp)s(onen)m(t)g(mark)m(er)g(is)660 -4461 y(`)p Fp(s)p Fr(')h(for)f(short-\015oats,)660 4612 -y(`)p Fp(f)p Fr(')h(for)f(single-\015oats,)660 4763 y(`)p -Fp(d)p Fr(')h(for)f(double-\015oats,)660 4914 y(`)p Fp(L)p -Fr(')h(for)f(long-\015oats,)480 5091 y(or)25 b(`)p Fp(e)p -Fr(',)i(whic)m(h)e(denotes)h(a)g(default)f(\015oat)h(format.)39 -b(The)25 b(precision)g(sp)s(ecifying)g(su\016x)g(has)g(the)g(syn-)480 -5215 y(tax)p 638 5215 V 57 w Fk(prec)30 b Fr(where)23 -b Fk(prec)30 b Fr(denotes)24 b(the)g(n)m(um)m(b)s(er)e(of)i(v)-5 -b(alid)25 b(man)m(tissa)f(digits)g(\(in)g(decimal,)i(excluding)480 -5340 y(leading)31 b(zero)s(es\),)h(cf.)41 b(also)31 b(function)f(`)p -Fp(cl_float_format)p Fr('.)p eop -%%Page: 38 40 -38 39 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(38)0 366 y(Complex)29 b(n)m(um)m(b)s(ers)480 491 y(External)i -(represen)m(tation:)660 646 y(In)h(algebraic)i(notation:)46 -b Fk(realpart)r Fp(+)p Fk(imagpart)r Fp(i)p Fr(.)g(Of)32 -b(course,)h(if)g Fk(imagpart)h Fr(is)e(negativ)m(e,)k(its)660 -771 y(prin)m(ted)23 b(represen)m(tation)h(b)s(egins)f(with)g(a)h(`)p -Fp(-)p Fr(',)h(and)e(the)h(`)p Fp(+)p Fr(')f(b)s(et)m(w)m(een)h -Fk(realpart)i Fr(and)d Fk(imagpart)660 895 y Fr(ma)m(y)37 -b(b)s(e)h(omitted.)63 b(Note)39 b(that)g(this)e(notation)j(cannot)e(b)s -(e)f(used)g(when)g(the)h Fk(imagpart)i Fr(is)660 1020 -y(rational)c(and)f(the)g(rational)h(n)m(um)m(b)s(er's)d(base)i(is)g -Fp(>)p Fr(18,)i(b)s(ecause)e(the)g(`)p Fp(i)p Fr(')g(is)g(then)g(read)f -(as)i(a)660 1144 y(digit.)660 1299 y(In)30 b(Common)e(Lisp)h(notation:) -42 b Fp(#C\()p Fk(realpart)32 b(imagpart)r Fp(\))p Fr(.)0 -1799 y Fs(5.2)68 b(Input)30 b(functions)0 2078 y Fr(Including)24 -b Fp()e Fr(de\014nes)i(a)h(t)m(yp)s(e)g Fp(cl_istream)p -Fr(,)e(whic)m(h)h(is)h(the)g(t)m(yp)s(e)g(of)g(the)g(\014rst)f(argumen) -m(t)g(to)h(all)h(input)0 2203 y(functions.)38 b(Unless)24 -b(y)m(ou)g(build)f(and)g(use)g(CLN)g(with)h(the)g(macro)f(CL)p -2375 2203 28 4 v 32 w(IO)p 2511 2203 V 33 w(STDIO)f(b)s(eing)i -(de\014ned,)g Fp(cl_istream)0 2327 y Fr(is)30 b(the)h(same)f(as)g -Fp(istream&)p Fr(.)0 2607 y(The)g(v)-5 b(ariable)180 -2887 y Fp(cl_istream)28 b(cl_stdin)0 3197 y Fr(con)m(tains)k(the)e -(standard)g(input)f(stream.)0 3476 y(These)h(are)h(the)f(simple)g -(input)f(functions:)0 3787 y Fp(int)g(freadchar)f(\(cl_istream)g -(stream\))480 3911 y Fr(Reads)33 b(a)h(c)m(haracter)h(from)c -Fp(stream)p Fr(.)48 b(Returns)32 b Fp(cl_EOF)f Fr(\(not)j(a)g(`)p -Fp(char)p Fr('!\))48 b(if)33 b(the)h(end)e(of)i(stream)480 -4036 y(w)m(as)d(encoun)m(tered)g(or)f(an)g(error)g(o)s(ccurred.)0 -4221 y Fp(int)f(funreadchar)f(\(cl_istream)f(stream,)h(int)i(c\))480 -4346 y Fr(Puts)37 b(bac)m(k)i Fp(c)f Fr(on)m(to)h Fp(stream)p -Fr(.)61 b Fp(c)38 b Fr(m)m(ust)e(b)s(e)i(the)g(result)g(of)g(the)g -(last)g Fp(freadchar)e Fr(op)s(eration)i(on)480 4471 -y Fp(stream)p Fr(.)0 4781 y(Eac)m(h)d(of)g(the)g(classes)g -Fp(cl_N)p Fr(,)g Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)f Fp(cl_I)p -Fr(,)h Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)h Fp(cl_FF)p -Fr(,)f Fp(cl_DF)p Fr(,)h Fp(cl_LF)e Fr(de\014nes,)i(in)f -Fp()p Fr(,)29 -b(the)i(follo)m(wing)h(input)d(function:)0 5215 y Fp(cl_istream)f -(operator>>)f(\(cl_istream)g(stream,)i Fk(t)m(yp)s(e)5 -b Fp(&)30 b(result\))480 5340 y Fr(Reads)g(a)h(n)m(um)m(b)s(er)d(from)h +Fr(.)-30 1397 y(Con)m(v)m(erting)34 b(an)f(in)m(ternal)h(to)g(an)e +(external)i(represen)m(tation)h(is)e(called)h(\\prin)m(ting",)h(con)m +(v)m(erting)f(an)f(external)h(to)-30 1506 y(an)24 b(in)m(ternal)h +(represen)m(tation)g(is)f(called)h(\\reading".)40 b(In)24 +b(CLN,)f(it)i(is)f(alw)m(a)m(ys)i(true)e(that)h(con)m(v)m(ersion)g(of)f +(an)g(in)m(ternal)-30 1616 y(to)j(an)e(external)i(represen)m(tation)g +(and)e(then)h(bac)m(k)g(to)h(an)e(in)m(ternal)i(represen)m(tation)g +(will)f(yield)g(the)g(same)f(in)m(ternal)-30 1725 y(represen)m(tation.) +42 b(Sym)m(b)s(olically:)f Fp(read\(print\(x\)\))26 b(==)k(x)p +Fr(.)40 b(This)30 b(is)g(called)i(\\prin)m(t-read)e(consistency".)-30 +1882 y(Di\013eren)m(t)i(t)m(yp)s(es)e(of)h(n)m(um)m(b)s(ers)d(ha)m(v)m +(e)j(di\013eren)m(t)g(external)g(represen)m(tations)h(\(case)f(is)g +(insigni\014can)m(t\):)-30 2076 y(In)m(tegers)167 b(External)35 +b(represen)m(tation:)50 b Fl(sign)p Fp({)p Fl(digit)r +Fp(}+)p Fr(.)j(The)34 b(reader)g(also)h(accepts)h(the)f(Common)d(Lisp)h +(syn-)450 2185 y(taxes)43 b Fl(sign)p Fp({)p Fl(digit)r +Fp(}+.)g Fr(with)f(a)h(trailing)g(dot)g(for)f(decimal)g(in)m(tegers)i +(and)e(the)h Fp(#)p Fl(n)p Fp(R)p Fr(,)h Fp(#b)p Fr(,)h +Fp(#o)p Fr(,)h Fp(#x)450 2295 y Fr(pre\014xes.)-30 2477 +y(Rational)32 b(n)m(um)m(b)s(ers)450 2586 y(External)26 +b(represen)m(tation:)39 b Fl(sign)p Fp({)p Fl(digit)r +Fp(}+/{)p Fl(digit)r Fp(}+)p Fr(.)g(The)25 b Fp(#)p Fl(n)p +Fp(R)p Fr(,)h Fp(#b)p Fr(,)g Fp(#o)p Fr(,)g Fp(#x)f Fr(pre\014xes)g +(are)h(allo)m(w)m(ed)450 2696 y(here)k(as)h(w)m(ell.)-30 +2878 y(Floating-p)s(oin)m(t)i(n)m(um)m(b)s(ers)450 2988 +y(External)58 b(represen)m(tation:)96 b Fl(sign)p Fp({)p +Fl(digit)r Fp(})p Fr(*)p Fl(exp)s(onen)m(t)60 b Fr(or)d +Fl(sign)p Fp({)p Fl(digit)r Fp(})p Fr(*)p Fp(.{)p Fl(digit)r +Fp(})p Fr(*)p Fl(exp)s(onen)m(t)k Fr(or)450 3097 y Fl(sign)p +Fp({)p Fl(digit)r Fp(})p Fr(*)p Fp(.{)p Fl(digit)r Fp(}+)p +Fr(.)45 b(A)31 b(precision)h(sp)s(eci\014er)f(of)h(the)f(form)p +2693 3097 28 4 v 63 w Fl(prec)37 b Fr(ma)m(y)31 b(b)s(e)g(app)s(ended.) +42 b(There)450 3207 y(m)m(ust)g(b)s(e)h(at)h(least)h(one)e(digit)h(in)f +(the)h(non-exp)s(onen)m(t)f(part.)80 b(The)42 b(exp)s(onen)m(t)i(has)f +(the)g(syn)m(tax)450 3316 y Fl(expmark)m(er)36 b(expsign)30 +b Fp({)p Fl(digit)r Fp(}+)p Fr(.)41 b(The)30 b(exp)s(onen)m(t)g(mark)m +(er)g(is)630 3462 y(`)p Fp(s)p Fr(')h(for)f(short-\015oats,)630 +3608 y(`)p Fp(f)p Fr(')h(for)f(single-\015oats,)630 3754 +y(`)p Fp(d)p Fr(')h(for)f(double-\015oats,)630 3900 y(`)p +Fp(L)p Fr(')h(for)f(long-\015oats,)450 4082 y(or)23 b(`)p +Fp(e)p Fr(',)h(whic)m(h)f(denotes)g(a)g(default)f(\015oat)i(format.)37 +b(The)22 b(precision)h(sp)s(ecifying)g(su\016x)e(has)i(the)f(syn)m(tax) +p 450 4191 V 477 4191 a Fl(prec)48 b Fr(where)41 b Fl(prec)48 +b Fr(denotes)42 b(the)g(n)m(um)m(b)s(er)e(of)i(v)-5 b(alid)43 +b(man)m(tissa)f(digits)g(\(in)h(decimal,)i(excluding)450 +4301 y(leading)31 b(zero)s(es\),)h(cf.)41 b(also)31 b(function)f(`)p +Fp(cl_float_format)p Fr('.)-30 4483 y(Complex)f(n)m(um)m(b)s(ers)450 +4592 y(External)i(represen)m(tation:)630 4738 y(In)36 +b(algebraic)j(notation:)54 b Fl(realpart)r Fp(+)p Fl(imagpart)r +Fp(i)p Fr(.)60 b(Of)37 b(course,)h(if)f Fl(imagpart)i +Fr(is)e(negativ)m(e,)k(its)630 4848 y(prin)m(ted)28 b(represen)m +(tation)i(b)s(egins)e(with)g(a)h(`)p Fp(-)p Fr(',)g(and)f(the)g(`)p +Fp(+)p Fr(')h(b)s(et)m(w)m(een)g Fl(realpart)i Fr(and)d +Fl(imagpart)630 4957 y Fr(ma)m(y)41 b(b)s(e)h(omitted.)75 +b(Note)43 b(that)g(this)e(notation)j(cannot)e(b)s(e)f(used)g(when)g +(the)h Fl(imagpart)i Fr(is)630 5067 y(rational)c(and)e(the)i(rational)g +(n)m(um)m(b)s(er's)c(base)j(is)g Fp(>)p Fr(18,)j(b)s(ecause)d(the)g(`)p +Fp(i)p Fr(')g(is)g(then)g(read)f(as)i(a)630 5177 y(digit.)630 +5322 y(In)30 b(Common)e(Lisp)h(notation:)42 b Fp(#C\()p +Fl(realpart)32 b(imagpart)r Fp(\))p Fr(.)p eop +%%Page: 29 31 +29 30 bop -30 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2844 +b(29)-30 299 y Fs(5.2)68 b(Input)44 b(functions)-30 491 +y Fr(Including)28 b Fp()e Fr(de\014nes)h(a)i(t)m(yp)s(e)g +Fp(cl_istream)p Fr(,)d(whic)m(h)i(is)h(the)g(t)m(yp)s(e)f(of)h(the)g +(\014rst)e(argumen)m(t)h(to)h(all)h(input)-30 601 y(functions.)40 +b(Unless)28 b(y)m(ou)h(build)f(and)g(use)g(CLN)h(with)f(the)h(macro)f +(CL)p 2391 601 28 4 v 32 w(IO)p 2527 601 V 33 w(STDIO)f(b)s(eing)i +(de\014ned,)f Fp(cl_istream)-30 710 y Fr(is)i(the)h(same)f(as)g +Fp(istream&)p Fr(.)-30 844 y(The)g(v)-5 b(ariable)150 +978 y Fp(cl_istream)28 b(cl_stdin)-30 1137 y Fr(con)m(tains)k(the)e +(standard)g(input)f(stream.)-30 1271 y(These)h(are)h(the)f(simple)g +(input)f(functions:)-30 1430 y Fp(int)g(freadchar)f(\(cl_istream)g +(stream\))450 1539 y Fr(Reads)37 b(a)f(c)m(haracter)j(from)c +Fp(stream)p Fr(.)57 b(Returns)35 b Fp(cl_EOF)g Fr(\(not)i(a)g(`)p +Fp(char)p Fr('!\))59 b(if)36 b(the)h(end)f(of)h(stream)450 +1649 y(w)m(as)31 b(encoun)m(tered)g(or)f(an)g(error)g(o)s(ccurred.)-30 +1807 y Fp(int)f(funreadchar)f(\(cl_istream)f(stream,)h(int)i(c\))450 +1917 y Fr(Puts)41 b(bac)m(k)h Fp(c)f Fr(on)m(to)i Fp(stream)p +Fr(.)72 b Fp(c)41 b Fr(m)m(ust)f(b)s(e)h(the)h(result)f(of)g(the)h +(last)g Fp(freadchar)d Fr(op)s(eration)j(on)450 2027 +y Fp(stream)p Fr(.)-30 2185 y(Eac)m(h)d(of)f(the)g(classes)h +Fp(cl_N)p Fr(,)g Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_I)p +Fr(,)g Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)g Fp(cl_FF)p +Fr(,)g Fp(cl_DF)p Fr(,)f Fp(cl_LF)f Fr(de\014nes,)i(in)f +Fp()p Fr(,)29 +b(the)i(follo)m(wing)h(input)d(function:)-30 2453 y Fp(cl_istream)f +(operator>>)f(\(cl_istream)g(stream,)i Fl(t)m(yp)s(e)5 +b Fp(&)30 b(result\))450 2563 y Fr(Reads)g(a)h(n)m(um)m(b)s(er)d(from)h Fp(stream)g Fr(and)h(stores)g(it)h(in)f(the)h Fp(result)p -Fr(.)p eop -%%Page: 39 41 -39 40 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(39)0 366 y(The)30 b(most)g(\015exible)g(input)g(functions,)g -(de\014ned)f(in)h Fp()p -Fr(,)28 b(are)j(the)f(follo)m(wing:)0 659 y Fp(cl_N)f(read_complex)e -(\(cl_istream)h(stream,)g(const)h(cl_read_flags&)d(flags\))0 -783 y(cl_R)j(read_real)f(\(cl_istream)f(stream,)i(const)g -(cl_read_flags&)d(flags\))0 908 y(cl_F)j(read_float)f(\(cl_istream)f -(stream,)h(const)h(cl_read_flags&)e(flags\))0 1033 y(cl_RA)i -(read_rational)e(\(cl_istream)g(stream,)h(const)h(cl_read_flags&)e -(flags\))0 1157 y(cl_I)i(read_integer)e(\(cl_istream)h(stream,)g(const) -h(cl_read_flags&)d(flags\))480 1282 y Fr(Reads)d(a)g(n)m(um)m(b)s(er)e -(from)h Fp(stream)p Fr(.)36 b(The)23 b Fp(flags)e Fr(are)i(parameters)g -(whic)m(h)f(a\013ect)j(the)e(input)f(syn)m(tax.)480 1406 -y(Whitespace)32 b(b)s(efore)e(the)g(n)m(um)m(b)s(er)e(is)j(silen)m(tly) -h(skipp)s(ed.)0 1568 y Fp(cl_N)d(read_complex)e(\(const)i -(cl_read_flags&)d(flags,)j(const)g(char)g(*)h(string,)f(const)g(char)g -(*)0 1692 y(string_limit,)e(const)i(char)g(*)h(*)g(end_of_parse\))0 -1817 y(cl_R)f(read_real)f(\(const)h(cl_read_flags&)d(flags,)j(const)g -(char)g(*)h(string,)e(const)h(char)h(*)0 1941 y(string_limit,)d(const)i -(char)g(*)h(*)g(end_of_parse\))0 2066 y(cl_F)f(read_float)f(\(const)g -(cl_read_flags&)f(flags,)i(const)g(char)g(*)h(string,)e(const)h(char)g -(*)0 2190 y(string_limit,)e(const)i(char)g(*)h(*)g(end_of_parse\))0 -2315 y(cl_RA)f(read_rational)e(\(const)h(cl_read_flags&)f(flags,)h -(const)h(char)h(*)g(string,)e(const)h(char)g(*)0 2439 -y(string_limit,)e(const)i(char)g(*)h(*)g(end_of_parse\))0 -2564 y(cl_I)f(read_integer)e(\(const)i(cl_read_flags&)d(flags,)j(const) -g(char)g(*)h(string,)f(const)g(char)g(*)0 2688 y(string_limit,)e(const) -i(char)g(*)h(*)g(end_of_parse\))480 2813 y Fr(Reads)g(a)h(n)m(um)m(b)s -(er)d(from)h(a)i(string)f(in)g(memory)-8 b(.)39 b(The)30 -b Fp(flags)f Fr(are)i(parameters)f(whic)m(h)g(a\013ect)i(the)480 -2938 y(input)26 b(syn)m(tax.)40 b(The)27 b(string)g(starts)g(at)h -Fp(string)d Fr(and)h(ends)g(at)i Fp(string_limit)c Fr(\(exclusiv)m(e)29 -b(limit\).)480 3062 y Fp(string_limit)24 b Fr(ma)m(y)j(also)h(b)s(e)e -Fp(NULL)p Fr(,)h(denoting)h(the)f(en)m(tire)h(string,)g(i.e.)40 -b(equiv)-5 b(alen)m(t)29 b(to)f Fp(string_)480 3187 y(limit)h(=)h -(string)f(+)h(strlen\(string\))p Fr(.)57 b(If)37 b Fp(end_of_parse)d -Fr(is)j Fp(NULL)p Fr(,)h(the)g(string)f(in)g(memory)480 -3311 y(m)m(ust)26 b(con)m(tain)i(exactly)h(one)f(n)m(um)m(b)s(er)d(and) -h(nothing)h(more,)g(else)h(a)g(fatal)g(error)f(will)g(b)s(e)g -(signalled.)480 3436 y(If)33 b Fp(end_of_parse)c Fr(is)k(not)h -Fp(NULL)p Fr(,)f Fp(*end_of_parse)c Fr(will)k(b)s(e)g(assigned)g(a)h(p) -s(oin)m(ter)f(past)g(the)g(last)480 3560 y(parsed)h(c)m(haracter)i -(\(i.e.)55 b Fp(string_limit)31 b Fr(if)k(nothing)f(came)h(after)g(the) -g(n)m(um)m(b)s(er\).)51 b(Whitespace)480 3685 y(is)30 -b(not)h(allo)m(w)m(ed.)0 3977 y(The)f(structure)g Fp(cl_read_flags)d -Fr(con)m(tains)k(the)g(follo)m(wing)g(\014elds:)0 4270 -y Fp(cl_read_syntax_t)26 b(syntax)480 4394 y Fr(The)c(p)s(ossible)f -(results)h(of)h(the)f(read)g(op)s(eration.)38 b(P)m(ossible)23 -b(v)-5 b(alues)23 b(are)f Fp(syntax_number)p Fr(,)f Fp(syntax_)480 -4519 y(real)p Fr(,)37 b Fp(syntax_rational)p Fr(,)e Fp(syntax_integer)p +Fr(.)-30 2721 y(The)f(most)g(\015exible)g(input)g(functions,)g +(de\014ned)f(in)h Fp()p +Fr(,)28 b(are)j(the)f(follo)m(wing:)-30 2880 y Fp(cl_N)f(read_complex)e +(\(cl_istream)h(stream,)g(const)h(cl_read_flags&)d(flags\))-30 +2990 y(cl_R)j(read_real)f(\(cl_istream)f(stream,)i(const)g +(cl_read_flags&)d(flags\))-30 3099 y(cl_F)j(read_float)f(\(cl_istream)f +(stream,)h(const)h(cl_read_flags&)e(flags\))-30 3209 +y(cl_RA)i(read_rational)e(\(cl_istream)g(stream,)h(const)h +(cl_read_flags&)e(flags\))-30 3318 y(cl_I)i(read_integer)e +(\(cl_istream)h(stream,)g(const)h(cl_read_flags&)d(flags\))450 +3428 y Fr(Reads)i(a)g(n)m(um)m(b)s(er)e(from)g Fp(stream)p +Fr(.)38 b(The)27 b Fp(flags)g Fr(are)h(parameters)f(whic)m(h)h +(a\013ect)h(the)f(input)f(syn)m(tax.)450 3538 y(Whitespace)32 +b(b)s(efore)e(the)g(n)m(um)m(b)s(er)e(is)j(silen)m(tly)h(skipp)s(ed.) +-30 3696 y Fp(cl_N)d(read_complex)e(\(const)i(cl_read_flags&)d(flags,)j +(const)g(char)g(*)h(string,)f(const)g(char)g(*)-30 3806 +y(string_limit,)e(const)i(char)g(*)h(*)g(end_of_parse\))-30 +3915 y(cl_R)f(read_real)f(\(const)h(cl_read_flags&)d(flags,)j(const)g +(char)g(*)h(string,)e(const)h(char)h(*)-30 4025 y(string_limit,)d +(const)i(char)g(*)h(*)g(end_of_parse\))-30 4134 y(cl_F)f(read_float)f +(\(const)g(cl_read_flags&)f(flags,)i(const)g(char)g(*)h(string,)e +(const)h(char)g(*)-30 4244 y(string_limit,)e(const)i(char)g(*)h(*)g +(end_of_parse\))-30 4354 y(cl_RA)f(read_rational)e(\(const)h +(cl_read_flags&)f(flags,)h(const)h(char)h(*)g(string,)e(const)h(char)g +(*)-30 4463 y(string_limit,)e(const)i(char)g(*)h(*)g(end_of_parse\))-30 +4573 y(cl_I)f(read_integer)e(\(const)i(cl_read_flags&)d(flags,)j(const) +g(char)g(*)h(string,)f(const)g(char)g(*)-30 4682 y(string_limit,)e +(const)i(char)g(*)h(*)g(end_of_parse\))450 4792 y Fr(Reads)k(a)h(n)m +(um)m(b)s(er)d(from)g(a)j(string)f(in)g(memory)-8 b(.)50 +b(The)34 b Fp(flags)e Fr(are)j(parameters)e(whic)m(h)h(a\013ect)i(the) +450 4902 y(input)31 b(syn)m(tax.)46 b(The)31 b(string)h(starts)g(at)h +Fp(string)d Fr(and)i(ends)f(at)h Fp(string_limit)d Fr(\(exclusiv)m(e)34 +b(limit\).)450 5011 y Fp(string_limit)29 b Fr(ma)m(y)i(also)i(b)s(e)f +Fp(NULL)p Fr(,)f(denoting)i(the)f(en)m(tire)h(string,)g(i.e.)47 +b(equiv)-5 b(alen)m(t)33 b(to)g Fp(string_)450 5121 y(limit)c(=)h +(string)f(+)h(strlen\(string\))p Fr(.)75 b(If)42 b Fp(end_of_parse)e +Fr(is)j Fp(NULL)p Fr(,)j(the)d(string)g(in)g(memory)450 +5230 y(m)m(ust)30 b(con)m(tain)j(exactly)g(one)f(n)m(um)m(b)s(er)d(and) +i(nothing)g(more,)g(else)i(a)f(fatal)g(error)f(will)h(b)s(e)f +(signalled.)450 5340 y(If)37 b Fp(end_of_parse)d Fr(is)k(not)g +Fp(NULL)p Fr(,)g Fp(*end_of_parse)c Fr(will)k(b)s(e)f(assigned)h(a)g(p) +s(oin)m(ter)g(past)f(the)h(last)p eop +%%Page: 30 32 +30 31 bop -30 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2844 +b(30)450 299 y(parsed)32 b(c)m(haracter)h(\(i.e.)48 b +Fp(string_limit)29 b Fr(if)j(nothing)g(came)g(after)h(the)g(n)m(um)m(b) +s(er\).)44 b(Whitespace)34 b(is)450 408 y(not)d(allo)m(w)m(ed.)-30 +565 y(The)f(structure)g Fp(cl_read_flags)d Fr(con)m(tains)k(the)g +(follo)m(wing)g(\014elds:)-30 721 y Fp(cl_read_syntax_t)26 +b(syntax)450 830 y Fr(The)i(p)s(ossible)f(results)h(of)g(the)h(read)f +(op)s(eration.)40 b(P)m(ossible)29 b(v)-5 b(alues)28 +b(are)h Fp(syntax_number)p Fr(,)c Fp(syntax_)450 940 +y(real)p Fr(,)49 b Fp(syntax_rational)p Fr(,)e Fp(syntax_integer)p Fr(,)g Fp(syntax_float)p Fr(,)g Fp(syntax_sfloat)p Fr(,)g -Fp(syntax_)480 4643 y(ffloat)p Fr(,)29 b Fp(syntax_dfloat)p -Fr(,)e Fp(syntax_lfloat)p Fr(.)0 4805 y Fp(cl_read_lsyntax_t)f(lsyntax) -480 4929 y Fr(Sp)s(eci\014es)e(the)i(language-dep)s(enden)m(t)g(syn)m -(tax)f(v)-5 b(arian)m(t)26 b(for)f(the)g(read)g(op)s(eration.)40 -b(P)m(ossible)26 b(v)-5 b(alues)480 5054 y(are)480 5215 -y Fp(lsyntax_standard)960 5340 y Fr(accept)32 b(standard)d(algebraic)j -(notation)g(only)-8 b(,)31 b(no)g(complex)f(n)m(um)m(b)s(ers,)p -eop -%%Page: 40 42 -40 41 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(40)480 366 y Fp(lsyntax_algebraic)960 491 y Fr(accept)32 -b(the)e(algebraic)i(notation)g Fk(x)6 b Fp(+)p Fk(y)i -Fp(i)30 b Fr(for)g(complex)g(n)m(um)m(b)s(ers,)480 679 -y Fp(lsyntax_commonlisp)960 804 y Fr(accept)44 b(the)f -Fp(#b)p Fr(,)i Fp(#o)p Fr(,)g Fp(#x)d Fr(syn)m(taxes)h(for)g(binary)-8 -b(,)45 b(o)s(ctal,)i(hexadecimal)c(n)m(um)m(b)s(ers,)960 -928 y Fp(#)p Fk(base)5 b Fp(R)42 b Fr(for)g(rational)h(n)m(um)m(b)s -(ers)d(in)h(a)i(giv)m(en)g(base,)i Fp(#c\()p Fk(realpart)33 -b(imagpart)r Fp(\))41 b Fr(for)960 1053 y(complex)30 -b(n)m(um)m(b)s(ers,)480 1241 y Fp(lsyntax_all)960 1365 -y Fr(accept)i(all)f(of)g(these)f(extensions.)0 1553 y -Fp(unsigned)e(int)i(rational_base)480 1678 y Fr(The)g(base)g(in)g(whic) -m(h)h(rational)g(n)m(um)m(b)s(ers)d(are)j(read.)0 1866 -y Fp(cl_float_format_t)26 b(float_flags.default_flo)o(at_f)o(orm)o(at) -480 1990 y Fr(The)k(\015oat)h(format)f(used)f(when)h(reading)g +Fp(syntax_)450 1050 y(ffloat)p Fr(,)29 b Fp(syntax_dfloat)p +Fr(,)e Fp(syntax_lfloat)p Fr(.)-30 1206 y Fp(cl_read_lsyntax_t)f +(lsyntax)450 1315 y Fr(Sp)s(eci\014es)31 b(the)g(language-dep)s(enden)m +(t)h(syn)m(tax)g(v)-5 b(arian)m(t)32 b(for)f(the)h(read)f(op)s +(eration.)43 b(P)m(ossible)33 b(v)-5 b(alues)450 1425 +y(are)450 1581 y Fp(lsyntax_standard)930 1691 y Fr(accept)32 +b(standard)d(algebraic)j(notation)g(only)-8 b(,)31 b(no)g(complex)f(n)m +(um)m(b)s(ers,)450 1847 y Fp(lsyntax_algebraic)930 1957 +y Fr(accept)i(the)e(algebraic)i(notation)g Fl(x)6 b Fp(+)p +Fl(y)i Fp(i)30 b Fr(for)g(complex)g(n)m(um)m(b)s(ers,)450 +2113 y Fp(lsyntax_commonlisp)930 2222 y Fr(accept)49 +b(the)g Fp(#b)p Fr(,)j Fp(#o)p Fr(,)g Fp(#x)47 b Fr(syn)m(taxes)i(for)f +(binary)-8 b(,)52 b(o)s(ctal,)i(hexadecimal)48 b(n)m(um)m(b)s(ers,)930 +2332 y Fp(#)p Fl(base)5 b Fp(R)25 b Fr(for)f(rational)i(n)m(um)m(b)s +(ers)d(in)h(a)i(giv)m(en)g(base,)g Fp(#c\()p Fl(realpart)32 +b(imagpart)r Fp(\))24 b Fr(for)h(com-)930 2441 y(plex)30 +b(n)m(um)m(b)s(ers,)450 2598 y Fp(lsyntax_all)930 2707 +y Fr(accept)i(all)f(of)g(these)f(extensions.)-30 2863 +y Fp(unsigned)e(int)i(rational_base)450 2973 y Fr(The)g(base)g(in)g +(whic)m(h)h(rational)g(n)m(um)m(b)s(ers)d(are)j(read.)-30 +3129 y Fp(cl_float_format_t)26 b(float_flags.default_flo)o(at_f)o(orm)o +(at)450 3239 y Fr(The)k(\015oat)h(format)f(used)f(when)h(reading)g (\015oats)h(with)f(exp)s(onen)m(t)g(mark)m(er)g(`)p Fp(e)p -Fr('.)0 2178 y Fp(cl_float_format_t)c(float_flags.default_lfl)o(oat_)o -(for)o(mat)480 2303 y Fr(The)k(\015oat)h(format)f(used)f(when)h +Fr('.)-30 3395 y Fp(cl_float_format_t)c(float_flags.default_lfl)o(oat_) +o(for)o(mat)450 3505 y Fr(The)k(\015oat)h(format)f(used)f(when)h (reading)g(\015oats)h(with)f(exp)s(onen)m(t)g(mark)m(er)g(`)p -Fp(l)p Fr('.)0 2491 y Fp(cl_boolean)e(float_flags.mantissa_de)o(pen)o -(dent)o(_flo)o(at_)o(form)o(at)480 2615 y Fr(When)k(this)g(\015ag)g(is) -g(true,)g(\015oats)h(sp)s(eci\014ed)e(with)g(more)g(digits)i(than)f -(corresp)s(onding)f(to)h(the)g(ex-)480 2740 y(p)s(onen)m(t)25 -b(mark)m(er)f(they)i(con)m(tain,)h(but)e(without)p 2123 -2740 28 4 v 58 w Fk(nnn)f Fr(su\016x,)h(will)h(get)g(a)g(precision)f -(corresp)s(onding)480 2864 y(to)31 b(their)g(n)m(um)m(b)s(er)d(of)i -(signi\014can)m(t)h(digits.)0 3374 y Fs(5.3)68 b(Output)30 -b(functions)0 3655 y Fr(Including)40 b Fp()d -Fr(de\014nes)j(a)h(t)m(yp)s(e)f Fp(cl_ostream)p Fr(,)h(whic)m(h)f(is)g -(the)h(t)m(yp)s(e)f(of)h(the)f(\014rst)g(argumen)m(t)g(to)h(all)0 -3780 y(output)e(functions.)66 b(Unless)39 b(y)m(ou)g(build)f(and)g(use) -h(CLN)f(with)h(the)g(macro)g(CL)p 2847 3780 V 32 w(IO)p -2983 3780 V 32 w(STDIO)f(b)s(eing)h(de\014ned,)0 3904 -y Fp(cl_ostream)28 b Fr(is)i(the)h(same)e(as)i Fp(ostream&)p -Fr(.)0 4185 y(The)f(v)-5 b(ariable)180 4466 y Fp(cl_ostream)28 -b(cl_stdout)0 4778 y Fr(con)m(tains)k(the)e(standard)g(output)g -(stream.)0 5059 y(The)g(v)-5 b(ariable)180 5340 y Fp(cl_ostream)28 -b(cl_stderr)p eop -%%Page: 41 43 -41 42 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(41)0 366 y(con)m(tains)32 b(the)e(standard)g(error)g(output)g -(stream.)0 643 y(These)g(are)h(the)f(simple)g(output)g(functions:)0 -948 y Fp(void)f(fprintchar)f(\(cl_ostream)f(stream,)h(char)i(c\))480 -1072 y Fr(Prin)m(ts)g(the)h(c)m(haracter)h Fp(x)e Fr(literally)i(on)e -(the)h Fp(stream)p Fr(.)0 1252 y Fp(void)e(fprint)g(\(cl_ostream)e -(stream,)i(const)f(char)i(*)g(string\))480 1376 y Fr(Prin)m(ts)g(the)h +Fp(l)p Fr('.)-30 3661 y Fp(cl_boolean)e(float_flags.mantissa_de)o(pen)o +(dent)o(_flo)o(at_)o(form)o(at)450 3770 y Fr(When)h(this)g(\015ag)h(is) +f(true,)g(\015oats)h(sp)s(eci\014ed)e(with)h(more)g(digits)g(than)g +(corresp)s(onding)g(to)g(the)h(exp)s(o-)450 3880 y(nen)m(t)g(mark)m(er) +e(they)i(con)m(tain,)h(but)e(without)p 2018 3880 28 4 +v 62 w Fl(nnn)e Fr(su\016x,)i(will)h(get)h(a)e(precision)h(corresp)s +(onding)e(to)450 3990 y(their)i(n)m(um)m(b)s(er)e(of)j(signi\014can)m +(t)g(digits.)-30 4242 y Fs(5.3)68 b(Output)45 b(functions)-30 +4433 y Fr(Including)24 b Fp()f Fr(de\014nes)h(a)h(t)m(yp)s(e)g +Fp(cl_ostream)p Fr(,)f(whic)m(h)g(is)h(the)h(t)m(yp)s(e)f(of)g(the)g +(\014rst)f(argumen)m(t)h(to)g(all)h(output)-30 4543 y(functions.)40 +b(Unless)28 b(y)m(ou)h(build)f(and)g(use)g(CLN)h(with)f(the)h(macro)f +(CL)p 2391 4543 V 32 w(IO)p 2527 4543 V 33 w(STDIO)f(b)s(eing)i +(de\014ned,)f Fp(cl_ostream)-30 4652 y Fr(is)i(the)h(same)f(as)g +Fp(ostream&)p Fr(.)-30 4785 y(The)g(v)-5 b(ariable)150 +4918 y Fp(cl_ostream)28 b(cl_stdout)-30 5074 y Fr(con)m(tains)k(the)e +(standard)g(output)g(stream.)-30 5207 y(The)g(v)-5 b(ariable)150 +5340 y Fp(cl_ostream)28 b(cl_stderr)p eop +%%Page: 31 33 +31 32 bop -30 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2844 +b(31)-30 299 y(con)m(tains)32 b(the)e(standard)g(error)g(output)g +(stream.)-30 444 y(These)g(are)h(the)f(simple)g(output)g(functions:)-30 +618 y Fp(void)f(fprintchar)f(\(cl_ostream)f(stream,)h(char)i(c\))450 +728 y Fr(Prin)m(ts)g(the)h(c)m(haracter)h Fp(x)e Fr(literally)i(on)e +(the)h Fp(stream)p Fr(.)-30 897 y Fp(void)e(fprint)g(\(cl_ostream)e +(stream,)i(const)f(char)i(*)g(string\))450 1007 y Fr(Prin)m(ts)g(the)h Fp(string)d Fr(literally)33 b(on)d(the)g Fp(stream)p -Fr(.)0 1556 y Fp(void)f(fprintdecimal)e(\(cl_ostream)g(stream,)i(int)g -(x\))0 1681 y(void)g(fprintdecimal)e(\(cl_ostream)g(stream,)i(const)g -(cl_I&)g(x\))480 1805 y Fr(Prin)m(ts)h(the)h(in)m(teger)h -Fp(x)e Fr(in)g(decimal)g(on)g(the)h Fp(stream)p Fr(.)0 -1985 y Fp(void)e(fprintbinary)e(\(cl_ostream)h(stream,)g(const)h(cl_I&) -g(x\))480 2110 y Fr(Prin)m(ts)h(the)h(in)m(teger)h Fp(x)e +Fr(.)-30 1176 y Fp(void)f(fprintdecimal)e(\(cl_ostream)g(stream,)i(int) +g(x\))-30 1286 y(void)g(fprintdecimal)e(\(cl_ostream)g(stream,)i(const) +g(cl_I&)g(x\))450 1396 y Fr(Prin)m(ts)h(the)h(in)m(teger)h +Fp(x)e Fr(in)g(decimal)g(on)g(the)h Fp(stream)p Fr(.)-30 +1565 y Fp(void)e(fprintbinary)e(\(cl_ostream)h(stream,)g(const)h(cl_I&) +g(x\))450 1675 y Fr(Prin)m(ts)h(the)h(in)m(teger)h Fp(x)e Fr(in)g(binary)f(\(base)i(2,)g(without)g(pre\014x\))e(on)h(the)h -Fp(stream)p Fr(.)0 2289 y Fp(void)e(fprintoctal)f(\(cl_ostream)f -(stream,)h(const)h(cl_I&)g(x\))480 2414 y Fr(Prin)m(ts)h(the)h(in)m +Fp(stream)p Fr(.)-30 1844 y Fp(void)e(fprintoctal)f(\(cl_ostream)f +(stream,)h(const)h(cl_I&)g(x\))450 1954 y Fr(Prin)m(ts)h(the)h(in)m (teger)h Fp(x)e Fr(in)g(o)s(ctal)h(\(base)g(8,)g(without)g(pre\014x\))e -(on)i(the)f Fp(stream)p Fr(.)0 2594 y Fp(void)f(fprinthexadecimal)d -(\(cl_ostream)h(stream,)i(const)f(cl_I&)h(x\))480 2718 +(on)i(the)f Fp(stream)p Fr(.)-30 2123 y Fp(void)f(fprinthexadecimal)d +(\(cl_ostream)h(stream,)i(const)f(cl_I&)h(x\))450 2233 y Fr(Prin)m(ts)h(the)h(in)m(teger)h Fp(x)e Fr(in)g(hexadecimal)g (\(base)h(16,)h(without)e(pre\014x\))g(on)g(the)h Fp(stream)p -Fr(.)0 3023 y(Eac)m(h)k(of)g(the)g(classes)g Fp(cl_N)p -Fr(,)g Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)f Fp(cl_I)p Fr(,)h -Fp(cl_F)p Fr(,)f Fp(cl_SF)p Fr(,)h Fp(cl_FF)p Fr(,)f -Fp(cl_DF)p Fr(,)h Fp(cl_LF)e Fr(de\014nes,)i(in)f Fp()p Fr(,)29 b(the)i(follo)m(wing)h -(output)e(functions:)0 3451 y Fp(void)f(fprint)g(\(cl_ostream)e -(stream,)i(const)f Fk(t)m(yp)s(e)5 b Fp(&)31 b(x\))0 -3576 y(cl_ostream)d(operator<<)f(\(cl_ostream)g(stream,)i(const)g -Fk(t)m(yp)s(e)5 b Fp(&)30 b(x\))480 3700 y Fr(Prin)m(ts)38 -b(the)h(n)m(um)m(b)s(er)d Fp(x)i Fr(on)g(the)h Fp(stream)p -Fr(.)63 b(The)38 b(output)g(ma)m(y)g(dep)s(end)f(on)h(the)h(global)g -(prin)m(ter)480 3825 y(settings)k(in)e(the)h(v)-5 b(ariable)43 -b Fp(cl_default_print_flags)p Fr(.)69 b(The)42 b Fp(ostream)e -Fr(\015ags)i(and)f(settings)480 3950 y(\(\015ags,)31 -b(width)f(and)g(lo)s(cale\))i(are)f(ignored.)0 4254 y(The)f(most)g -(\015exible)g(output)g(function,)g(de\014ned)g(in)g Fp()p Fr(,)28 b(are)j(the)f(follo)m(wing:)240 -4510 y Fp(void)47 b(print_complex)92 b(\(cl_ostream)44 -b(stream,)i(const)g(cl_print_flags&)e(flags,)1242 4614 -y(const)j(cl_N&)f(z\);)240 4717 y(void)h(print_real)236 -b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)1242 -4821 y(const)j(cl_R&)f(z\);)240 4925 y(void)h(print_float)188 -b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)1242 -5029 y(const)j(cl_F&)f(z\);)240 5132 y(void)h(print_rational)d -(\(cl_ostream)g(stream,)i(const)g(cl_print_flags&)e(flags,)1242 -5236 y(const)j(cl_RA&)f(z\);)240 5340 y(void)h(print_integer)92 -b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)p -eop -%%Page: 42 44 -42 43 bop 0 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2784 -b(42)1242 366 y Fp(const)47 b(cl_I&)f(z\);)0 640 y Fr(Prin)m(ts)30 +Fr(.)-30 2408 y(Eac)m(h)39 b(of)f(the)g(classes)h Fp(cl_N)p +Fr(,)g Fp(cl_R)p Fr(,)g Fp(cl_RA)p Fr(,)g Fp(cl_I)p Fr(,)g +Fp(cl_F)p Fr(,)g Fp(cl_SF)p Fr(,)g Fp(cl_FF)p Fr(,)g +Fp(cl_DF)p Fr(,)f Fp(cl_LF)f Fr(de\014nes,)i(in)f Fp()p Fr(,)29 b(the)i(follo)m(wing)h +(output)e(functions:)-30 2692 y Fp(void)f(fprint)g(\(cl_ostream)e +(stream,)i(const)f Fl(t)m(yp)s(e)5 b Fp(&)31 b(x\))-30 +2801 y(cl_ostream)d(operator<<)f(\(cl_ostream)g(stream,)i(const)g +Fl(t)m(yp)s(e)5 b Fp(&)30 b(x\))450 2911 y Fr(Prin)m(ts)42 +b(the)g(n)m(um)m(b)s(er)e Fp(x)i Fr(on)g(the)g Fp(stream)p +Fr(.)75 b(The)41 b(output)h(ma)m(y)g(dep)s(end)e(on)i(the)h(global)g +(prin)m(ter)450 3021 y(settings)23 b(in)e(the)h(v)-5 +b(ariable)22 b Fp(cl_default_print_flags)p Fr(.)32 b(The)21 +b Fp(ostream)f Fr(\015ags)h(and)h(settings)g(\(\015ags,)450 +3130 y(width)30 b(and)f(lo)s(cale\))k(are)e(ignored.)-30 +3305 y(The)f(most)g(\015exible)g(output)g(function,)g(de\014ned)g(in)g +Fp()p Fr(,)28 b(are)j(the)f(follo)m +(wing:)210 3444 y Fp(void)47 b(print_complex)92 b(\(cl_ostream)44 +b(stream,)i(const)g(cl_print_flags&)e(flags,)1212 3548 +y(const)j(cl_N&)f(z\);)210 3651 y(void)h(print_real)236 +b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)1212 +3755 y(const)j(cl_R&)f(z\);)210 3859 y(void)h(print_float)188 +b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)1212 +3963 y(const)j(cl_F&)f(z\);)210 4066 y(void)h(print_rational)d +(\(cl_ostream)g(stream,)i(const)g(cl_print_flags&)e(flags,)1212 +4170 y(const)j(cl_RA&)f(z\);)210 4274 y(void)h(print_integer)92 +b(\(cl_ostream)44 b(stream,)i(const)g(cl_print_flags&)e(flags,)1212 +4378 y(const)j(cl_I&)f(z\);)-30 4522 y Fr(Prin)m(ts)30 b(the)h(n)m(um)m(b)s(er)d Fp(x)i Fr(on)g(the)h Fp(stream)p Fr(.)39 b(The)30 b Fp(flags)f Fr(are)h(parameters)g(whic)m(h)g -(a\013ect)i(the)f(output.)0 914 y(The)f(structure)g(t)m(yp)s(e)g -Fp(cl_print_flags)d Fr(con)m(tains)k(the)g(follo)m(wing)h(\014elds:)0 -1213 y Fp(unsigned)c(int)i(rational_base)480 1338 y Fr(The)g(base)g(in) +(a\013ect)i(the)f(output.)-30 4667 y(The)f(structure)g(t)m(yp)s(e)g +Fp(cl_print_flags)d Fr(con)m(tains)k(the)g(follo)m(wing)h(\014elds:)-30 +4842 y Fp(unsigned)c(int)i(rational_base)450 4951 y Fr(The)g(base)g(in) g(whic)m(h)h(rational)g(n)m(um)m(b)s(ers)d(are)j(prin)m(ted.)40 -b(Default)32 b(is)e Fp(10)p Fr(.)0 1512 y Fp(cl_boolean)e -(rational_readably)480 1637 y Fr(If)i(this)h(\015ag)g(is)g(true,)g -(rational)h(n)m(um)m(b)s(ers)c(are)j(prin)m(ted)f(with)h(radix)f(sp)s -(eci\014ers)g(in)g(Common)f(Lisp)480 1761 y(syn)m(tax)i(\()p -Fp(#)p Fk(n)p Fp(R)f Fr(or)g Fp(#b)g Fr(or)g Fp(#o)g +b(Default)32 b(is)e Fp(10)p Fr(.)-30 5121 y Fp(cl_boolean)e +(rational_readably)450 5230 y Fr(If)34 b(this)h(\015ag)h(is)f(true,)h +(rational)g(n)m(um)m(b)s(ers)c(are)k(prin)m(ted)e(with)h(radix)f(sp)s +(eci\014ers)h(in)f(Common)f(Lisp)450 5340 y(syn)m(tax)e(\()p +Fp(#)p Fl(n)p Fp(R)f Fr(or)g Fp(#b)g Fr(or)g Fp(#o)g Fr(or)g Fp(#x)g Fr(pre\014xes,)g(trailing)h(dot\).)41 -b(Default)32 b(is)e(false.)0 1936 y Fp(cl_boolean)e(float_readably)480 -2060 y Fr(If)i(this)g(\015ag)g(is)g(true,)h(t)m(yp)s(e)f(sp)s(eci\014c) -g(exp)s(onen)m(t)g(mark)m(ers)f(ha)m(v)m(e)j(precedence)e(o)m(v)m(er)i -('E'.)f(Default)g(is)480 2185 y(false.)0 2359 y Fp(cl_float_format_t)26 -b(default_float_format)480 2484 y Fr(Floating)35 b(p)s(oin)m(t)e(n)m -(um)m(b)s(ers)d(of)j(this)g(format)g(will)g(b)s(e)f(prin)m(ted)h(using) -f(the)h('E')g(exp)s(onen)m(t)g(mark)m(er.)480 2608 y(Default)e(is)g -Fp(cl_float_format_ffloat)p Fr(.)0 2782 y Fp(cl_boolean)d -(complex_readably)480 2907 y Fr(If)37 b(this)f(\015ag)i(is)f(true,)h -(complex)f(n)m(um)m(b)s(ers)e(will)i(b)s(e)f(prin)m(ted)h(using)f(the)i -(Common)c(Lisp)i(syn)m(tax)480 3031 y Fp(#C\()p Fk(realpart)c(imagpart) -r Fp(\))p Fr(.)40 b(Default)32 b(is)e(false.)0 3206 y -Fp(cl_string)e(univpoly_varname)480 3330 y Fr(Univ)-5 -b(ariate)31 b(p)s(olynomials)f(with)f(no)h(explicit)h(indeterminate)f -(name)f(will)i(b)s(e)e(prin)m(ted)h(using)f(this)480 -3455 y(v)-5 b(ariable)31 b(name.)40 b(Default)31 b(is)g -Fp("x")p Fr(.)0 3754 y(The)38 b(global)i(v)-5 b(ariable)40 -b Fp(cl_default_print_flags)32 b Fr(con)m(tains)40 b(the)f(default)g(v) --5 b(alues,)41 b(used)d(b)m(y)g(the)h(function)0 3878 -y Fp(fprint)p Fr(.)p eop -%%Page: 43 45 -43 44 bop 0 -116 a Fr(Chapter)30 b(6:)41 b(Rings)3120 -b(43)0 366 y Fo(6)80 b(Rings)0 754 y Fr(CLN)30 b(has)g(a)h(class)g(of)g -(abstract)g(rings.)1433 1010 y Fp(Ring)1338 1113 y(cl_ring)1290 -1217 y()0 1494 y Fr(Rings)f(can)h(b)s(e)f(compared)f(for)h -(equalit)m(y:)0 1798 y Fp(bool)f(operator==)f(\(const)g(cl_ring&,)g -(const)h(cl_ring&\))0 1923 y(bool)g(operator!=)f(\(const)g(cl_ring&,)g -(const)h(cl_ring&\))480 2047 y Fr(These)h(compare)g(t)m(w)m(o)i(rings)e -(for)g(equalit)m(y)-8 b(.)0 2352 y(Giv)m(en)31 b(a)g(ring)f +b(Default)32 b(is)e(false.)p eop +%%Page: 32 34 +32 33 bop -30 -116 a Fr(Chapter)30 b(5:)41 b(Input/Output)2844 +b(32)-30 299 y Fp(cl_boolean)28 b(float_readably)450 +408 y Fr(If)34 b(this)g(\015ag)h(is)f(true,)i(t)m(yp)s(e)e(sp)s +(eci\014c)g(exp)s(onen)m(t)h(mark)m(ers)e(ha)m(v)m(e)j(precedence)f(o)m +(v)m(er)g('E'.)g(Default)h(is)450 518 y(false.)-30 677 +y Fp(cl_float_format_t)26 b(default_float_format)450 +787 y Fr(Floating)40 b(p)s(oin)m(t)d(n)m(um)m(b)s(ers)e(of)j(this)f +(format)g(will)h(b)s(e)f(prin)m(ted)g(using)g(the)h('E')g(exp)s(onen)m +(t)f(mark)m(er.)450 897 y(Default)31 b(is)g Fp(cl_float_format_ffloat)p +Fr(.)-30 1056 y Fp(cl_boolean)d(complex_readably)450 +1166 y Fr(If)41 b(this)g(\015ag)g(is)h(true,)i(complex)c(n)m(um)m(b)s +(ers)f(will)j(b)s(e)e(prin)m(ted)h(using)g(the)g(Common)e(Lisp)h(syn)m +(tax)450 1275 y Fp(#C\()p Fl(realpart)32 b(imagpart)r +Fp(\))p Fr(.)40 b(Default)32 b(is)e(false.)-30 1435 y +Fp(cl_string)e(univpoly_varname)450 1544 y Fr(Univ)-5 +b(ariate)37 b(p)s(olynomials)d(with)i(no)f(explicit)i(indeterminate)e +(name)f(will)i(b)s(e)f(prin)m(ted)g(using)g(this)450 +1654 y(v)-5 b(ariable)31 b(name.)40 b(Default)31 b(is)g +Fp("x")p Fr(.)-30 1813 y(The)43 b(global)j(v)-5 b(ariable)45 +b Fp(cl_default_print_flags)37 b Fr(con)m(tains)46 b(the)e(default)g(v) +-5 b(alues,)48 b(used)43 b(b)m(y)h(the)g(function)-30 +1923 y Fp(fprint)p Fr(.)p eop +%%Page: 33 35 +33 34 bop -30 -116 a Fr(Chapter)30 b(6:)41 b(Rings)3180 +b(33)-30 299 y Fo(6)80 b(Rings)-30 533 y Fr(CLN)30 b(has)g(a)h(class)g +(of)g(abstract)g(rings.)1403 662 y Fp(Ring)1308 765 y(cl_ring)1260 +869 y()-30 1004 y Fr(Rings)f(can)h(b)s(e)f(compared)f(for)h +(equalit)m(y:)-30 1163 y Fp(bool)f(operator==)f(\(const)g(cl_ring&,)g +(const)h(cl_ring&\))-30 1273 y(bool)g(operator!=)f(\(const)g(cl_ring&,) +g(const)h(cl_ring&\))450 1382 y Fr(These)h(compare)g(t)m(w)m(o)i(rings) +e(for)g(equalit)m(y)-8 b(.)-30 1542 y(Giv)m(en)31 b(a)g(ring)f Fp(R)p Fr(,)g(the)h(follo)m(wing)h(mem)m(b)s(ers)27 b(can)k(b)s(e)f -(used.)0 2656 y Fp(void)f(R->fprint)f(\(cl_ostream)f(stream,)i(const)g -(cl_ring_element&)d(x\))0 2780 y(cl_boolean)i(R->equal)g(\(const)g -(cl_ring_element&)e(x,)k(const)f(cl_ring_element&)d(y\))0 -2905 y(cl_ring_element)g(R->zero)j(\(\))0 3030 y(cl_boolean)f(R->zerop) -g(\(const)g(cl_ring_element&)e(x\))0 3154 y(cl_ring_element)g(R->plus)j -(\(const)f(cl_ring_element&)e(x,)k(const)f(cl_ring_element&)d(y\))0 -3279 y(cl_ring_element)g(R->minus)i(\(const)h(cl_ring_element&)d(x,)k -(const)f(cl_ring_element&)d(y\))0 3403 y(cl_ring_element)g(R->uminus)i -(\(const)h(cl_ring_element&)d(x\))0 3528 y(cl_ring_element)g(R->one)j -(\(\))0 3652 y(cl_ring_element)d(R->canonhom)i(\(const)g(cl_I&)h(x\))0 -3777 y(cl_ring_element)d(R->mul)j(\(const)g(cl_ring_element&)c(x,)30 -b(const)f(cl_ring_element&)d(y\))0 3901 y(cl_ring_element)g(R->square)i -(\(const)h(cl_ring_element&)d(x\))0 4026 y(cl_ring_element)g -(R->expt_pos)i(\(const)g(cl_ring_element&)e(x,)k(const)f(cl_I&)g(y\))0 -4302 y Fr(The)h(follo)m(wing)i(rings)e(are)g(built-in.)0 -4607 y Fp(cl_null_ring)d(cl_0_ring)480 4731 y Fr(The)j(n)m(ull)g(ring,) -h(con)m(taining)g(only)g(zero.)0 4911 y Fp(cl_complex_ring)26 -b(cl_C_ring)480 5036 y Fr(The)k(ring)g(of)h(complex)f(n)m(um)m(b)s +(used.)-30 1701 y Fp(void)f(R->fprint)f(\(cl_ostream)f(stream,)i(const) +g(cl_ring_element&)d(x\))-30 1811 y(cl_boolean)i(R->equal)g(\(const)g +(cl_ring_element&)e(x,)k(const)f(cl_ring_element&)d(y\))-30 +1920 y(cl_ring_element)g(R->zero)j(\(\))-30 2030 y(cl_boolean)f +(R->zerop)g(\(const)g(cl_ring_element&)e(x\))-30 2139 +y(cl_ring_element)g(R->plus)j(\(const)f(cl_ring_element&)e(x,)k(const)f +(cl_ring_element&)d(y\))-30 2249 y(cl_ring_element)g(R->minus)i +(\(const)h(cl_ring_element&)d(x,)k(const)f(cl_ring_element&)d(y\))-30 +2359 y(cl_ring_element)g(R->uminus)i(\(const)h(cl_ring_element&)d(x\)) +-30 2468 y(cl_ring_element)g(R->one)j(\(\))-30 2578 y(cl_ring_element)d +(R->canonhom)h(\(const)i(cl_I&)g(x\))-30 2687 y(cl_ring_element)d +(R->mul)j(\(const)g(cl_ring_element&)c(x,)30 b(const)f +(cl_ring_element&)d(y\))-30 2797 y(cl_ring_element)g(R->square)i +(\(const)h(cl_ring_element&)d(x\))-30 2907 y(cl_ring_element)g +(R->expt_pos)h(\(const)i(cl_ring_element&)d(x,)k(const)f(cl_I&)g(y\)) +-30 3041 y Fr(The)h(follo)m(wing)i(rings)e(are)g(built-in.)-30 +3200 y Fp(cl_null_ring)d(cl_0_ring)450 3310 y Fr(The)j(n)m(ull)g(ring,) +h(con)m(taining)g(only)g(zero.)-30 3469 y Fp(cl_complex_ring)26 +b(cl_C_ring)450 3579 y Fr(The)k(ring)g(of)h(complex)f(n)m(um)m(b)s (ers.)38 b(This)29 b(corresp)s(onds)g(to)j(the)e(t)m(yp)s(e)h -Fp(cl_N)p Fr(.)0 5215 y Fp(cl_real_ring)c(cl_R_ring)480 -5340 y Fr(The)j(ring)g(of)h(real)g(n)m(um)m(b)s(ers.)38 +Fp(cl_N)p Fr(.)-30 3738 y Fp(cl_real_ring)c(cl_R_ring)450 +3848 y Fr(The)j(ring)g(of)h(real)g(n)m(um)m(b)s(ers.)38 b(This)29 b(corresp)s(onds)g(to)i(the)g(t)m(yp)s(e)g -Fp(cl_R)p Fr(.)p eop -%%Page: 44 46 -44 45 bop 0 -116 a Fr(Chapter)30 b(6:)41 b(Rings)3120 -b(44)0 366 y Fp(cl_rational_ring)26 b(cl_RA_ring)480 -491 y Fr(The)k(ring)g(of)h(rational)g(n)m(um)m(b)s(ers.)38 +Fp(cl_R)p Fr(.)-30 4007 y Fp(cl_rational_ring)26 b(cl_RA_ring)450 +4117 y Fr(The)k(ring)g(of)h(rational)g(n)m(um)m(b)s(ers.)38 b(This)30 b(corresp)s(onds)f(to)i(the)g(t)m(yp)s(e)f -Fp(cl_RA)p Fr(.)0 665 y Fp(cl_integer_ring)c(cl_I_ring)480 -790 y Fr(The)k(ring)g(of)h(in)m(tegers.)41 b(This)30 +Fp(cl_RA)p Fr(.)-30 4276 y Fp(cl_integer_ring)c(cl_I_ring)450 +4386 y Fr(The)k(ring)g(of)h(in)m(tegers.)41 b(This)30 b(corresp)s(onds)f(to)i(the)g(t)m(yp)s(e)f Fp(cl_I)p -Fr(.)0 1089 y(T)m(yp)s(e)g(tests)h(can)g(b)s(e)e(p)s(erformed)f(for)i +Fr(.)-30 4545 y(T)m(yp)s(e)g(tests)h(can)g(b)s(e)e(p)s(erformed)f(for)i (an)m(y)h(of)g Fp(cl_C_ring)p Fr(,)d Fp(cl_R_ring)p Fr(,)g -Fp(cl_RA_ring)p Fr(,)g Fp(cl_I_ring)p Fr(:)0 1388 y Fp(cl_boolean)g -(instanceof)f(\(const)i(cl_number&)e(x,)j(const)f(cl_number_ring&)d -(R\))480 1512 y Fr(T)-8 b(ests)31 b(whether)f(the)g(giv)m(en)i(n)m(um)m -(b)s(er)c(is)i(an)g(elemen)m(t)h(of)g(the)f(n)m(um)m(b)s(er)e(ring)i -(R.)p eop -%%Page: 45 47 -45 46 bop 0 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 -b(in)m(tegers)2670 b(45)0 366 y Fo(7)80 b(Mo)t(dular)32 -b(in)l(tegers)0 1011 y Fs(7.1)68 b(Mo)t(dular)30 b(in)l(teger)i(rings)0 -1292 y Fr(CLN)24 b(implemen)m(ts)f(mo)s(dular)g(in)m(tegers,)k(i.e.)40 -b(in)m(tegers)26 b(mo)s(dulo)d(a)i(\014xed)f(in)m(teger)i(N.)f(The)g -(mo)s(dulus)d(is)i(explicitly)0 1417 y(part)34 b(of)f(ev)m(ery)i(mo)s -(dular)d(in)m(teger.)52 b(CLN)33 b(do)s(esn't)g(allo)m(w)i(y)m(ou)g(to) -f(\(acciden)m(tally\))j(mix)c(elemen)m(ts)h(of)f(di\013eren)m(t)0 -1541 y(mo)s(dular)20 b(rings,)k(e.g.)39 b Fp(\(3)30 b(mod)f(4\))h(+)g -(\(2)g(mod)f(5\))22 b Fr(will)g(result)g(in)g(a)h(run)m(time)e(error.) -37 b(\(Ideally)23 b(one)g(w)m(ould)f(imagine)0 1666 y(a)28 -b(generic)g(data)g(t)m(yp)s(e)f Fp(cl_MI\(N\))p Fr(,)f(but)g(C)p -Fp(++)g Fr(do)s(esn't)h(ha)m(v)m(e)i(generic)f(t)m(yp)s(es.)39 -b(So)28 b(one)f(has)g(to)h(liv)m(e)g(with)f(run)m(time)0 -1790 y(c)m(hec)m(ks.\))0 2072 y(The)j(class)h(of)g(mo)s(dular)d(in)m -(teger)k(rings)e(is)1433 2332 y Fp(Ring)1338 2436 y(cl_ring)1290 -2540 y()1481 2644 y(|)1481 2748 y(|)1051 2851 -y(Modular)46 b(integer)g(ring)1195 2955 y(cl_modint_ring)1147 -3059 y()0 3340 y Fr(and)30 b(the)g(class)h(of)g(all)g -(mo)s(dular)e(in)m(tegers)i(\(elemen)m(ts)g(of)g(mo)s(dular)d(in)m -(teger)k(rings\))e(is)1195 3601 y Fp(Modular)45 b(integer)1433 -3705 y(cl_MI)1147 3808 y()0 4090 y Fr(Mo)s(dular)30 -b(in)m(teger)i(rings)e(are)g(constructed)h(using)f(the)h(function)0 -4404 y Fp(cl_modint_ring)26 b(cl_find_modint_ring)g(\(const)i(cl_I&)h -(N\))480 4528 y Fr(This)23 b(function)h(returns)e(the)i(mo)s(dular)e -(ring)i(`)p Fp(Z/NZ)p Fr('.)37 b(It)24 b(tak)m(es)i(care)e(of)g -(\014nding)f(out)h(ab)s(out)f(sp)s(ecial)480 4653 y(cases)34 -b(of)f Fp(N)p Fr(,)g(lik)m(e)h(p)s(o)m(w)m(ers)f(of)g(t)m(w)m(o)i(and)d -(o)s(dd)g(n)m(um)m(b)s(ers)e(for)j(whic)m(h)f(Mon)m(tgomery)i(m)m -(ultiplication)480 4777 y(will)39 b(b)s(e)f(a)h(win,)h(and)e -(precomputes)f(an)m(y)h(necessary)h(auxiliary)h(data)f(for)f(computing) -g(mo)s(dulo)480 4902 y Fp(N)p Fr(.)45 b(There)32 b(is)f(a)i(cac)m(he)g -(table)g(of)f(rings,)g(indexed)g(b)m(y)g Fp(N)f Fr(\(or,)i(more)e -(precisely)-8 b(,)34 b(b)m(y)e Fp(abs\(N\))p Fr(\).)44 -b(This)480 5026 y(ensures)29 b(that)i(the)g(precomputation)f(costs)h -(are)g(reduced)e(to)j(a)e(minim)m(um.)0 5340 y(Mo)s(dular)g(in)m(teger) -i(rings)e(can)g(b)s(e)g(compared)f(for)i(equalit)m(y:)p -eop -%%Page: 46 48 -46 47 bop 0 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 -b(in)m(tegers)2670 b(46)0 366 y Fp(bool)29 b(operator==)f(\(const)g -(cl_modint_ring&,)e(const)j(cl_modint_ring&\))0 491 y(bool)g -(operator!=)f(\(const)g(cl_modint_ring&,)e(const)j(cl_modint_ring&\)) -480 616 y Fr(These)e(compare)g(t)m(w)m(o)h(mo)s(dular)e(in)m(teger)i -(rings)f(for)g(equalit)m(y)-8 b(.)42 b(Tw)m(o)27 b(di\013eren)m(t)h -(calls)g(to)g Fp(cl_find_)480 740 y(modint_ring)34 b -Fr(with)i(the)h(same)f(argumen)m(t)g(necessarily)h(return)f(the)h(same) -f(ring)g(b)s(ecause)h(it)g(is)480 865 y(memoized)29 b(in)h(the)h(cac)m -(he)h(table.)0 1318 y Fs(7.2)68 b(F)-11 b(unctions)30 -b(on)g(mo)t(dular)g(in)l(tegers)0 1593 y Fr(Giv)m(en)h(a)g(mo)s(dular)d -(in)m(teger)k(ring)e Fp(R)p Fr(,)h(the)f(follo)m(wing)i(mem)m(b)s(ers)c -(can)i(b)s(e)g(used.)0 1893 y Fp(cl_I)f(R->modulus)480 -2017 y Fr(This)h(is)g(the)h(ring's)f(mo)s(dulus,)e(normalized)i(to)h(b) -s(e)e(nonnegativ)m(e:)43 b Fp(abs\(N\))p Fr(.)0 2193 -y Fp(cl_MI)29 b(R->zero\(\))480 2317 y Fr(This)h(returns)f -Fp(0)h(mod)f(N)p Fr(.)0 2493 y Fp(cl_MI)g(R->one\(\))480 -2617 y Fr(This)h(returns)f Fp(1)h(mod)f(N)p Fr(.)0 2793 -y Fp(cl_MI)g(R->canonhom)e(\(const)i(cl_I&)g(x\))480 -2917 y Fr(This)h(returns)f Fp(x)h(mod)f(N)p Fr(.)0 3093 -y Fp(cl_I)g(R->retract)f(\(const)g(cl_MI&)h(x\))480 3217 -y Fr(This)20 b(is)h(a)g(partial)g(in)m(v)m(erse)h(function)e(to)i -Fp(R->canonhom)p Fr(.)34 b(It)21 b(returns)e(the)i(standard)f(represen) -m(tativ)m(e)480 3342 y(\()p Fp(>=0)p Fr(,)30 b Fp(random\(cl_random_stat) -o(e&)24 b(randomstate\))0 3642 y(cl_MI)29 b(R->random\(\))480 -3766 y Fr(This)h(returns)f(a)h(random)f(in)m(teger)j(mo)s(dulo)d -Fp(N)p Fr(.)0 4066 y(The)h(follo)m(wing)i(op)s(erations)e(are)h -(de\014ned)e(on)i(mo)s(dular)d(in)m(tegers.)0 4366 y -Fp(cl_modint_ring)e(x.ring)j(\(\))480 4491 y Fr(Returns)g(the)i(ring)f -(to)h(whic)m(h)f(the)h(mo)s(dular)d(in)m(teger)k Fp(x)e -Fr(b)s(elongs.)0 4666 y Fp(cl_MI)f(operator+)f(\(const)g(cl_MI&,)h -(const)g(cl_MI&\))480 4791 y Fr(Returns)j(the)h(sum)f(of)h(t)m(w)m(o)h -(mo)s(dular)d(in)m(tegers.)51 b(One)32 b(of)i(the)f(argumen)m(ts)f(ma)m -(y)h(also)h(b)s(e)f(a)g(plain)480 4915 y(in)m(teger.)0 -5091 y Fp(cl_MI)c(operator-)f(\(const)g(cl_MI&,)h(const)g(cl_MI&\))480 -5215 y Fr(Returns)k(the)h(di\013erence)h(of)f(t)m(w)m(o)i(mo)s(dular)c -(in)m(tegers.)53 b(One)33 b(of)i(the)f(argumen)m(ts)f(ma)m(y)h(also)h -(b)s(e)f(a)480 5340 y(plain)c(in)m(teger.)p eop -%%Page: 47 49 -47 48 bop 0 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 -b(in)m(tegers)2670 b(47)0 366 y Fp(cl_MI)29 b(operator-)f(\(const)g -(cl_MI&\))480 491 y Fr(Returns)h(the)i(negativ)m(e)i(of)d(a)h(mo)s -(dular)d(in)m(teger.)0 663 y Fp(cl_MI)h(operator*)f(\(const)g(cl_MI&,)h -(const)g(cl_MI&\))480 787 y Fr(Returns)37 b(the)i(pro)s(duct)e(of)h(t)m -(w)m(o)i(mo)s(dular)c(in)m(tegers.)65 b(One)38 b(of)g(the)h(argumen)m -(ts)e(ma)m(y)h(also)h(b)s(e)f(a)480 912 y(plain)30 b(in)m(teger.)0 -1084 y Fp(cl_MI)f(square)g(\(const)f(cl_MI&\))480 1208 -y Fr(Returns)h(the)i(square)f(of)h(a)f(mo)s(dular)f(in)m(teger.)0 -1380 y Fp(cl_MI)g(recip)g(\(const)g(cl_MI&)f(x\))480 -1505 y Fr(Returns)c(the)i(recipro)s(cal)f Fp(x^-1)f Fr(of)i(a)f(mo)s -(dular)e(in)m(teger)k Fp(x)p Fr(.)38 b Fp(x)25 b Fr(m)m(ust)f(b)s(e)h -(coprime)f(to)i(the)f(mo)s(dulus,)480 1629 y(otherwise)31 -b(an)f(error)g(message)h(is)f(issued.)0 1801 y Fp(cl_MI)f(div)g -(\(const)g(cl_MI&)g(x,)h(const)e(cl_MI&)h(y\))480 1926 -y Fr(Returns)j(the)h(quotien)m(t)h Fp(x*y^-1)e Fr(of)h(t)m(w)m(o)h(mo)s -(dular)d(in)m(tegers)j Fp(x)p Fr(,)g Fp(y)p Fr(.)48 b -Fp(y)33 b Fr(m)m(ust)e(b)s(e)i(coprime)f(to)i(the)480 -2050 y(mo)s(dulus,)28 b(otherwise)j(an)f(error)g(message)g(is)h -(issued.)0 2222 y Fp(cl_MI)e(expt_pos)f(\(const)h(cl_MI&)f(x,)i(const)f -(cl_I&)g(y\))480 2347 y(y)h Fr(m)m(ust)f(b)s(e)h Fp(>)g -Fr(0.)41 b(Returns)30 b Fp(x^y)p Fr(.)0 2519 y Fp(cl_MI)f(expt)g -(\(const)g(cl_MI&)f(x,)i(const)f(cl_I&)g(y\))480 2643 -y Fr(Returns)d Fp(x^y)p Fr(.)39 b(If)26 b Fp(y)h Fr(is)g(negativ)m(e,)j -Fp(x)d Fr(m)m(ust)f(b)s(e)h(coprime)f(to)i(the)f(mo)s(dulus,)e(else)j -(an)f(error)g(message)480 2768 y(is)j(issued.)0 2940 -y Fp(cl_MI)f(operator<<)f(\(const)g(cl_MI&)h(x,)h(const)f(cl_I&)f(y\)) -480 3064 y Fr(Returns)h Fp(x*2^y)p Fr(.)0 3236 y Fp(cl_MI)g(operator>>) -f(\(const)g(cl_MI&)h(x,)h(const)f(cl_I&)f(y\))480 3361 -y Fr(Returns)g Fp(x*2^-y)p Fr(.)38 b(When)29 b Fp(y)f -Fr(is)h(p)s(ositiv)m(e,)i(the)e(mo)s(dulus)d(m)m(ust)i(b)s(e)g(o)s(dd,) -g(or)h(an)g(error)f(message)h(is)480 3485 y(issued.)0 -3657 y Fp(bool)g(operator==)f(\(const)g(cl_MI&,)h(const)g(cl_MI&\))0 -3782 y(bool)g(operator!=)f(\(const)g(cl_MI&,)h(const)g(cl_MI&\))480 -3906 y Fr(Compares)24 b(t)m(w)m(o)i(mo)s(dular)d(in)m(tegers,)28 -b(b)s(elonging)e(to)f(the)h(same)e(mo)s(dular)f(in)m(teger)k(ring,)f -(for)f(equal-)480 4031 y(it)m(y)-8 b(.)0 4203 y Fp(cl_boolean)28 -b(zerop)h(\(const)f(cl_MI&)h(x\))480 4327 y Fr(Returns)g(true)i(if)f -Fp(x)g Fr(is)g Fp(0)g(mod)g(N)p Fr(.)0 4625 y(The)g(follo)m(wing)i -(output)e(functions)g(are)g(de\014ned)g(\(see)h(also)g(the)g(c)m -(hapter)g(on)f(input/output\).)0 4923 y Fp(void)f(fprint)g -(\(cl_ostream)e(stream,)i(const)f(cl_MI&)h(x\))0 5047 -y(cl_ostream)f(operator<<)f(\(cl_ostream)g(stream,)i(const)g(cl_MI&)f -(x\))480 5172 y Fr(Prin)m(ts)36 b(the)h(mo)s(dular)e(in)m(teger)j -Fp(x)e Fr(on)g(the)h Fp(stream)p Fr(.)57 b(The)36 b(output)h(ma)m(y)f -(dep)s(end)e(on)j(the)g(global)480 5296 y(prin)m(ter)30 -b(settings)h(in)f(the)h(v)-5 b(ariable)31 b Fp(cl_default_print_flags)p -Fr(.)p eop -%%Page: 48 50 -48 49 bop 0 -116 a Fr(Chapter)30 b(8:)41 b(Sym)m(b)s(olic)29 -b(data)i(t)m(yp)s(es)2536 b(48)0 366 y Fo(8)80 b(Sym)l(b)t(olic)31 -b(data)f(t)l(yp)t(es)0 784 y Fr(CLN)g(implemen)m(ts)f(t)m(w)m(o)j(sym)m -(b)s(olic)d(\(non-n)m(umeric\))h(data)h(t)m(yp)s(es:)41 -b(strings)30 b(and)g(sym)m(b)s(ols.)0 1310 y Fs(8.1)68 -b(Strings)0 1593 y Fr(The)30 b(class)1290 1855 y Fp(String)1242 -1959 y(cl_string)1195 2062 y()0 2345 y Fr(implemen)m(ts)f -(imm)m(utable)g(strings.)0 2628 y(Strings)h(are)h(constructed)f -(through)g(the)h(follo)m(wing)g(constructors:)0 2944 -y Fp(cl_string)d(\(const)h(char)g(*)h(s\))480 3069 y -Fr(Returns)f(an)i(imm)m(utable)e(cop)m(y)i(of)f(the)h -(\(zero-terminated\))h(C)e(string)g Fp(s)p Fr(.)0 3260 +Fp(cl_RA_ring)p Fr(,)g Fp(cl_I_ring)p Fr(:)-30 4705 y +Fp(cl_boolean)g(instanceof)f(\(const)i(cl_number&)e(x,)j(const)f +(cl_number_ring&)d(R\))450 4814 y Fr(T)-8 b(ests)31 b(whether)f(the)g +(giv)m(en)i(n)m(um)m(b)s(er)c(is)i(an)g(elemen)m(t)h(of)g(the)f(n)m(um) +m(b)s(er)e(ring)i(R.)p eop +%%Page: 34 36 +34 35 bop -30 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 +b(in)m(tegers)2730 b(34)-30 299 y Fo(7)80 b(Mo)t(dular)55 +b(in)l(tegers)-30 657 y Fs(7.1)68 b(Mo)t(dular)45 b(in)l(teger)h(rings) +-30 850 y Fr(CLN)29 b(implemen)m(ts)f(mo)s(dular)f(in)m(tegers,)k(i.e.) +41 b(in)m(tegers)31 b(mo)s(dulo)c(a)j(\014xed)e(in)m(teger)j(N.)f(The)e +(mo)s(dulus)f(is)i(explicitly)-30 960 y(part)37 b(of)h(ev)m(ery)g(mo)s +(dular)e(in)m(teger.)63 b(CLN)37 b(do)s(esn't)g(allo)m(w)i(y)m(ou)f(to) +g(\(acciden)m(tally\))j(mix)36 b(elemen)m(ts)i(of)f(di\013eren)m(t)-30 +1069 y(mo)s(dular)25 b(rings,)j(e.g.)41 b Fp(\(3)30 b(mod)f(4\))h(+)g +(\(2)g(mod)f(5\))e Fr(will)h(result)f(in)g(a)h(run)m(time)e(error.)40 +b(\(Ideally)28 b(one)g(w)m(ould)f(imagine)-30 1179 y(a)k(generic)h +(data)f(t)m(yp)s(e)g Fp(cl_MI\(N\))p Fr(,)e(but)h(C)p +Fp(++)g Fr(do)s(esn't)h(ha)m(v)m(e)h(generic)g(t)m(yp)s(es.)42 +b(So)30 b(one)h(has)g(to)h(liv)m(e)g(with)e(run)m(time)-30 +1288 y(c)m(hec)m(ks.\))-30 1423 y(The)g(class)h(of)g(mo)s(dular)d(in)m +(teger)k(rings)e(is)1403 1552 y Fp(Ring)1308 1656 y(cl_ring)1260 +1760 y()1451 1863 y(|)1451 1967 y(|)1021 2071 +y(Modular)46 b(integer)g(ring)1165 2175 y(cl_modint_ring)1117 +2279 y()-30 2413 y Fr(and)30 b(the)g(class)h(of)g(all) +g(mo)s(dular)e(in)m(tegers)i(\(elemen)m(ts)g(of)g(mo)s(dular)d(in)m +(teger)k(rings\))e(is)1165 2542 y Fp(Modular)45 b(integer)1403 +2646 y(cl_MI)1117 2750 y()-30 2885 y +Fr(Mo)s(dular)30 b(in)m(teger)i(rings)e(are)g(constructed)h(using)f +(the)h(function)-30 3044 y Fp(cl_modint_ring)26 b(cl_find_modint_ring)g +(\(const)i(cl_I&)h(N\))450 3154 y Fr(This)f(function)g(returns)f(the)h +(mo)s(dular)e(ring)j(`)p Fp(Z/NZ)p Fr('.)39 b(It)28 b(tak)m(es)i(care)f +(of)g(\014nding)e(out)h(ab)s(out)g(sp)s(ecial)450 3264 +y(cases)e(of)e Fp(N)p Fr(,)i(lik)m(e)g(p)s(o)m(w)m(ers)f(of)g(t)m(w)m +(o)h(and)e(o)s(dd)f(n)m(um)m(b)s(ers)g(for)h(whic)m(h)h(Mon)m(tgomery)g +(m)m(ultiplication)h(will)450 3373 y(b)s(e)g(a)h(win,)g(and)f +(precomputes)f(an)m(y)i(necessary)g(auxiliary)h(data)f(for)f(computing) +g(mo)s(dulo)f Fp(N)p Fr(.)39 b(There)450 3483 y(is)27 +b(a)h(cac)m(he)g(table)g(of)g(rings,)f(indexed)g(b)m(y)g +Fp(N)g Fr(\(or,)h(more)e(precisely)-8 b(,)29 b(b)m(y)f +Fp(abs\(N\))p Fr(\).)38 b(This)26 b(ensures)g(that)450 +3592 y(the)31 b(precomputation)e(costs)j(are)e(reduced)g(to)h(a)g +(minim)m(um.)-30 3752 y(Mo)s(dular)f(in)m(teger)i(rings)e(can)g(b)s(e)g +(compared)f(for)i(equalit)m(y:)-30 3912 y Fp(bool)e(operator==)f +(\(const)g(cl_modint_ring&,)e(const)j(cl_modint_ring&\))-30 +4022 y(bool)g(operator!=)f(\(const)g(cl_modint_ring&,)e(const)j +(cl_modint_ring&\))450 4131 y Fr(These)j(compare)g(t)m(w)m(o)h(mo)s +(dular)d(in)m(teger)k(rings)d(for)h(equalit)m(y)-8 b(.)48 +b(Tw)m(o)32 b(di\013eren)m(t)h(calls)g(to)g Fp(cl_find_)450 +4241 y(modint_ring)39 b Fr(with)i(the)h(same)f(argumen)m(t)g +(necessarily)h(return)f(the)h(same)f(ring)g(b)s(ecause)h(it)g(is)450 +4350 y(memoized)29 b(in)h(the)h(cac)m(he)h(table.)-30 +4608 y Fs(7.2)68 b(F)-11 b(unctions)44 b(on)h(mo)t(dular)g(in)l(tegers) +-30 4801 y Fr(Giv)m(en)31 b(a)g(mo)s(dular)d(in)m(teger)k(ring)e +Fp(R)p Fr(,)h(the)f(follo)m(wing)i(mem)m(b)s(ers)c(can)i(b)s(e)g(used.) +-30 4961 y Fp(cl_I)f(R->modulus)450 5071 y Fr(This)h(is)g(the)h(ring's) +f(mo)s(dulus,)e(normalized)i(to)h(b)s(e)e(nonnegativ)m(e:)43 +b Fp(abs\(N\))p Fr(.)-30 5230 y Fp(cl_MI)29 b(R->zero\(\))450 +5340 y Fr(This)h(returns)f Fp(0)h(mod)f(N)p Fr(.)p eop +%%Page: 35 37 +35 36 bop -30 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 +b(in)m(tegers)2730 b(35)-30 299 y Fp(cl_MI)29 b(R->one\(\))450 +408 y Fr(This)h(returns)f Fp(1)h(mod)f(N)p Fr(.)-30 576 +y Fp(cl_MI)g(R->canonhom)e(\(const)i(cl_I&)g(x\))450 +686 y Fr(This)h(returns)f Fp(x)h(mod)f(N)p Fr(.)-30 853 +y Fp(cl_I)g(R->retract)f(\(const)g(cl_MI&)h(x\))450 963 +y Fr(This)c(is)h(a)h(partial)f(in)m(v)m(erse)h(function)f(to)h +Fp(R->canonhom)p Fr(.)36 b(It)26 b(returns)f(the)h(standard)f(represen) +m(tativ)m(e)450 1072 y(\()p Fp(>=0)p Fr(,)30 b Fp(random\(cl_random_stat)o(e&)24 b(randomstate\))-30 +1349 y(cl_MI)29 b(R->random\(\))450 1459 y Fr(This)h(returns)f(a)h +(random)f(in)m(teger)j(mo)s(dulo)d Fp(N)p Fr(.)-30 1630 +y(The)h(follo)m(wing)i(op)s(erations)e(are)h(de\014ned)e(on)i(mo)s +(dular)d(in)m(tegers.)-30 1802 y Fp(cl_modint_ring)e(x.ring)j(\(\))450 +1912 y Fr(Returns)g(the)i(ring)f(to)h(whic)m(h)f(the)h(mo)s(dular)d(in) +m(teger)k Fp(x)e Fr(b)s(elongs.)-30 2079 y Fp(cl_MI)f(operator+)f +(\(const)g(cl_MI&,)h(const)g(cl_MI&\))450 2189 y Fr(Returns)36 +b(the)h(sum)d(of)j(t)m(w)m(o)h(mo)s(dular)d(in)m(tegers.)60 +b(One)37 b(of)f(the)h(argumen)m(ts)f(ma)m(y)g(also)i(b)s(e)e(a)h(plain) +450 2298 y(in)m(teger.)-30 2466 y Fp(cl_MI)29 b(operator-)f(\(const)g +(cl_MI&,)h(const)g(cl_MI&\))450 2575 y Fr(Returns)37 +b(the)h(di\013erence)g(of)g(t)m(w)m(o)h(mo)s(dular)d(in)m(tegers.)65 +b(One)37 b(of)h(the)g(argumen)m(ts)f(ma)m(y)h(also)g(b)s(e)g(a)450 +2685 y(plain)30 b(in)m(teger.)-30 2852 y Fp(cl_MI)f(operator-)f +(\(const)g(cl_MI&\))450 2962 y Fr(Returns)h(the)i(negativ)m(e)i(of)d(a) +h(mo)s(dular)d(in)m(teger.)-30 3130 y Fp(cl_MI)h(operator*)f(\(const)g +(cl_MI&,)h(const)g(cl_MI&\))450 3239 y Fr(Returns)e(the)g(pro)s(duct)f +(of)i(t)m(w)m(o)h(mo)s(dular)c(in)m(tegers.)41 b(One)27 +b(of)h(the)f(argumen)m(ts)g(ma)m(y)g(also)h(b)s(e)f(a)h(plain)450 +3349 y(in)m(teger.)-30 3516 y Fp(cl_MI)h(square)g(\(const)f(cl_MI&\)) +450 3626 y Fr(Returns)h(the)i(square)f(of)h(a)f(mo)s(dular)f(in)m +(teger.)-30 3793 y Fp(cl_MI)g(recip)g(\(const)g(cl_MI&)f(x\))450 +3903 y Fr(Returns)g(the)i(recipro)s(cal)g Fp(x^-1)e Fr(of)i(a)f(mo)s +(dular)f(in)m(teger)i Fp(x)p Fr(.)40 b Fp(x)29 b Fr(m)m(ust)g(b)s(e)f +(coprime)h(to)h(the)f(mo)s(dulus,)450 4012 y(otherwise)i(an)f(error)g +(message)h(is)f(issued.)-30 4180 y Fp(cl_MI)f(div)g(\(const)g(cl_MI&)g +(x,)h(const)e(cl_MI&)h(y\))450 4290 y Fr(Returns)36 b(the)g(quotien)m +(t)i Fp(x*y^-1)d Fr(of)h(t)m(w)m(o)i(mo)s(dular)c(in)m(tegers)k +Fp(x)p Fr(,)g Fp(y)p Fr(.)59 b Fp(y)36 b Fr(m)m(ust)f(b)s(e)h(coprime)g +(to)h(the)450 4399 y(mo)s(dulus,)28 b(otherwise)j(an)f(error)g(message) +g(is)h(issued.)-30 4567 y Fp(cl_MI)e(expt_pos)f(\(const)h(cl_MI&)f(x,)i +(const)f(cl_I&)g(y\))450 4676 y(y)h Fr(m)m(ust)f(b)s(e)h +Fp(>)g Fr(0.)41 b(Returns)30 b Fp(x^y)p Fr(.)-30 4844 +y Fp(cl_MI)f(expt)g(\(const)g(cl_MI&)f(x,)i(const)f(cl_I&)g(y\))450 +4953 y Fr(Returns)h Fp(x^y)p Fr(.)42 b(If)30 b Fp(y)h +Fr(is)g(negativ)m(e,)i Fp(x)e Fr(m)m(ust)f(b)s(e)g(coprime)g(to)i(the)f +(mo)s(dulus,)e(else)i(an)g(error)g(message)450 5063 y(is)f(issued.)-30 +5230 y Fp(cl_MI)f(operator<<)f(\(const)g(cl_MI&)h(x,)h(const)f(cl_I&)f +(y\))450 5340 y Fr(Returns)h Fp(x*2^y)p Fr(.)p eop +%%Page: 36 38 +36 37 bop -30 -116 a Fr(Chapter)30 b(7:)41 b(Mo)s(dular)30 +b(in)m(tegers)2730 b(36)-30 299 y Fp(cl_MI)29 b(operator>>)f(\(const)g +(cl_MI&)h(x,)h(const)f(cl_I&)f(y\))450 408 y Fr(Returns)k +Fp(x*2^-y)p Fr(.)45 b(When)33 b Fp(y)f Fr(is)g(p)s(ositiv)m(e,)j(the)e +(mo)s(dulus)c(m)m(ust)j(b)s(e)g(o)s(dd,)g(or)h(an)f(error)g(message)h +(is)450 518 y(issued.)-30 677 y Fp(bool)c(operator==)f(\(const)g +(cl_MI&,)h(const)g(cl_MI&\))-30 787 y(bool)g(operator!=)f(\(const)g +(cl_MI&,)h(const)g(cl_MI&\))450 897 y Fr(Compares)21 +b(t)m(w)m(o)j(mo)s(dular)c(in)m(tegers,)25 b(b)s(elonging)e(to)g(the)f +(same)g(mo)s(dular)e(in)m(teger)k(ring,)g(for)e(equalit)m(y)-8 +b(.)-30 1056 y Fp(cl_boolean)28 b(zerop)h(\(const)f(cl_MI&)h(x\))450 +1166 y Fr(Returns)g(true)i(if)f Fp(x)g Fr(is)g Fp(0)g(mod)g(N)p +Fr(.)-30 1325 y(The)g(follo)m(wing)i(output)e(functions)g(are)g +(de\014ned)g(\(see)h(also)g(the)g(c)m(hapter)g(on)f(input/output\).)-30 +1484 y Fp(void)f(fprint)g(\(cl_ostream)e(stream,)i(const)f(cl_MI&)h +(x\))-30 1594 y(cl_ostream)f(operator<<)f(\(cl_ostream)g(stream,)i +(const)g(cl_MI&)f(x\))450 1704 y Fr(Prin)m(ts)40 b(the)h(mo)s(dular)d +(in)m(teger)k Fp(x)d Fr(on)i(the)f Fp(stream)p Fr(.)69 +b(The)40 b(output)g(ma)m(y)f(dep)s(end)g(on)h(the)h(global)450 +1813 y(prin)m(ter)30 b(settings)h(in)f(the)h(v)-5 b(ariable)31 +b Fp(cl_default_print_flags)p Fr(.)p eop +%%Page: 37 39 +37 38 bop -30 -116 a Fr(Chapter)30 b(8:)41 b(Sym)m(b)s(olic)29 +b(data)i(t)m(yp)s(es)2596 b(37)-30 299 y Fo(8)80 b(Sym)l(b)t(olic)54 +b(data)g(t)l(yp)t(es)-30 513 y Fr(CLN)30 b(implemen)m(ts)f(t)m(w)m(o)j +(sym)m(b)s(olic)d(\(non-n)m(umeric\))h(data)h(t)m(yp)s(es:)41 +b(strings)30 b(and)g(sym)m(b)s(ols.)-30 758 y Fs(8.1)68 +b(Strings)-30 946 y Fr(The)30 b(class)1260 1071 y Fp(String)1212 +1175 y(cl_string)1165 1278 y()-30 1409 y +Fr(implemen)m(ts)f(imm)m(utable)g(strings.)-30 1539 y(Strings)h(are)h +(constructed)f(through)g(the)h(follo)m(wing)g(constructors:)-30 +1691 y Fp(cl_string)d(\(const)h(char)g(*)h(s\))450 1800 +y Fr(Returns)f(an)i(imm)m(utable)e(cop)m(y)i(of)f(the)h +(\(zero-terminated\))h(C)e(string)g Fp(s)p Fr(.)-30 1951 y Fp(cl_string)e(\(const)h(char)g(*)h(ptr,)f(unsigned)f(long)h(len\)) -480 3385 y Fr(Returns)34 b(an)h(imm)m(utable)f(cop)m(y)h(of)g(the)h -Fp(len)e Fr(c)m(haracters)i(at)g Fp(ptr[0])p Fr(,)f Fn(:)15 -b(:)g(:)q Fr(,)36 b Fp(ptr[len-1])p Fr(.)52 b(NUL)480 -3509 y(c)m(haracters)32 b(are)f(allo)m(w)m(ed.)0 3826 +450 2061 y Fr(Returns)36 b(an)h(imm)m(utable)f(cop)m(y)i(of)f(the)g +Fp(len)f Fr(c)m(haracters)j(at)e Fp(ptr[0])p Fr(,)43 +b(.)22 b(.)h(.)11 b(,)39 b Fp(ptr[len-1])p Fr(.)58 b(NUL)450 +2171 y(c)m(haracters)32 b(are)f(allo)m(w)m(ed.)-30 2322 y(The)f(follo)m(wing)i(functions)e(are)g(a)m(v)-5 b(ailable)33 -b(on)d(strings:)0 4142 y Fp(operator)e(=)480 4267 y Fr(Assignmen)m(t)i -(from)f Fp(cl_string)f Fr(and)h Fp(const)g(char)h(*)p -Fr(.)0 4458 y Fp(s.length\(\))0 4583 y(strlen\(s\))480 -4707 y Fr(Returns)f(the)i(length)g(of)f(the)h(string)f -Fp(s)p Fr(.)0 4899 y Fp(s[i])288 b Fr(Returns)24 b(the)h -Fp(i)p Fr(th)f(c)m(haracter)j(of)e(the)f(string)h Fp(s)p -Fr(.)39 b Fp(i)24 b Fr(m)m(ust)g(b)s(e)g(in)h(the)f(range)i -Fp(0)k(<=)f(i)h(<)g(s.length\(\))p Fr(.)0 5091 y Fp(bool)f(equal)g -(\(const)g(cl_string&)e(s1,)j(const)f(cl_string&)e(s2\))480 -5215 y Fr(Compares)34 b(t)m(w)m(o)i(strings)f(for)g(equalit)m(y)-8 -b(.)57 b(One)35 b(of)g(the)h(argumen)m(ts)e(ma)m(y)h(also)h(b)s(e)f(a)g -(plain)g Fp(const)480 5340 y(char)29 b(*)p Fr(.)p eop -%%Page: 49 51 -49 50 bop 0 -116 a Fr(Chapter)30 b(8:)41 b(Sym)m(b)s(olic)29 -b(data)i(t)m(yp)s(es)2536 b(49)0 366 y Fs(8.2)68 b(Sym)l(b)t(ols)0 -640 y Fr(Sym)m(b)s(ols)40 b(are)j(uniqui\014ed)d(strings:)64 -b(all)43 b(sym)m(b)s(ols)e(with)h(the)g(same)g(name)f(are)i(shared.)75 -b(This)41 b(means)g(that)0 765 y(comparison)34 b(of)i(t)m(w)m(o)g(sym)m -(b)s(ols)e(is)h(fast)h(\(e\013ectiv)m(ely)i(just)d(a)g(p)s(oin)m(ter)g -(comparison\),)h(whereas)f(comparison)g(of)0 890 y(t)m(w)m(o)26 -b(strings)f(m)m(ust)f(in)g(the)h(w)m(orst)h(case)g(w)m(alk)f(b)s(oth)f -(strings)h(un)m(til)g(their)g(end.)38 b(Sym)m(b)s(ols)24 -b(are)h(used,)g(for)g(example,)0 1014 y(as)31 b(tags)g(for)f(prop)s -(erties,)g(as)h(names)e(of)i(v)-5 b(ariables)31 b(in)f(p)s(olynomial)f -(rings,)i(etc.)0 1288 y(Sym)m(b)s(ols)e(are)h(constructed)h(through)f -(the)g(follo)m(wing)i(constructor:)0 1587 y Fp(cl_symbol)c(\(const)h -(cl_string&)e(s\))480 1711 y Fr(Lo)s(oks)j(up)g(or)g(creates)i(a)f(new) -e(sym)m(b)s(ol)h(with)g(a)g(giv)m(en)i(name.)0 2010 y(The)e(follo)m -(wing)i(op)s(erations)e(are)h(a)m(v)-5 b(ailable)33 b(on)d(sym)m(b)s -(ols:)0 2309 y Fp(cl_string)e(\(const)h(cl_symbol&)e(sym\))480 -2434 y Fr(Con)m(v)m(ersion)k(to)g Fp(cl_string)p Fr(:)38 +b(on)d(strings:)-30 2473 y Fp(operator)e(=)450 2583 y +Fr(Assignmen)m(t)i(from)f Fp(cl_string)f Fr(and)h Fp(const)g(char)h(*)p +Fr(.)-30 2734 y Fp(s.length\(\))-30 2844 y(strlen\(s\))450 +2953 y Fr(Returns)f(the)i(length)g(of)f(the)h(string)f +Fp(s)p Fr(.)-30 3104 y Fp(s[i])288 b Fr(Returns)28 b(the)i +Fp(i)p Fr(th)f(c)m(haracter)i(of)e(the)g(string)h Fp(s)p +Fr(.)40 b Fp(i)29 b Fr(m)m(ust)f(b)s(e)h(in)g(the)g(range)h +Fp(0)g(<=)f(i)h(<)g(s.length\(\))p Fr(.)-30 3256 y Fp(bool)f(equal)g +(\(const)g(cl_string&)e(s1,)j(const)f(cl_string&)e(s2\))450 +3365 y Fr(Compares)38 b(t)m(w)m(o)i(strings)f(for)f(equalit)m(y)-8 +b(.)69 b(One)38 b(of)h(the)g(argumen)m(ts)g(ma)m(y)f(also)i(b)s(e)e(a)i +(plain)e Fp(const)450 3475 y(char)29 b(*)p Fr(.)-30 3720 +y Fs(8.2)68 b(Sym)l(b)t(ols)-30 3908 y Fr(Sym)m(b)s(ols)31 +b(are)i(uniqui\014ed)d(strings:)45 b(all)34 b(sym)m(b)s(ols)d(with)h +(the)g(same)g(name)g(are)h(shared.)46 b(This)32 b(means)f(that)i(com-) +-30 4018 y(parison)38 b(of)g(t)m(w)m(o)i(sym)m(b)s(ols)d(is)h(fast)h +(\(e\013ectiv)m(ely)j(just)37 b(a)i(p)s(oin)m(ter)f(comparison\),)i +(whereas)f(comparison)e(of)i(t)m(w)m(o)-30 4128 y(strings)32 +b(m)m(ust)f(in)g(the)i(w)m(orst)f(case)h(w)m(alk)g(b)s(oth)e(strings)h +(un)m(til)g(their)g(end.)45 b(Sym)m(b)s(ols)30 b(are)j(used,)f(for)f +(example,)i(as)-30 4237 y(tags)e(for)g(prop)s(erties,)f(as)g(names)f +(of)i(v)-5 b(ariables)31 b(in)f(p)s(olynomial)g(rings,)g(etc.)-30 +4368 y(Sym)m(b)s(ols)f(are)h(constructed)h(through)f(the)g(follo)m +(wing)i(constructor:)-30 4519 y Fp(cl_symbol)c(\(const)h(cl_string&)e +(s\))450 4629 y Fr(Lo)s(oks)j(up)g(or)g(creates)i(a)f(new)e(sym)m(b)s +(ol)h(with)g(a)g(giv)m(en)i(name.)-30 4780 y(The)e(follo)m(wing)i(op)s +(erations)e(are)h(a)m(v)-5 b(ailable)33 b(on)d(sym)m(b)s(ols:)-30 +4931 y Fp(cl_string)e(\(const)h(cl_symbol&)e(sym\))450 +5041 y Fr(Con)m(v)m(ersion)k(to)g Fp(cl_string)p Fr(:)38 b(Returns)30 b(the)g(string)h(whic)m(h)f(names)f(the)i(sym)m(b)s(ol)e -Fp(sym)p Fr(.)0 2608 y Fp(bool)g(equal)g(\(const)g(cl_symbol&)e(sym1,)i -(const)g(cl_symbol&)f(sym2\))480 2733 y Fr(Compares)h(t)m(w)m(o)j(sym)m -(b)s(ols)d(for)h(equalit)m(y)-8 b(.)43 b(This)29 b(is)i(v)m(ery)f -(fast.)p eop -%%Page: 50 52 -50 51 bop 0 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 b(ariate)32 -b(p)s(olynomials)2423 b(50)0 366 y Fo(9)80 b(Univ)-9 -b(ariate)33 b(p)t(olynomials)0 907 y Fs(9.1)68 b(Univ)-7 -b(ariate)32 b(p)t(olynomial)g(rings)0 1181 y Fr(CLN)d(implemen)m(ts)e -(univ)-5 b(ariate)30 b(p)s(olynomials)f(\(p)s(olynomials)f(in)h(one)h -(v)-5 b(ariable\))30 b(o)m(v)m(er)g(an)f(arbitrary)g(ring.)40 -b(The)0 1305 y(indeterminate)h(v)-5 b(ariable)43 b(ma)m(y)e(b)s(e)g -(either)i(unnamed)c(\(and)i(will)h(b)s(e)g(prin)m(ted)f(according)i(to) -f Fp(cl_default_)0 1430 y(print_flags.univpoly_var)o(name)o -Fr(,)23 b(whic)m(h)28 b(defaults)g(to)g(`)p Fp(x)p Fr('\))h(or)f(carry) -g(a)g(giv)m(en)h(name.)39 b(The)28 b(base)g(ring)g(and)0 -1554 y(the)h(indeterminate)f(are)g(explicitly)i(part)f(of)f(ev)m(ery)h -(p)s(olynomial.)40 b(CLN)28 b(do)s(esn't)g(allo)m(w)i(y)m(ou)e(to)i -(\(acciden)m(tally\))0 1679 y(mix)h(elemen)m(ts)h(of)f(di\013eren)m(t)h -(p)s(olynomial)f(rings,)h(e.g.)46 b Fp(\(a^2+1\))28 b(*)i(\(b^3-1\))g -Fr(will)i(result)f(in)h(a)g(run)m(time)e(error.)0 1803 -y(\(Ideally)h(this)g(should)e(return)g(a)i(m)m(ultiv)-5 -b(ariate)31 b(p)s(olynomial,)f(but)g(they)h(are)f(not)h(y)m(et)g -(implemen)m(ted)e(in)h(CLN.\))0 2077 y(The)g(classes)h(of)g(univ)-5 -b(ariate)31 b(p)s(olynomial)f(rings)f(are)1529 2330 y -Fp(Ring)1433 2434 y(cl_ring)1385 2538 y()1576 -2642 y(|)1576 2746 y(|)1051 2849 y(Univariate)45 b(polynomial)g(ring) -1290 2953 y(cl_univpoly_ring)1290 3057 y()1576 -3161 y(|)765 3264 y(+----------------+------)o(----)o(----)o(---)o(--+) -765 3368 y(|)763 b(|)907 b(|)288 3472 y(Complex)46 b(polynomial)f(ring) -189 b(|)i(Modular)46 b(integer)g(polynomial)f(ring)288 -3576 y(cl_univpoly_complex_rin)o(g)137 b(|)382 b -(cl_univpoly_modint_ring)335 3680 y()137 -b(|)382 b()1576 3783 y(|)765 3887 -y(+----------------+)765 3991 y(|)763 b(|)383 4095 y(Real)47 -b(polynomial)e(ring)237 b(|)383 4198 y(cl_univpoly_real_ring)185 -b(|)431 4302 y()g(|)1576 4406 y(|)765 -4510 y(+----------------+)765 4614 y(|)763 b(|)288 4717 -y(Rational)45 b(polynomial)g(ring)142 b(|)288 4821 y -(cl_univpoly_rational_ri)o(ng)89 b(|)335 4925 y -()g(|)1576 5029 y(|)765 5132 -y(+----------------+)765 5236 y(|)288 5340 y(Integer)46 -b(polynomial)f(ring)p eop -%%Page: 51 53 -51 52 bop 0 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 b(ariate)32 -b(p)s(olynomials)2423 b(51)288 366 y Fp(cl_univpoly_integer_rin)o(g)335 -470 y()0 784 y Fr(and)30 b(the)g(corresp)s +Fp(sym)p Fr(.)-30 5192 y Fp(bool)g(equal)g(\(const)g(cl_symbol&)e +(sym1,)i(const)g(cl_symbol&)f(sym2\))450 5301 y Fr(Compares)h(t)m(w)m +(o)j(sym)m(b)s(ols)d(for)h(equalit)m(y)-8 b(.)43 b(This)29 +b(is)i(v)m(ery)f(fast.)p eop +%%Page: 38 40 +38 39 bop -30 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 +b(ariate)32 b(p)s(olynomials)2483 b(38)-30 299 y Fo(9)80 +b(Univ)-9 b(ariate)56 b(p)t(olynomials)-30 652 y Fs(9.1)68 +b(Univ)-7 b(ariate)47 b(p)t(olynomial)f(rings)-30 844 +y Fr(CLN)33 b(implemen)m(ts)f(univ)-5 b(ariate)35 b(p)s(olynomials)e +(\(p)s(olynomials)g(in)g(one)h(v)-5 b(ariable\))35 b(o)m(v)m(er)g(an)f +(arbitrary)f(ring.)50 b(The)-30 953 y(indeterminate)23 +b(v)-5 b(ariable)23 b(ma)m(y)g(b)s(e)f(either)h(unnamed)e(\(and)h(will) +i(b)s(e)e(prin)m(ted)g(according)i(to)g Fp(cl_default_print_)-30 +1063 y(flags.univpoly_varname)p Fr(,)37 b(whic)m(h)j(defaults)g(to)h(`) +p Fp(x)p Fr('\))g(or)f(carry)h(a)f(giv)m(en)h(name.)70 +b(The)40 b(base)g(ring)g(and)g(the)-30 1172 y(indeterminate)31 +b(are)h(explicitly)g(part)f(of)h(ev)m(ery)g(p)s(olynomial.)42 +b(CLN)31 b(do)s(esn't)g(allo)m(w)i(y)m(ou)e(to)h(\(acciden)m(tally\))j +(mix)-30 1282 y(elemen)m(ts)23 b(of)g(di\013eren)m(t)h(p)s(olynomial)e +(rings,)i(e.g.)40 b Fp(\(a^2+1\))28 b(*)i(\(b^3-1\))21 +b Fr(will)i(result)g(in)g(a)g(run)m(time)f(error.)38 +b(\(Ideally)-30 1391 y(this)30 b(should)g(return)f(a)i(m)m(ultiv)-5 +b(ariate)31 b(p)s(olynomial,)f(but)g(they)g(are)h(not)g(y)m(et)g +(implemen)m(ted)e(in)h(CLN.\))-30 1525 y(The)g(classes)h(of)g(univ)-5 +b(ariate)31 b(p)s(olynomial)f(rings)f(are)1499 1653 y +Fp(Ring)1403 1757 y(cl_ring)1355 1861 y()1546 +1965 y(|)1546 2068 y(|)1021 2172 y(Univariate)45 b(polynomial)g(ring) +1260 2276 y(cl_univpoly_ring)1260 2380 y()1546 +2484 y(|)735 2587 y(+----------------+------)o(----)o(----)o(---)o(--+) +735 2691 y(|)763 b(|)907 b(|)258 2795 y(Complex)46 b(polynomial)f(ring) +189 b(|)i(Modular)46 b(integer)g(polynomial)f(ring)258 +2899 y(cl_univpoly_complex_rin)o(g)137 b(|)382 b +(cl_univpoly_modint_ring)305 3002 y()137 +b(|)382 b()1546 3106 y(|)735 3210 +y(+----------------+)735 3314 y(|)763 b(|)353 3418 y(Real)47 +b(polynomial)e(ring)237 b(|)353 3521 y(cl_univpoly_real_ring)185 +b(|)401 3625 y()g(|)1546 3729 y(|)735 +3833 y(+----------------+)735 3936 y(|)763 b(|)258 4040 +y(Rational)45 b(polynomial)g(ring)142 b(|)258 4144 y +(cl_univpoly_rational_ri)o(ng)89 b(|)305 4248 y +()g(|)1546 4352 y(|)735 4455 +y(+----------------+)735 4559 y(|)258 4663 y(Integer)46 +b(polynomial)f(ring)258 4767 y(cl_univpoly_integer_rin)o(g)305 +4870 y()-30 5004 y Fr(and)30 b(the)g(corresp)s (onding)g(classes)h(of)g(univ)-5 b(ariate)31 b(p)s(olynomials)e(are) -1147 1077 y Fp(Univariate)45 b(polynomial)1481 1181 y(cl_UP)1290 -1285 y()1576 1389 y(|)765 1492 y -(+----------------+------)o(----)o(----)o(---)o(--+)765 -1596 y(|)763 b(|)907 b(|)383 1700 y(Complex)46 b(polynomial)331 -b(|)286 b(Modular)46 b(integer)g(polynomial)622 1804 -y(cl_UP_N)618 b(|)764 b(cl_UP_MI)335 1908 y()137 -b(|)382 b()1576 2011 y(|)765 2115 -y(+----------------+)765 2219 y(|)763 b(|)479 2323 y(Real)46 -b(polynomial)379 b(|)622 2426 y(cl_UP_R)618 b(|)431 2530 -y()185 b(|)1576 2634 y(|)765 2738 -y(+----------------+)765 2842 y(|)763 b(|)383 2945 y(Rational)46 -b(polynomial)283 b(|)622 3049 y(cl_UP_RA)570 b(|)335 -3153 y()89 b(|)1576 3257 y(|)765 -3360 y(+----------------+)765 3464 y(|)383 3568 y(Integer)46 -b(polynomial)622 3672 y(cl_UP_I)335 3776 y()0 -4089 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomial)d(rings)h(are)h -(constructed)g(using)f(the)g(functions)0 4468 y Fp(cl_univpoly_ring)c -(cl_find_univpoly_ring)e(\(const)29 b(cl_ring&)f(R\))0 -4593 y(cl_univpoly_ring)e(cl_find_univpoly_ring)e(\(const)29 -b(cl_ring&)f(R,)i(const)f(cl_symbol&)f(varname\))480 -4717 y Fr(This)36 b(function)h(returns)f(the)i(p)s(olynomial)e(ring)h -(`)p Fp(R[X])p Fr(',)h(unnamed)d(or)i(named.)60 b Fp(R)37 -b Fr(ma)m(y)g(b)s(e)f(an)480 4842 y(arbitrary)g(ring.)56 -b(This)35 b(function)h(tak)m(es)h(care)f(of)g(\014nding)f(out)h(ab)s -(out)f(sp)s(ecial)i(cases)f(of)g Fp(R)p Fr(,)h(suc)m(h)480 -4966 y(as)28 b(the)g(rings)g(of)g(complex)g(n)m(um)m(b)s(ers,)e(real)i +1117 5132 y Fp(Univariate)45 b(polynomial)1451 5236 y(cl_UP)1260 +5340 y()p eop +%%Page: 39 41 +39 40 bop -30 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 +b(ariate)32 b(p)s(olynomials)2483 b(39)1546 299 y Fp(|)735 +403 y(+----------------+------)o(----)o(----)o(---)o(--+)735 +506 y(|)763 b(|)907 b(|)353 610 y(Complex)46 b(polynomial)331 +b(|)286 b(Modular)46 b(integer)g(polynomial)592 714 y(cl_UP_N)618 +b(|)764 b(cl_UP_MI)305 818 y()137 +b(|)382 b()1546 922 y(|)735 1025 +y(+----------------+)735 1129 y(|)763 b(|)449 1233 y(Real)46 +b(polynomial)379 b(|)592 1337 y(cl_UP_R)618 b(|)401 1440 +y()185 b(|)1546 1544 y(|)735 1648 +y(+----------------+)735 1752 y(|)763 b(|)353 1856 y(Rational)46 +b(polynomial)283 b(|)592 1959 y(cl_UP_RA)570 b(|)305 +2063 y()89 b(|)1546 2167 y(|)735 +2271 y(+----------------+)735 2374 y(|)353 2478 y(Integer)46 +b(polynomial)592 2582 y(cl_UP_I)305 2686 y()-30 +3545 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomial)d(rings)h(are)h +(constructed)g(using)f(the)g(functions)-30 4792 y Fp(cl_univpoly_ring)c +(cl_find_univpoly_ring)e(\(const)29 b(cl_ring&)f(R\))-30 +4902 y(cl_univpoly_ring)e(cl_find_univpoly_ring)e(\(const)29 +b(cl_ring&)f(R,)i(const)f(cl_symbol&)f(varname\))450 +5011 y Fr(This)40 b(function)h(returns)f(the)h(p)s(olynomial)g(ring)g +(`)p Fp(R[X])p Fr(',)i(unnamed)c(or)i(named.)71 b Fp(R)41 +b Fr(ma)m(y)g(b)s(e)f(an)450 5121 y(arbitrary)f(ring.)68 +b(This)39 b(function)g(tak)m(es)i(care)f(of)g(\014nding)e(out)h(ab)s +(out)h(sp)s(ecial)g(cases)g(of)g Fp(R)p Fr(,)h(suc)m(h)450 +5230 y(as)33 b(the)g(rings)g(of)g(complex)f(n)m(um)m(b)s(ers,)g(real)h (n)m(um)m(b)s(ers,)f(rational)i(n)m(um)m(b)s(ers,)d(in)m(tegers,)k(or)e -(mo)s(dular)480 5091 y(in)m(teger)j(rings.)40 b(There)30 -b(is)g(a)g(cac)m(he)i(table)e(of)g(rings,)g(indexed)g(b)m(y)f -Fp(R)h Fr(and)f Fp(varname)p Fr(.)39 b(This)29 b(ensures)480 -5215 y(that)24 b(t)m(w)m(o)h(calls)g(of)e(this)h(function)f(with)g(the) -h(same)f(argumen)m(ts)g(will)h(return)e(the)i(same)f(p)s(olynomial)480 -5340 y(ring.)p eop -%%Page: 52 54 -52 53 bop 0 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 b(ariate)32 -b(p)s(olynomials)2423 b(52)0 366 y Fp(cl_univpoly_complex_ring)24 -b(cl_find_univpoly_ring)g(\(const)29 b(cl_complex_ring&)d(R\))0 -491 y(cl_univpoly_complex_ring)e(cl_find_univpoly_ring)g(\(const)29 -b(cl_complex_ring&)d(R,)k(const)0 616 y(cl_symbol&)e(varname\))0 -740 y(cl_univpoly_real_ring)d(cl_find_univpoly_ring)f(\(const)29 -b(cl_real_ring&)e(R\))0 865 y(cl_univpoly_real_ring)e -(cl_find_univpoly_ring)f(\(const)29 b(cl_real_ring&)e(R,)i(const)0 -989 y(cl_symbol&)f(varname\))0 1114 y(cl_univpoly_rational_rin)o(g)c -(cl_find_univpoly_ring)h(\(const)k(cl_rational_ring&)c(R\))0 -1238 y(cl_univpoly_rational_rin)o(g)f(cl_find_univpoly_ring)h(\(const)k -(cl_rational_ring&)c(R,)30 b(const)0 1363 y(cl_symbol&)e(varname\))0 -1487 y(cl_univpoly_integer_ring)c(cl_find_univpoly_ring)g(\(const)29 -b(cl_integer_ring&)d(R\))0 1612 y(cl_univpoly_integer_ring)e -(cl_find_univpoly_ring)g(\(const)29 b(cl_integer_ring&)d(R,)k(const)0 -1736 y(cl_symbol&)e(varname\))0 1861 y(cl_univpoly_modint_ring)c -(cl_find_univpoly_ring)h(\(const)j(cl_modint_ring&)e(R\))0 -1985 y(cl_univpoly_modint_ring)e(cl_find_univpoly_ring)h(\(const)j -(cl_modint_ring&)e(R,)k(const)0 2110 y(cl_symbol&)e(varname\))480 -2234 y Fr(These)c(functions)f(are)i(equiv)-5 b(alen)m(t)26 -b(to)e(the)h(general)g Fp(cl_find_univpoly_ring)p Fr(,)20 -b(only)k(the)g(return)480 2359 y(t)m(yp)s(e)31 b(is)f(more)f(sp)s -(eci\014c,)i(according)g(to)g(the)g(base)f(ring's)h(t)m(yp)s(e.)0 -2845 y Fs(9.2)68 b(F)-11 b(unctions)30 b(on)g(univ)-7 -b(ariate)31 b(p)t(olynomials)0 3123 y Fr(Giv)m(en)g(a)g(univ)-5 -b(ariate)31 b(p)s(olynomial)f(ring)g Fp(R)p Fr(,)g(the)h(follo)m(wing)h -(mem)m(b)s(ers)27 b(can)k(b)s(e)f(used.)0 3430 y Fp(cl_ring)e -(R->basering\(\))480 3555 y Fr(This)i(returns)f(the)h(base)h(ring,)f -(as)h(passed)f(to)h(`)p Fp(cl_find_univpoly_ring)p Fr('.)0 -3737 y Fp(cl_UP)e(R->zero\(\))480 3862 y Fr(This)h(returns)f -Fp(0)h(in)g(R)p Fr(,)g(a)h(p)s(olynomial)e(of)i(degree)g(-1.)0 -4045 y Fp(cl_UP)e(R->one\(\))480 4169 y Fr(This)h(returns)f +(mo)s(dular)450 5340 y(in)m(teger)i(rings.)48 b(There)33 +b(is)g(a)h(cac)m(he)g(table)g(of)g(rings,)f(indexed)g(b)m(y)g +Fp(R)g Fr(and)f Fp(varname)p Fr(.)48 b(This)32 b(ensures)p +eop +%%Page: 40 42 +40 41 bop -30 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 +b(ariate)32 b(p)s(olynomials)2483 b(40)450 299 y(that)28 +b(t)m(w)m(o)i(calls)f(of)e(this)h(function)g(with)f(the)h(same)f +(argumen)m(ts)h(will)g(return)e(the)i(same)g(p)s(olynomial)450 +408 y(ring.)-30 547 y Fp(cl_univpoly_complex_ring)c +(cl_find_univpoly_ring)g(\(const)29 b(cl_complex_ring&)d(R\))-30 +657 y(cl_univpoly_complex_ring)e(cl_find_univpoly_ring)g(\(const)29 +b(cl_complex_ring&)d(R,)k(const)-30 766 y(cl_symbol&)e(varname\))-30 +876 y(cl_univpoly_real_ring)d(cl_find_univpoly_ring)f(\(const)29 +b(cl_real_ring&)e(R\))-30 986 y(cl_univpoly_real_ring)e +(cl_find_univpoly_ring)f(\(const)29 b(cl_real_ring&)e(R,)i(const)g +(cl_symbol&)-30 1095 y(varname\))-30 1205 y(cl_univpoly_rational_rin)o +(g)24 b(cl_find_univpoly_ring)h(\(const)k(cl_rational_ring&)c(R\))-30 +1314 y(cl_univpoly_rational_rin)o(g)f(cl_find_univpoly_ring)h(\(const)k +(cl_rational_ring&)c(R,)30 b(const)-30 1424 y(cl_symbol&)e(varname\)) +-30 1533 y(cl_univpoly_integer_ring)c(cl_find_univpoly_ring)g(\(const) +29 b(cl_integer_ring&)d(R\))-30 1643 y(cl_univpoly_integer_ring)e +(cl_find_univpoly_ring)g(\(const)29 b(cl_integer_ring&)d(R,)k(const)-30 +1753 y(cl_symbol&)e(varname\))-30 1862 y(cl_univpoly_modint_ring)c +(cl_find_univpoly_ring)h(\(const)j(cl_modint_ring&)e(R\))-30 +1972 y(cl_univpoly_modint_ring)e(cl_find_univpoly_ring)h(\(const)j +(cl_modint_ring&)e(R,)k(const)-30 2081 y(cl_symbol&)e(varname\))450 +2191 y Fr(These)i(functions)g(are)g(equiv)-5 b(alen)m(t)32 +b(to)f(the)f(general)i Fp(cl_find_univpoly_ring)p Fr(,)24 +b(only)31 b(the)f(return)450 2301 y(t)m(yp)s(e)h(is)f(more)f(sp)s +(eci\014c,)i(according)g(to)g(the)g(base)f(ring's)h(t)m(yp)s(e.)-30 +2579 y Fs(9.2)68 b(F)-11 b(unctions)44 b(on)h(univ)-7 +b(ariate)46 b(p)t(olynomials)-30 2780 y Fr(Giv)m(en)31 +b(a)g(univ)-5 b(ariate)31 b(p)s(olynomial)f(ring)g Fp(R)p +Fr(,)g(the)h(follo)m(wing)h(mem)m(b)s(ers)27 b(can)k(b)s(e)f(used.)-30 +2952 y Fp(cl_ring)e(R->basering\(\))450 3061 y Fr(This)i(returns)f(the) +h(base)h(ring,)f(as)h(passed)f(to)h(`)p Fp(cl_find_univpoly_ring)p +Fr('.)-30 3229 y Fp(cl_UP)e(R->zero\(\))450 3339 y Fr(This)h(returns)f +Fp(0)h(in)g(R)p Fr(,)g(a)h(p)s(olynomial)e(of)i(degree)g(-1.)-30 +3506 y Fp(cl_UP)e(R->one\(\))450 3616 y Fr(This)h(returns)f Fp(1)h(in)g(R)p Fr(,)g(a)h(p)s(olynomial)e(of)i(degree)g -Fp(<)p Fr(=)f(0.)0 4352 y Fp(cl_UP)f(R->canonhom)e(\(const)i(cl_I&)g -(x\))480 4476 y Fr(This)h(returns)f Fp(x)h(in)g(R)p Fr(,)g(a)h(p)s -(olynomial)e(of)i(degree)g Fp(<)p Fr(=)f(0.)0 4659 y -Fp(cl_UP)f(R->monomial)e(\(const)i(cl_ring_element&)d(x,)k(uintL)f(e\)) -480 4784 y Fr(This)h(returns)f(a)h(sparse)g(p)s(olynomial:)41 +Fp(<)p Fr(=)f(0.)-30 3784 y Fp(cl_UP)f(R->canonhom)e(\(const)i(cl_I&)g +(x\))450 3893 y Fr(This)h(returns)f Fp(x)h(in)g(R)p Fr(,)g(a)h(p)s +(olynomial)e(of)i(degree)g Fp(<)p Fr(=)f(0.)-30 4061 +y Fp(cl_UP)f(R->monomial)e(\(const)i(cl_ring_element&)d(x,)k(uintL)f +(e\))450 4171 y Fr(This)h(returns)f(a)h(sparse)g(p)s(olynomial:)41 b Fp(x)30 b(*)g(X^e)p Fr(,)f(where)h Fp(X)g Fr(is)h(the)f -(indeterminate.)0 4966 y Fp(cl_UP)f(R->create)f(\(sintL)g(degree\))480 -5091 y Fr(Creates)38 b(a)g(new)f(p)s(olynomial)f(with)i(a)f(giv)m(en)i -(degree.)62 b(The)37 b(zero)h(p)s(olynomial)f(has)g(degree)h -Fp(-1)p Fr(.)480 5215 y(After)29 b(creating)i(the)e(p)s(olynomial,)f(y) -m(ou)i(should)e(put)g(in)h(the)g(co)s(e\016cien)m(ts,)i(using)d(the)h -Fp(set_coeff)480 5340 y Fr(mem)m(b)s(er)f(function,)i(and)g(then)g -(call)i(the)e Fp(finalize)e Fr(mem)m(b)s(er)g(function.)p +(indeterminate.)-30 4339 y Fp(cl_UP)f(R->create)f(\(sintL)g(degree\)) +450 4448 y Fr(Creates)d(a)f(new)f(p)s(olynomial)g(with)h(a)g(giv)m(en)h +(degree.)39 b(The)24 b(zero)g(p)s(olynomial)g(has)f(degree)i +Fp(-1)p Fr(.)38 b(After)450 4558 y(creating)26 b(the)f(p)s(olynomial,)g +(y)m(ou)g(should)e(put)h(in)g(the)h(co)s(e\016cien)m(ts,)j(using)c(the) +h Fp(set_coeff)d Fr(mem)m(b)s(er)450 4667 y(function,)30 +b(and)g(then)g(call)i(the)e Fp(finalize)f Fr(mem)m(b)s(er)e(function.) +-30 4839 y(The)j(follo)m(wing)i(are)e(the)h(only)g(destructiv)m(e)g(op) +s(erations)g(on)f(univ)-5 b(ariate)31 b(p)s(olynomials.)-30 +5011 y Fp(void)e(set_coeff)f(\(cl_UP&)g(x,)i(uintL)f(index,)g(const)g +(cl_ring_element&)d(y\))450 5121 y Fr(This)32 b(c)m(hanges)i(the)f(co)s +(e\016cien)m(t)i(of)e Fp(X^index)e Fr(in)i Fp(x)g Fr(to)g(b)s(e)g +Fp(y)p Fr(.)48 b(After)33 b(c)m(hanging)h(a)f(p)s(olynomial)g(and)450 +5230 y(b)s(efore)40 b(applying)h(an)m(y)g Fp(")p Fr(normal)p +Fp(")e Fr(op)s(eration)i(on)g(it,)j(y)m(ou)d(should)f(call)i(its)f +Fp(finalize)e Fr(mem)m(b)s(er)450 5340 y(function.)p eop -%%Page: 53 55 -53 54 bop 0 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 b(ariate)32 -b(p)s(olynomials)2423 b(53)0 366 y(The)30 b(follo)m(wing)i(are)e(the)h -(only)g(destructiv)m(e)g(op)s(erations)g(on)f(univ)-5 -b(ariate)31 b(p)s(olynomials.)0 677 y Fp(void)e(set_coeff)f(\(cl_UP&)g -(x,)i(uintL)f(index,)g(const)g(cl_ring_element&)d(y\))480 -802 y Fr(This)i(c)m(hanges)j(the)e(co)s(e\016cien)m(t)i(of)f -Fp(X^index)d Fr(in)i Fp(x)g Fr(to)h(b)s(e)f Fp(y)p Fr(.)40 -b(After)29 b(c)m(hanging)h(a)g(p)s(olynomial)f(and)480 -926 y(b)s(efore)35 b(applying)h(an)m(y)g Fp(")p Fr(normal)p -Fp(")f Fr(op)s(eration)h(on)g(it,)i(y)m(ou)e(should)f(call)i(its)f -Fp(finalize)e Fr(mem)m(b)s(er)480 1051 y(function.)0 -1237 y Fp(void)29 b(finalize)f(\(cl_UP&)h(x\))480 1361 -y Fr(This)f(function)g(marks)f(the)h(endp)s(oin)m(t)g(of)h(destructiv)m -(e)g(mo)s(di\014cations)f(of)g(a)h(p)s(olynomial.)40 -b(It)28 b(nor-)480 1486 y(malizes)23 b(the)f(in)m(ternal)h(represen)m -(tation)h(so)e(that)h(subsequen)m(t)f(computations)g(ha)m(v)m(e)i(less) -e(o)m(v)m(erhead.)480 1611 y(Doing)32 b(normal)e(computations)h(on)g -(unnormalized)f(p)s(olynomials)g(ma)m(y)h(pro)s(duce)e(wrong)i(results) -480 1735 y(or)f(crash)g(the)h(program.)0 2046 y(The)f(follo)m(wing)i -(op)s(erations)e(are)h(de\014ned)e(on)i(univ)-5 b(ariate)31 -b(p)s(olynomials.)0 2356 y Fp(cl_univpoly_ring)26 b(x.ring)j(\(\))480 -2481 y Fr(Returns)g(the)i(ring)f(to)h(whic)m(h)f(the)h(univ)-5 -b(ariate)31 b(p)s(olynomial)f Fp(x)g Fr(b)s(elongs.)0 -2667 y Fp(cl_UP)f(operator+)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))480 -2792 y Fr(Returns)g(the)i(sum)d(of)j(t)m(w)m(o)h(univ)-5 -b(ariate)31 b(p)s(olynomials.)0 2978 y Fp(cl_UP)e(operator-)f(\(const)g -(cl_UP&,)h(const)g(cl_UP&\))480 3102 y Fr(Returns)g(the)i(di\013erence) -g(of)f(t)m(w)m(o)i(univ)-5 b(ariate)31 b(p)s(olynomials.)0 -3288 y Fp(cl_UP)e(operator-)f(\(const)g(cl_UP&\))480 -3413 y Fr(Returns)h(the)i(negativ)m(e)i(of)d(a)h(univ)-5 -b(ariate)31 b(p)s(olynomial.)0 3599 y Fp(cl_UP)e(operator*)f(\(const)g -(cl_UP&,)h(const)g(cl_UP&\))480 3724 y Fr(Returns)e(the)h(pro)s(duct)e -(of)i(t)m(w)m(o)h(univ)-5 b(ariate)28 b(p)s(olynomials.)39 -b(One)27 b(of)h(the)g(argumen)m(ts)f(ma)m(y)g(also)i(b)s(e)480 -3848 y(a)i(plain)f(in)m(teger)i(or)e(an)g(elemen)m(t)h(of)g(the)f(base) -h(ring.)0 4034 y Fp(cl_UP)e(square)g(\(const)f(cl_UP&\))480 -4159 y Fr(Returns)h(the)i(square)f(of)h(a)f(univ)-5 b(ariate)31 -b(p)s(olynomial.)0 4345 y Fp(cl_UP)e(expt_pos)f(\(const)h(cl_UP&)f(x,)i -(const)f(cl_I&)g(y\))480 4470 y(y)h Fr(m)m(ust)f(b)s(e)h -Fp(>)g Fr(0.)41 b(Returns)30 b Fp(x^y)p Fr(.)0 4656 y -Fp(bool)f(operator==)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))0 -4780 y(bool)g(operator!=)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))480 -4905 y Fr(Compares)39 b(t)m(w)m(o)j(univ)-5 b(ariate)41 -b(p)s(olynomials,)h(b)s(elonging)e(to)h(the)g(same)f(univ)-5 -b(ariate)41 b(p)s(olynomial)480 5029 y(ring,)30 b(for)h(equalit)m(y)-8 -b(.)0 5215 y Fp(cl_boolean)28 b(zerop)h(\(const)f(cl_UP&)h(x\))480 -5340 y Fr(Returns)g(true)i(if)f Fp(x)g Fr(is)g Fp(0)g(in)g(R)p -Fr(.)p eop -%%Page: 54 56 -54 55 bop 0 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 b(ariate)32 -b(p)s(olynomials)2423 b(54)0 366 y Fp(sintL)29 b(degree)g(\(const)f -(cl_UP&)h(x\))480 491 y Fr(Returns)g(the)i(degree)g(of)g(the)f(p)s +%%Page: 41 43 +41 42 bop -30 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 +b(ariate)32 b(p)s(olynomials)2483 b(41)-30 299 y Fp(void)29 +b(finalize)f(\(cl_UP&)h(x\))450 408 y Fr(This)j(function)h(marks)f(the) +h(endp)s(oin)m(t)f(of)i(destructiv)m(e)g(mo)s(di\014cations)e(of)h(a)h +(p)s(olynomial.)48 b(It)33 b(nor-)450 518 y(malizes)c(the)f(in)m +(ternal)h(represen)m(tation)h(so)e(that)h(subsequen)m(t)f(computations) +g(ha)m(v)m(e)i(less)e(o)m(v)m(erhead.)450 628 y(Doing)f(normal)e +(computations)g(on)h(unnormalized)f(p)s(olynomials)g(ma)m(y)g(pro)s +(duce)g(wrong)g(results)h(or)450 737 y(crash)k(the)h(program.)-30 +887 y(The)f(follo)m(wing)i(op)s(erations)e(are)h(de\014ned)e(on)i(univ) +-5 b(ariate)31 b(p)s(olynomials.)-30 1036 y Fp(cl_univpoly_ring)26 +b(x.ring)j(\(\))450 1146 y Fr(Returns)g(the)i(ring)f(to)h(whic)m(h)f +(the)h(univ)-5 b(ariate)31 b(p)s(olynomial)f Fp(x)g Fr(b)s(elongs.)-30 +1295 y Fp(cl_UP)f(operator+)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))450 +1405 y Fr(Returns)g(the)i(sum)d(of)j(t)m(w)m(o)h(univ)-5 +b(ariate)31 b(p)s(olynomials.)-30 1554 y Fp(cl_UP)e(operator-)f +(\(const)g(cl_UP&,)h(const)g(cl_UP&\))450 1664 y Fr(Returns)g(the)i +(di\013erence)g(of)f(t)m(w)m(o)i(univ)-5 b(ariate)31 +b(p)s(olynomials.)-30 1813 y Fp(cl_UP)e(operator-)f(\(const)g(cl_UP&\)) +450 1923 y Fr(Returns)h(the)i(negativ)m(e)i(of)d(a)h(univ)-5 +b(ariate)31 b(p)s(olynomial.)-30 2072 y Fp(cl_UP)e(operator*)f(\(const) +g(cl_UP&,)h(const)g(cl_UP&\))450 2182 y Fr(Returns)i(the)i(pro)s(duct)d +(of)j(t)m(w)m(o)g(univ)-5 b(ariate)33 b(p)s(olynomials.)45 +b(One)32 b(of)g(the)g(argumen)m(ts)g(ma)m(y)f(also)j(b)s(e)450 +2291 y(a)d(plain)f(in)m(teger)i(or)e(an)g(elemen)m(t)h(of)g(the)f(base) +h(ring.)-30 2441 y Fp(cl_UP)e(square)g(\(const)f(cl_UP&\))450 +2550 y Fr(Returns)h(the)i(square)f(of)h(a)f(univ)-5 b(ariate)31 +b(p)s(olynomial.)-30 2700 y Fp(cl_UP)e(expt_pos)f(\(const)h(cl_UP&)f +(x,)i(const)f(cl_I&)g(y\))450 2809 y(y)h Fr(m)m(ust)f(b)s(e)h +Fp(>)g Fr(0.)41 b(Returns)30 b Fp(x^y)p Fr(.)-30 2959 +y Fp(bool)f(operator==)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))-30 +3068 y(bool)g(operator!=)f(\(const)g(cl_UP&,)h(const)g(cl_UP&\))450 +3178 y Fr(Compares)23 b(t)m(w)m(o)i(univ)-5 b(ariate)25 +b(p)s(olynomials,)g(b)s(elonging)g(to)g(the)f(same)g(univ)-5 +b(ariate)24 b(p)s(olynomial)g(ring,)450 3288 y(for)30 +b(equalit)m(y)-8 b(.)-30 3437 y Fp(cl_boolean)28 b(zerop)h(\(const)f +(cl_UP&)h(x\))450 3547 y Fr(Returns)g(true)i(if)f Fp(x)g +Fr(is)g Fp(0)g(in)g(R)p Fr(.)-30 3696 y Fp(sintL)f(degree)g(\(const)f +(cl_UP&)h(x\))450 3806 y Fr(Returns)g(the)i(degree)g(of)g(the)f(p)s (olynomial.)40 b(The)30 b(zero)h(p)s(olynomial)f(has)g(degree)h -Fp(-1)p Fr(.)0 665 y Fp(cl_ring_element)26 b(coeff)j(\(const)g(cl_UP&)f -(x,)i(uintL)f(index\))480 790 y Fr(Returns)g(the)i(co)s(e\016cien)m(t)h -(of)f Fp(X^index)d Fr(in)i(the)h(p)s(olynomial)f Fp(x)p -Fr(.)0 964 y Fp(cl_ring_element)c(x)k(\(const)f(cl_ring_element&)d(y\)) -480 1089 y Fr(Ev)-5 b(aluation:)40 b(If)25 b Fp(x)h Fr(is)h(a)f(p)s -(olynomial)g(and)g Fp(y)g Fr(b)s(elongs)g(to)h(the)f(base)h(ring,)g -(then)f(`)p Fp(x\(y\))p Fr(')g(returns)f(the)480 1213 -y(v)-5 b(alue)31 b(of)f(the)h(substitution)f(of)h Fp(y)f -Fr(in)m(to)h Fp(x)p Fr(.)0 1388 y Fp(cl_UP)e(deriv)g(\(const)g(cl_UP&)f -(x\))480 1512 y Fr(Returns)h(the)i(deriv)-5 b(ativ)m(e)32 -b(of)e(the)h(p)s(olynomial)f Fp(x)g Fr(with)g(resp)s(ect)g(to)h(the)g -(indeterminate)f Fp(X)p Fr(.)0 1811 y(The)g(follo)m(wing)i(output)e -(functions)g(are)g(de\014ned)g(\(see)h(also)g(the)g(c)m(hapter)g(on)f -(input/output\).)0 2110 y Fp(void)f(fprint)g(\(cl_ostream)e(stream,)i -(const)f(cl_UP&)h(x\))0 2234 y(cl_ostream)f(operator<<)f(\(cl_ostream)g -(stream,)i(const)g(cl_UP&)f(x\))480 2359 y Fr(Prin)m(ts)39 -b(the)g(univ)-5 b(ariate)40 b(p)s(olynomial)f Fp(x)f -Fr(on)h(the)h Fp(stream)p Fr(.)65 b(The)39 b(output)g(ma)m(y)f(dep)s -(end)g(on)h(the)480 2484 y(global)32 b(prin)m(ter)e(settings)h(in)f -(the)h(v)-5 b(ariable)31 b Fp(cl_default_print_flags)p -Fr(.)0 2932 y Fs(9.3)68 b(Sp)t(ecial)31 b(p)t(olynomials)0 -3206 y Fr(The)f(follo)m(wing)i(functions)e(return)f(sp)s(ecial)i(p)s -(olynomials.)0 3505 y Fp(cl_UP_I)d(cl_tschebychev)f(\(sintL)i(n\))480 -3629 y Fr(Returns)g(the)i(n-th)f(Tc)m(heb)m(yc)m(hev)h(p)s(olynomial)f -(\(n)g Fp(>)p Fr(=)g(0\).)0 3804 y Fp(cl_UP_I)e(cl_hermite)g(\(sintL)h -(n\))480 3928 y Fr(Returns)g(the)i(n-th)f(Hermite)g(p)s(olynomial)g -(\(n)g Fp(>)p Fr(=)g(0\).)0 4102 y Fp(cl_UP_RA)e(cl_legendre)f(\(sintL) -i(n\))480 4227 y Fr(Returns)g(the)i(n-th)f(Legendre)g(p)s(olynomial)g -(\(n)g Fp(>)p Fr(=)g(0\).)0 4401 y Fp(cl_UP_I)e(cl_laguerre)g(\(sintL)g -(n\))480 4526 y Fr(Returns)h(the)i(n-th)f(Laguerre)h(p)s(olynomial)e -(\(n)h Fp(>)p Fr(=)g(0\).)0 4825 y(Information)24 b(ho)m(w)h(to)h -(deriv)m(e)f(the)g(di\013eren)m(tial)i(equation)f(satis\014ed)f(b)m(y)f -(eac)m(h)j(of)e(these)g(p)s(olynomials)f(from)g(their)0 -4949 y(de\014nition)30 b(can)h(b)s(e)e(found)g(in)i(the)f -Fp(doc/polynomial/)c Fr(directory)-8 b(.)p eop -%%Page: 55 57 -55 56 bop 0 -116 a Fr(Chapter)30 b(10:)41 b(In)m(ternals)2950 -b(55)0 366 y Fo(10)80 b(In)l(ternals)0 944 y Fs(10.1)68 -b(Wh)l(y)31 b(C)p Ff(++)e Fs(?)0 1220 y Fr(Using)i(C)p -Fp(++)e Fr(as)i(an)f(implemen)m(tation)g(language)i(pro)m(vides)75 -1496 y Fq(\017)60 b Fr(E\016ciency:)41 b(It)31 b(compiles)f(to)h(mac)m -(hine)f(co)s(de.)75 1648 y Fq(\017)60 b Fr(P)m(ortabilit)m(y:)43 -b(It)29 b(runs)f(on)i(all)g(platforms)f(supp)s(orting)f(a)i(C)p -Fp(++)e Fr(compiler.)40 b(Because)31 b(of)f(the)g(a)m(v)-5 -b(ailabilit)m(y)33 b(of)180 1772 y(GNU)j(C)p Fp(++)p -Fr(,)f(this)g(includes)g(all)h(curren)m(tly)f(used)f(32-bit)i(and)f -(64-bit)h(platforms,)f(indep)s(enden)m(tly)g(of)g(the)180 -1897 y(qualit)m(y)d(of)e(the)h(v)m(endor's)f(C)p Fp(++)f -Fr(compiler.)75 2049 y Fq(\017)60 b Fr(T)m(yp)s(e)26 -b(safet)m(y:)40 b(The)25 b(C)p Fp(++)g Fr(compilers)h(kno)m(ws)g(ab)s -(out)g(the)g(n)m(um)m(b)s(er)e(t)m(yp)s(es)j(and)e(complains)h(if,)h -(for)f(example,)180 2173 y(y)m(ou)41 b(try)f(to)h(assign)g(a)f(\015oat) -h(to)g(an)g(in)m(teger)g(v)-5 b(ariable.)72 b(Ho)m(w)m(ev)m(er,)45 -b(a)c(dra)m(wbac)m(k)f(is)h(that)g(C)p Fp(++)e Fr(do)s(esn't)180 -2298 y(kno)m(w)27 b(ab)s(out)f(generic)i(t)m(yp)s(es,)g(hence)f(a)g -(restriction)h(lik)m(e)g(that)f Fp(operator+)h(\(const)g(cl_MI&,)h -(const)g(cl_)180 2422 y(MI&\))f Fr(requires)h(that)g(b)s(oth)g(argumen) +Fp(-1)p Fr(.)-30 3955 y Fp(cl_ring_element)26 b(coeff)j(\(const)g +(cl_UP&)f(x,)i(uintL)f(index\))450 4065 y Fr(Returns)g(the)i(co)s +(e\016cien)m(t)h(of)f Fp(X^index)d Fr(in)i(the)h(p)s(olynomial)f +Fp(x)p Fr(.)-30 4214 y Fp(cl_ring_element)c(x)k(\(const)f +(cl_ring_element&)d(y\))450 4324 y Fr(Ev)-5 b(aluation:)42 +b(If)29 b Fp(x)h Fr(is)h(a)f(p)s(olynomial)g(and)f Fp(y)h +Fr(b)s(elongs)g(to)h(the)g(base)f(ring,)g(then)g(`)p +Fp(x\(y\))p Fr(')g(returns)f(the)450 4433 y(v)-5 b(alue)31 +b(of)f(the)h(substitution)f(of)h Fp(y)f Fr(in)m(to)h +Fp(x)p Fr(.)-30 4583 y Fp(cl_UP)e(deriv)g(\(const)g(cl_UP&)f(x\))450 +4692 y Fr(Returns)h(the)i(deriv)-5 b(ativ)m(e)32 b(of)e(the)h(p)s +(olynomial)f Fp(x)g Fr(with)g(resp)s(ect)g(to)h(the)g(indeterminate)f +Fp(X)p Fr(.)-30 4842 y(The)g(follo)m(wing)i(output)e(functions)g(are)g +(de\014ned)g(\(see)h(also)g(the)g(c)m(hapter)g(on)f(input/output\).)-30 +4991 y Fp(void)f(fprint)g(\(cl_ostream)e(stream,)i(const)f(cl_UP&)h +(x\))-30 5101 y(cl_ostream)f(operator<<)f(\(cl_ostream)g(stream,)i +(const)g(cl_UP&)f(x\))450 5210 y Fr(Prin)m(ts)d(the)f(univ)-5 +b(ariate)26 b(p)s(olynomial)e Fp(x)g Fr(on)h(the)f Fp(stream)p +Fr(.)38 b(The)24 b(output)g(ma)m(y)g(dep)s(end)f(on)i(the)g(global)450 +5320 y(prin)m(ter)30 b(settings)h(in)f(the)h(v)-5 b(ariable)31 +b Fp(cl_default_print_flags)p Fr(.)p eop +%%Page: 42 44 +42 43 bop -30 -116 a Fr(Chapter)30 b(9:)41 b(Univ)-5 +b(ariate)32 b(p)s(olynomials)2483 b(42)-30 299 y Fs(9.3)68 +b(Sp)t(ecial)45 b(p)t(olynomials)-30 491 y Fr(The)30 +b(follo)m(wing)i(functions)e(return)f(sp)s(ecial)i(p)s(olynomials.)-30 +651 y Fp(cl_UP_I)d(cl_tschebychev)f(\(sintL)i(n\))450 +760 y Fr(Returns)g(the)i(n-th)f(Tc)m(heb)m(yc)m(hev)h(p)s(olynomial)f +(\(n)g Fp(>)p Fr(=)g(0\).)-30 920 y Fp(cl_UP_I)e(cl_hermite)g(\(sintL)h +(n\))450 1029 y Fr(Returns)g(the)i(n-th)f(Hermite)g(p)s(olynomial)g +(\(n)g Fp(>)p Fr(=)g(0\).)-30 1189 y Fp(cl_UP_RA)e(cl_legendre)f +(\(sintL)i(n\))450 1298 y Fr(Returns)g(the)i(n-th)f(Legendre)g(p)s +(olynomial)g(\(n)g Fp(>)p Fr(=)g(0\).)-30 1458 y Fp(cl_UP_I)e +(cl_laguerre)g(\(sintL)g(n\))450 1567 y Fr(Returns)h(the)i(n-th)f +(Laguerre)h(p)s(olynomial)e(\(n)h Fp(>)p Fr(=)g(0\).)-30 +1727 y(Information)e(ho)m(w)h(to)h(deriv)m(e)g(the)g(di\013eren)m(tial) +g(equation)h(satis\014ed)e(b)m(y)g(eac)m(h)h(of)g(these)g(p)s +(olynomials)e(from)g(their)-30 1836 y(de\014nition)i(can)h(b)s(e)e +(found)g(in)i(the)f Fp(doc/polynomial/)c Fr(directory)-8 +b(.)p eop +%%Page: 43 45 +43 44 bop -30 -116 a Fr(Chapter)30 b(10:)41 b(In)m(ternals)3010 +b(43)-30 299 y Fo(10)80 b(In)l(ternals)-30 651 y Fs(10.1)68 +b(Wh)l(y)45 b(C)p Fg(++)f Fs(?)-30 843 y Fr(Using)31 +b(C)p Fp(++)e Fr(as)i(an)f(implemen)m(tation)g(language)i(pro)m(vides) +45 977 y Fq(\017)60 b Fr(E\016ciency:)41 b(It)31 b(compiles)f(to)h(mac) +m(hine)f(co)s(de.)45 1111 y Fq(\017)60 b Fr(P)m(ortabilit)m(y:)49 +b(It)33 b(runs)f(on)h(all)h(platforms)f(supp)s(orting)e(a)j(C)p +Fp(++)e Fr(compiler.)50 b(Because)34 b(of)g(the)f(a)m(v)-5 +b(ailabilit)m(y)37 b(of)150 1220 y(GNU)j(C)p Fp(++)p +Fr(,)h(this)f(includes)f(all)h(curren)m(tly)g(used)e(32-bit)j(and)e +(64-bit)i(platforms,)g(indep)s(enden)m(tly)d(of)i(the)150 +1330 y(qualit)m(y)32 b(of)e(the)h(v)m(endor's)f(C)p Fp(++)f +Fr(compiler.)45 1464 y Fq(\017)60 b Fr(T)m(yp)s(e)30 +b(safet)m(y:)43 b(The)30 b(C)p Fp(++)g Fr(compilers)g(kno)m(ws)g(ab)s +(out)h(the)f(n)m(um)m(b)s(er)f(t)m(yp)s(es)h(and)h(complains)f(if,)h +(for)f(example,)150 1573 y(y)m(ou)44 b(try)f(to)i(assign)f(a)g(\015oat) +g(to)g(an)g(in)m(teger)h(v)-5 b(ariable.)81 b(Ho)m(w)m(ev)m(er,)50 +b(a)44 b(dra)m(wbac)m(k)g(is)f(that)h(C)p Fp(++)f Fr(do)s(esn't)150 +1683 y(kno)m(w)33 b(ab)s(out)h(generic)g(t)m(yp)s(es,)g(hence)g(a)g +(restriction)g(lik)m(e)h(that)f Fp(operator+)28 b(\(const)g(cl_MI&,)h +(const)g(cl_)150 1792 y(MI&\))j Fr(requires)h(that)g(b)s(oth)g(argumen) m(ts)f(b)s(elong)h(to)h(the)g(same)e(mo)s(dular)f(ring)i(cannot)h(b)s -(e)f(expressed)f(as)i(a)180 2547 y(compile-time)g(information.)75 -2698 y Fq(\017)60 b Fr(Algebraic)34 b(syn)m(tax:)46 b(The)32 +(e)f(expressed)f(as)i(a)150 1902 y(compile-time)c(information.)45 +2036 y Fq(\017)60 b Fr(Algebraic)37 b(syn)m(tax:)52 b(The)35 b(elemen)m(tary)h(op)s(erations)g Fp(+)p Fr(,)g Fp(-)p -Fr(,)g Fp(*)p Fr(,)g Fp(=)p Fr(,)g Fp(==)p Fr(,)g(...)48 -b(can)33 b(b)s(e)f(used)f(in)i(in\014x)e(notation,)180 -2823 y(whic)m(h)f(is)h(more)e(con)m(v)m(enien)m(t)k(than)d(Lisp)f +Fr(,)h Fp(*)p Fr(,)g Fp(=)p Fr(,)g Fp(==)p Fr(,)f(...)57 +b(can)36 b(b)s(e)f(used)f(in)i(in\014x)e(notation,)150 +2145 y(whic)m(h)c(is)h(more)e(con)m(v)m(enien)m(t)k(than)d(Lisp)f (notation)j(`)p Fp(\(+)e(x)g(y\))p Fr(')g(or)g(C)g(notation)i(`)p -Fp(add\(x,y,&z\))p Fr('.)0 3126 y(With)c(these)g(language)h(features,)g -(there)f(is)f(no)h(need)f(for)g(t)m(w)m(o)i(separate)g(languages,)h -(one)d(for)h(the)g(implemen)m(ta-)0 3251 y(tion)i(of)h(the)f(library)f -(and)h(one)g(in)g(whic)m(h)g(the)g(library's)f(users)h(can)g(program.) -39 b(This)29 b(means)g(that)i(a)f(protot)m(yp)s(e)0 3375 -y(implemen)m(tation)36 b(of)g(an)f(algorithm)h(can)h(b)s(e)e(in)m -(tegrated)i(in)m(to)g(the)f(library)g(immediately)f(after)i(it)f(has)g -(b)s(een)0 3500 y(tested)g(and)f(debugged.)55 b(No)36 -b(need)g(to)g(rewrite)f(it)h(in)f(a)h(lo)m(w-lev)m(el)i(language)f -(after)f(ha)m(ving)g(protot)m(yp)s(ed)f(in)h(a)0 3624 -y(high-lev)m(el)c(language.)0 4093 y Fs(10.2)68 b(Memory)31 -b(e\016ciency)0 4369 y Fr(In)f(order)g(to)h(sa)m(v)m(e)h(memory)c(allo) -s(cations,)33 b(CLN)d(implemen)m(ts:)75 4645 y Fq(\017)60 -b Fr(Ob)5 b(ject)31 b(sharing:)40 b(An)30 b(op)s(eration)h(lik)m(e)g -Fp(x+0)f Fr(returns)f Fp(x)h Fr(without)g(cop)m(ying)i(it.)75 -4797 y Fq(\017)60 b Fr(Garbage)42 b(collection:)64 b(A)41 -b(reference)g(coun)m(ting)h(mec)m(hanism)d(mak)m(es)i(sure)f(that)h(an) -m(y)g(n)m(um)m(b)s(er)e(ob)5 b(ject's)180 4922 y(storage)32 -b(is)e(freed)g(immediately)g(when)f(the)i(last)g(reference)g(to)g(the)g -(ob)5 b(ject)31 b(is)f(gone.)75 5073 y Fq(\017)60 b Fr(Small)20 -b(in)m(tegers)j(are)e(represen)m(ted)g(as)g(immediate)f(v)-5 -b(alues)22 b(instead)f(of)g(p)s(oin)m(ters)g(to)h(heap)f(allo)s(cated)i -(storage.)180 5198 y(This)44 b(means)g(that)i(in)m(tegers)g -Fp(>)30 b(-2^29)p Fr(,)48 b Fp(<)30 b(2^29)44 b Fr(don't)h(consume)f -(heap)h(memory)-8 b(,)47 b(unless)d(they)h(w)m(ere)180 -5322 y(explicitly)32 b(allo)s(cated)g(on)f(the)f(heap.)p -eop -%%Page: 56 58 -56 57 bop 0 -116 a Fr(Chapter)30 b(10:)41 b(In)m(ternals)2950 -b(56)0 366 y Fs(10.3)68 b(Sp)t(eed)30 b(e\016ciency)0 -640 y Fr(Sp)s(eed)f(e\016ciency)j(is)e(obtained)h(b)m(y)f(the)h(com)m -(bination)f(of)h(the)f(follo)m(wing)i(tric)m(ks)f(and)f(algorithms:)75 -914 y Fq(\017)60 b Fr(Small)38 b(in)m(tegers,)43 b(b)s(eing)c(represen) -m(ted)g(as)g(immediate)f(v)-5 b(alues,)42 b(don't)d(require)g(memory)e -(access,)43 b(just)c(a)180 1039 y(couple)31 b(of)f(instructions)h(for)f -(eac)m(h)h(elemen)m(tary)g(op)s(eration.)75 1188 y Fq(\017)60 -b Fr(The)27 b(k)m(ernel)h(of)f(CLN)g(has)g(b)s(een)g(written)g(in)g -(assem)m(bly)g(language)h(for)f(some)g(CPUs)g(\()p Fp(i386)p -Fr(,)g Fp(m68k)p Fr(,)g Fp(sparc)p Fr(,)180 1313 y Fp(mips)p -Fr(,)i Fp(arm)p Fr(\).)75 1462 y Fq(\017)60 b Fr(On)33 -b(all)i(CPUs,)g(CLN)f(ma)m(y)g(b)s(e)g(con\014gured)f(to)i(use)f(the)g -(sup)s(ere\016cien)m(t)g(lo)m(w-lev)m(el)j(routines)e(from)d(GNU)180 -1587 y(GMP)f(v)m(ersion)g(3.)75 1736 y Fq(\017)60 b Fr(F)-8 -b(or)32 b(large)g(n)m(um)m(b)s(ers,)e(CLN)h(uses,)g(instead)g(of)h(the) -f(standard)g Fp(O\(N^2\))e Fr(algorithm,)j(the)g(Karatsuba)f(m)m(ul-) -180 1861 y(tiplication,)i(whic)m(h)d(is)g(an)91 b Fn(O)s -Fr(\()p Fn(N)1368 1828 y Fh(1)p Fi(:)p Fh(6)1458 1861 -y Fr(\))31 b(algorithm.)75 2010 y Fq(\017)60 b Fr(F)-8 -b(or)45 b(v)m(ery)g(large)h(n)m(um)m(b)s(ers)c(\(more)i(than)g(12000)i -(decimal)f(digits\),)k(CLN)44 b(uses)g(Sc)m(h\177)-45 -b(onhage-Strassen)180 2135 y(m)m(ultiplication,)32 b(whic)m(h)e(is)g -(an)g(asymptotically)i(optimal)e(m)m(ultiplication)i(algorithm.)75 -2284 y Fq(\017)60 b Fr(These)27 b(fast)h(m)m(ultiplication)h -(algorithms)e(also)i(giv)m(e)g(impro)m(v)m(emen)m(ts)d(in)i(the)f(sp)s -(eed)g(of)h(division)f(and)g(radix)180 2409 y(con)m(v)m(ersion.)0 -2857 y Fs(10.4)68 b(Garbage)31 b(collection)0 3131 y -Fr(All)39 b(the)f(n)m(um)m(b)s(er)e(classes)j(are)g(reference)g(coun)m -(t)f(classes:)58 b(They)37 b(only)i(con)m(tain)g(a)g(p)s(oin)m(ter)f -(to)h(an)f(ob)5 b(ject)39 b(in)0 3256 y(the)h(heap.)71 -b(Up)s(on)39 b(construction,)44 b(assignmen)m(t)c(and)f(destruction)i -(of)f(n)m(um)m(b)s(er)e(ob)5 b(jects,)44 b(only)c(the)h(ob)5 -b(jects')0 3380 y(reference)31 b(coun)m(t)g(are)g(manipulated.)0 -3654 y(Memory)g(o)s(ccupied)g(b)m(y)g(n)m(um)m(b)s(er)d(ob)5 -b(jects)32 b(are)g(automatically)h(reclaimed)e(as)g(so)s(on)g(as)h -(their)f(reference)g(coun)m(t)0 3779 y(drops)e(to)i(zero.)0 -4053 y(F)-8 b(or)31 b(n)m(um)m(b)s(er)d(rings,)i(another)g(strategy)h -(is)f(implemen)m(ted:)39 b(There)30 b(is)g(a)h(cac)m(he)g(of,)g(for)f -(example,)g(the)g(mo)s(dular)0 4177 y(in)m(teger)k(rings.)49 -b(A)33 b(mo)s(dular)e(in)m(teger)j(ring)f(is)g(destro)m(y)m(ed)h(only)f -(if)g(its)g(reference)h(coun)m(t)f(dropp)s(ed)e(to)j(zero)g(and)0 -4302 y(the)40 b(cac)m(he)i(is)e(ab)s(out)g(to)g(b)s(e)g(resized.)70 -b(The)39 b(e\013ect)j(of)e(this)g(strategy)h(is)f(that)h(recen)m(tly)g -(used)e(rings)h(remain)0 4426 y(cac)m(hed,)32 b(whereas)e(undue)f -(memory)f(consumption)h(through)g(cac)m(hed)j(rings)e(is)g(a)m(v)m -(oided.)p eop -%%Page: 57 59 -57 58 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(57)0 366 y Fo(11)80 b(Using)30 -b(the)g(library)0 729 y Fr(F)-8 b(or)43 b(the)g(follo)m(wing)g -(discussion,)i(w)m(e)e(will)g(assume)e(that)i(y)m(ou)g(ha)m(v)m(e)g -(installed)g(the)g(CLN)f(source)g(in)g Fp($CLN_)0 854 -y(DIR)37 b Fr(and)g(built)h(it)g(in)g Fp($CLN_TARGETDIR)p -Fr(.)60 b(F)-8 b(or)38 b(example,)i(for)e(me)f(it's)h -Fp(CLN_DIR="$HOME/cln")33 b Fr(and)k Fp(CLN_)0 978 y -(TARGETDIR="$HOME/cln/lin)o(uxel)o(f")p Fr(.)g(Y)-8 b(ou)32 -b(migh)m(t)f(de\014ne)g(these)h(as)f(en)m(vironmen)m(t)g(v)-5 -b(ariables,)33 b(or)e(directly)0 1103 y(substitute)f(the)h(appropriate) -f(v)-5 b(alues.)0 1540 y Fs(11.1)68 b(Compiler)32 b(options)0 -1814 y Fr(Un)m(til)f(y)m(ou)g(ha)m(v)m(e)h(installed)f(CLN)f(in)g(a)h -(public)e(place,)j(the)e(follo)m(wing)i(options)f(are)g(needed:)0 -2088 y(When)f(y)m(ou)h(compile)f(CLN)g(application)i(co)s(de,)f(add)e -(the)i(\015ags)383 2341 y Fp(-I$CLN_DIR/include)43 b -(-I$CLN_TARGETDIR/include)0 2615 y Fr(to)25 b(the)f(C)p -Fp(++)f Fr(compiler's)h(command)e(line)j(\()p Fp(make)e -Fr(v)-5 b(ariable)25 b(CFLA)m(GS)f(or)g(CXXFLA)m(GS\).)i(When)e(y)m(ou) -g(link)g(CLN)0 2740 y(application)32 b(co)s(de)e(to)h(form)e(an)i -(executable,)h(add)e(the)g(\015ags)383 2993 y Fp -($CLN_TARGETDIR/src/libcln)o(.a)0 3267 y Fr(to)h(the)g(C/C)p +Fp(add\(x,y,&z\))p Fr('.)-30 2303 y(With)24 b(these)f(language)h +(features,)i(there)d(is)g(no)g(need)g(for)f(t)m(w)m(o)j(separate)f +(languages,)i(one)d(for)g(the)g(implemen)m(tation)-30 +2413 y(of)44 b(the)g(library)f(and)g(one)h(in)g(whic)m(h)f(the)h +(library's)g(users)f(can)h(program.)79 b(This)43 b(means)g(that)h(a)g +(protot)m(yp)s(e)-30 2523 y(implemen)m(tation)c(of)g(an)g(algorithm)g +(can)h(b)s(e)f(in)m(tegrated)h(in)m(to)h(the)e(library)g(immediately)f +(after)i(it)g(has)f(b)s(een)-30 2632 y(tested)g(and)e(debugged.)65 +b(No)39 b(need)g(to)g(rewrite)g(it)h(in)e(a)h(lo)m(w-lev)m(el)j +(language)e(after)f(ha)m(ving)g(protot)m(yp)s(ed)g(in)g(a)-30 +2742 y(high-lev)m(el)32 b(language.)-30 2997 y Fs(10.2)68 +b(Memory)45 b(e\016ciency)-30 3189 y Fr(In)30 b(order)g(to)h(sa)m(v)m +(e)h(memory)c(allo)s(cations,)33 b(CLN)d(implemen)m(ts:)45 +3323 y Fq(\017)60 b Fr(Ob)5 b(ject)31 b(sharing:)40 b(An)30 +b(op)s(eration)h(lik)m(e)g Fp(x+0)f Fr(returns)f Fp(x)h +Fr(without)g(cop)m(ying)i(it.)45 3457 y Fq(\017)60 b +Fr(Garbage)29 b(collection:)42 b(A)28 b(reference)h(coun)m(ting)g(mec)m +(hanism)d(mak)m(es)i(sure)f(that)i(an)m(y)f(n)m(um)m(b)s(er)d(ob)5 +b(ject's)29 b(stor-)150 3566 y(age)j(is)e(freed)g(immediately)g(when)f +(the)i(last)g(reference)g(to)g(the)f(ob)5 b(ject)32 b(is)e(gone.)45 +3700 y Fq(\017)60 b Fr(Small)35 b(in)m(tegers)h(are)g(represen)m(ted)f +(as)h(immediate)e(v)-5 b(alues)36 b(instead)g(of)f(p)s(oin)m(ters)h(to) +g(heap)f(allo)s(cated)i(stor-)150 3810 y(age.)51 b(This)33 +b(means)f(that)i(in)m(tegers)g Fp(>)d(-2^29)p Fr(,)h +Fp(<)f(2^29)h Fr(don't)h(consume)f(heap)h(memory)-8 b(,)33 +b(unless)g(they)g(w)m(ere)150 3919 y(explicitly)f(allo)s(cated)g(on)f +(the)f(heap.)-30 4174 y Fs(10.3)68 b(Sp)t(eed)45 b(e\016ciency)-30 +4366 y Fr(Sp)s(eed)29 b(e\016ciency)j(is)e(obtained)h(b)m(y)f(the)h +(com)m(bination)f(of)h(the)f(follo)m(wing)i(tric)m(ks)f(and)f +(algorithms:)45 4500 y Fq(\017)60 b Fr(Small)43 b(in)m(tegers,)49 +b(b)s(eing)43 b(represen)m(ted)h(as)g(immediate)f(v)-5 +b(alues,)48 b(don't)43 b(require)h(memory)e(access,)48 +b(just)c(a)150 4610 y(couple)31 b(of)f(instructions)h(for)f(eac)m(h)h +(elemen)m(tary)g(op)s(eration.)45 4744 y Fq(\017)60 b +Fr(The)31 b(k)m(ernel)h(of)f(CLN)g(has)g(b)s(een)g(written)g(in)g +(assem)m(bly)g(language)i(for)e(some)g(CPUs)f(\()p Fp(i386)p +Fr(,)h Fp(m68k)p Fr(,)g Fp(sparc)p Fr(,)150 4853 y Fp(mips)p +Fr(,)e Fp(arm)p Fr(\).)45 4987 y Fq(\017)60 b Fr(On)38 +b(all)h(CPUs,)h(CLN)e(ma)m(y)g(b)s(e)g(con\014gured)g(to)h(use)f(the)g +(sup)s(ere\016cien)m(t)h(lo)m(w-lev)m(el)i(routines)d(from)f(GNU)150 +5097 y(GMP)31 b(v)m(ersion)g(3.)45 5230 y Fq(\017)60 +b Fr(F)-8 b(or)32 b(large)g(n)m(um)m(b)s(ers,)e(CLN)g(uses,)i(instead)f +(of)h(the)f(standard)f Fp(O\(N^2\))g Fr(algorithm,)i(the)f(Karatsuba)g +(m)m(ulti-)150 5340 y(plication,)h(whic)m(h)e(is)h(an)f +Ff(O)s Fr(\()p Ff(N)1217 5307 y Fi(1)p Fj(:)p Fi(6)1307 +5340 y Fr(\))h(algorithm.)p eop +%%Page: 44 46 +44 45 bop -30 -116 a Fr(Chapter)30 b(10:)41 b(In)m(ternals)3010 +b(44)45 299 y Fq(\017)60 b Fr(F)-8 b(or)50 b(v)m(ery)g(large)g(n)m(um)m +(b)s(ers)d(\(more)i(than)g(12000)j(decimal)d(digits\),)55 +b(CLN)49 b(uses)g(Sc)m(h\177)-45 b(onhage-Strassen)150 +408 y(m)m(ultiplication,)32 b(whic)m(h)e(is)g(an)g(asymptotically)i +(optimal)e(m)m(ultiplication)i(algorithm.)45 543 y Fq(\017)60 +b Fr(These)32 b(fast)g(m)m(ultiplication)i(algorithms)e(also)h(giv)m(e) +g(impro)m(v)m(emen)m(ts)f(in)g(the)g(sp)s(eed)f(of)i(division)f(and)f +(radix)150 653 y(con)m(v)m(ersion.)-30 910 y Fs(10.4)68 +b(Garbage)46 b(collection)-30 1103 y Fr(All)33 b(the)g(n)m(um)m(b)s(er) +d(classes)j(are)g(reference)g(coun)m(t)g(classes:)46 +b(They)31 b(only)i(con)m(tain)h(a)f(p)s(oin)m(ter)f(to)h(an)f(ob)5 +b(ject)34 b(in)e(the)-30 1212 y(heap.)40 b(Up)s(on)27 +b(construction,)j(assignmen)m(t)e(and)g(destruction)h(of)f(n)m(um)m(b)s +(er)e(ob)5 b(jects,)30 b(only)f(the)f(ob)5 b(jects')29 +b(reference)-30 1322 y(coun)m(t)i(are)g(manipulated.)-30 +1456 y(Memory)k(o)s(ccupied)h(b)m(y)f(n)m(um)m(b)s(er)f(ob)5 +b(jects)36 b(are)h(automatically)g(reclaimed)f(as)g(so)s(on)f(as)h +(their)g(reference)g(coun)m(t)-30 1566 y(drops)29 b(to)i(zero.)-30 +1700 y(F)-8 b(or)34 b(n)m(um)m(b)s(er)e(rings,)i(another)g(strategy)h +(is)f(implemen)m(ted:)46 b(There)33 b(is)h(a)g(cac)m(he)h(of,)g(for)f +(example,)g(the)g(mo)s(dular)-30 1810 y(in)m(teger)29 +b(rings.)39 b(A)27 b(mo)s(dular)f(in)m(teger)j(ring)e(is)g(destro)m(y)m +(ed)h(only)g(if)f(its)h(reference)g(coun)m(t)g(dropp)s(ed)d(to)j(zero)g +(and)f(the)-30 1919 y(cac)m(he)36 b(is)f(ab)s(out)f(to)h(b)s(e)f +(resized.)54 b(The)34 b(e\013ect)i(of)e(this)h(strategy)h(is)e(that)h +(recen)m(tly)h(used)e(rings)g(remain)g(cac)m(hed,)-30 +2029 y(whereas)c(undue)f(memory)f(consumption)h(through)h(cac)m(hed)h +(rings)f(is)h(a)m(v)m(oided.)p eop +%%Page: 45 47 +45 46 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(45)-30 299 y Fo(11)80 b(Using)54 +b(the)f(library)-30 523 y Fr(F)-8 b(or)47 b(the)g(follo)m(wing)g +(discussion,)j(w)m(e)d(will)g(assume)e(that)h(y)m(ou)h(ha)m(v)m(e)h +(installed)f(the)f(CLN)g(source)g(in)g Fp($CLN_)-30 632 +y(DIR)41 b Fr(and)g(built)h(it)g(in)g Fp($CLN_TARGETDIR)p +Fr(.)71 b(F)-8 b(or)43 b(example,)h(for)e(me)f(it's)h +Fp(CLN_DIR="$HOME/cln")37 b Fr(and)k Fp(CLN_)-30 742 +y(TARGETDIR="$HOME/cln/lin)o(uxel)o(f")p Fr(.)53 b(Y)-8 +b(ou)38 b(migh)m(t)e(de\014ne)g(these)h(as)g(en)m(vironmen)m(t)f(v)-5 +b(ariables,)40 b(or)c(directly)-30 851 y(substitute)30 +b(the)h(appropriate)f(v)-5 b(alues.)-30 1103 y Fs(11.1)68 +b(Compiler)46 b(options)-30 1293 y Fr(Un)m(til)31 b(y)m(ou)g(ha)m(v)m +(e)h(installed)f(CLN)f(in)g(a)h(public)e(place,)j(the)e(follo)m(wing)i +(options)f(are)g(needed:)-30 1426 y(When)f(y)m(ou)h(compile)f(CLN)g +(application)i(co)s(de,)f(add)e(the)i(\015ags)353 1552 +y Fp(-I$CLN_DIR/include)43 b(-I$CLN_TARGETDIR/include)-30 +1685 y Fr(to)29 b(the)g(C)p Fp(++)e Fr(compiler's)h(command)f(line)h +(\()p Fp(make)g Fr(v)-5 b(ariable)29 b(CFLA)m(GS)g(or)f(CXXFLA)m(GS\).) +i(When)e(y)m(ou)h(link)f(CLN)-30 1794 y(application)k(co)s(de)e(to)h +(form)e(an)i(executable,)h(add)e(the)g(\015ags)353 1921 +y Fp($CLN_TARGETDIR/src/libcln)o(.a)-30 2053 y Fr(to)h(the)g(C/C)p Fp(++)e Fr(compiler's)h(command)e(line)j(\()p Fp(make)f -Fr(v)-5 b(ariable)31 b(LIBS\).)0 3541 y(If)20 b(y)m(ou)g(did)g(a)h -Fp(make)29 b(install)p Fr(,)20 b(the)h(include)f(\014les)g(are)h -(installed)g(in)f(a)g(public)g(directory)h(\(normally)f -Fp(/usr/local/include)p Fr(\),)0 3665 y(hence)k(y)m(ou)f(don't)h(need)f -(sp)s(ecial)h(\015ags)g(for)f(compiling.)38 b(The)23 -b(library)g(has)h(b)s(een)e(installed)j(to)f(a)g(public)e(directory)0 -3790 y(as)33 b(w)m(ell)h(\(normally)f Fp(/usr/local/lib)p -Fr(\),)e(hence)i(when)f(linking)h(a)h(CLN)f(application)h(it)g(is)f -(su\016cien)m(t)h(to)f(giv)m(e)0 3915 y(the)e(\015ag)f -Fp(-lcln)p Fr(.)0 4352 y Fs(11.2)68 b(Include)30 b(\014les)0 -4626 y Fr(Here)h(is)f(a)h(summary)c(of)k(the)f(include)h(\014les)f(and) -g(their)g(con)m(ten)m(ts.)0 4922 y Fp()480 -5047 y Fr(General)h(de\014nitions,)f(reference)h(coun)m(ting,)h -(garbage)f(collection.)0 5215 y Fp()480 -5340 y Fr(The)f(class)h(cl)p 950 5340 28 4 v 33 w(n)m(um)m(b)s(er.)p +Fr(v)-5 b(ariable)31 b(LIBS\).)-30 2186 y(If)62 b(y)m(ou)h(did)f(a)h +Fp(make)29 b(install)p Fr(,)69 b(the)62 b(include)h(\014les)f(are)h +(installed)g(in)g(a)f(public)g(directory)h(\(normally)-30 +2295 y Fp(/usr/local/include)p Fr(\),)45 b(hence)g(y)m(ou)h(don't)g +(need)f(sp)s(ecial)h(\015ags)g(for)f(compiling.)85 b(The)45 +b(library)g(has)h(b)s(een)-30 2405 y(installed)i(to)g(a)f(public)f +(directory)i(as)f(w)m(ell)h(\(normally)f Fp(/usr/local/lib)p +Fr(\),)h(hence)f(when)f(linking)h(a)g(CLN)-30 2514 y(application)32 +b(it)f(is)f(su\016cien)m(t)h(to)g(giv)m(e)h(the)e(\015ag)h +Fp(-lcln)p Fr(.)-30 2766 y Fs(11.2)68 b(Include)45 b(\014les)-30 +2956 y Fr(Here)31 b(is)f(a)h(summary)c(of)k(the)f(include)h(\014les)f +(and)g(their)g(con)m(ten)m(ts.)-30 3111 y Fp()450 +3221 y Fr(General)h(de\014nitions,)f(reference)h(coun)m(ting,)h +(garbage)f(collection.)-30 3376 y Fp()450 +3486 y Fr(The)f(class)h(cl)p 920 3486 28 4 v 33 w(n)m(um)m(b)s(er.)-30 +3641 y Fp()450 3751 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 3751 V 34 w(N,)f(the)h(complex)f(n)m(um)m(b)s +(ers.)-30 3906 y Fp()450 4016 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 4016 V 34 w(R,)f(the)h(real)g(n)m(um)m(b)s +(ers.)-30 4171 y Fp()450 4281 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 4281 V 34 w(F,)f(the)h(\015oats.)-30 +4436 y Fp()450 4545 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 4545 V 34 w(SF,)f(the)h(short-\015oats.)-30 +4701 y Fp()450 4810 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 4810 V 34 w(FF,)g(the)f(single-\015oats.)-30 +4966 y Fp()450 5075 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 5075 V 34 w(DF,)g(the)f(double-\015oats.)-30 +5230 y Fp()450 5340 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 5340 V 34 w(LF,)f(the)h(long-\015oats.)p eop -%%Page: 58 60 -58 59 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(58)0 366 y Fp()480 -491 y Fr(F)-8 b(unctions)31 b(for)f(class)h(cl)p 1318 -491 28 4 v 34 w(N,)f(the)h(complex)f(n)m(um)m(b)s(ers.)0 -670 y Fp()480 794 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 794 V 34 w(R,)f(the)h(real)g(n)m(um)m(b)s -(ers.)0 973 y Fp()480 1097 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 1097 V 34 w(F,)f(the)h(\015oats.)0 -1276 y Fp()480 1400 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 1400 V 34 w(SF,)f(the)h(short-\015oats.)0 -1579 y Fp()480 1703 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 1703 V 34 w(FF,)g(the)f(single-\015oats.)0 -1882 y Fp()480 2006 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 2006 V 34 w(DF,)g(the)f(double-\015oats.)0 -2185 y Fp()480 2309 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 2309 V 34 w(LF,)f(the)h(long-\015oats.)0 -2488 y Fp()480 2612 y Fr(F)-8 b(unctions)31 -b(for)f(class)h(cl)p 1318 2612 V 34 w(RA,)f(the)h(rational)g(n)m(um)m -(b)s(ers.)0 2791 y Fp()480 2916 y Fr(F)-8 -b(unctions)31 b(for)f(class)h(cl)p 1318 2916 V 34 w(I,)f(the)h(in)m -(tegers.)0 3094 y Fp()480 3219 y Fr(Input/Output.)0 -3397 y Fp()480 3522 y Fr(Input/Output)d(for)j(class)g -(cl)p 1491 3522 V 33 w(N,)g(the)f(complex)g(n)m(um)m(b)s(ers.)0 -3700 y Fp()480 3825 y Fr(Input/Output)e(for)j(class)g(cl) -p 1491 3825 V 33 w(R,)g(the)f(real)h(n)m(um)m(b)s(ers.)0 -4003 y Fp()480 4128 y Fr(Input/Output)d(for)j(class)g -(cl)p 1491 4128 V 33 w(F,)g(the)g(\015oats.)0 4306 y -Fp()480 4431 y Fr(Input/Output)d(for)j(class)g(cl)p -1491 4431 V 33 w(SF,)f(the)h(short-\015oats.)0 4609 y -Fp()480 4734 y Fr(Input/Output)d(for)j(class)g(cl)p -1491 4734 V 33 w(FF,)g(the)g(single-\015oats.)0 4912 -y Fp()480 5037 y Fr(Input/Output)d(for)j(class)g(cl)p -1491 5037 V 33 w(DF,)g(the)g(double-\015oats.)0 5215 -y Fp()480 5340 y Fr(Input/Output)d(for)j(class)g(cl)p -1491 5340 V 33 w(LF,)g(the)f(long-\015oats.)p eop -%%Page: 59 61 -59 60 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(59)0 366 y Fp()480 -491 y Fr(Input/Output)28 b(for)j(class)g(cl)p 1491 491 -28 4 v 33 w(RA,)g(the)f(rational)i(n)m(um)m(b)s(ers.)0 -670 y Fp()480 794 y Fr(Input/Output)c(for)j(class)g -(cl)p 1491 794 V 33 w(I,)f(the)h(in)m(tegers.)0 973 y -Fp()480 1097 y Fr(Flags)h(for)e(customizing)g(input)g(op)s -(erations.)0 1276 y Fp()480 1400 y Fr(Flags)i(for)e -(customizing)g(output)g(op)s(erations.)0 1579 y Fp()480 -1703 y(cl_malloc_hook)p Fr(,)d Fp(cl_free_hook)p Fr(.)0 -1882 y Fp()480 2006 y(cl_abort)p Fr(.)0 2185 -y Fp()480 2309 y Fr(Conditions/exceptions.)0 -2488 y Fp()480 2612 y Fr(Strings.)0 2791 -y Fp()480 2916 y Fr(Sym)m(b)s(ols.)0 3094 -y Fp()480 3219 y Fr(Prop)s(ert)m(y)j(lists.)0 -3397 y Fp()480 3522 y Fr(General)h(rings.)0 -3700 y Fp()480 3825 y Fr(The)f(n)m(ull)g(ring.)0 -4003 y Fp()480 4128 y Fr(The)g(ring)g(of)h(complex)f -(n)m(um)m(b)s(ers.)0 4306 y Fp()480 4431 -y Fr(The)g(ring)g(of)h(real)g(n)m(um)m(b)s(ers.)0 4609 -y Fp()480 4734 y Fr(The)f(ring)g(of)h(rational)g(n) -m(um)m(b)s(ers.)0 4912 y Fp()480 5037 -y Fr(The)f(ring)g(of)h(in)m(tegers.)0 5215 y Fp()480 -5340 y Fr(Num)m(b)s(er)d(threory)i(functions.)p eop -%%Page: 60 62 -60 61 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(60)0 366 y Fp()480 -491 y Fr(Mo)s(dular)30 b(in)m(tegers.)0 659 y Fp()96 -b Fr(V)-8 b(ectors.)0 827 y Fp()480 952 y Fr(General)31 -b(v)m(ectors.)0 1120 y Fp()480 1244 y -Fr(General)g(v)m(ectors)h(o)m(v)m(er)g(cl)p 1393 1244 -28 4 v 33 w(n)m(um)m(b)s(er.)0 1412 y Fp()480 -1537 y Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1393 -1537 V 33 w(N.)0 1705 y Fp()480 1829 y -Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1393 1829 -V 33 w(R.)0 1997 y Fp()480 2122 y Fr(General)f(v)m -(ectors)h(o)m(v)m(er)g(cl)p 1393 2122 V 33 w(RA.)0 2290 -y Fp()480 2414 y Fr(General)f(v)m(ectors)h(o)m(v)m(er) -g(cl)p 1393 2414 V 33 w(I.)0 2582 y Fp()480 -2707 y Fr(General)f(v)m(ectors)h(of)f(mo)s(dular)d(in)m(tegers.)0 -2875 y Fp()480 3000 y Fr(Simple)h(v)m(ectors.)0 -3168 y Fp()480 3292 y Fr(Simple)g(v)m(ectors)j(o)m(v)m -(er)g(cl)p 1352 3292 V 33 w(n)m(um)m(b)s(er.)0 3460 y -Fp()480 3585 y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g -(cl)p 1352 3585 V 33 w(N.)0 3753 y Fp()480 -3877 y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g(cl)p 1352 -3877 V 33 w(R.)0 4045 y Fp()480 4170 -y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g(cl)p 1352 4170 -V 33 w(RA.)0 4338 y Fp()480 4462 y Fr(Simple)d(v)m -(ectors)j(o)m(v)m(er)g(cl)p 1352 4462 V 33 w(I.)0 4630 -y Fp()480 4755 y Fr(Simple)d(v)m(ectors)j(of)e -(general)i(ring)e(elemen)m(ts.)0 4923 y Fp()480 -5047 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials.)0 5215 -y Fp()480 5340 y Fr(Univ)-5 b(ariate)32 -b(p)s(olynomials)d(o)m(v)m(er)j(the)f(in)m(tegers.)p -eop -%%Page: 61 63 -61 62 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(61)0 366 y Fp()480 -491 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f -(rational)g(n)m(um)m(b)s(ers.)0 671 y Fp()480 -795 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f -(real)g(n)m(um)m(b)s(ers.)0 975 y Fp()480 -1099 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f -(complex)f(n)m(um)m(b)s(ers.)0 1279 y Fp()480 -1403 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(mo)s -(dular)c(in)m(teger)k(rings.)0 1583 y Fp()480 -1707 y Fr(Timing)d(facilities.)0 1887 y Fp()144 -b Fr(Includes)30 b(all)h(of)f(the)h(ab)s(o)m(v)m(e.)0 -2359 y Fs(11.3)68 b(An)30 b(Example)0 2635 y Fr(A)g(function)h(whic)m -(h)f(computes)f(the)i(n)m(th)f(Fib)s(onacci)h(n)m(um)m(b)s(er)d(can)j -(b)s(e)f(written)g(as)h(follo)m(ws.)240 2891 y Fp(#include)46 -b()240 2995 y(#include)g()240 -3203 y(//)h(Returns)f(F_n,)h(computed)e(as)i(the)g(nearest)f(integer)g -(to)240 3306 y(//)h(\(\(1+sqrt\(5\)\)/2\)^n/sqrt\(5\))o(.)42 -b(Assume)k(n>=0.)240 3410 y(const)g(cl_I)h(fibonacci)e(\(int)i(n\))240 -3514 y({)622 3618 y(//)g(Need)g(a)g(precision)e(of)j -(\(\(1+sqrt\(5\)\)/2\)^-n.)622 3722 y(cl_float_format_t)43 +%%Page: 46 48 +46 47 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(46)-30 299 y Fp()450 +408 y Fr(F)-8 b(unctions)31 b(for)f(class)h(cl)p 1288 +408 28 4 v 34 w(RA,)f(the)h(rational)g(n)m(um)m(b)s(ers.)-30 +573 y Fp()450 682 y Fr(F)-8 b(unctions)31 +b(for)f(class)h(cl)p 1288 682 V 34 w(I,)f(the)h(in)m(tegers.)-30 +847 y Fp()450 956 y Fr(Input/Output.)-30 1121 +y Fp()450 1230 y Fr(Input/Output)d(for)j(class)g(cl)p +1461 1230 V 33 w(N,)g(the)f(complex)g(n)m(um)m(b)s(ers.)-30 +1395 y Fp()450 1504 y Fr(Input/Output)e(for)j(class)g(cl) +p 1461 1504 V 33 w(R,)g(the)f(real)h(n)m(um)m(b)s(ers.)-30 +1669 y Fp()450 1778 y Fr(Input/Output)d(for)j(class)g +(cl)p 1461 1778 V 33 w(F,)g(the)g(\015oats.)-30 1943 +y Fp()450 2052 y Fr(Input/Output)d(for)j(class)g(cl)p +1461 2052 V 33 w(SF,)f(the)h(short-\015oats.)-30 2217 +y Fp()450 2326 y Fr(Input/Output)d(for)j(class)g(cl)p +1461 2326 V 33 w(FF,)g(the)g(single-\015oats.)-30 2491 +y Fp()450 2600 y Fr(Input/Output)d(for)j(class)g(cl)p +1461 2600 V 33 w(DF,)g(the)g(double-\015oats.)-30 2765 +y Fp()450 2874 y Fr(Input/Output)d(for)j(class)g(cl)p +1461 2874 V 33 w(LF,)g(the)f(long-\015oats.)-30 3039 +y Fp()450 3148 y Fr(Input/Output)e(for)j(class)g(cl)p +1461 3148 V 33 w(RA,)g(the)f(rational)i(n)m(um)m(b)s(ers.)-30 +3313 y Fp()450 3422 y Fr(Input/Output)c(for)j(class)g +(cl)p 1461 3422 V 33 w(I,)f(the)h(in)m(tegers.)-30 3587 +y Fp()450 3696 y Fr(Flags)h(for)e(customizing)g(input)g(op) +s(erations.)-30 3861 y Fp()450 3970 y Fr(Flags)i(for)e +(customizing)g(output)g(op)s(erations.)-30 4134 y Fp()450 +4244 y(cl_malloc_hook)p Fr(,)d Fp(cl_free_hook)p Fr(.)-30 +4408 y Fp()450 4518 y(cl_abort)p Fr(.)-30 +4682 y Fp()450 4792 y Fr(Conditions/exceptions.)-30 +4956 y Fp()450 5066 y Fr(Strings.)-30 5230 +y Fp()450 5340 y Fr(Sym)m(b)s(ols.)p eop +%%Page: 47 49 +47 48 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(47)-30 299 y Fp()450 +408 y Fr(Prop)s(ert)m(y)30 b(lists.)-30 564 y Fp()450 +674 y Fr(General)h(rings.)-30 830 y Fp()450 +939 y Fr(The)f(n)m(ull)g(ring.)-30 1095 y Fp()450 +1204 y Fr(The)g(ring)g(of)h(complex)f(n)m(um)m(b)s(ers.)-30 +1360 y Fp()450 1470 y Fr(The)g(ring)g(of)h(real)g(n)m +(um)m(b)s(ers.)-30 1625 y Fp()450 +1735 y Fr(The)f(ring)g(of)h(rational)g(n)m(um)m(b)s(ers.)-30 +1891 y Fp()450 2000 y Fr(The)f(ring)g(of)h(in)m +(tegers.)-30 2156 y Fp()450 2266 y Fr(Num)m(b)s(er)d +(threory)i(functions.)-30 2421 y Fp()450 +2531 y Fr(Mo)s(dular)g(in)m(tegers.)-30 2687 y Fp()96 +b Fr(V)-8 b(ectors.)-30 2842 y Fp()450 2952 +y Fr(General)31 b(v)m(ectors.)-30 3108 y Fp()450 +3217 y Fr(General)g(v)m(ectors)h(o)m(v)m(er)g(cl)p 1363 +3217 28 4 v 33 w(n)m(um)m(b)s(er.)-30 3373 y Fp()450 +3483 y Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1363 +3483 V 33 w(N.)-30 3638 y Fp()450 3748 +y Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1363 3748 +V 33 w(R.)-30 3904 y Fp()450 4013 y +Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1363 4013 +V 33 w(RA.)-30 4169 y Fp()450 4279 y +Fr(General)f(v)m(ectors)h(o)m(v)m(er)g(cl)p 1363 4279 +V 33 w(I.)-30 4434 y Fp()450 4544 +y Fr(General)f(v)m(ectors)h(of)f(mo)s(dular)d(in)m(tegers.)-30 +4700 y Fp()450 4809 y Fr(Simple)h(v)m(ectors.)-30 +4965 y Fp()450 5075 y Fr(Simple)g(v)m(ectors)j(o)m(v)m +(er)g(cl)p 1322 5075 V 33 w(n)m(um)m(b)s(er.)-30 5230 +y Fp()450 5340 y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g +(cl)p 1322 5340 V 33 w(N.)p eop +%%Page: 48 50 +48 49 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(48)-30 299 y Fp()450 +408 y Fr(Simple)29 b(v)m(ectors)j(o)m(v)m(er)g(cl)p 1322 +408 28 4 v 33 w(R.)-30 575 y Fp()450 +685 y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g(cl)p 1322 +685 V 33 w(RA.)-30 852 y Fp()450 961 +y Fr(Simple)d(v)m(ectors)j(o)m(v)m(er)g(cl)p 1322 961 +V 33 w(I.)-30 1128 y Fp()450 1238 y +Fr(Simple)d(v)m(ectors)j(of)e(general)i(ring)e(elemen)m(ts.)-30 +1405 y Fp()450 1514 y Fr(Univ)-5 b(ariate)32 +b(p)s(olynomials.)-30 1681 y Fp()450 +1791 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f(in) +m(tegers.)-30 1958 y Fp()450 +2067 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f +(rational)g(n)m(um)m(b)s(ers.)-30 2234 y Fp()450 +2344 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f +(real)g(n)m(um)m(b)s(ers.)-30 2511 y Fp()450 +2620 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(the)f +(complex)f(n)m(um)m(b)s(ers.)-30 2787 y Fp()450 +2897 y Fr(Univ)-5 b(ariate)32 b(p)s(olynomials)d(o)m(v)m(er)j(mo)s +(dular)c(in)m(teger)k(rings.)-30 3064 y Fp()450 +3173 y Fr(Timing)d(facilities.)-30 3340 y Fp()144 +b Fr(Includes)30 b(all)h(of)f(the)h(ab)s(o)m(v)m(e.)-30 +3616 y Fs(11.3)68 b(An)44 b(Example)-30 3816 y Fr(A)30 +b(function)h(whic)m(h)f(computes)f(the)i(n)m(th)f(Fib)s(onacci)h(n)m +(um)m(b)s(er)d(can)j(b)s(e)f(written)g(as)h(follo)m(ws.)210 +3953 y Fp(#include)46 b()210 4056 y(#include)g +()210 4264 y(//)h(Returns)f(F_n,)h(computed)e(as)i(the)g +(nearest)f(integer)g(to)210 4368 y(//)h +(\(\(1+sqrt\(5\)\)/2\)^n/sqrt\(5\))o(.)42 b(Assume)k(n>=0.)210 +4472 y(const)g(cl_I)h(fibonacci)e(\(int)i(n\))210 4575 +y({)592 4679 y(//)g(Need)g(a)g(precision)e(of)j +(\(\(1+sqrt\(5\)\)/2\)^-n.)592 4783 y(cl_float_format_t)43 b(prec)k(=)g(cl_float_format\(\(int\)\(0.)o(2089)o(8764)o(1*n)o(+5\)\)) -o(;)622 3825 y(cl_R)f(sqrt5)h(=)g(sqrt\(cl_float\(5,prec\)\);)622 -3929 y(cl_R)f(phi)h(=)h(\(1+sqrt5\)/2;)622 4033 y(return)e(round1\()g -(expt\(phi,n\)/sqrt5)d(\);)240 4137 y(})0 4413 y Fr(Let's)31 -b(explain)g(what)f(is)g(going)i(on)e(in)g(detail.)0 4690 -y(The)j(include)h(\014le)g Fp()c Fr(is)k(necessary)g(b)s -(ecause)g(the)g(t)m(yp)s(e)g Fp(cl_I)e Fr(is)i(used)f(in)h(the)g -(function,)h(and)0 4814 y(the)30 b(include)g(\014le)g -Fp()d Fr(is)j(needed)g(for)g(the)g(t)m(yp)s(e)h -Fp(cl_R)e Fr(and)g(the)h(\015oating)h(p)s(oin)m(t)f(n)m(um)m(b)s(er)e -(functions.)0 4939 y(The)i(order)g(of)g(the)h(include)f(\014les)g(do)s -(es)g(not)h(matter.)0 5215 y(Then)h(comes)i(the)f(function)h -(declaration.)51 b(The)33 b(argumen)m(t)g(is)g(an)h Fp(int)p -Fr(,)f(the)h(result)f(an)h(in)m(teger.)51 b(The)33 b(return)0 -5340 y(t)m(yp)s(e)26 b(is)g(de\014ned)f(as)h(`)p Fp(const)j(cl_I)p -Fr(',)d(not)h(simply)d(`)p Fp(cl_I)p Fr(',)i(b)s(ecause)g(that)h(allo)m -(ws)g(the)f(compiler)g(to)h(detect)g(t)m(yp)s(os)p eop -%%Page: 62 64 -62 63 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(62)0 366 y(lik)m(e)40 b(`)p Fp(fibonacci\(n\))27 -b(=)j(100)p Fr('.)64 b(It)39 b(w)m(ould)f(b)s(e)g(p)s(ossible)g(to)h -(declare)g(the)g(return)e(t)m(yp)s(e)i(as)g Fp(const)29 -b(cl_R)37 b Fr(\(real)0 491 y(n)m(um)m(b)s(er\))28 b(or)h(ev)m(en)i -Fp(const)e(cl_N)f Fr(\(complex)i(n)m(um)m(b)s(er\).)39 -b(W)-8 b(e)31 b(use)e(the)h(most)f(sp)s(ecialized)i(p)s(ossible)e -(return)g(t)m(yp)s(e)0 616 y(b)s(ecause)34 b(functions)f(whic)m(h)g -(call)i(`)p Fp(fibonacci)p Fr(')d(will)i(b)s(e)f(able)h(to)g(pro\014t)f -(from)f(the)i(compiler's)f(t)m(yp)s(e)h(analysis:)0 740 -y(Adding)j(t)m(w)m(o)h(in)m(tegers)h(is)e(sligh)m(tly)h(more)f -(e\016cien)m(t)h(than)f(adding)g(the)h(same)e(ob)5 b(jects)38 -b(declared)g(as)f(complex)0 865 y(n)m(um)m(b)s(ers,)30 -b(b)s(ecause)i(it)g(needs)g(less)g(t)m(yp)s(e)g(dispatc)m(h.)46 -b(Also,)33 b(when)e(linking)h(to)h(CLN)e(as)h(a)h(non-shared)e(library) --8 b(,)0 989 y(this)30 b(minimizes)f(the)i(size)g(of)f(the)h(resulting) -f(executable)i(program.)0 1263 y(The)37 b(result)g(will)g(b)s(e)g -(computed)f(as)h(expt\(phi,n\)/sqrt\(5\),)k(rounded)35 -b(to)j(the)g(nearest)f(in)m(teger.)63 b(In)36 b(order)h(to)0 -1388 y(get)h(a)f(correct)h(result,)h(the)e(absolute)h(error)e(should)g -(b)s(e)g(less)h(than)g(1/2,)j(i.e.)61 b(the)37 b(relativ)m(e)i(error)e -(should)f(b)s(e)0 1512 y(less)28 b(than)g -(sqrt\(5\)/\(2*expt\(phi,n\)\).)43 b(T)-8 b(o)29 b(this)f(end,)g(the)h -(\014rst)e(line)i(computes)e(a)i(\015oating)g(p)s(oin)m(t)f(precision)g -(for)0 1637 y(sqrt\(5\))j(and)f(phi.)0 1911 y(Then)37 -b(sqrt\(5\))i(is)e(computed)g(b)m(y)h(\014rst)f(con)m(v)m(erting)j(the) -e(in)m(teger)h(5)f(to)h(a)f(\015oating)h(p)s(oin)m(t)e(n)m(um)m(b)s(er) -f(and)h(than)0 2035 y(taking)j(the)f(square)f(ro)s(ot.)67 -b(The)38 b(con)m(v)m(erse,)43 b(\014rst)38 b(taking)i(the)f(square)f -(ro)s(ot)h(of)g(5,)j(and)c(then)h(con)m(v)m(erting)h(to)0 -2160 y(the)c(desired)g(precision,)h(w)m(ould)f(not)g(w)m(ork)g(in)g -(CLN:)g(The)f(square)h(ro)s(ot)g(w)m(ould)g(b)s(e)f(computed)g(to)h(a)h -(default)0 2284 y(precision)e(\(normally)g(single-\015oat)h -(precision\),)h(and)e(the)g(follo)m(wing)h(con)m(v)m(ersion)g(could)f -(not)h(help)e(ab)s(out)h(the)0 2409 y(lac)m(king)i(accuracy)-8 -b(.)58 b(This)35 b(is)h(b)s(ecause)f(CLN)g(is)h(not)g(a)g(sym)m(b)s -(olic)f(computer)f(algebra)j(system)d(and)h(do)s(es)h(not)0 -2533 y(represen)m(t)30 b(sqrt\(5\))i(in)e(a)h(non-n)m(umeric)d(w)m(a)m -(y)-8 b(.)0 2807 y(The)38 b(t)m(yp)s(e)h Fp(cl_R)f Fr(for)h(sqrt5)g -(and,)i(in)d(the)h(follo)m(wing)i(line,)g(phi)d(is)h(the)g(only)g(p)s -(ossible)g(c)m(hoice.)68 b(Y)-8 b(ou)39 b(cannot)0 2932 -y(write)28 b Fp(cl_F)e Fr(b)s(ecause)i(the)f(C)p Fp(++)g -Fr(compiler)g(can)h(only)f(infer)g(that)h Fp(cl_float\(5,prec\))23 -b Fr(is)28 b(a)g(real)g(n)m(um)m(b)s(er.)37 b(Y)-8 b(ou)0 -3056 y(cannot)31 b(write)g Fp(cl_N)e Fr(b)s(ecause)h(a)h(`)p -Fp(round1)p Fr(')e(do)s(es)h(not)h(exist)g(for)f(general)h(complex)f(n) -m(um)m(b)s(ers.)0 3330 y(When)44 b(the)h(function)f(returns,)j(all)e -(the)g(lo)s(cal)g(v)-5 b(ariables)45 b(in)f(the)h(function)f(are)h -(automatically)h(reclaimed)0 3455 y(\(garbage)32 b(collected\).)43 -b(Only)30 b(the)h(result)f(surviv)m(es)g(and)g(gets)h(passed)f(to)h -(the)g(caller.)0 3729 y(The)j(\014le)g Fp(fibonacci.cc)d -Fr(in)j(the)h(sub)s(directory)e Fp(examples)f Fr(con)m(tains)k(this)e -(implemen)m(tation)g(together)i(with)0 3853 y(an)30 b(ev)m(en)h(faster) -g(algorithm.)0 4292 y Fs(11.4)68 b(Debugging)31 b(supp)t(ort)0 -4566 y Fr(When)f(debugging)g(a)h(CLN)f(application)i(with)e(GNU)h +o(;)592 4887 y(cl_R)f(sqrt5)h(=)g(sqrt\(cl_float\(5,prec\)\);)592 +4990 y(cl_R)f(phi)h(=)h(\(1+sqrt5\)/2;)592 5094 y(return)e(round1\()g +(expt\(phi,n\)/sqrt5)d(\);)210 5198 y(})-30 5340 y Fr(Let's)31 +b(explain)g(what)f(is)g(going)i(on)e(in)g(detail.)p eop +%%Page: 49 51 +49 50 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(49)-30 299 y(The)27 b(include)g(\014le)h +Fp()c Fr(is)k(necessary)g(b)s(ecause)f(the)h(t)m(yp)s(e)g +Fp(cl_I)e Fr(is)i(used)f(in)g(the)h(function,)g(and)f(the)-30 +408 y(include)k(\014le)g Fp()e Fr(is)i(needed)g(for)g(the)g +(t)m(yp)s(e)h Fp(cl_R)e Fr(and)h(the)g(\015oating)h(p)s(oin)m(t)f(n)m +(um)m(b)s(er)e(functions.)43 b(The)-30 518 y(order)30 +b(of)g(the)h(include)f(\014les)g(do)s(es)g(not)h(matter.)-30 +657 y(Then)23 b(comes)i(the)f(function)h(declaration.)40 +b(The)24 b(argumen)m(t)g(is)g(an)h Fp(int)p Fr(,)g(the)f(result)h(an)f +(in)m(teger.)40 b(The)24 b(return)g(t)m(yp)s(e)-30 767 +y(is)33 b(de\014ned)e(as)i(`)p Fp(const)c(cl_I)p Fr(',)j(not)h(simply)e +(`)p Fp(cl_I)p Fr(',)i(b)s(ecause)f(that)h(allo)m(ws)h(the)f(compiler)f +(to)h(detect)h(t)m(yp)s(os)f(lik)m(e)-30 876 y(`)p Fp(fibonacci\(n\))27 +b(=)j(100)p Fr('.)40 b(It)29 b(w)m(ould)f(b)s(e)h(p)s(ossible)f(to)i +(declare)f(the)h(return)d(t)m(yp)s(e)i(as)g Fp(const)g(cl_R)f +Fr(\(real)i(n)m(um)m(b)s(er\))-30 986 y(or)36 b(ev)m(en)g +Fp(const)29 b(cl_N)35 b Fr(\(complex)h(n)m(um)m(b)s(er\).)55 +b(W)-8 b(e)37 b(use)f(the)g(most)f(sp)s(ecialized)i(p)s(ossible)e +(return)g(t)m(yp)s(e)h(b)s(ecause)-30 1095 y(functions)26 +b(whic)m(h)g(call)h(`)p Fp(fibonacci)p Fr(')d(will)j(b)s(e)e(able)i(to) +g(pro\014t)f(from)e(the)j(compiler's)f(t)m(yp)s(e)g(analysis:)39 +b(Adding)26 b(t)m(w)m(o)-30 1205 y(in)m(tegers)g(is)e(sligh)m(tly)i +(more)e(e\016cien)m(t)i(than)e(adding)g(the)h(same)f(ob)5 +b(jects)25 b(declared)g(as)g(complex)f(n)m(um)m(b)s(ers,)g(b)s(ecause) +-30 1314 y(it)34 b(needs)f(less)h(t)m(yp)s(e)f(dispatc)m(h.)51 +b(Also,)35 b(when)d(linking)i(to)g(CLN)f(as)h(a)g(non-shared)e(library) +-8 b(,)35 b(this)e(minimizes)f(the)-30 1424 y(size)f(of)g(the)f +(resulting)h(executable)h(program.)-30 1563 y(The)f(result)g(will)h(b)s +(e)f(computed)f(as)i(expt\(phi,n\)/sqrt\(5\),)h(rounded)d(to)j(the)e +(nearest)h(in)m(teger.)46 b(In)31 b(order)g(to)h(get)-30 +1673 y(a)c(correct)h(result,)g(the)f(absolute)h(error)e(should)g(b)s(e) +g(less)i(than)e(1/2,)j(i.e.)41 b(the)28 b(relativ)m(e)i(error)e(should) +f(b)s(e)g(less)h(than)-30 1782 y(sqrt\(5\)/\(2*expt\(phi,n\)\).)65 +b(T)-8 b(o)38 b(this)g(end,)h(the)e(\014rst)g(line)h(computes)f(a)h +(\015oating)g(p)s(oin)m(t)g(precision)g(for)f(sqrt\(5\))-30 +1892 y(and)30 b(phi.)-30 2031 y(Then)41 b(sqrt\(5\))h(is)g(computed)e +(b)m(y)i(\014rst)e(con)m(v)m(erting)k(the)e(in)m(teger)h(5)f(to)g(a)g +(\015oating)g(p)s(oin)m(t)g(n)m(um)m(b)s(er)d(and)i(than)-30 +2140 y(taking)i(the)f(square)g(ro)s(ot.)76 b(The)42 b(con)m(v)m(erse,)k +(\014rst)c(taking)h(the)f(square)g(ro)s(ot)g(of)g(5,)k(and)c(then)f +(con)m(v)m(erting)j(to)-30 2250 y(the)c(desired)f(precision,)j(w)m +(ould)e(not)g(w)m(ork)f(in)h(CLN:)f(The)g(square)h(ro)s(ot)g(w)m(ould)f +(b)s(e)g(computed)f(to)j(a)f(default)-30 2359 y(precision)g(\(normally) +f(single-\015oat)j(precision\),)h(and)c(the)h(follo)m(wing)i(con)m(v)m +(ersion)f(could)f(not)g(help)f(ab)s(out)h(the)-30 2469 +y(lac)m(king)h(accuracy)-8 b(.)68 b(This)39 b(is)g(b)s(ecause)g(CLN)g +(is)g(not)g(a)g(sym)m(b)s(olic)g(computer)f(algebra)i(system)e(and)h +(do)s(es)g(not)-30 2579 y(represen)m(t)30 b(sqrt\(5\))i(in)e(a)h(non-n) +m(umeric)d(w)m(a)m(y)-8 b(.)-30 2717 y(The)29 b(t)m(yp)s(e)i +Fp(cl_R)d Fr(for)i(sqrt5)g(and,)g(in)g(the)g(follo)m(wing)h(line,)g +(phi)e(is)h(the)h(only)f(p)s(ossible)f(c)m(hoice.)43 +b(Y)-8 b(ou)30 b(cannot)h(write)-30 2827 y Fp(cl_F)26 +b Fr(b)s(ecause)h(the)g(C)p Fp(++)g Fr(compiler)f(can)i(only)f(infer)g +(that)g Fp(cl_float\(5,prec\))c Fr(is)k(a)h(real)f(n)m(um)m(b)s(er.)38 +b(Y)-8 b(ou)27 b(cannot)-30 2937 y(write)k Fp(cl_N)e +Fr(b)s(ecause)h(a)h(`)p Fp(round1)p Fr(')e(do)s(es)h(not)h(exist)g(for) +f(general)h(complex)f(n)m(um)m(b)s(ers.)-30 3075 y(When)21 +b(the)g(function)g(returns,)h(all)g(the)f(lo)s(cal)h(v)-5 +b(ariables)22 b(in)f(the)g(function)g(are)g(automatically)i(reclaimed)e +(\(garbage)-30 3185 y(collected\).)43 b(Only)30 b(the)h(result)f +(surviv)m(es)g(and)g(gets)h(passed)f(to)h(the)g(caller.)-30 +3324 y(The)d(\014le)h Fp(fibonacci.cc)c Fr(in)j(the)h(sub)s(directory)e +Fp(examples)f Fr(con)m(tains)k(this)f(implemen)m(tation)f(together)i +(with)e(an)-30 3434 y(ev)m(en)j(faster)g(algorithm.)-30 +3702 y Fs(11.4)68 b(Debugging)46 b(supp)t(ort)-30 3899 +y Fr(When)30 b(debugging)g(a)h(CLN)f(application)i(with)e(GNU)h Fp(gdb)p Fr(,)f(t)m(w)m(o)h(facilities)i(are)e(a)m(v)-5 -b(ailable)33 b(from)28 b(the)j(library:)75 4840 y Fq(\017)60 -b Fr(The)32 b(library)h(do)s(es)f(t)m(yp)s(e)h(c)m(hec)m(ks,)j(range)d -(c)m(hec)m(ks,)i(consistency)f(c)m(hec)m(ks)g(at)g(man)m(y)e(places.)49 -b(When)33 b(one)g(of)180 4965 y(these)40 b(fails,)i(the)e(function)f -Fp(cl_abort\(\))d Fr(is)j(called.)69 b(Its)39 b(default)h(implemen)m -(tation)f(is)g(to)h(p)s(erform)d(an)180 5089 y Fp(exit\(1\))p -Fr(,)29 b(so)i(y)m(ou)f(w)m(on't)i(ha)m(v)m(e)f(a)g(core)h(dump.)38 -b(But)31 b(for)f(debugging,)h(it)g(is)f(b)s(est)g(to)i(set)f(a)g -(breakp)s(oin)m(t)f(at)180 5214 y(this)g(function:)420 -5340 y Fp(\(gdb\))46 b(break)h(cl_abort)p eop -%%Page: 63 65 -63 64 bop 0 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 -b(the)f(library)2621 b(63)180 366 y(When)30 b(this)g(breakp)s(oin)m(t)h -(is)f(hit,)h(lo)s(ok)g(at)g(the)f(stac)m(k's)i(bac)m(ktrace:)420 -495 y Fp(\(gdb\))46 b(where)75 645 y Fq(\017)60 b Fr(The)27 -b(debugger's)g(normal)g Fp(print)f Fr(command)f(do)s(esn't)j(kno)m(w)f -(ab)s(out)h(CLN's)f(t)m(yp)s(es)g(and)g(therefore)h(prin)m(ts)180 -769 y(mostly)43 b(useless)h(hexadecimal)g(addresses.)80 -b(CLN)43 b(o\013ers)h(a)g(function)f Fp(cl_print)p Fr(,)i(callable)h -(from)c(the)180 894 y(debugger,)37 b(for)e(prin)m(ting)g(n)m(um)m(b)s -(er)e(ob)5 b(jects.)57 b(In)35 b(order)g(to)h(get)g(this)g(function,)g -(y)m(ou)g(ha)m(v)m(e)h(to)f(de\014ne)f(the)180 1018 y(macro)24 -b(`)p Fp(CL_DEBUG)p Fr(')f(and)h(then)h(include)f(all)h(the)g(header)g -(\014les)f(for)h(whic)m(h)f(y)m(ou)h(w)m(an)m(t)h Fp(cl_print)c -Fr(debugging)180 1143 y(supp)s(ort.)39 b(F)-8 b(or)31 -b(example:)420 1271 y Fp(#define)46 b(CL_DEBUG)420 1375 -y(#include)g()180 1525 y Fr(No)m(w,)26 b(if)f(y)m(ou)f(ha) -m(v)m(e)i(in)e(y)m(our)g(program)f(a)i(v)-5 b(ariable)25 -b Fp(cl_string)i(s)p Fr(,)f(and)e(insp)s(ect)g(it)g(under)f -Fp(gdb)p Fr(,)i(the)f(output)180 1649 y(ma)m(y)30 b(lo)s(ok)h(lik)m(e)h -(this:)420 1778 y Fp(\(gdb\))46 b(print)h(s)420 1882 -y($7)g(=)h({)43 b(=)48 b({)f(=)h({pointer)d(=)j -(0x8055b60,)d(heappointer)f(=)k(0x8055b60,)515 1985 y(word)f(=)h -(134568800}},)c(})420 2089 y(\(gdb\))i(call)h(cl_print\(s\))420 -2193 y(\(cl_string\))e("")420 2297 y($8)i(=)h(134568800)180 -2446 y Fr(Note)34 b(that)f(the)g(output)f(of)h Fp(cl_print)d -Fr(go)s(es)k(to)f(the)g(program's)e(error)h(output,)h(not)g(to)h(gdb's) -e(standard)180 2571 y(output.)180 2720 y(Note,)38 b(ho)m(w)m(ev)m(er,)g -(that)d(the)g(ab)s(o)m(v)m(e)i(facilit)m(y)g(do)s(es)d(not)i(w)m(ork)f -(with)f(all)i(CLN)f(t)m(yp)s(es,)h(only)g(with)e(n)m(um)m(b)s(er)180 -2845 y(ob)5 b(jects)42 b(and)e(similar.)72 b(Therefore)41 -b(CLN)g(o\013ers)g(a)h(mem)m(b)s(er)c(function)j Fp(debug_print\(\))c -Fr(on)k(all)h(CLN)180 2969 y(t)m(yp)s(es.)63 b(The)37 -b(same)g(macro)h(`)p Fp(CL_DEBUG)p Fr(')e(is)h(needed)h(for)f(this)h -(mem)m(b)s(er)d(function)j(to)g(b)s(e)f(implemen)m(ted.)180 -3094 y(Under)30 b Fp(gdb)p Fr(,)f(y)m(ou)i(call)h(it)f(lik)m(e)g(this:) -420 3222 y Fp(\(gdb\))46 b(print)h(s)420 3326 y($7)g(=)h -({)43 b(=)48 b({)f(=)h({pointer)d(=)j(0x8055b60,)d -(heappointer)f(=)k(0x8055b60,)515 3430 y(word)f(=)h(134568800}},)c(}) -420 3534 y(\(gdb\))i(call)h(s.debug_print\(\))420 3638 -y(\(cl_string\))e("")420 3741 y(\(gdb\))h(define)g(cprint)420 -3845 y(>call)g(\($1\).debug_print\(\))420 3949 y(>end)420 -4053 y(\(gdb\))g(cprint)g(s)420 4156 y(\(cl_string\))f("")180 -4306 y Fr(Unfortunately)-8 b(,)31 b(this)g(feature)f(do)s(es)g(not)h -(seem)f(to)h(w)m(ork)f(under)f(all)i(circumstances.)p +b(ailable)33 b(from)28 b(the)j(library:)45 4038 y Fq(\017)60 +b Fr(The)36 b(library)g(do)s(es)g(t)m(yp)s(e)h(c)m(hec)m(ks,)j(range)d +(c)m(hec)m(ks,)i(consistency)f(c)m(hec)m(ks)g(at)f(man)m(y)f(places.)60 +b(When)36 b(one)h(of)150 4147 y(these)44 b(fails,)j(the)c(function)g +Fp(cl_abort\(\))e Fr(is)i(called.)81 b(Its)43 b(default)g(implemen)m +(tation)g(is)g(to)h(p)s(erform)d(an)150 4257 y Fp(exit\(1\))p +Fr(,)32 b(so)i(y)m(ou)g(w)m(on't)g(ha)m(v)m(e)h(a)f(core)g(dump.)47 +b(But)34 b(for)f(debugging,)h(it)g(is)g(b)s(est)f(to)h(set)g(a)g +(breakp)s(oin)m(t)f(at)150 4366 y(this)d(function:)390 +4497 y Fp(\(gdb\))46 b(break)h(cl_abort)150 4634 y Fr(When)30 +b(this)g(breakp)s(oin)m(t)h(is)f(hit,)h(lo)s(ok)g(at)g(the)f(stac)m +(k's)i(bac)m(ktrace:)390 4765 y Fp(\(gdb\))46 b(where)45 +4902 y Fq(\017)60 b Fr(The)32 b(debugger's)g(normal)g +Fp(print)f Fr(command)f(do)s(esn't)j(kno)m(w)f(ab)s(out)h(CLN's)f(t)m +(yp)s(es)g(and)g(therefore)h(prin)m(ts)150 5011 y(mostly)j(useless)g +(hexadecimal)h(addresses.)58 b(CLN)35 b(o\013ers)i(a)g(function)f +Fp(cl_print)p Fr(,)f(callable)k(from)34 b(the)j(de-)150 +5121 y(bugger,)29 b(for)f(prin)m(ting)g(n)m(um)m(b)s(er)d(ob)5 +b(jects.)41 b(In)28 b(order)f(to)i(get)g(this)f(function,)h(y)m(ou)f +(ha)m(v)m(e)i(to)f(de\014ne)e(the)h(macro)150 5230 y(`)p +Fp(CL_DEBUG)p Fr(')21 b(and)h(then)g(include)g(all)i(the)f(header)f +(\014les)h(for)f(whic)m(h)g(y)m(ou)h(w)m(an)m(t)h Fp(cl_print)c +Fr(debugging)i(supp)s(ort.)150 5340 y(F)-8 b(or)31 b(example:)p eop -%%Page: 64 66 -64 65 bop 0 -116 a Fr(Chapter)30 b(12:)41 b(Customizing)2803 -b(64)0 366 y Fo(12)80 b(Customizing)0 1146 y Fs(12.1)68 -b(Error)31 b(handling)0 1438 y Fr(When)36 b(a)g(fatal)h(error)f(o)s -(ccurs,)i(an)d(error)h(message)g(is)g(output)g(to)h(the)f(standard)f -(error)h(output)f(stream,)j(and)0 1562 y(the)k(function)f -Fp(cl_abort)e Fr(is)j(called.)76 b(The)41 b(default)h(v)m(ersion)g(of)f -(this)h(function)f(\(pro)m(vided)h(in)f(the)h(library\))0 -1687 y(terminates)32 b(the)g(application.)46 b(T)-8 b(o)32 -b(catc)m(h)h(suc)m(h)f(a)g(fatal)h(error,)f(y)m(ou)g(need)f(to)i -(de\014ne)e(the)h(function)f Fp(cl_abort)0 1811 y Fr(y)m(ourself,)g -(with)f(the)h(protot)m(yp)s(e)240 2083 y Fp(#include)46 -b()240 2186 y(void)h(cl_abort)e(\(void\);)0 -2478 y Fr(This)30 b(function)g(m)m(ust)f(not)i(return)e(con)m(trol)j -(to)f(its)f(caller.)0 3087 y Fs(12.2)68 b(Floating-p)t(oin)l(t)32 -b(under\015o)l(w)0 3379 y Fr(Floating)c(p)s(oin)m(t)d(under\015o)m(w)g -(denotes)h(the)g(situation)g(when)f(a)h(\015oating-p)s(oin)m(t)h(n)m -(um)m(b)s(er)c(is)j(to)g(b)s(e)f(created)i(whic)m(h)0 -3503 y(is)32 b(so)g(close)h(to)f Fp(0)g Fr(that)g(its)g(exp)s(onen)m(t) -g(is)g(to)s(o)h(lo)m(w)f(to)h(b)s(e)e(represen)m(ted)h(in)m(ternally)-8 -b(.)46 b(By)32 b(default,)h(this)e(causes)i(a)0 3628 -y(fatal)f(error.)40 b(If)30 b(y)m(ou)h(set)f(the)h(global)h(v)-5 -b(ariable)240 3899 y Fp(cl_boolean)45 b(cl_inhibit_floating_poin)o -(t_un)o(derf)o(low)0 4190 y Fr(to)36 b Fp(cl_true)p Fr(,)f(the)h(error) -f(will)h(b)s(e)f(inhibited,)h(and)f(a)h(\015oating-p)s(oin)m(t)h(zero)f -(will)g(b)s(e)f(generated)h(instead.)56 b(The)0 4315 -y(default)31 b(v)-5 b(alue)30 b(of)h Fp(cl_inhibit_floating_poin)o -(t_un)o(der)o(flow)24 b Fr(is)30 b Fp(cl_false)p Fr(.)0 -4924 y Fs(12.3)68 b(Customizing)32 b(I/O)0 5215 y Fr(The)27 -b(output)g(of)h(the)f(function)h Fp(fprint)d Fr(ma)m(y)i(b)s(e)g -(customized)h(b)m(y)f(c)m(hanging)h(the)g(v)-5 b(alue)28 -b(of)g(the)f(global)i(v)-5 b(ariable)0 5340 y Fp -(cl_default_print_flags)p Fr(.)p eop -%%Page: 65 67 -65 66 bop 0 -116 a Fr(Chapter)30 b(12:)41 b(Customizing)2803 -b(65)0 366 y Fs(12.4)68 b(Customizing)32 b(the)e(memory)h(allo)t(cator) -0 640 y Fr(Ev)m(ery)j(memory)d(allo)s(cation)36 b(of)e(CLN)f(is)h(done) -f(through)g(the)g(function)h(p)s(oin)m(ter)f Fp(cl_malloc_hook)p -Fr(.)47 b(F)-8 b(reeing)0 765 y(of)31 b(this)g(memory)e(is)i(done)f -(through)g(the)h(function)g(p)s(oin)m(ter)g Fp(cl_free_hook)p -Fr(.)39 b(The)30 b(default)h(v)m(ersions)g(of)g(these)0 -890 y(functions,)e(pro)m(vided)f(in)g(the)h(library)-8 -b(,)29 b(call)h Fp(malloc)d Fr(and)h Fp(free)f Fr(and)h(c)m(hec)m(k)i -(the)f Fp(malloc)e Fr(result)h(against)i Fp(NULL)p Fr(.)0 -1014 y(If)25 b(y)m(ou)h(w)m(an)m(t)h(to)f(pro)m(vide)g(another)g -(memory)d(allo)s(cator,)29 b(y)m(ou)d(need)f(to)i(de\014ne)e(the)h(v)-5 -b(ariables)26 b Fp(cl_malloc_hook)0 1139 y Fr(and)k Fp(cl_free_hook)d -Fr(y)m(ourself,)k(lik)m(e)g(this:)240 1392 y Fp(#include)46 -b()240 1496 y(void*)g(\(*cl_malloc_hook\))d(\(size_t)j -(size\))h(=)g Fn(:)15 b(:)g(:)q Fp(;)240 1599 y(void)47 -b(\(*cl_free_hook\))c(\(void*)j(ptr\))286 b(=)47 b Fn(:)15 -b(:)g(:)q Fp(;)0 1873 y Fr(The)30 b Fp(cl_malloc_hook)c +%%Page: 50 52 +50 51 bop -30 -116 a Fr(Chapter)30 b(11:)41 b(Using)31 +b(the)f(library)2681 b(50)390 299 y Fp(#define)46 b(CL_DEBUG)390 +403 y(#include)g()150 537 y Fr(No)m(w,)30 +b(if)e(y)m(ou)g(ha)m(v)m(e)i(in)d(y)m(our)h(program)f(a)i(v)-5 +b(ariable)29 b Fp(cl_string)f(s)p Fr(,)g(and)g(insp)s(ect)g(it)g(under) +f Fp(gdb)p Fr(,)h(the)g(output)150 647 y(ma)m(y)i(lo)s(ok)h(lik)m(e)h +(this:)390 775 y Fp(\(gdb\))46 b(print)h(s)390 879 y($7)g(=)h +({)43 b(=)48 b({)f(=)h({pointer)d(=)j(0x8055b60,)d +(heappointer)f(=)k(0x8055b60,)485 983 y(word)f(=)h(134568800}},)c(})390 +1087 y(\(gdb\))i(call)h(cl_print\(s\))390 1191 y(\(cl_string\))e("")390 +1294 y($8)i(=)h(134568800)150 1429 y Fr(Note)38 b(that)f(the)g(output)f +(of)h Fp(cl_print)d Fr(go)s(es)j(to)g(the)g(program's)f(error)g +(output,)i(not)e(to)i(gdb's)e(standard)150 1538 y(output.)150 +1673 y(Note,)43 b(ho)m(w)m(ev)m(er,)f(that)d(the)g(ab)s(o)m(v)m(e)i +(facilit)m(y)f(do)s(es)f(not)g(w)m(ork)g(with)f(all)i(CLN)f(t)m(yp)s +(es,)i(only)e(with)f(n)m(um)m(b)s(er)150 1782 y(ob)5 +b(jects)27 b(and)e(similar.)38 b(Therefore)26 b(CLN)f(o\013ers)i(a)f +(mem)m(b)s(er)d(function)j Fp(debug_print\(\))c Fr(on)j(all)i(CLN)f(t)m +(yp)s(es.)150 1892 y(The)h(same)g(macro)g(`)p Fp(CL_DEBUG)p +Fr(')f(is)h(needed)h(for)f(this)g(mem)m(b)s(er)e(function)i(to)i(b)s(e) +e(implemen)m(ted.)38 b(Under)27 b Fp(gdb)p Fr(,)150 2002 +y(y)m(ou)k(call)g(it)g(lik)m(e)h(this:)390 2130 y Fp(\(gdb\))46 +b(print)h(s)390 2234 y($7)g(=)h({)43 b(=)48 +b({)f(=)h({pointer)d(=)j(0x8055b60,)d(heappointer)f(=)k(0x8055b60,)485 +2338 y(word)f(=)h(134568800}},)c(})390 2442 y(\(gdb\))i(call)h +(s.debug_print\(\))390 2545 y(\(cl_string\))e("")390 +2649 y(\(gdb\))h(define)g(cprint)390 2753 y(>call)g +(\($1\).debug_print\(\))390 2857 y(>end)390 2961 y(\(gdb\))g(cprint)g +(s)390 3064 y(\(cl_string\))f("")150 3199 y Fr(Unfortunately)-8 +b(,)31 b(this)g(feature)f(do)s(es)g(not)h(seem)f(to)h(w)m(ork)f(under)f +(all)i(circumstances.)p eop +%%Page: 51 53 +51 52 bop -30 -116 a Fr(Chapter)30 b(12:)41 b(Customizing)2863 +b(51)-30 299 y Fo(12)80 b(Customizing)-30 656 y Fs(12.1)68 +b(Error)46 b(handling)-30 848 y Fr(When)30 b(a)h(fatal)g(error)f(o)s +(ccurs,)g(an)g(error)g(message)g(is)g(output)g(to)h(the)f(standard)g +(error)g(output)f(stream,)h(and)g(the)-30 958 y(function)c +Fp(cl_abort)e Fr(is)i(called.)41 b(The)26 b(default)g(v)m(ersion)h(of)g +(this)f(function)g(\(pro)m(vided)g(in)g(the)h(library\))f(terminates) +-30 1068 y(the)i(application.)41 b(T)-8 b(o)29 b(catc)m(h)h(suc)m(h)d +(a)i(fatal)g(error,)f(y)m(ou)h(need)e(to)i(de\014ne)f(the)g(function)f +Fp(cl_abort)f Fr(y)m(ourself,)j(with)-30 1177 y(the)i(protot)m(yp)s(e) +210 1306 y Fp(#include)46 b()210 1410 y(void)h(cl_abort)e +(\(void\);)-30 1544 y Fr(This)30 b(function)g(m)m(ust)f(not)i(return)e +(con)m(trol)j(to)f(its)f(caller.)-30 1802 y Fs(12.2)68 +b(Floating-p)t(oin)l(t)47 b(under\015o)l(w)-30 1994 y +Fr(Floating)32 b(p)s(oin)m(t)e(under\015o)m(w)e(denotes)j(the)f +(situation)h(when)e(a)h(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(er)d(is)i +(to)h(b)s(e)e(created)i(whic)m(h)-30 2104 y(is)k(so)g(close)g(to)h +Fp(0)e Fr(that)h(its)g(exp)s(onen)m(t)g(is)g(to)s(o)g(lo)m(w)g(to)h(b)s +(e)e(represen)m(ted)g(in)m(ternally)-8 b(.)55 b(By)35 +b(default,)h(this)f(causes)g(a)-30 2213 y(fatal)d(error.)40 +b(If)30 b(y)m(ou)h(set)f(the)h(global)h(v)-5 b(ariable)210 +2342 y Fp(cl_boolean)45 b(cl_inhibit_floating_poin)o(t_un)o(derf)o(low) +-30 2477 y Fr(to)40 b Fp(cl_true)p Fr(,)f(the)g(error)g(will)g(b)s(e)f +(inhibited,)j(and)d(a)h(\015oating-p)s(oin)m(t)i(zero)e(will)h(b)s(e)e +(generated)i(instead.)66 b(The)-30 2586 y(default)31 +b(v)-5 b(alue)30 b(of)h Fp(cl_inhibit_floating_poin)o(t_un)o(der)o +(flow)24 b Fr(is)30 b Fp(cl_false)p Fr(.)-30 2844 y Fs(12.3)68 +b(Customizing)46 b(I/O)-30 3036 y Fr(The)31 b(output)g(of)g(the)g +(function)g Fp(fprint)f Fr(ma)m(y)h(b)s(e)f(customized)h(b)m(y)g(c)m +(hanging)i(the)e(v)-5 b(alue)32 b(of)f(the)h(global)g(v)-5 +b(ariable)-30 3146 y Fp(cl_default_print_flags)p Fr(.)-30 +3403 y Fs(12.4)68 b(Customizing)46 b(the)f(memory)h(allo)t(cator)-30 +3596 y Fr(Ev)m(ery)38 b(memory)e(allo)s(cation)k(of)e(CLN)f(is)h(done)g +(through)f(the)h(function)g(p)s(oin)m(ter)f Fp(cl_malloc_hook)p +Fr(.)60 b(F)-8 b(reeing)-30 3705 y(of)35 b(this)f(memory)f(is)i(done)f +(through)g(the)h(function)f(p)s(oin)m(ter)h Fp(cl_free_hook)p +Fr(.)50 b(The)34 b(default)h(v)m(ersions)g(of)f(these)-30 +3815 y(functions,)f(pro)m(vided)f(in)g(the)h(library)-8 +b(,)33 b(call)h Fp(malloc)d Fr(and)h Fp(free)f Fr(and)h(c)m(hec)m(k)i +(the)f Fp(malloc)e Fr(result)h(against)i Fp(NULL)p Fr(.)-30 +3924 y(If)c(y)m(ou)g(w)m(an)m(t)h(to)f(pro)m(vide)g(another)h(memory)d +(allo)s(cator,)k(y)m(ou)e(need)g(to)h(de\014ne)e(the)h(v)-5 +b(ariables)31 b Fp(cl_malloc_hook)-30 4034 y Fr(and)f +Fp(cl_free_hook)d Fr(y)m(ourself,)k(lik)m(e)g(this:)210 +4163 y Fp(#include)46 b()210 4267 y(void*)g +(\(*cl_malloc_hook\))d(\(size_t)j(size\))h(=)g(...)o(;)210 +4370 y(void)g(\(*cl_free_hook\))c(\(void*)j(ptr\))286 +b(=)47 b(...)o(;)-30 4505 y Fr(The)30 b Fp(cl_malloc_hook)c Fr(function)k(m)m(ust)g(not)g(return)g(a)g Fp(NULL)g -Fr(p)s(oin)m(ter.)0 2147 y(It)24 b(is)g(not)g(p)s(ossible)f(to)i(c)m -(hange)g(the)f(memory)e(allo)s(cator)k(at)f(run)m(time,)f(b)s(ecause)g -(it)g(is)g(already)g(called)i(at)e(program)0 2272 y(startup)30 -b(b)m(y)g(the)h(constructors)f(of)h(some)f(global)h(v)-5 -b(ariables.)p eop -%%Page: 66 68 -66 67 bop 0 -116 a Fr(Index)3586 b(66)0 366 y Fo(Index)0 -848 y Fs(A)0 981 y Fe(abs)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)37 b Fc(14)0 1097 y(abstract)26 b(class)16 -b Fd(.)f(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)43 b Fc(7)0 1213 y Fe(acos)27 b(\(\))8 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(23)0 -1330 y Fe(acosh)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(25)0 1446 y(adv)n(o)r(cacy)19 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)45 -b Fc(55)0 1562 y(Arc)n(himedes')25 b(constan)n(t)17 b -Fd(.)c(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(24)0 1678 y Fe(As\(\))27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)34 b Fc(11)0 1794 y Fe(ash)26 b(\(\))10 b -Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(29)0 -1911 y Fe(asin)9 b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -35 b Fc(23)0 2027 y Fe(asin)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)34 b Fc(23)0 2143 y Fe(asinh)27 b(\(\))c Fd(.)13 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(25)0 2259 y Fe(atan)9 -b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)35 -b Fc(24)0 2376 y Fe(atan)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)34 b Fc(24)0 2492 y Fe(atanh)27 b(\(\))c Fd(.)13 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(25)0 2745 y Fs(B)0 2878 -y Fe(basering)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 b Fc(52)0 -2994 y Fe(binomial)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(30)0 3111 y Fe(boole)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(27)0 3227 y Fe(boole)p 200 3227 24 4 v 29 w(1)7 -b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)33 b Fc(27)0 -3343 y Fe(boole)p 200 3343 V 29 w(2)7 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)33 b Fc(27)0 3459 y Fe(boole)p 200 3459 V -29 w(and)20 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 b Fc(27)0 -3576 y Fe(boole)p 200 3576 V 29 w(andc1)13 b Fd(.)i(.)e(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)40 -b Fc(27)0 3692 y Fe(boole)p 200 3692 V 29 w(andc2)13 -b Fd(.)i(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)40 b Fc(27)0 3808 y Fe(boole)p 200 -3808 V 29 w(c1)22 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)48 -b Fc(27)0 3924 y Fe(boole)p 200 3924 V 29 w(c2)22 b Fd(.)13 -b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)48 b Fc(27)0 4040 y Fe(boole)p -200 4040 V 29 w(clr)20 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 -b Fc(27)0 4157 y Fe(boole)p 200 4157 V 29 w(eqv)20 b -Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 b Fc(27)0 4273 y Fe(boole)p -200 4273 V 29 w(nand)16 b Fd(.)e(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)43 b Fc(27)0 -4389 y Fe(boole)p 200 4389 V 29 w(nor)20 b Fd(.)13 b(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -45 b Fc(27)0 4505 y Fe(boole)p 200 4505 V 29 w(orc1)16 -b Fd(.)e(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)43 b Fc(27)0 4622 y Fe(boole)p -200 4622 V 29 w(orc2)16 b Fd(.)e(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)43 b Fc(27)0 -4738 y Fe(boole)p 200 4738 V 29 w(set)20 b Fd(.)13 b(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -45 b Fc(27)0 4854 y Fe(boole)p 200 4854 V 29 w(xor)20 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 b Fc(27)0 5108 y Fs(C)0 -5240 y Fe(canonhom)27 b(\(\))22 b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)47 b Fc(46,)27 b(52)0 -5357 y(Catalan's)h(constan)n(t)13 b Fd(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)40 b Fc(26)2031 848 y Fe(ceiling1)27 -b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 b Fc(18)2031 964 y Fe(ceiling2)27 -b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 b Fc(19)2031 1080 y Fe(cis)26 -b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(23)2031 1197 y Fe(cl_idecoded_float)10 b Fd(.)17 -b(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)36 -b Fc(31)2031 1313 y Fe(cl)p 2114 1313 V 29 w(abort)26 -b(\(\))21 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)47 b Fc(64)2031 1429 -y Fe(cl)p 2114 1429 V 29 w(byte)7 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)33 b Fc(28)2031 1545 y Fe(cl)p 2114 1545 V 29 -w(catalanconst)28 b(\(\))20 b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)46 b Fc(26)2031 1662 y Fe(cl)p 2114 1662 -V 29 w(compare)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)42 b Fc(16)2031 -1778 y Fe(cl)p 2114 1778 V 29 w(cos)p 2260 1778 V 29 -w(sin)26 b(\(\))21 b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)47 b Fc(23)2031 1894 -y Fe(cl)p 2114 1894 V 29 w(cos)p 2260 1894 V 29 w(sin)p -2406 1894 V 29 w(t)22 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)48 b Fc(23)2031 -2010 y Fe(cl)p 2114 2010 V 29 w(cosh)p 2299 2010 V 29 -w(sinh)26 b(\(\))16 b Fd(.)e(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)42 b Fc(25)2031 2127 y Fe(cl)p -2114 2127 V 29 w(cosh)p 2299 2127 V 29 w(sinh)p 2484 -2127 V 29 w(t)17 b Fd(.)c(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)43 b Fc(25)2031 2243 y Fe(CL)p -2114 2243 V 29 w(DEBUG)22 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)48 -b Fc(63)2031 2359 y Fe(cl)p 2114 2359 V 29 w(decoded)p -2416 2359 V 30 w(dfloat)22 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)47 b Fc(31)2031 2475 y Fe(cl)p 2114 -2475 V 29 w(decoded)p 2416 2475 V 30 w(ffloat)22 b Fd(.)13 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)47 -b Fc(31)2031 2591 y Fe(cl)p 2114 2591 V 29 w(decoded)p -2416 2591 V 30 w(float)6 b Fd(.)14 b(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)33 b Fc(31)2031 2708 y Fe(cl)p -2114 2708 V 29 w(decoded)p 2416 2708 V 30 w(lfloat)22 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)47 -b Fc(31)2031 2824 y Fe(cl)p 2114 2824 V 29 w(decoded)p -2416 2824 V 30 w(sfloat)22 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)47 b Fc(31)2031 2940 y Fe(cl)p 2114 -2940 V 29 w(default)p 2416 2940 V 30 w(float)p 2641 2940 -V 29 w(format)11 b Fd(.)j(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)37 -b Fc(32)2031 3056 y Fe(cl)p 2114 3056 V 29 w(default)p -2416 3056 V 30 w(print)p 2641 3056 V 29 w(flags)14 b -Fd(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)40 b Fc(64)2031 -3173 y Fe(cl)p 2114 3173 V 29 w(default)p 2416 3173 V -30 w(random)p 2680 3173 V 29 w(state)11 b Fd(.)j(.)f(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)37 b Fc(34)2031 3289 y Fe(cl)p 2114 3289 V 29 -w(DF)14 b Fd(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)41 -b Fc(9)2031 3405 y Fe(cl)p 2114 3405 V 29 w(double)p -2377 3405 V 29 w(approx)27 b(\(\))c Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)49 b Fc(11)2031 3521 y Fe(cl)p 2114 -3521 V 29 w(equal)p 2338 3521 V 29 w(hashcode)27 b(\(\))21 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(16)2031 3638 y Fe(cl)p 2114 3638 V 29 w(eulerconst)28 -b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)34 b Fc(25)2031 3754 y Fe(cl)p 2114 3754 V -29 w(F)8 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)34 -b Fc(7,)27 b(9)2031 3870 y Fe(cl)p 2114 3870 V 29 w(FF)14 -b Fd(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)41 -b Fc(9)2031 3986 y Fe(cl)p 2114 3986 V 29 w(find)p 2299 -3986 V 29 w(modint)p 2562 3986 V 29 w(ring)27 b(\(\))21 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)47 b Fc(45)2031 -4102 y Fe(cl)p 2114 4102 V 29 w(find)p 2299 4102 V 29 -w(univpoly)p 2640 4102 V 30 w(ring)26 b(\(\))15 b Fd(.)f(.)f(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)42 b Fc(52)2031 4219 y Fe(cl)p 2114 4219 V -29 w(float)22 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)48 b -Fc(32)2031 4335 y Fe(cl)p 2114 4335 V 29 w(float)p 2338 -4335 V 29 w(approx)27 b(\(\))8 b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(11)2031 4451 y Fe(cl)p -2114 4451 V 29 w(float)p 2338 4451 V 29 w(format)27 b(\(\))8 -b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 -b Fc(32)2031 4567 y Fe(cl)p 2114 4567 V 29 w(free)p 2299 -4567 V 29 w(hook)26 b(\(\))16 b Fd(.)e(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)42 b Fc(65)2031 4684 -y Fe(cl)p 2114 4684 V 29 w(hermite)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)42 -b Fc(54)2031 4800 y Fe(cl)p 2114 4800 V 29 w(I)p 2182 -4800 V 28 w(to)p 2288 4800 V 29 w(int)26 b(\(\))7 b Fd(.)13 -b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)33 b Fc(11)2031 4916 y Fe(cl)p 2114 4916 V 29 w(I)p -2182 4916 V 28 w(to)p 2288 4916 V 29 w(long)26 b(\(\))c -Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)48 b Fc(11)2031 5032 y Fe(cl)p 2114 5032 V 29 w(I)p -2182 5032 V 28 w(to)p 2288 5032 V 29 w(uint)26 b(\(\))c -Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)48 b Fc(11)2031 5149 y Fe(cl)p 2114 5149 V 29 w(I)p -2182 5149 V 28 w(to)p 2288 5149 V 29 w(ulong)27 b(\(\))19 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -45 b Fc(11)2031 5265 y Fe(cl)p 2114 5265 V 29 w(laguerre)27 -b(\(\))13 b Fd(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)39 b Fc(54)p eop -%%Page: 67 69 -67 68 bop 0 -116 a Fr(Index)3586 b(67)0 366 y Fe(cl)p -83 366 24 4 v 29 w(legendre)27 b(\(\))13 b Fd(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)39 b -Fc(54)0 483 y Fe(cl)p 83 483 V 29 w(LF)14 b Fd(.)f(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)41 b Fc(9)0 599 y Fe(cl)p 83 599 -V 29 w(malloc)p 346 599 V 29 w(hook)27 b(\(\))11 b Fd(.)i(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(65)0 -715 y Fe(cl)p 83 715 V 29 w(N)16 b Fd(.)d(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)44 b Fc(7)0 831 y Fe(cl)p 83 831 V -29 w(number)22 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)48 b -Fc(7)0 948 y Fe(cl)p 83 948 V 29 w(pi)12 b Fd(.)h(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)38 b Fc(24)0 1064 y Fe(cl)p 83 1064 -V 29 w(R)16 b Fd(.)d(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)44 -b Fc(7)0 1180 y Fe(cl)p 83 1180 V 29 w(RA)14 b Fd(.)f(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)41 b Fc(7)0 1296 y Fe(cl)p -83 1296 V 29 w(SF)14 b Fd(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)41 b Fc(9)0 1413 y Fe(cl)p 83 1413 V 29 w(string)27 -b(\(\))18 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)44 b Fc(48)0 1529 y Fe(cl)p -83 1529 V 29 w(symbol)27 b(\(\))18 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)44 -b Fc(49)0 1645 y Fe(cl)p 83 1645 V 29 w(tschebychev)28 -b(\(\))22 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)49 b Fc(54)0 1761 y Fe(cl)p 83 1761 V 29 w(zeta)26 -b(\(\))e Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)49 b Fc(26)0 1877 y Fe(coeff)27 -b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(54)0 -1994 y(comparison)17 b Fd(.)c(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)43 b Fc(16)0 -2110 y(compiler)26 b(options)14 b Fd(.)g(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)41 b Fc(57)0 2226 -y Fe(complex)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 b -Fc(15)0 2342 y(complex)25 b(n)n(um)n(b)r(er)6 b Fd(.)11 -b(.)i(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)33 -b Fc(7,)26 b(10)0 2459 y Fe(conjugate)i(\(\))12 b Fd(.)h(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 -b Fc(16)0 2575 y(con)n(v)n(ersion)22 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)48 -b Fc(10,)27 b(32)0 2691 y Fe(cos)f(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)37 b Fc(23)0 2807 y Fe(cosh)27 b(\(\))8 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(24)0 -2924 y Fe(create)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(52)0 3040 y(customizing)8 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)35 -b Fc(64)0 3302 y Fs(D)0 3434 y Fe(debug)p 200 3434 V -29 w(print)27 b(\(\))13 b Fd(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)39 b Fc(63)0 3551 y(debugging)19 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)45 b Fc(62)0 3667 y Fe(decode)p -239 3667 V 30 w(float)26 b(\(\))10 b Fd(.)k(.)f(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)37 b Fc(31)0 3783 -y Fe(degree)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(54)0 3899 y Fe(denominator)28 b(\(\))7 b Fd(.)14 -b(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -34 b Fc(15)0 4016 y Fe(deposit)p 278 4016 V 30 w(field)27 -b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)34 b Fc(28)0 4132 y Fe(deriv)27 b(\(\))c Fd(.)13 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(54)0 4248 y Fe(div)26 -b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(47)0 4364 y Fe(doublefactorial)29 b(\(\))14 b Fd(.)g(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)41 b Fc(30)0 4480 -y Fe(dpb)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(28)0 4742 y Fs(E)0 4875 y Fe(equal)27 b(\(\))12 -b Fd(.)h(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)38 b Fc(48,)27 b(49)0 4991 y Fe(etract)g(\(\))20 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(46)0 5108 y(Euler's)27 -b(constan)n(t)21 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)48 b Fc(25)0 5224 y Fe(evenp)27 -b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(29)0 -5340 y(exact)26 b(n)n(um)n(b)r(er)15 b Fd(.)10 b(.)k(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)42 -b Fc(8)2031 366 y Fe(exp)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)37 b Fc(22)2031 483 y Fe(exp1)27 b(\(\))8 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(23)2031 -599 y Fe(expt)27 b(\(\))21 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)48 b Fc(14,)26 b(22,)h(47)2031 -715 y Fe(expt)p 2192 715 V 29 w(pos)f(\(\))16 b Fd(.)e(.)f(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)43 b Fc(14,)26 b(47,)h(53)2031 -831 y Fe(exquo)g(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(14)2031 1070 y Fs(F)2031 1203 y Fe(factorial)28 -b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)39 b Fc(30)2031 1319 y Fe(fceiling)27 -b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 b Fc(19)2031 1436 y Fe(fceiling2)28 -b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)39 b Fc(20)2031 1552 y Fe(ffloor)27 -b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(19)2031 -1668 y Fe(ffloor2)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(20)2031 1784 y(Fib)r(onacci)27 b(n)n(um)n(b)r(er)7 -b Fd(.)k(.)i(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)33 -b Fc(61)2031 1900 y Fe(finalize)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(53)2031 2017 y Fe(float)p 2231 2017 V 29 w(digits)27 -b(\(\))10 b Fd(.)k(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)37 b Fc(31)2031 2133 y Fe(float)p 2231 2133 -V 29 w(epsilon)28 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)34 b Fc(33)2031 2249 y Fe(float)p -2231 2249 V 29 w(exponent)28 b(\(\))22 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)49 b Fc(31)2031 2365 -y Fe(float)p 2231 2365 V 29 w(negative)p 2572 2365 V -30 w(epsilon)28 b(\(\))7 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)34 -b Fc(33)2031 2482 y Fe(float)p 2231 2482 V 29 w(precision)28 -b(\(\))20 b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -46 b Fc(31)2031 2598 y Fe(float)p 2231 2598 V 29 w(radix)27 -b(\(\))13 b Fd(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)39 b Fc(31)2031 2714 y Fe(float)p 2231 -2714 V 29 w(sign)27 b(\(\))22 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)48 b Fc(31,)27 b(32)2031 -2830 y(\015oating-p)r(oin)n(t)f(n)n(um)n(b)r(er)14 b -Fd(.)d(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)41 -b Fc(8)2031 2947 y Fe(floor1)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)46 b Fc(18)2031 3063 y Fe(floor2)27 b(\(\))20 b Fd(.)13 -b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)46 b Fc(19)2031 3179 y Fe(fprint)27 -b(\(\))9 b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)35 b Fc(47,)27 b(54)2031 3295 -y Fe(fround)g(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(19)2031 3411 y Fe(fround2)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(20)2031 3528 y Fe(ftruncate)28 b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 -b Fc(19)2031 3644 y Fe(ftruncate2)28 b(\(\))10 b Fd(.)j(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)36 -b Fc(20)2031 3883 y Fs(G)2031 4016 y Fc(garbage)27 b(collection)15 -b Fd(.)f(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)41 -b Fc(55,)27 b(56)2031 4132 y Fe(gcd)f(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)37 b Fc(29)2031 4248 y(GMP)15 b Fd(.)f(.)f(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)42 b Fc(2)2031 4487 y -Fs(H)2031 4620 y Fc(header)26 b(\014les)19 b Fd(.)13 -b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)45 b Fc(57)2031 4736 y(Hermite)25 b(p)r(olynomial)9 -b Fd(.)k(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)36 -b Fc(54)2031 4975 y Fs(I)2031 5108 y Fe(imagpart)27 b(\(\))15 -b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)41 b Fc(15)2031 5224 y(include)26 -b(\014les)10 b Fd(.)j(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)37 b Fc(57)2031 5340 -y(Input/Output)20 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)49 b Fc(37)p eop -%%Page: 68 70 -68 69 bop 0 -116 a Fr(Index)3586 b(68)0 366 y Fc(installation)23 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)48 b Fc(5)0 483 y(in)n(teger)9 -b Fd(.)14 b(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)36 b -Fc(7)0 599 y Fe(integer)p 278 599 24 4 v 30 w(decode)p -542 599 V 29 w(float)27 b(\(\))12 b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -39 b Fc(32)0 715 y Fe(integer)p 278 715 V 30 w(length)27 -b(\(\))22 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)49 b Fc(29)0 831 y Fe(isqrt)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)49 b Fc(21)0 1093 y Fs(L)0 1226 y Fc(Laguerre)26 -b(p)r(olynomial)14 b Fd(.)g(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)40 b Fc(54)0 1342 y Fe(lcm)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)37 b Fc(30)0 1458 y Fe(ldb)26 b(\(\))10 -b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(28)0 -1575 y Fe(ldb)p 122 1575 V 29 w(test)26 b(\(\))21 b Fd(.)13 -b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)47 b Fc(28)0 1691 y Fe(least)p 200 1691 V -29 w(negative)p 541 1691 V 30 w(float)27 b(\(\))12 b -Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 b Fc(33)0 1807 -y Fe(least)p 200 1807 V 29 w(positive)p 541 1807 V 30 -w(float)27 b(\(\))12 b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 -b Fc(33)0 1923 y(Legende)26 b(p)r(olynomial)8 b Fd(.)13 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)34 -b Fc(54)0 2040 y Fe(length)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(48)0 2156 y Fe(ln)26 b(\(\))13 b Fd(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)40 b Fc(22)0 2272 y Fe(log)26 b(\(\))10 b -Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(22)0 -2388 y Fe(logand)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(27)0 2505 y Fe(logandc1)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(27)0 2621 y Fe(logandc2)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(27)0 2737 y Fe(logbitp)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(28)0 2853 y Fe(logcount)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(28)0 2969 y Fe(logeqv)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(27)0 3086 y Fe(logior)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(27)0 3202 y Fe(lognand)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(27)0 3318 y Fe(lognor)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(27)0 3434 y Fe(lognot)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(27)0 3551 y Fe(logorc1)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(27)0 3667 y Fe(logorc2)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(27)0 3783 y Fe(logp)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)34 b Fc(30)0 3899 y Fe(logtest)27 b(\(\))17 b -Fd(.)d(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)44 b Fc(28)0 4016 y Fe(logxor)27 -b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(27)0 -4277 y Fs(M)0 4410 y Fe(make)11 b Fd(.)j(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)38 b Fc(3)0 4526 y Fe(mask)p 161 4526 -V 29 w(field)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)42 b Fc(28)0 4643 -y Fe(max)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(17)0 4759 y Fe(min)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)37 b Fc(17)0 4875 y Fe(minus1)27 b(\(\))20 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(13)0 4991 y Fe(minusp)27 -b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(16)0 -5108 y Fe(mod)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(21)0 5224 y(mo)r(difying)26 b(op)r(erators)e Fd(.)13 -b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)49 -b Fc(35)0 5340 y(mo)r(dular)25 b(in)n(teger)8 b Fd(.)14 -b(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -35 b Fc(45)2031 366 y Fe(modulus)18 b Fd(.)d(.)e(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -45 b Fc(46)2031 483 y Fe(monomial)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(52)2031 599 y(Mon)n(tgomery)25 b(m)n(ultiplication)c -Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)48 b Fc(45)2031 715 y -Fe(most)p 2192 715 V 29 w(negative)p 2533 715 V 30 w(float)27 -b(\(\))15 b Fd(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(33)2031 831 y Fe(most)p 2192 831 V 29 w(positive)p -2533 831 V 30 w(float)27 b(\(\))15 b Fd(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)41 b Fc(33)2031 1151 y Fs(N)2031 1284 y Fe(numerator)28 -b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)39 b Fc(15)2031 1604 y Fs(O)2031 -1737 y Fe(oddp)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 -b Fc(29)2031 1853 y Fe(one)26 b(\(\))17 b Fd(.)d(.)f(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)43 -b Fc(46,)27 b(52)2031 1969 y Fe(operator)g(!=)f(\(\))16 -b Fd(.)e(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)43 b Fc(16,)27 b(46,)f(47,)h(53)2031 -2086 y Fe(operator)g(&)f(\(\))17 b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)43 b Fc(27)2031 -2202 y Fe(operator)27 b(&=)f(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)41 b Fc(35)2031 -2318 y Fe(operator)27 b(\(\))f(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)41 b Fc(54)2031 -2434 y Fe(operator)27 b(*)f(\(\))12 b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)39 b Fc(13,)26 b(47,)h(53)2031 2550 -y Fe(operator)g(*=)f(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)41 b Fc(35)2031 2667 -y Fe(operator)27 b(-)f(\(\))12 b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)39 b Fc(13,)26 b(46,)h(53)2031 2783 y Fe(operator)g(--)f -(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)41 b Fc(36)2031 2899 y Fe(operator)27 -b(-=)f(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)41 b Fc(35)2031 3015 y Fe(operator)27 -b(/)f(\(\))17 b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)43 b Fc(14)2031 3132 y Fe(operator)27 -b(/=)f(\(\))14 b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)41 b Fc(35)2031 3248 y Fe(operator)27 -b(==)f(\(\))16 b Fd(.)e(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)43 b Fc(16,)27 -b(46,)f(47,)h(53)2031 3364 y Fe(operator)g([])f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(48)2031 3480 y Fe(operator)27 b(|)f(\(\))17 -b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)43 b Fc(27)2031 3597 y Fe(operator)27 b(|=)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(35)2031 3713 y Fe(operator)27 b(~)f(\(\))17 -b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)43 b Fc(27)2031 3829 y Fe(operator)27 b(+)f(\(\))12 -b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)39 -b Fc(13,)26 b(46,)h(53)2031 3945 y Fe(operator)g(+=)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(35)2031 4061 y Fe(operator)27 b(++)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(36)2031 4178 y Fe(operator)27 b(>)f(\(\))17 -b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)43 b Fc(16)2031 4294 y Fe(operator)27 b(>=)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(16)2031 4410 y Fe(operator)27 b(>>)f(\(\))21 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)47 -b Fc(29,)27 b(47)2031 4526 y Fe(operator)g(>>=)g(\(\))11 -b Fd(.)j(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)38 b Fc(35)2031 4643 y Fe(operator)27 b(^)f(\(\))17 -b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)43 b Fc(27)2031 4759 y Fe(operator)27 b(^=)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(35)2031 4875 y Fe(operator)27 b(<)f(\(\))17 -b Fd(.)c(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)43 b Fc(16)2031 4991 y Fe(operator)27 b(<=)f(\(\))14 -b Fd(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)41 b Fc(16)2031 5108 y Fe(operator)27 b(<<)f(\(\))10 -b Fd(.)k(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)37 b -Fc(29,)26 b(47,)h(54)2031 5224 y Fe(operator)g(<<=)g(\(\))11 -b Fd(.)j(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)38 b Fc(35)2031 5340 y Fe(ord2)27 b(\(\))8 b Fd(.)13 -b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(29)p eop -%%Page: 69 71 -69 70 bop 0 -116 a Fr(Index)3586 b(69)0 366 y Fs(P)0 -499 y Fe(phase)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(22)0 616 y(pi)21 b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)48 b Fc(24)0 732 y Fe(plus1)27 b(\(\))c -Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(13)0 848 y Fe(plusp)27 -b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 b Fc(17)0 -964 y(p)r(olynomial)21 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)48 b -Fc(50)0 1080 y(p)r(ortabilit)n(y)11 b Fd(.)j(.)f(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)38 -b Fc(55)0 1197 y Fe(power2p)27 b(\(\))17 b Fd(.)d(.)f(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)44 -b Fc(29)0 1313 y(prin)n(ting)22 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)49 -b Fc(37)0 1529 y Fs(R)0 1662 y Fe(random)27 b(\(\))20 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(46)0 1778 y Fe(random)p -239 1778 24 4 v 30 w(F)25 b(\(\))c Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)47 -b Fc(35)0 1894 y Fe(random)p 239 1894 V 30 w(I)25 b(\(\))c -Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)47 b Fc(34)0 2010 y Fe(random)p 239 -2010 V 30 w(R)25 b(\(\))c Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)47 b Fc(35)0 -2127 y Fe(random32)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(34)0 2243 y Fe(rational)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(33)0 2359 y(rational)27 b(n)n(um)n(b)r(er)7 b Fd(.)k(.)i(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)34 -b Fc(7)0 2475 y Fe(rationalize)28 b(\(\))7 b Fd(.)14 -b(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -34 b Fc(34)0 2591 y(reading)15 b Fd(.)e(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)41 -b Fc(37)0 2708 y(real)27 b(n)n(um)n(b)r(er)7 b Fd(.)k(.)i(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)34 b Fc(7)0 2824 y Fe(realpart)27 b(\(\))15 b Fd(.)f(.)f(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)41 -b Fc(15)0 2940 y Fe(recip)27 b(\(\))12 b Fd(.)h(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)38 -b Fc(14,)27 b(47)0 3056 y(reference)g(coun)n(ting)20 -b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)47 -b Fc(55)0 3173 y Fe(rem)26 b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)37 b Fc(21)0 3289 y(represen)n(tation)20 b -Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)46 b Fc(37)0 3405 y(Riemann's)25 b(zeta)18 -b Fd(.)c(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)45 b Fc(26)0 3521 y(ring)21 b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)48 b Fc(45)0 3638 y Fe(ring)27 b(\(\))8 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(53)0 -3754 y Fe(ring\(\))22 b Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)47 -b Fc(46)0 3870 y Fe(rootp)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(21)0 3986 y Fe(round1)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(18)0 4102 y Fe(round2)27 b(\(\))20 b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 -b Fc(19)0 4219 y(rounding)6 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)33 -b Fc(17)0 4335 y(rounding)25 b(error)16 b Fd(.)f(.)e(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)44 -b Fc(8)0 4451 y(Rubik's)25 b(cub)r(e)d Fd(.)13 b(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(11)0 4667 y Fs(S)0 4800 y Fe(scale)p 200 4800 V -29 w(float)27 b(\(\))13 b Fd(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)39 b Fc(30)2031 366 y(Sc)n(h\177)-38 -b(onhage-Strassen)15 b Fd(.)e(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)42 b Fc(56)2031 483 y(Sc)n(h\177)-38 b(onhage-Strassen)26 -b(m)n(ultiplication)10 b Fd(.)j(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(2)2031 599 y Fe(sed)13 -b Fd(.)h(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)41 -b Fc(3)2031 715 y Fe(set)p 2153 715 V 29 w(coeff)27 b(\(\))18 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)44 b Fc(53)2031 831 y Fe(signum)27 b(\(\))20 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(15)2031 948 y Fe(sin)26 -b(\(\))10 b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 -b Fc(23)2031 1064 y Fe(sinh)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)h(.)34 b Fc(24)2031 1180 y Fe(sqrt)27 b(\(\))8 -b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 b Fc(21)2031 -1296 y Fe(sqrtp)27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)49 -b Fc(21)2031 1413 y Fe(square)27 b(\(\))16 b Fd(.)d(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)43 b Fc(13,)26 -b(47,)h(53)2031 1529 y(string)8 b Fd(.)14 b(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)35 b Fc(48)2031 1645 y Fe(strlen)27 b(\(\))20 -b Fd(.)13 b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)46 b Fc(48)2031 1761 y(sym)n(b)r(ol)19 -b Fd(.)13 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)46 b Fc(49)2031 -1877 y(sym)n(b)r(olic)25 b(t)n(yp)r(e)8 b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)35 -b Fc(48)2031 2143 y Fs(T)2031 2276 y Fe(tan)26 b(\(\))10 -b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)37 b Fc(23)2031 -2392 y Fe(tanh)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 -b Fc(25)2031 2508 y Fe(The\(\))27 b(\(\))c Fd(.)13 b(.)g(.)g(.)g(.)g(.) -g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)49 b Fc(11)2031 2625 y(transcenden)n(tal)26 b(functions)18 -b Fd(.)c(.)f(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)45 b Fc(22)2031 -2741 y Fe(truncate1)28 b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 b -Fc(18)2031 2857 y Fe(truncate2)28 b(\(\))12 b Fd(.)h(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)39 -b Fc(19)2031 2973 y(Tsc)n(heb)n(yc)n(hev)25 b(p)r(olynomial)18 -b Fd(.)13 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)44 b Fc(54)2031 -3239 y Fs(U)2031 3372 y Fc(under\015o)n(w)9 b Fd(.)k(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)36 b Fc(64)2031 3488 y(univ)l(ariate)26 b(p)r(olynomial)11 -b Fd(.)i(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)38 -b Fc(50)2031 3754 y Fs(W)2031 3887 y Fe(WANT)p 2192 3887 -V 29 w(OBFUSCATING)p 2650 3887 V 31 w(OPERATORS)15 b -Fd(.)g(.)e(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)41 b Fc(35)2031 4152 y Fs(X)2031 4285 -y Fe(xgcd)27 b(\(\))8 b Fd(.)13 b(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)34 -b Fc(30)2031 4551 y Fs(Z)2031 4684 y Fe(zero)27 b(\(\))14 -b Fd(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)41 b Fc(46,)27 b(52)2031 4800 -y Fe(zerop)g(\(\))18 b Fd(.)c(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)45 b Fc(16,)26 b(47,)h(53)p eop -%%Page: -1 72 --1 71 bop 3875 -116 a Fr(i)0 366 y Fo(T)-13 b(able)31 -b(of)f(Con)l(ten)l(ts)0 715 y Fs(1)135 b(In)l(tro)t(duction)40 -b Fb(.)20 b(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f -(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.) -f(.)85 b Fs(1)0 995 y(2)135 b(Installation)14 b Fb(.)22 -b(.)d(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f -(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.) -f(.)59 b Fs(3)299 1151 y Fr(2.1)92 b(Prerequisites)15 -b Fa(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)44 -b Fr(3)598 1276 y(2.1.1)93 b(C)p Fp(++)29 b Fr(compiler)14 -b Fa(.)g(.)h(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)43 b Fr(3)598 1400 y(2.1.2)93 -b(Mak)m(e)31 b(utilit)m(y)14 b Fa(.)i(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)43 -b Fr(3)598 1525 y(2.1.3)93 b(Sed)29 b(utilit)m(y)h Fa(.)15 -b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +Fr(p)s(oin)m(ter.)-30 4639 y(It)e(is)f(not)h(p)s(ossible)f(to)h(c)m +(hange)h(the)e(memory)f(allo)s(cator)j(at)f(run)m(time,)f(b)s(ecause)h +(it)g(is)f(already)h(called)h(at)f(program)-30 4749 y(startup)i(b)m(y)g +(the)h(constructors)f(of)h(some)f(global)h(v)-5 b(ariables.)p +eop +%%Page: 52 54 +52 53 bop -30 -116 a Fr(Index)3646 b(52)-30 299 y Fo(Index)-30 +614 y Fs(A)-30 737 y Fe(abs)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)38 b Fc(12)-30 829 y(abstract)26 b(class)g Fd(.)12 +b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)50 b Fc(6)-30 921 y Fe(acos)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)36 b Fc(18)-30 1013 y Fe(acosh)27 b(\(\))9 b Fd(.)j(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)35 b Fc(19)-30 1105 y(adv)n(o)r(cacy)24 b Fd(.)12 +b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)50 b Fc(43)-30 1197 y(Arc)n(himedes')25 +b(constan)n(t)17 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)43 +b Fc(19)-30 1289 y Fe(As\(\)\(\))6 b Fd(.)14 b(.)e(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)32 b Fc(9)-30 1381 y Fe(ash)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)38 b Fc(22)-30 1473 y Fe(asin)8 b Fd(.)13 +b(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)34 b Fc(18)-30 1565 +y Fe(asin)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)36 +b Fc(18)-30 1657 y Fe(asinh)27 b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 +b Fc(19)-30 1749 y Fe(atan)8 b Fd(.)13 b(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)34 b Fc(18)-30 1841 y Fe(atan)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)36 b Fc(18)-30 1933 y Fe(atanh)27 b(\(\))9 b Fd(.)j(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)35 b Fc(19)-30 2180 y Fs(B)-30 2303 y Fe(basering)27 +b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)49 b Fc(40)-30 2395 y Fe(binomial)27 +b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)49 b Fc(23)-30 2487 y Fe(boole)27 +b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 b Fc(21)-30 2579 +y Fe(boole_1)23 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)48 b Fc(21)-30 +2671 y Fe(boole_2)23 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)48 +b Fc(21)-30 2763 y Fe(boole_and)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 2855 y Fe(boole_andc1)16 b Fd(.)f(.)d(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)42 b +Fc(21)-30 2947 y Fe(boole_andc2)16 b Fd(.)f(.)d(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)42 b Fc(21)-30 +3039 y Fe(boole_c1)22 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 b +Fc(21)-30 3131 y Fe(boole_c2)22 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 +b Fc(21)-30 3222 y Fe(boole_clr)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 3314 y Fe(boole_eqv)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 3406 y Fe(boole_nand)17 b Fd(.)e(.)d(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)43 +b Fc(21)-30 3498 y Fe(boole_nor)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 3590 y Fe(boole_orc1)17 b Fd(.)e(.)d(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)43 +b Fc(21)-30 3682 y Fe(boole_orc2)17 b Fd(.)e(.)d(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)43 +b Fc(21)-30 3774 y Fe(boole_set)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 3866 y Fe(boole_xor)21 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)45 +b Fc(21)-30 4114 y Fs(C)-30 4236 y Fe(canonhom)27 b(\(\))15 +b Fd(.)f(.)e(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)41 +b Fc(35,)27 b(40)-30 4328 y(Catalan's)h(constan)n(t)10 +b Fd(.)i(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)36 +b Fc(20)-30 4420 y Fe(ceiling1)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 +b Fc(14)-30 4512 y Fe(ceiling2)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 +b Fc(15)-30 4604 y Fe(cis)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)38 b Fc(18)-30 4696 y Fe(cl_idecoded_float)7 b Fd(.)16 +b(.)d(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)33 +b Fc(24)-30 4788 y Fe(cl_abort)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 +b Fc(51)-30 4880 y Fe(cl_byte)23 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)48 +b Fc(21)-30 4972 y Fe(cl_catalanconst)29 b(\(\))13 b +Fd(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)39 +b Fc(20)-30 5064 y Fe(cl_compare)28 b(\(\))20 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)46 +b Fc(13)-30 5156 y Fe(cl_cos_sin)28 b(\(\))20 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)46 +b Fc(18)-30 5248 y Fe(cl_cos_sin_t)15 b Fd(.)g(.)d(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)40 b Fc(18)-30 +5340 y Fe(cl_cosh_sinh)28 b(\(\))17 b Fd(.)c(.)f(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)43 b Fc(19)2032 614 y +Fe(cl_cosh_sinh_t)12 b Fd(.)j(.)e(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)37 b Fc(19)2032 707 y Fe(CL_DEBUG)22 +b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)46 b Fc(49)2032 800 y Fe(cl_decoded_dfloat)7 +b Fd(.)17 b(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 +b Fc(24)2032 892 y Fe(cl_decoded_ffloat)7 b Fd(.)17 b(.)12 +b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 b Fc(24)2032 +985 y Fe(cl_decoded_float)9 b Fd(.)16 b(.)c(.)h(.)f(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)34 b Fc(24)2032 1078 y Fe(cl_decoded_lfloat)7 +b Fd(.)17 b(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 +b Fc(24)2032 1170 y Fe(cl_decoded_sfloat)7 b Fd(.)17 +b(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 +b Fc(24)2032 1263 y Fe(cl_default_float_format)17 b Fd(.)g(.)c(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)42 b Fc(25)2032 1356 y Fe(cl_default_print_flags)18 +b Fd(.)g(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)44 b Fc(51)2032 1448 +y Fe(cl_default_random_state)17 b Fd(.)g(.)c(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)42 +b Fc(26)2032 1541 y Fe(cl_DF)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)34 b Fc(7)2032 1634 y Fe(cl_DF_fdiv_t)15 b Fd(.)g(.)d(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)40 +b Fc(15)2032 1726 y Fe(cl_double_approx)29 b(\(\))12 +b Fd(.)h(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)39 +b Fc(9)2032 1819 y Fe(cl_equal_hashcode)30 b(\(\))10 +b Fd(.)i(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)35 b Fc(13)2032 +1912 y Fe(cl_eulerconst)29 b(\(\))16 b Fd(.)c(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)h(.)f(.)g(.)h(.)41 b Fc(20)2032 2004 y Fe(cl_F)22 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 b Fc(6,)27 b(7)2032 +2097 y Fe(cl_F_fdiv_t)16 b Fd(.)f(.)d(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)42 b Fc(15)2032 2190 +y Fe(cl_FF)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)34 +b Fc(7)2032 2282 y Fe(cl_FF_fdiv_t)15 b Fd(.)g(.)d(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)40 b Fc(15)2032 +2375 y Fe(cl_find_modint_ring)30 b(\(\))7 b Fd(.)13 b(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)33 b Fc(34)2032 2468 y Fe(cl_find_univpoly_ring)e(\(\))22 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)48 b Fc(40)2032 2560 y Fe(cl_float)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(25)2032 2653 y Fe(cl_float_approx)29 +b(\(\))14 b Fd(.)f(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)40 +b Fc(9)2032 2746 y Fe(cl_float_format)29 b(\(\))13 b +Fd(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)38 +b Fc(25)2032 2838 y Fe(cl_float_format_t)7 b Fd(.)17 +b(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 +b Fc(25)2032 2931 y Fe(cl_free_hook)c(\(\))17 b Fd(.)12 +b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)43 +b Fc(51)2032 3023 y Fe(cl_hermite)28 b(\(\))20 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)46 +b Fc(42)2032 3116 y Fe(cl_I_to_int)28 b(\(\))20 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)46 +b Fc(9)2032 3209 y Fe(cl_I_to_long)29 b(\(\))18 b Fd(.)12 +b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 +b Fc(9)2032 3301 y Fe(cl_I_to_uint)29 b(\(\))18 b Fd(.)12 +b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 +b Fc(9)2032 3394 y Fe(cl_I_to_ulong)29 b(\(\))17 b Fd(.)12 +b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)43 +b Fc(9)2032 3487 y Fe(cl_laguerre)28 b(\(\))18 b Fd(.)c(.)e(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)44 b Fc(42)2032 +3579 y Fe(cl_legendre)28 b(\(\))18 b Fd(.)c(.)e(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)44 b Fc(42)2032 3672 +y Fe(cl_LF)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)34 +b Fc(7)2032 3765 y Fe(cl_LF_fdiv_t)15 b Fd(.)g(.)d(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)40 b Fc(15)2032 +3857 y Fe(cl_malloc_hook)29 b(\(\))14 b Fd(.)f(.)f(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)40 b Fc(51)2032 3950 y Fe(cl_modint_ring)12 +b Fd(.)j(.)e(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)37 +b Fc(34)2032 4043 y Fe(cl_N)9 b Fd(.)k(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)35 b Fc(6)2032 4135 y Fe(cl_number)22 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)46 b Fc(6)2032 4228 y Fe(cl_pi)27 b(\(\))9 +b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)35 b Fc(19)2032 4321 y Fe(cl_R)9 +b Fd(.)k(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)35 b Fc(6)2032 +4413 y Fe(cl_R_fdiv_t)16 b Fd(.)f(.)d(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)42 b Fc(15)2032 4506 +y Fe(cl_RA)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)34 +b Fc(6)2032 4599 y Fe(cl_random_state)10 b Fd(.)16 b(.)c(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)36 b Fc(26)2032 +4691 y Fe(cl_SF)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)34 +b Fc(7)2032 4784 y Fe(cl_SF_fdiv_t)15 b Fd(.)g(.)d(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)40 b Fc(15)2032 +4877 y Fe(cl_string)28 b(\(\))22 b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)47 b Fc(37)2032 +4969 y Fe(cl_symbol)28 b(\(\))22 b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)47 b Fc(37)2032 +5062 y Fe(cl_tschebychev)29 b(\(\))14 b Fd(.)f(.)f(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)40 b Fc(42)2032 5155 y Fe(cl_zeta)27 +b(\(\))6 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)32 b Fc(20)2032 5247 y +Fe(coeff)27 b(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)35 b +Fc(41)2032 5340 y(comparison)24 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)49 b +Fc(13)p eop +%%Page: 53 55 +53 54 bop -30 -116 a Fr(Index)3646 b(53)-30 299 y Fc(compiler)26 +b(options)9 b Fd(.)j(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)35 b Fc(45)-30 391 y Fe(complex)27 b(\(\))6 +b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)32 b Fc(12)-30 482 y(complex)25 b(n)n(um)n(b)r(er) +19 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)48 +b Fc(6,)26 b(8)-30 574 y Fe(conjugate)i(\(\))21 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +47 b Fc(12)-30 666 y(con)n(v)n(ersion)15 b Fd(.)e(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)41 +b Fc(8,)26 b(25)-30 758 y Fe(cos)g(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)38 b Fc(18)-30 849 y Fe(cosh)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)36 b Fc(19)-30 941 y Fe(create)27 b(\(\))8 +b Fd(.)k(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)33 b Fc(40)-30 1033 y(customizing)15 +b Fd(.)d(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)41 b Fc(51)-30 1292 y Fs(D)-30 1414 y +Fe(debug_print)28 b(\(\))18 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 b Fc(50)-30 1506 y(debugging)7 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)33 b Fc(49)-30 1597 y Fe(decode_float)28 +b(\(\))17 b Fd(.)c(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)43 b Fc(24)-30 1689 y Fe(degree)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +33 b Fc(41)-30 1781 y Fe(denominator)28 b(\(\))18 b Fd(.)13 +b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 +b Fc(12)-30 1873 y Fe(deposit_field)29 b(\(\))16 b Fd(.)c(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)41 b Fc(22)-30 +1964 y Fe(deriv)27 b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 +b Fc(41)-30 2056 y Fe(div)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)38 b Fc(35)-30 2148 y Fe(doublefactorial)29 b(\(\))13 +b Fd(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)39 +b Fc(23)-30 2240 y Fe(dpb)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)38 b Fc(22)-30 2501 y Fs(E)-30 2623 y Fe(equal)27 +b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 b Fc(37)-30 2715 +y(Euler's)27 b(constan)n(t)15 b Fd(.)d(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)41 b Fc(20)-30 2806 y Fe(evenp)27 +b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 b Fc(22)-30 2898 +y(exact)26 b(n)n(um)n(b)r(er)20 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)48 b Fc(6)-30 +2990 y Fe(exp)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 +b Fc(17)-30 3082 y Fe(exp1)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +36 b Fc(17)-30 3173 y Fe(expt)27 b(\(\))14 b Fd(.)e(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)40 b Fc(11,)26 +b(17,)h(35)-30 3265 y Fe(expt_pos)g(\(\))8 b Fd(.)13 +b(.)g(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 +b Fc(11,)26 b(35,)h(41)-30 3357 y Fe(exquo)g(\(\))9 b +Fd(.)j(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)35 b Fc(11)-30 3618 y Fs(F)-30 +3740 y Fe(factorial)28 b(\(\))21 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)47 b Fc(23)-30 +3832 y Fe(fceiling)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 b Fc(15)-30 +3924 y Fe(fceiling2)28 b(\(\))21 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)47 b Fc(15)-30 +4015 y Fe(ffloor)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(15)-30 4107 y Fe(ffloor2)27 b(\(\))6 b Fd(.)13 b(.)f(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)32 +b Fc(15)-30 4199 y(Fib)r(onacci)27 b(n)n(um)n(b)r(er)18 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)46 +b Fc(48)-30 4291 y Fe(finalize)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 +b Fc(41)-30 4382 y Fe(float_digits)28 b(\(\))17 b Fd(.)c(.)f(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)43 b Fc(24)-30 +4474 y Fe(float_epsilon)29 b(\(\))16 b Fd(.)c(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)41 b Fc(25)-30 4566 y Fe(float_exponent)29 +b(\(\))14 b Fd(.)f(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)40 +b Fc(24)-30 4658 y Fe(float_negative_epsilon)31 b(\(\))21 +b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)47 b Fc(25)-30 4749 y Fe(float_precision)29 +b(\(\))13 b Fd(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)39 +b Fc(24)-30 4841 y Fe(float_radix)28 b(\(\))18 b Fd(.)13 +b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 +b Fc(24)-30 4933 y Fe(float_sign)28 b(\(\))20 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)46 +b Fc(24)-30 5024 y(\015oating-p)r(oin)n(t)26 b(n)n(um)n(b)r(er)12 +b Fd(.)e(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 +b Fc(7)2032 299 y Fe(floor1)27 b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(14)2032 391 y Fe(floor2)27 b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(15)2032 482 y Fe(fprint)27 b(\(\))18 b Fd(.)13 b(.)g(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)44 +b Fc(36,)27 b(41)2032 574 y Fe(fround)g(\(\))8 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)33 b Fc(15)2032 666 y Fe(fround2)27 b(\(\))6 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)32 b Fc(15)2032 758 y Fe(ftruncate)c(\(\))22 +b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)47 b Fc(15)2032 849 y Fe(ftruncate2)28 b(\(\))20 +b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)46 b Fc(15)2032 1095 y Fs(G)2032 1218 y Fc(garbage)27 +b(collection)14 b Fd(.)h(.)d(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)40 +b Fc(43,)27 b(44)2032 1310 y Fe(gcd)g(\(\))12 b Fd(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)38 b Fc(23)2032 1401 y(GMP)8 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)33 b Fc(1,)27 b(4)2032 1660 y Fs(H)2032 1783 y +Fc(header)f(\014les)7 b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 b Fc(45)2032 +1874 y(Hermite)25 b(p)r(olynomial)7 b Fd(.)12 b(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)32 b Fc(42)2032 2133 y Fs(I)2032 +2256 y Fe(imagpart)c(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(12)2032 +2347 y(include)26 b(\014les)17 b Fd(.)c(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)43 b Fc(45)2032 +2439 y(Input/Output)14 b Fd(.)c(.)i(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)40 b Fc(28)2032 2531 y(installation)9 +b Fd(.)14 b(.)e(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)35 b Fc(4)2032 2623 y(in)n(teger)10 +b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)36 b Fc(6)2032 +2714 y Fe(integer_decode_float)30 b(\(\))24 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)49 b Fc(24)2032 2806 y Fe(integer_length)29 +b(\(\))14 b Fd(.)f(.)f(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)40 +b Fc(22)2032 2898 y Fe(isqrt)27 b(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)35 +b Fc(16)2032 3159 y Fs(L)2032 3281 y Fc(Laguerre)27 b(p)r(olynomial)13 +b Fd(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)38 +b Fc(42)2032 3373 y Fe(lcm)27 b(\(\))12 b Fd(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)38 b Fc(23)2032 3465 y Fe(ldb)27 b(\(\))12 b Fd(.)g(.)h(.)f(.)g(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)38 b Fc(22)2032 3557 y Fe(ldb_test)28 b(\(\))23 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)48 b Fc(22)2032 3648 y Fe(least_negative_float)30 +b(\(\))24 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)49 b Fc(25)2032 +3740 y Fe(least_positive_float)30 b(\(\))24 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)49 b Fc(25)2032 3832 y(Legende)26 +b(p)r(olynomial)e Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +49 b Fc(42)2032 3924 y Fe(length)27 b(\(\))8 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)33 b Fc(37)2032 4015 y Fe(ln)26 b(\(\))13 +b Fd(.)g(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)39 b Fc(17)2032 +4107 y Fe(log)27 b(\(\))12 b Fd(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 +b Fc(17)2032 4199 y Fe(logand)27 b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(21)2032 4291 y Fe(logandc1)28 b(\(\))23 b Fd(.)12 +b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)48 b Fc(21)2032 4382 y Fe(logandc2)28 b(\(\))23 b +Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)48 b Fc(21)2032 4474 y Fe(logbitp)27 b(\(\))6 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)32 b Fc(21)2032 4566 y Fe(logcount)c(\(\))23 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)48 b Fc(21)2032 4658 y Fe(logeqv)27 b(\(\))8 +b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)33 b Fc(21)2032 4749 y Fe(logior)27 +b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 b Fc(21)2032 4841 +y Fe(lognand)27 b(\(\))6 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)32 b Fc(21)2032 +4933 y Fe(lognor)27 b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(21)2032 5024 y Fe(lognot)27 b(\(\))8 b Fd(.)13 b(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(20)p eop +%%Page: 54 56 +54 55 bop -30 -116 a Fr(Index)3646 b(54)-30 299 y Fe(logorc1)27 +b(\(\))6 b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)32 b Fc(21)-30 391 y Fe(logorc2)27 +b(\(\))6 b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)32 b Fc(21)-30 483 y Fe(logp)27 +b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)36 b Fc(23)-30 +575 y Fe(logtest)27 b(\(\))6 b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)32 +b Fc(21)-30 667 y Fe(logxor)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(21)-30 929 y Fs(M)-30 1052 y Fe(make)9 b Fd(.)k(.)g(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)35 b Fc(3)-30 1144 y Fe(mask_field)28 +b(\(\))20 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)46 b Fc(22)-30 1235 y Fe(max)26 b(\(\))12 +b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 b Fc(13)-30 1327 +y Fe(min)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 +b Fc(13)-30 1419 y Fe(minus1)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(11)-30 1511 y Fe(minusp)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(13)-30 1603 y Fe(mod)26 b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)38 b Fc(16)-30 1695 y(mo)r(difying)26 b(op)r(erators)c +Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)47 +b Fc(27)-30 1787 y(mo)r(dular)25 b(in)n(teger)20 b Fd(.)12 +b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)45 +b Fc(34)-30 1879 y Fe(modulus)23 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)48 +b Fc(34)-30 1971 y Fe(monomial)27 b(\(\))d Fd(.)12 b(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)49 +b Fc(40)-30 2063 y(Mon)n(tgomery)25 b(m)n(ultiplication)9 +b Fd(.)k(.)f(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 b Fc(34)-30 2155 y Fe +(most_negative_float)30 b(\(\))7 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)33 b Fc(25)-30 2247 y Fe(most_positive_float)d(\(\))7 +b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)33 b Fc(25)-30 +2509 y Fs(N)-30 2632 y Fe(numerator)28 b(\(\))21 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +47 b Fc(12)-30 2879 y Fs(O)-30 3002 y Fe(oddp)27 b(\(\))10 +b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)36 b Fc(22)-30 3094 y +Fe(one)26 b(\(\))d Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(35,)27 +b(40)-30 3186 y Fe(operator)g(!=)f(\(\))c Fd(.)13 b(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +47 b Fc(13,)27 b(34,)f(36,)h(41)-30 3278 y Fe(operator)g(&)f(\(\))9 +b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)34 b Fc(21)-30 3370 y Fe(operator)27 b(&=)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 3461 y Fe(operator)27 b(\(\))f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(41)-30 3553 y Fe(operator)27 b(*)f(\(\))12 +b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)38 b +Fc(11,)26 b(35,)h(41)-30 3645 y Fe(operator)g(*=)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 3737 y Fe(operator)27 b(-)f(\(\))12 +b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)38 b +Fc(11,)26 b(35,)h(41)-30 3829 y Fe(operator)g(--)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 3921 y Fe(operator)27 b(-=)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 4013 y Fe(operator)27 b(/)f(\(\))9 +b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)34 b Fc(11)-30 4105 y Fe(operator)27 b(/=)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 4197 y Fe(operator)27 b(==)f(\(\))c +Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)47 b Fc(13,)27 b(34,)f(36,)h(41)-30 +4289 y Fe(operator)g([])f(\(\))7 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 b Fc(37)-30 +4381 y Fe(operator)27 b(|)f(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 b Fc(21)-30 +4473 y Fe(operator)27 b(|=)f(\(\))7 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)33 b Fc(27)-30 +4565 y Fe(operator)27 b(~)f(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 b Fc(20)-30 +4657 y Fe(operator)27 b(+)f(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)38 b Fc(11,)26 b(35,)h(41)-30 4749 y Fe(operator)g(+=)f +(\(\))7 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)33 b Fc(27)-30 4841 y Fe(operator)27 b(++)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(27)-30 4933 y Fe(operator)27 b(>)f(\(\))9 +b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)34 b Fc(13)-30 5024 y Fe(operator)27 b(>=)f(\(\))7 +b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)33 b Fc(13)2032 299 y Fe(operator)28 b(>>)e(\(\))18 +b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)43 +b Fc(22,)27 b(36)2032 398 y Fe(operator)h(>>=)e(\(\))e +Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)50 +b Fc(27)2032 497 y Fe(operator)28 b(^)d(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 +b Fc(21)2032 596 y Fe(operator)28 b(^=)e(\(\))7 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)33 +b Fc(27)2032 695 y Fe(operator)28 b(<)d(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 +b Fc(13)2032 794 y Fe(operator)28 b(<=)e(\(\))7 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)33 +b Fc(13)2032 893 y Fe(operator)28 b(<<)e(\(\))21 b Fd(.)13 +b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)47 b Fc(22,)27 b(35,)f(36,)h(41)2032 +992 y Fe(operator)h(<<=)e(\(\))e Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)50 b Fc(27)2032 1092 y Fe(ord2)27 +b(\(\))10 b Fd(.)j(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)36 b Fc(22)2032 +1378 y Fs(P)2032 1516 y Fe(phase)27 b(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)35 b Fc(17)2032 1615 y(pi)18 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)44 b Fc(19)2032 1714 y Fe(plus1)27 b(\(\))9 +b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)35 b Fc(11)2032 1813 y Fe(plusp)27 +b(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)35 b Fc(13)2032 1912 +y(p)r(olynomial)10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)36 b Fc(38)2032 2011 +y(p)r(ortabilit)n(y)17 b Fd(.)c(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)43 b Fc(43)2032 +2110 y Fe(power2p)27 b(\(\))6 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)32 +b Fc(23)2032 2209 y(prin)n(ting)8 b Fd(.)k(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(28)2032 2509 y Fs(R)2032 2646 y Fe(random)27 b(\(\))8 +b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)33 b Fc(35)2032 2746 y Fe(random_F)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(26)2032 2845 y Fe(random_I)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(26)2032 2944 y Fe(random_R)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(26)2032 3043 y Fe(random32)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(26)2032 3142 y Fe(rational)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(26)2032 3241 y(rational)27 +b(n)n(um)n(b)r(er)17 b Fd(.)11 b(.)h(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)g(.)44 b Fc(6)2032 3340 y Fe(rationalize)28 +b(\(\))18 b Fd(.)c(.)e(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)44 b Fc(26)2032 3439 y(reading)17 b Fd(.)c(.)g(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)43 b Fc(28)2032 3538 y(real)27 b(n)n(um)n(b)r(er)13 +b Fd(.)d(.)i(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)39 b Fc(6)2032 3637 y Fe(realpart)28 +b(\(\))23 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)48 b Fc(12)2032 3736 y Fe(recip)27 +b(\(\))20 b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)45 b Fc(11,)27 b(35)2032 3835 +y(reference)g(coun)n(ting)17 b Fd(.)12 b(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)43 b Fc(43)2032 3935 y Fe(rem)27 +b(\(\))12 b Fd(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 b Fc(16)2032 +4034 y(represen)n(tation)12 b Fd(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)37 b Fc(28)2032 4133 +y Fe(retract)27 b(\(\))6 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)32 b Fc(35)2032 +4232 y(Riemann's)25 b(zeta)11 b Fd(.)i(.)g(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)37 b Fc(20)2032 4331 +y(ring)21 b Fd(.)12 b(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)46 +b Fc(34)2032 4430 y Fe(ring)27 b(\(\))21 b Fd(.)13 b(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)47 +b Fc(35,)27 b(41)2032 4529 y Fe(rootp)g(\(\))9 b Fd(.)k(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)35 b Fc(16)2032 4628 y Fe(round1)27 b(\(\))8 b Fd(.)13 +b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) +h(.)f(.)g(.)h(.)33 b Fc(14)2032 4727 y Fe(round2)27 b(\(\))8 +b Fd(.)13 b(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)g(.)h(.)f(.)g(.)h(.)33 b Fc(15)2032 4826 y(rounding)10 +b Fd(.)i(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)35 b Fc(13)2032 4925 y(rounding)26 +b(error)7 b Fd(.)13 b(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)34 b Fc(7)2032 5024 y(Rubik's)25 +b(cub)r(e)14 b Fd(.)f(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)41 b Fc(8)p eop +%%Page: 55 57 +55 56 bop -30 -116 a Fr(Index)3646 b(55)-30 299 y Fs(S)-30 +421 y Fe(scale_float)28 b(\(\))18 b Fd(.)13 b(.)g(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)44 b Fc(23)-30 512 +y(Sc)n(h\177)-38 b(onhage-Strassen)26 b(m)n(ultiplication)14 +b Fd(.)e(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)41 +b Fc(1,)26 b(44)-30 603 y Fe(sed)10 b Fd(.)j(.)g(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)36 b Fc(3)-30 695 y Fe(set_coeff)28 b(\(\))21 +b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)47 b Fc(40)-30 786 y Fe(signum)27 b(\(\))8 b +Fd(.)k(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)33 b Fc(12)-30 878 y Fe(sin)26 b(\(\))12 +b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 b Fc(17)-30 969 +y Fe(sinh)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)36 +b Fc(19)-30 1061 y Fe(sqrt)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +36 b Fc(16)-30 1152 y Fe(sqrtp)27 b(\(\))9 b Fd(.)j(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)35 +b Fc(16)-30 1244 y Fe(square)27 b(\(\))11 b Fd(.)i(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)37 b Fc(11,)26 b(35,)h(41)-30 +1335 y(string)8 b Fd(.)13 b(.)g(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)34 +b Fc(37)-30 1426 y Fe(strlen)27 b(\(\))8 b Fd(.)k(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)33 +b Fc(37)-30 1518 y(sym)n(b)r(ol)22 b Fd(.)12 b(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)48 +b Fc(37)-30 1609 y(sym)n(b)r(olic)25 b(t)n(yp)r(e)17 +b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)43 b Fc(37)-30 1867 y Fs(T)-30 1988 y Fe(tan)26 +b(\(\))12 b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)38 b Fc(18)-30 +2080 y Fe(tanh)27 b(\(\))10 b Fd(.)j(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)36 +b Fc(19)-30 2171 y Fe(The\(\)\(\))24 b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +48 b Fc(9)-30 2263 y(transcenden)n(tal)26 b(functions)c +Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)47 b Fc(17)2032 +299 y Fe(truncate1)28 b(\(\))22 b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)47 b Fc(14)2032 +393 y Fe(truncate2)28 b(\(\))22 b Fd(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)47 b Fc(15)2032 +487 y(Tsc)n(heb)n(yc)n(hev)25 b(p)r(olynomial)c Fd(.)12 +b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)46 b Fc(42)2032 759 y +Fs(U)2032 887 y Fc(under\015o)n(w)14 b Fd(.)e(.)g(.)h(.)f(.)g(.)h(.)f +(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)40 +b Fc(51)2032 981 y(univ)l(ariate)26 b(p)r(olynomial)11 +b Fd(.)i(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) +h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)37 b +Fc(38)2032 1253 y Fs(W)2032 1380 y Fe(WANT_OBFUSCATING_OPERATORS)13 +b Fd(.)18 b(.)12 b(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)38 b Fc(27)2032 1640 y Fs(X)2032 +1767 y Fe(xgcd)27 b(\(\))10 b Fd(.)j(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.) +f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g +(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)36 +b Fc(23)2032 2041 y Fs(Z)2032 2168 y Fe(zero)27 b(\(\))21 +b Fd(.)13 b(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h +(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)47 b Fc(34,)27 b(40)2032 2263 y Fe(zerop)g(\(\))12 +b Fd(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.) +g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)39 +b Fc(13,)26 b(36,)h(41)p eop +%%Page: -1 58 +-1 57 bop 3905 -116 a Fr(i)-30 299 y Fo(T)-13 b(able)54 +b(of)g(Con)l(ten)l(ts)-30 641 y Fs(1)135 b(In)l(tro)t(duction)39 +b Fb(.)20 b(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f +(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.) +h(.)f(.)84 b Fs(1)-30 911 y(2)135 b(Installation)13 b +Fb(.)22 b(.)d(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f +(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) +f(.)g(.)h(.)f(.)58 b Fs(3)269 1048 y Fr(2.1)92 b(Prerequisites)24 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)58 b Fr(3)299 1649 y(2.2)92 -b(Building)30 b(the)h(library)25 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.) h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)55 b Fr(4)299 1774 y(2.3)92 b(Installing)31 b(the)g(library)8 +(.)53 b Fr(3)568 1157 y(2.1.1)93 b(C)p Fp(++)29 b Fr(compiler)22 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)38 b Fr(5)299 -1898 y(2.4)92 b(Cleaning)31 b(up)8 b Fa(.)14 b(.)h(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)52 b Fr(3)568 1267 +y(2.1.2)93 b(Mak)m(e)31 b(utilit)m(y)22 b Fa(.)17 b(.)e(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)38 b Fr(6)0 2147 -y Fs(3)135 b(Ordinary)45 b(n)l(um)l(b)t(er)f(t)l(yp)t(es)31 -b Fb(.)19 b(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h -(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)75 b Fs(7)299 2303 -y Fr(3.1)92 b(Exact)31 b(n)m(um)m(b)s(ers)14 b Fa(.)f(.)i(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)44 b Fr(8)299 2428 -y(3.2)92 b(Floating-p)s(oin)m(t)33 b(n)m(um)m(b)s(ers)17 -b Fa(.)12 b(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)47 b Fr(8)299 2552 y(3.3)92 -b(Complex)29 b(n)m(um)m(b)s(ers)17 b Fa(.)c(.)i(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)52 b Fr(3)568 1377 y(2.1.3)93 b(Sed)29 b(utilit)m(y)16 +b Fa(.)g(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 b Fr(3)269 +1486 y(2.2)92 b(Building)30 b(the)h(library)13 b Fa(.)h(.)h(.)g(.)g(.)g (.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)47 b Fr(10)299 2677 y(3.4)92 b(Con)m(v)m(ersions)10 -b Fa(.)16 b(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)40 -b Fr(10)0 2926 y Fs(4)135 b(F)-11 b(unctions)44 b(on)h(n)l(um)l(b)t -(ers)38 b Fb(.)20 b(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f -(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)83 b Fs(12)299 -3081 y Fr(4.1)92 b(Constructing)30 b(n)m(um)m(b)s(ers)21 -b Fa(.)13 b(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)50 b Fr(12)598 3206 y(4.1.1)93 -b(Constructing)30 b(in)m(tegers)24 b Fa(.)15 b(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)42 b Fr(3)568 1596 y(2.2.1)93 +b(Using)30 b(the)h(GNU)g(MP)f(Library)c Fa(.)15 b(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)53 b Fr(12)598 3330 y(4.1.2)93 -b(Constructing)30 b(rational)h(n)m(um)m(b)s(ers)11 b -Fa(.)i(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)40 b Fr(12)598 3455 y(4.1.3)93 -b(Constructing)30 b(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers)25 -b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)56 b Fr(12)598 3579 y(4.1.4)93 b(Constructing)30 -b(complex)g(n)m(um)m(b)s(ers)21 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)53 -b Fr(13)299 3704 y(4.2)92 b(Elemen)m(tary)30 b(functions)17 -b Fa(.)e(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 b Fr(13)299 3829 y(4.3)92 -b(Elemen)m(tary)30 b(rational)i(functions)20 b Fa(.)14 -b(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)49 -b Fr(15)299 3953 y(4.4)92 b(Elemen)m(tary)30 b(complex)g(functions)11 -b Fa(.)k(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)40 -b Fr(15)299 4078 y(4.5)92 b(Comparisons)13 b Fa(.)g(.)i(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)g(.)57 b Fr(4)269 1705 y(2.3)92 b(Installing)31 +b(the)g(library)17 b Fa(.)d(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)47 +b Fr(4)269 1815 y(2.4)92 b(Cleaning)31 b(up)17 b Fa(.)d(.)h(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)47 +b Fr(5)-30 2057 y Fs(3)135 b(Ordinary)45 b(n)l(um)l(b)t(er)f(t)l(yp)t +(es)29 b Fb(.)20 b(.)g(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h +(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)74 b Fs(6)269 +2194 y Fr(3.1)92 b(Exact)31 b(n)m(um)m(b)s(ers)22 b Fa(.)13 +b(.)i(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)52 +b Fr(6)269 2304 y(3.2)92 b(Floating-p)s(oin)m(t)33 b(n)m(um)m(b)s(ers) +23 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)55 b Fr(7)269 2413 +y(3.3)92 b(Complex)29 b(n)m(um)m(b)s(ers)c Fa(.)15 b(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)57 b Fr(8)269 2523 y(3.4)92 b(Con)m(v)m +(ersions)20 b Fa(.)c(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)42 b Fr(16)299 4202 -y(4.6)92 b(Rounding)29 b(functions)9 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)50 b Fr(8)-30 2765 y Fs(4)135 b(F)-11 +b(unctions)44 b(on)h(n)l(um)l(b)t(ers)37 b Fb(.)19 b(.)h(.)f(.)h(.)f(.) +h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h +(.)f(.)h(.)82 b Fs(10)269 2902 y Fr(4.1)92 b(Constructing)30 +b(n)m(um)m(b)s(ers)d Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)59 +b Fr(10)568 3012 y(4.1.1)93 b(Constructing)30 b(in)m(tegers)10 +b Fa(.)16 b(.)f(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)40 b Fr(10)568 3122 y(4.1.2)93 b(Constructing)30 +b(rational)h(n)m(um)m(b)s(ers)20 b Fa(.)13 b(.)i(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)49 b Fr(10)568 3231 y(4.1.3)93 b(Constructing)30 b(\015oating-p)s +(oin)m(t)h(n)m(um)m(b)s(ers)14 b Fa(.)f(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)43 b Fr(10)568 +3341 y(4.1.4)93 b(Constructing)30 b(complex)g(n)m(um)m(b)s(ers)11 +b Fa(.)h(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)40 b Fr(10)269 3450 +y(4.2)92 b(Elemen)m(tary)30 b(functions)25 b Fa(.)15 +b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)h(.)38 b Fr(17)299 4327 y(4.7)92 b(Ro)s(ots)24 b -Fa(.)15 b(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)g(.)g(.)g(.)55 b Fr(11)269 3560 y(4.3)92 +b(Elemen)m(tary)30 b(rational)i(functions)c Fa(.)15 b(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)53 b Fr(21)299 4451 y(4.8)92 b(T)-8 -b(ranscenden)m(tal)31 b(functions)8 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)57 b +Fr(12)269 3670 y(4.4)92 b(Elemen)m(tary)30 b(complex)g(functions)19 +b Fa(.)c(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)49 b Fr(12)269 3779 y(4.5)92 b(Comparisons)21 b Fa(.)14 +b(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)38 -b Fr(22)598 4576 y(4.8.1)93 b(Exp)s(onen)m(tial)30 b(and)g(logarithmic) -h(functions)9 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)38 b Fr(22)598 4700 y(4.8.2)93 -b(T)-8 b(rigonometric)30 b(functions)17 b Fa(.)e(.)h(.)f(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)51 +b Fr(13)269 3889 y(4.6)92 b(Rounding)29 b(functions)18 +b Fa(.)d(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)47 b Fr(13)269 +3998 y(4.7)92 b(Ro)s(ots)11 b Fa(.)k(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)47 b Fr(23)598 4825 y(4.8.3)93 -b(Hyp)s(erb)s(olic)29 b(functions)15 b Fa(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)44 b Fr(24)598 4949 -y(4.8.4)93 b(Euler)29 b(gamma)12 b Fa(.)i(.)h(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)41 -b Fr(25)598 5074 y(4.8.5)93 b(Riemann)29 b(zeta)e Fa(.)15 -b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)55 b Fr(26)299 5198 y(4.9)92 b(F)-8 b(unctions)31 -b(on)f(in)m(tegers)17 b Fa(.)f(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 -b Fr(26)598 5323 y(4.9.1)93 b(Logical)32 b(functions)25 -b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)55 b Fr(26)p eop -%%Page: -2 73 --2 72 bop 3849 -116 a Fr(ii)598 83 y(4.9.2)93 b(Num)m(b)s(er)28 -b(theoretic)k(functions)11 b Fa(.)k(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)40 +b Fr(16)269 4108 y(4.8)92 b(T)-8 b(ranscenden)m(tal)31 +b(functions)17 b Fa(.)e(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.) -40 b Fr(29)598 208 y(4.9.3)93 b(Com)m(binatorial)30 b(functions)12 -b Fa(.)j(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)42 -b Fr(30)299 332 y(4.10)92 b(F)-8 b(unctions)31 b(on)g(\015oating-p)s -(oin)m(t)g(n)m(um)m(b)s(ers)19 b Fa(.)12 b(.)j(.)h(.)f(.)g(.)g(.)g(.)g +f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 b Fr(17)568 4218 +y(4.8.1)93 b(Exp)s(onen)m(tial)30 b(and)g(logarithmic)h(functions)17 +b Fa(.)e(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +h(.)f(.)46 b Fr(17)568 4327 y(4.8.2)93 b(T)-8 b(rigonometric)30 +b(functions)c Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)55 b Fr(17)568 4437 y(4.8.3)93 b(Hyp)s(erb)s(olic)29 +b(functions)23 b Fa(.)15 b(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)53 b Fr(19)568 4546 y(4.8.4)93 b(Euler)29 +b(gamma)20 b Fa(.)14 b(.)i(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)49 b Fr(20)568 +4656 y(4.8.5)93 b(Riemann)29 b(zeta)13 b Fa(.)j(.)f(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)42 +b Fr(20)269 4765 y(4.9)92 b(F)-8 b(unctions)31 b(on)f(in)m(tegers)c +Fa(.)16 b(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)48 b Fr(30)299 457 y(4.11)92 b(Con)m(v)m(ersion)31 -b(functions)25 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)54 b Fr(20)568 4875 +y(4.9.1)93 b(Logical)32 b(functions)13 b Fa(.)h(.)h(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)42 +b Fr(20)568 4985 y(4.9.2)93 b(Num)m(b)s(er)28 b(theoretic)k(functions) +20 b Fa(.)14 b(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)49 +b Fr(23)568 5094 y(4.9.3)93 b(Com)m(binatorial)30 b(functions)21 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)50 +b Fr(23)269 5204 y(4.10)92 b(F)-8 b(unctions)31 b(on)g(\015oating-p)s +(oin)m(t)g(n)m(um)m(b)s(ers)25 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)54 b Fr(32)598 -581 y(4.11.1)93 b(Con)m(v)m(ersion)31 b(to)g(\015oating-p)s(oin)m(t)h -(n)m(um)m(b)s(ers)9 b Fa(.)j(.)j(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)38 b Fr(32)598 706 y(4.11.2)93 -b(Con)m(v)m(ersion)31 b(to)g(rational)h(n)m(um)m(b)s(ers)15 -b Fa(.)d(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)44 b Fr(33)299 830 y(4.12)92 -b(Random)29 b(n)m(um)m(b)s(er)f(generators)16 b Fa(.)g(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)45 b -Fr(34)299 955 y(4.13)92 b(Obfuscating)30 b(op)s(erators)21 -b Fa(.)16 b(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +g(.)g(.)56 b Fr(23)269 5313 y(4.11)92 b(Con)m(v)m(ersion)31 +b(functions)12 b Fa(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)50 b Fr(35)0 1204 y Fs(5)135 -b(Input/Output)28 b Fb(.)18 b(.)i(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h -(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.) -g(.)h(.)f(.)h(.)72 b Fs(37)299 1359 y Fr(5.1)92 b(In)m(ternal)31 -b(and)e(prin)m(ted)h(represen)m(tation)20 b Fa(.)d(.)e(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)41 b +Fr(25)p eop +%%Page: -2 59 +-2 58 bop 3879 -116 a Fr(ii)568 83 y(4.11.1)93 b(Con)m(v)m(ersion)31 +b(to)g(\015oating-p)s(oin)m(t)h(n)m(um)m(b)s(ers)17 b +Fa(.)c(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)47 b Fr(25)568 193 y(4.11.2)93 b(Con)m(v)m(ersion)31 +b(to)g(rational)h(n)m(um)m(b)s(ers)21 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)h(.)49 b Fr(37)299 1484 y(5.2)92 b(Input)29 -b(functions)e Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)57 -b Fr(38)299 1609 y(5.3)92 b(Output)29 b(functions)12 -b Fa(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)42 b Fr(40)0 -1858 y Fs(6)135 b(Rings)23 b Fb(.)d(.)g(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f -(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.) -h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)68 -b Fs(43)0 2138 y(7)135 b(Mo)t(dular)44 b(in)l(tegers)28 -b Fb(.)22 b(.)d(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f -(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)73 -b Fs(45)299 2293 y Fr(7.1)92 b(Mo)s(dular)30 b(in)m(teger)i(rings)10 -b Fa(.)k(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)39 b Fr(45)299 2418 y(7.2)92 -b(F)-8 b(unctions)31 b(on)f(mo)s(dular)e(in)m(tegers)j -Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)59 -b Fr(46)0 2667 y Fs(8)135 b(Sym)l(b)t(olic)45 b(data)g(t)l(yp)t(es)30 -b Fb(.)20 b(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f -(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)74 b Fs(48)299 -2823 y Fr(8.1)92 b(Strings)22 b Fa(.)14 b(.)h(.)g(.)g(.)g(.)g(.)h(.)f +53 b Fr(26)269 302 y(4.12)92 b(Random)29 b(n)m(um)m(b)s(er)f +(generators)e Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)51 b Fr(48)299 -2947 y(8.2)92 b(Sym)m(b)s(ols)17 b Fa(.)c(.)i(.)g(.)g(.)g(.)g(.)g(.)g +h(.)f(.)g(.)g(.)g(.)53 b Fr(26)269 412 y(4.13)92 b(Obfuscating)30 +b(op)s(erators)g Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)59 b Fr(27)-30 +654 y Fs(5)135 b(Input/Output)26 b Fb(.)19 b(.)h(.)f(.)g(.)h(.)f(.)h(.) +f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g +(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)71 b Fs(28)269 791 +y Fr(5.1)92 b(In)m(ternal)31 b(and)e(prin)m(ted)h(represen)m(tation)g +Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)58 +b Fr(28)269 901 y(5.2)92 b(Input)29 b(functions)14 b +Fa(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h -(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 b Fr(49)0 -3196 y Fs(9)135 b(Univ)-7 b(ariate)46 b(p)t(olynomials)41 -b Fb(.)19 b(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h -(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)84 b Fs(50)299 3352 y -Fr(9.1)92 b(Univ)-5 b(ariate)32 b(p)s(olynomial)d(rings)16 -b Fa(.)f(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)44 +b Fr(29)269 1010 y(5.3)92 b(Output)29 b(functions)21 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)50 +b Fr(30)-30 1253 y Fs(6)135 b(Rings)22 b Fb(.)e(.)f(.)h(.)f(.)h(.)f(.)h +(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.) +f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)67 +b Fs(33)-30 1523 y(7)135 b(Mo)t(dular)44 b(in)l(tegers)27 +b Fb(.)22 b(.)d(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f +(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)72 +b Fs(34)269 1660 y Fr(7.1)92 b(Mo)s(dular)30 b(in)m(teger)i(rings)18 +b Fa(.)c(.)h(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)46 b Fr(50)299 3477 y(9.2)92 b(F)-8 b(unctions)31 -b(on)f(univ)-5 b(ariate)31 b(p)s(olynomials)20 b Fa(.)14 -b(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)49 b Fr(52)299 -3601 y(9.3)92 b(Sp)s(ecial)31 b(p)s(olynomials)25 b Fa(.)15 -b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)47 b Fr(34)269 1769 +y(7.2)92 b(F)-8 b(unctions)31 b(on)f(mo)s(dular)e(in)m(tegers)16 +b Fa(.)h(.)e(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)46 b Fr(34)-30 2012 y Fs(8)135 b(Sym)l(b)t(olic)45 +b(data)g(t)l(yp)t(es)28 b Fb(.)21 b(.)e(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h +(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.) +73 b Fs(37)269 2149 y Fr(8.1)92 b(Strings)9 b Fa(.)14 +b(.)h(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)56 b Fr(54)0 3850 y Fs(10)135 -b(In)l(ternals)21 b Fb(.)f(.)g(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f -(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.) -h(.)f(.)h(.)f(.)h(.)f(.)g(.)66 b Fs(55)299 4006 y Fr(10.1)92 -b(Wh)m(y)31 b(C)p Fp(++)f Fr(?)19 b Fa(.)14 b(.)h(.)g(.)g(.)h(.)f(.)g +g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)38 b Fr(37)269 2258 y(8.2)92 b(Sym)m(b)s(ols)24 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)55 b Fr(37)-30 2501 y Fs(9)135 b(Univ)-7 +b(ariate)46 b(p)t(olynomials)40 b Fb(.)19 b(.)h(.)f(.)g(.)h(.)f(.)h(.)f +(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)83 +b Fs(38)269 2638 y Fr(9.1)92 b(Univ)-5 b(ariate)32 b(p)s(olynomial)d +(rings)c Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)54 b Fr(38)269 2747 y(9.2)92 b(F)-8 +b(unctions)31 b(on)f(univ)-5 b(ariate)31 b(p)s(olynomials)d +Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)58 +b Fr(40)269 2857 y(9.3)92 b(Sp)s(ecial)31 b(p)s(olynomials)13 +b Fa(.)h(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)43 b Fr(42)-30 +3099 y Fs(10)135 b(In)l(ternals)20 b Fb(.)g(.)g(.)f(.)g(.)h(.)f(.)h(.)f +(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)h(.) +f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)64 b +Fs(43)269 3236 y Fr(10.1)92 b(Wh)m(y)31 b(C)p Fp(++)f +Fr(?)d Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)57 b Fr(43)269 3346 y(10.2)92 b(Memory)30 b(e\016ciency)25 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)53 b Fr(43)269 +3455 y(10.3)92 b(Sp)s(eed)30 b(e\016ciency)e Fa(.)15 +b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)48 b Fr(55)299 4130 y(10.2)92 -b(Memory)30 b(e\016ciency)15 b Fa(.)h(.)f(.)h(.)f(.)g(.)g(.)g(.)g(.)g +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)57 b Fr(43)269 +3565 y(10.4)92 b(Garbage)32 b(collection)14 b Fa(.)k(.)d(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)44 -b Fr(55)299 4255 y(10.3)92 b(Sp)s(eed)30 b(e\016ciency)19 -b Fa(.)d(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)44 b Fr(44)-30 3807 y Fs(11)135 b(Using)46 +b(the)f(library)25 b Fb(.)20 b(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h +(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.) +h(.)69 b Fs(45)269 3944 y Fr(11.1)92 b(Compiler)30 b(options)21 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)50 b +Fr(45)269 4054 y(11.2)92 b(Include)30 b(\014les)18 b +Fa(.)d(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)47 +b Fr(45)269 4164 y(11.3)92 b(An)30 b(Example)d Fa(.)15 +b(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)57 +b Fr(48)269 4273 y(11.4)92 b(Debugging)32 b(supp)s(ort)23 +b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)54 b Fr(49)-30 +4516 y Fs(12)135 b(Customizing)39 b Fb(.)19 b(.)h(.)f(.)h(.)f(.)h(.)f +(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.) +h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)83 b Fs(51)269 4653 +y Fr(12.1)92 b(Error)30 b(handling)24 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)h +(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)48 b Fr(56)299 -4379 y(10.4)92 b(Garbage)32 b(collection)e Fa(.)15 b(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)54 b Fr(51)269 4762 y(12.2)92 +b(Floating-p)s(oin)m(t)33 b(under\015o)m(w)19 b Fa(.)14 +b(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)57 b Fr(56)0 4628 y Fs(11)135 b(Using)46 b(the)f(library)26 -b Fb(.)20 b(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f -(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)71 -b Fs(57)299 4784 y Fr(11.1)92 b(Compiler)30 b(options)12 -b Fa(.)j(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)41 b Fr(57)299 -4909 y(11.2)92 b(Include)30 b(\014les)10 b Fa(.)15 b(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)39 b Fr(57)299 5033 -y(11.3)92 b(An)30 b(Example)19 b Fa(.)c(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)49 b Fr(61)299 5158 y(11.4)92 b(Debugging)32 -b(supp)s(ort)17 b Fa(.)c(.)i(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 -b Fr(62)p eop -%%Page: -3 74 --3 73 bop 3824 -116 a Fr(iii)0 83 y Fs(12)135 b(Customizing)40 -b Fb(.)20 b(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f -(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)84 -b Fs(64)299 239 y Fr(12.1)92 b(Error)30 b(handling)17 -b Fa(.)d(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 -b Fr(64)299 363 y(12.2)92 b(Floating-p)s(oin)m(t)33 b(under\015o)m(w)11 -b Fa(.)j(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) +g(.)g(.)g(.)49 b Fr(51)269 4872 y(12.3)92 b(Customizing)30 +b(I/O)25 b Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)40 b Fr(64)299 488 y(12.3)92 b(Customizing)30 -b(I/O)16 b Fa(.)f(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) -g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)h(.)f(.)g(.)g(.)45 -b Fr(64)299 612 y(12.4)92 b(Customizing)30 b(the)h(memory)d(allo)s -(cator)k Fa(.)15 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g -(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)59 -b Fr(65)0 861 y Fs(Index)31 b Fb(.)19 b(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h -(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.) -g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)76 -b Fs(66)p eop +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)54 +b Fr(51)269 4981 y(12.4)92 b(Customizing)30 b(the)h(memory)d(allo)s +(cator)16 b Fa(.)i(.)d(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g +(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)46 +b Fr(51)-30 5224 y Fs(Index)30 b Fb(.)19 b(.)g(.)h(.)f(.)h(.)f(.)h(.)f +(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.) +h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f(.)h(.)f(.)g(.)h(.)f(.)h(.)f +(.)h(.)74 b Fs(52)p eop %%Trailer end userdict /end-hook known{end-hook}if diff --git a/doc/cln.tex b/doc/cln.tex index 21f263e..3bbb9ae 100644 --- a/doc/cln.tex +++ b/doc/cln.tex @@ -283,13 +283,13 @@ initializations will not work. @end itemize @end ignore -@cindex @code{make} @subsection Make utility +@cindex @code{make} To build CLN, you also need to have GNU @code{make} installed. -@cindex @code{sed} @subsection Sed utility +@cindex @code{sed} To build CLN on HP-UX, you also need to have GNU @code{sed} installed. This is because the libtool script, which creates the CLN library, relies @@ -411,6 +411,27 @@ use @samp{--enable-shared} because @code{g++} would miscompile parts of the library. +@subsection Using the GNU MP Library +@cindex GMP + +Starting with version 1.0.4, CLN may be configured to make use of a +preinstalled @code{gmp} library. Please make sure that you have at +least @code{gmp} version 3.0 installed since earlier versions are +unsupported and likely not to work. Enabling this feature by calling +@code{configure} with the option @samp{--with-gmp} is known to be quite +a boost for CLN's performance. + +If you have installed the @code{gmp} library and its header file in +some place where your compiler cannot find it by default, you must help +@code{configure} by setting @code{CPPFLAGS} and @code{LDFLAGS}. Here is +an example: + +@example +$ CC="gcc" CFLAGS="-O2" CXX="g++" CXXFLAGS="-O2 -fno-exceptions" \ + CPPFLAGS="-I/opt/gmp/include" LDFLAGS="-L/opt/gmp/lib" ./configure --with-gmp +@end example + + @section Installing the library @cindex installation @@ -721,10 +742,10 @@ Conversions from any class to any of its subclasses (``derived classes'' in C++ terminology) are not provided. Instead, you can assert and check that a value belongs to a certain subclass, and return it as element of that class, using the @samp{As} and @samp{The} macros. -@cindex @code{As() ()} +@cindex @code{As()()} @code{As(@var{type})(@var{value})} checks that @var{value} belongs to @var{type} and returns it as such. -@cindex @code{The() ()} +@cindex @code{The()()} @code{The(@var{type})(@var{value})} assumes that @var{value} belongs to @var{type} and returns it as such. It is your responsibility to ensure that this assumption is valid. @@ -852,7 +873,7 @@ Returns the reciprocal of the argument. The class @code{cl_I} doesn't define a @samp{/} operation because in the C/C++ language this operator, applied to integral types, denotes the @samp{floor} or @samp{truncate} operation (which one of these, -is implementation dependent). (@xref{Rounding functions}) +is implementation dependent). (@xref{Rounding functions}.) Instead, @code{cl_I} defines an ``exact quotient'' function: @table @code @@ -1196,6 +1217,11 @@ and the remainder. The suffix @samp{2} indicates this. Each of the classes @code{cl_F}, @code{cl_SF}, @code{cl_FF}, @code{cl_DF}, @code{cl_LF} defines the following operations: +@cindex @code{cl_F_fdiv_t} +@cindex @code{cl_SF_fdiv_t} +@cindex @code{cl_FF_fdiv_t} +@cindex @code{cl_DF_fdiv_t} +@cindex @code{cl_LF_fdiv_t} @table @code @item struct @var{type}_fdiv_t @{ @var{type} quotient; @var{type} remainder; @}; @@ -1209,6 +1235,7 @@ defines the following operations: @cindex @code{fround2 ()} @end table and similarly for class @code{cl_R}, but with quotient type @code{cl_F}. +@cindex @code{cl_R_fdiv_t} The class @code{cl_R} defines the following operations: @@ -1482,7 +1509,7 @@ Archimedes' constant pi = 3.14@dots{} is returned by the following functions: @table @code @item cl_F cl_pi (cl_float_format_t f) -@cindex @code{cl_pi} +@cindex @code{cl_pi ()} Returns pi as a float of format @code{f}. @item cl_F cl_pi (const cl_F& y) @@ -2083,6 +2110,7 @@ zero, it is treated as positive. Same for @code{y}. @subsection Conversion to floating-point numbers The type @code{cl_float_format_t} describes a floating-point format. +@cindex @code{cl_float_format_t} @table @code @item cl_float_format_t cl_float_format (uintL n) @@ -2106,7 +2134,7 @@ defines the following operations: @table @code @item cl_F cl_float (const @var{type}&x, cl_float_format_t f) -@cindex @code{cl_float} +@cindex @code{cl_float ()} Returns @code{x} as a float of format @code{f}. @item cl_F cl_float (const @var{type}&x, const cl_F& y) Returns @code{x} in the float format of @code{y}. @@ -2198,6 +2226,7 @@ Calling one of these modifies the state of the random number generator in a complicated but deterministic way. The global variable +@cindex @code{cl_random_state} @cindex @code{cl_default_random_state} @example cl_random_state cl_default_random_state @@ -2684,6 +2713,7 @@ The class of modular integer rings is cl_modint_ring @end example +@cindex @code{cl_modint_ring} and the class of all modular integers (elements of modular integer rings) is @@ -2742,7 +2772,7 @@ This returns @code{1 mod N}. This returns @code{x mod N}. @item cl_I R->retract (const cl_MI& x) -@cindex @code{etract ()} +@cindex @code{retract ()} This is a partial inverse function to @code{R->canonhom}. It returns the standard representative (@code{>=0}, @code{ @end example +@cindex @code{cl_modint_ring} and the class of all modular integers (elements of modular integer rings) is @@ -2986,7 +3028,7 @@ This returns @code{1 mod N}. This returns @code{x mod N}. @item cl_I R->retract (const cl_MI& x) -@cindex @code{etract ()} +@cindex @code{retract ()} This is a partial inverse function to @code{R->canonhom}. It returns the standard representative (@code{>=0}, @code{ - + CLN, a Class Library for Numbers - 1. Introduction diff --git a/doc/cln_10.html b/doc/cln_10.html index d858b76..677b915 100644 --- a/doc/cln_10.html +++ b/doc/cln_10.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 10. Internals @@ -9,13 +9,13 @@ Go to the first, previous,

      -

      10. Internals

      +

      10. Internals

      -

      10.1 Why C++ ?

      +

      10.1 Why C++ ?

      - +

      @@ -30,7 +30,7 @@ Efficiency: It compiles to machine code.

    • - + Portability: It runs on all platforms supporting a C++ compiler. Because of the availability of GNU C++, this includes all currently used 32-bit and 64-bit platforms, independently of the quality of the vendor's C++ compiler. @@ -62,7 +62,7 @@ in a high-level language. -

      10.2 Memory efficiency

      +

      10.2 Memory efficiency

      In order to save memory allocations, CLN implements: @@ -76,8 +76,8 @@ Object sharing: An operation like x+0 returns x withou it.

    • - - + + Garbage collection: A reference counting mechanism makes sure that any number object's storage is freed immediately when the last reference to the object is gone. @@ -91,7 +91,7 @@ on the heap. -

      10.3 Speed efficiency

      +

      10.3 Speed efficiency

      Speed efficiency is obtained by the combination of the following tricks @@ -122,9 +122,9 @@ algorithm. For very large numbers (more than 12000 decimal digits), CLN uses Schönhage-Strassen - -multiplication, which is an asymptotically -optimal multiplication algorithm. + +multiplication, which is an asymptotically optimal multiplication +algorithm.

    • These fast multiplication algorithms also give improvements in the speed @@ -133,9 +133,9 @@ of division and radix conversion. -

      10.4 Garbage collection

      +

      10.4 Garbage collection

      - +

      diff --git a/doc/cln_11.html b/doc/cln_11.html index 411c047..59bcaa8 100644 --- a/doc/cln_11.html +++ b/doc/cln_11.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 11. Using the library @@ -9,7 +9,7 @@ Go to the first, previous,

      -

      11. Using the library

      +

      11. Using the library

      For the following discussion, we will assume that you have installed @@ -21,9 +21,9 @@ environment variables, or directly substitute the appropriate values. -

      11.1 Compiler options

      +

      11.1 Compiler options

      - +

      @@ -60,10 +60,10 @@ linking a CLN application it is sufficient to give the flag -lcln. -

      11.2 Include files

      +

      11.2 Include files

      - - + +

      @@ -256,11 +256,11 @@ Includes all of the above. -

      11.3 An Example

      +

      11.3 An Example

      A function which computes the nth Fibonacci number can be written as follows. - + @@ -344,9 +344,9 @@ contains this implementation together with an even faster algorithm. -

      11.4 Debugging support

      +

      11.4 Debugging support

      - +

      @@ -380,7 +380,7 @@ CLN offers a function cl_print, callable from the debugger, for printing number objects. In order to get this function, you have to define the macro `CL_DEBUG' and then include all the header files for which you want cl_print debugging support. For example: - + 

       #define CL_DEBUG
@@ -407,7 +407,7 @@ only with number objects and similar. Therefore CLN offers a member function
 debug_print() on all CLN types. The same macro `CL_DEBUG'
 is needed for this member function to be implemented. Under gdb,
 you call it like this:
-
+
 
 
       (gdb) print s
diff --git a/doc/cln_12.html b/doc/cln_12.html
index 9399348..6b80c8c 100644
--- a/doc/cln_12.html
+++ b/doc/cln_12.html
@@ -1,6 +1,6 @@
 
 
-
+
 
 CLN, a Class Library for Numbers - 12. Customizing
 
@@ -9,14 +9,14 @@ Go to the first, previous, 
      
 
 
-
      12. Customizing
      
+
      12. Customizing
      
 
      
-
+
 
 
 
 
-
      12.1 Error handling
      
+
      12.1 Error handling
      
 
 
      
 When a fatal error occurs, an error message is output to the standard error
@@ -31,15 +31,15 @@ void cl_abort (void);
 
      
 
 
      
-
+
 This function must not return control to its caller.
 
 
 
 
-
      12.2 Floating-point underflow
      
+
      12.2 Floating-point underflow
      
 
      
-
+
 
 
 
      
@@ -60,17 +60,17 @@ will be generated instead.  The default value of
 
 
 
-
      12.3 Customizing I/O
      
+
      12.3 Customizing I/O
      
 
 
      
 The output of the function fprint may be customized by changing the
 value of the global variable cl_default_print_flags.
-
+
 
 
 
 
-
      12.4 Customizing the memory allocator
      
+
      12.4 Customizing the memory allocator
      
 
 
      
 Every memory allocation of CLN is done through the function pointer
@@ -89,8 +89,8 @@ void (*cl_free_hook) (void* ptr)      = ...;

      - - + + The cl_malloc_hook function must not return a NULL pointer. diff --git a/doc/cln_13.html b/doc/cln_13.html index 1240d1e..0bb9712 100644 --- a/doc/cln_13.html +++ b/doc/cln_13.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - Index @@ -9,7 +9,7 @@ Go to the first, previous, ne

      -

      Index

      +

      Index

      Jump to: diff --git a/doc/cln_2.html b/doc/cln_2.html index d9f2136..86b3375 100644 --- a/doc/cln_2.html +++ b/doc/cln_2.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 2. Installation @@ -50,21 +50,23 @@ of static and global variables, a feature which I could implement for GNU g++ only. -

      -

      2.1.2 Make utility

      +

      + +

      To build CLN, you also need to have GNU make installed. -

      -

      2.1.3 Sed utility

      +

      + +

      To build CLN on HP-UX, you also need to have GNU sed installed. @@ -200,11 +202,40 @@ library. -

      2.3 Installing the library

      +

      2.2.1 Using the GNU MP Library

      +

      +Starting with version 1.0.4, CLN may be configured to make use of a +preinstalled gmp library. Please make sure that you have at +least gmp version 3.0 installed since earlier versions are +unsupported and likely not to work. Enabling this feature by calling +configure with the option `--with-gmp' is known to be quite +a boost for CLN's performance. + + +

      +If you have installed the gmp library and its header file in +some place where your compiler cannot find it by default, you must help +configure by setting CPPFLAGS and LDFLAGS. Here is +an example: + + + +

      +$ CC="gcc" CFLAGS="-O2" CXX="g++" CXXFLAGS="-O2 -fno-exceptions" \
+  CPPFLAGS="-I/opt/gmp/include" LDFLAGS="-L/opt/gmp/lib" ./configure --with-gmp
+
      + + + +

      2.3 Installing the library

      +

      + + +

      As with any autoconfiguring GNU software, installation is as easy as this: @@ -230,7 +261,7 @@ the --prefix=... option. -

      2.4 Cleaning up

      +

      2.4 Cleaning up

      You can remove system-dependent files generated by make through diff --git a/doc/cln_3.html b/doc/cln_3.html index ed3eae4..5a60729 100644 --- a/doc/cln_3.html +++ b/doc/cln_3.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 3. Ordinary number types @@ -9,7 +9,7 @@ Go to the first, previous,

      -

      3. Ordinary number types

      +

      3. Ordinary number types

      CLN implements the following class hierarchy: @@ -45,8 +45,8 @@ Rational number Floating-point number

      - + The base class cl_number is an abstract base class. It is not useful to declare a variable of this type except if you want to completely disable compile-time type checking and use run-time type @@ -54,24 +54,24 @@ checking instead.

      - + The class cl_N comprises real and complex numbers. There is no special class for complex numbers since complex numbers with imaginary part 0 are automatically converted to real numbers.

      - + The class cl_R comprises real numbers of different kinds. It is an abstract class.

      - + The class cl_RA comprises exact real numbers: rational numbers, including integers. There is no special class for non-integral rational numbers since rational numbers with denominator 1 are automatically converted @@ -79,16 +79,16 @@ to integers.

      - + The class cl_F implements floating-point approximations to real numbers. It is an abstract class. -

      3.1 Exact numbers

      +

      3.1 Exact numbers

      - +

      @@ -130,9 +130,9 @@ is completely transparent. -

      3.2 Floating-point numbers

      +

      3.2 Floating-point numbers

      - +

      @@ -144,7 +144,7 @@ CLN implements ordinary floating-point numbers, with mantissa and exponent.

      - + The elementary operations (+, -, *, /, ...) only return approximate results. For example, the value of the expression (cl_F) 0.3 + (cl_F) 0.4 prints as `0.70000005', not as @@ -175,7 +175,7 @@ Floating point numbers come in four flavors:

      • - + Short floats, type cl_SF. They have 1 sign bit, 8 exponent bits (including the exponent's sign), and 17 mantissa bits (including the "hidden" bit). @@ -183,7 +183,7 @@ They don't consume heap allocation.
      • - + Single floats, type cl_FF. They have 1 sign bit, 8 exponent bits (including the exponent's sign), and 24 mantissa bits (including the "hidden" bit). @@ -192,7 +192,7 @@ This corresponds closely to the C/C++ type `float'.
      • - + Double floats, type cl_DF. They have 1 sign bit, 11 exponent bits (including the exponent's sign), and 53 mantissa bits (including the "hidden" bit). @@ -201,7 +201,7 @@ This corresponds closely to the C/C++ type `double'.
      • - + Long floats, type cl_LF. They have 1 sign bit, 32 exponent bits (including the exponent's sign), and n mantissa bits (including the "hidden" bit), where n >= 64. @@ -222,7 +222,7 @@ with larger exponent range.

        - + As a user of CLN, you can forget about the differences between the four floating-point types and just declare all your floating-point variables as being of type cl_F. This has the advantage that @@ -237,9 +237,9 @@ the floating point contagion rule happened to change in the future.) -

        3.3 Complex numbers

        +

        3.3 Complex numbers

        - +

        @@ -256,9 +256,9 @@ through application of sqrt or transcendental functions. -

        3.4 Conversions

        +

        3.4 Conversions

        - +

        @@ -317,7 +317,7 @@ Conversions from `const char *' are provided for the classes cl_R, cl_N. The easiest way to specify a value which is outside of the range of the C++ built-in types is therefore to specify it as a string, like this: - + 

            cl_I order_of_rubiks_cube_group = "43252003274489856000";
@@ -337,16 +337,16 @@ the functions
 
 
        int cl_I_to_int (const cl_I& x)
 
        
-
+
 
        unsigned int cl_I_to_uint (const cl_I& x)
 
        
-
+
 
        long cl_I_to_long (const cl_I& x)
 
        
-
+
 
        unsigned long cl_I_to_ulong (const cl_I& x)
 
        
-
+
 Returns x as element of the C type ctype. If x is not
 representable in the range of ctype, a runtime error occurs.
 
@@ -363,10 +363,10 @@ the functions
 
 
        float cl_float_approx (const type& x)
 
        
-
+
 
        double cl_double_approx (const type& x)
 
        
-
+
 Returns an approximation of x of C type ctype.
 If abs(x) is too close to 0 (underflow), 0 is returned.
 If abs(x) is too large (overflow), an IEEE infinity is returned.
@@ -377,10 +377,10 @@ Conversions from any class to any of its subclasses ("derived classes" in
 C++ terminology) are not provided. Instead, you can assert and check
 that a value belongs to a certain subclass, and return it as element of that
 class, using the `As' and `The' macros.
-
+
 As(type)(value) checks that value belongs to
 type and returns it as such.
-
+
 The(type)(value) assumes that value belongs to
 type and returns it as such. It is your responsibility to ensure
 that this assumption is valid.
diff --git a/doc/cln_4.html b/doc/cln_4.html
index 4bf113f..183858e 100644
--- a/doc/cln_4.html
+++ b/doc/cln_4.html
@@ -1,6 +1,6 @@
 
 
-
+
 
 CLN, a Class Library for Numbers - 4. Functions on numbers
 
@@ -9,7 +9,7 @@ Go to the first, previous, 
        
 
 
-
        4. Functions on numbers
        
+
        4. Functions on numbers
        
 
 
        
 Each of the number classes declares its mathematical operations in the
@@ -19,7 +19,7 @@ objects of type cl_I, it should #include <cl_integer.h
 
 
 
-
        4.1 Constructing numbers
        
+
        4.1 Constructing numbers
        
 
 
        
 Here is how to create number objects "from nothing".
@@ -27,37 +27,37 @@ Here is how to create number objects "from nothing".
 
 
 
-
        4.1.1 Constructing integers
        
+
        4.1.1 Constructing integers
        
 
 
        
 cl_I objects are most easily constructed from C integers and from
-strings. See section 3.4 Conversions.
+strings. See section 3.4 Conversions.
 
 
 
 
-
        4.1.2 Constructing rational numbers
        
+
        4.1.2 Constructing rational numbers
        
 
 
        
 cl_RA objects can be constructed from strings. The syntax
-for rational numbers is described in section 5.1 Internal and printed representation.
+for rational numbers is described in section 5.1 Internal and printed representation.
 Another standard way to produce a rational number is through application
 of `operator /' or `recip' on integers.
 
 
 
 
-
        4.1.3 Constructing floating-point numbers
        
+
        4.1.3 Constructing floating-point numbers
        
 
 
        
 cl_F objects with low precision are most easily constructed from
-C `float' and `double'. See section 3.4 Conversions.
+C `float' and `double'. See section 3.4 Conversions.
 
 
 
        
 To construct a cl_F with high precision, you can use the conversion
 from `const char *', but you have to specify the desired precision
-within the string. (See section 5.1 Internal and printed representation.)
+within the string. (See section 5.1 Internal and printed representation.)
 Example:
 
 
        @@ -71,7 +71,7 @@ will set `e' to the given value, with a precision of 40 decimal dig
 
        
 The programmatic way to construct a cl_F with high precision is
 through the cl_float conversion function, see
-section 4.11.1 Conversion to floating-point numbers. For example, to compute
+section 4.11.1 Conversion to floating-point numbers. For example, to compute
 e to 40 decimal places, first construct 1.0 to 40 decimal places
 and then apply the exponential function:
 
@@ -82,7 +82,7 @@ and then apply the exponential function:
 
 
 
-
        4.1.4 Constructing complex numbers
        
+
        4.1.4 Constructing complex numbers
        
 
 
        
 Non-real cl_N objects are normally constructed through the function
@@ -92,12 +92,12 @@ Non-real cl_N objects are normally constructed through the function
 
        
 
 
        
-See section 4.4 Elementary complex functions.
+See section 4.4 Elementary complex functions.
 
 
 
 
-
        4.2 Elementary functions
        
+
        4.2 Elementary functions
        
 
 
        
 Each of the classes cl_N, cl_R, cl_RA, cl_I,
@@ -109,12 +109,12 @@ defines the following operations:
 
 
        type operator + (const type&, const type&)
 
        
-
+
 Addition.
 
 
        type operator - (const type&, const type&)
 
        
-
+
 Subtraction.
 
 
        type operator - (const type&)
@@ -123,22 +123,22 @@ Returns the negative of the argument.
 
 
        type plus1 (const type& x)
 
        
-
+
 Returns x + 1.
 
 
        type minus1 (const type& x)
 
        
-
+
 Returns x - 1.
 
 
        type operator * (const type&, const type&)
 
        
-
+
 Multiplication.
 
 
        type square (const type& x)
 
        
-
+
 Returns x * x.
 
 
@@ -152,12 +152,12 @@ defines the following operations:
 
 
        type operator / (const type&, const type&)
 
        
-
+
 Division.
 
 
        type recip (const type&)
 
        
-
+
 Returns the reciprocal of the argument.
 
 
@@ -165,7 +165,7 @@ Returns the reciprocal of the argument.
 The class cl_I doesn't define a `/' operation because
 in the C/C++ language this operator, applied to integral types,
 denotes the `floor' or `truncate' operation (which one of these,
-is implementation dependent). (See section 4.6 Rounding functions)
+is implementation dependent). (See section 4.6 Rounding functions.)
 Instead, cl_I defines an "exact quotient" function:
 
 
@@ -173,7 +173,7 @@ Instead, cl_I defines an "exact quotient" function:
 
 
        cl_I exquo (const cl_I& x, const cl_I& y)
 
        
-
+
 Checks that y divides x, and returns the quotient x/y.
 
 
@@ -185,14 +185,14 @@ The following exponentiation functions are defined:
 
 
        cl_I expt_pos (const cl_I& x, const cl_I& y)
 
        
-
+
 
        cl_RA expt_pos (const cl_RA& x, const cl_I& y)
 
        
 y must be > 0. Returns x^y.
 
 
        cl_RA expt (const cl_RA& x, const cl_I& y)
 
        
-
+
 
        cl_R expt (const cl_R& x, const cl_I& y)
 
        
 
        cl_N expt (const cl_N& x, const cl_I& y)
@@ -210,7 +210,7 @@ defines the following operation:
 
 
        type abs (const type& x)
 
        
-
+
 Returns the absolute value of x.
 This is x if x >= 0, and -x if x <= 0.
 
@@ -236,7 +236,7 @@ defines the following operation:
 
 
        type signum (const type& x)
 
        
-
+
 Returns the sign of x, in the same number format as x.
 This is defined as x / abs(x) if x is non-zero, and
 x if x is zero. If x is real, the value is either
@@ -245,7 +245,7 @@ This is defined as x / abs(x) if x is non-zero, and
 
 
 
-
        4.3 Elementary rational functions
        
+
        4.3 Elementary rational functions
        
 
 
        
 Each of the classes cl_RA, cl_I defines the following operations:
@@ -255,12 +255,12 @@ Each of the classes cl_RA, cl_I defines the following
 
 
        cl_I numerator (const type& x)
 
        
-
+
 Returns the numerator of x.
 
 
        cl_I denominator (const type& x)
 
        
-
+
 Returns the denominator of x.
 
 
@@ -271,7 +271,7 @@ a way that they have no factor in common and the denominator is positive.
 
 
 
-
        4.4 Elementary complex functions
        
+
        4.4 Elementary complex functions
        
 
 
        
 The class cl_N defines the following operation:
@@ -281,7 +281,7 @@ The class cl_N defines the following operation:
 
 
        cl_N complex (const cl_R& a, const cl_R& b)
 
        
-
+
 Returns the complex number a+bi, that is, the complex number with
 real part a and imaginary part b.
 
@@ -294,17 +294,17 @@ Each of the classes cl_N, cl_R defines the following o
 
 
        cl_R realpart (const type& x)
 
        
-
+
 Returns the real part of x.
 
 
        cl_R imagpart (const type& x)
 
        
-
+
 Returns the imaginary part of x.
 
 
        type conjugate (const type& x)
 
        
-
+
 Returns the complex conjugate of x.
 
 
@@ -324,9 +324,9 @@ We have the relations
 
 
 
-
        4.5 Comparisons
        
+
        4.5 Comparisons
        
 
        
-
+
 
 
 
        
@@ -339,22 +339,22 @@ defines the following operations:
 
 
        bool operator == (const type&, const type&)
 
        
-
+
 
        bool operator != (const type&, const type&)
 
        
-
+
 Comparison, as in C and C++.
 
 
        uint32 cl_equal_hashcode (const type&)
 
        
-
+
 Returns a 32-bit hash code that is the same for any two numbers which are
 the same according to ==. This hash code depends on the number's value,
 not its type or precision.
 
 
        cl_boolean zerop (const type& x)
 
        
-
+
 Compare against zero: x == 0
 
 
@@ -368,42 +368,42 @@ defines the following operations:
 
 
        cl_signean cl_compare (const type& x, const type& y)
 
        
-
+
 Compares x and y. Returns +1 if x>y,
 -1 if x<y, 0 if x=y.
 
 
        bool operator <= (const type&, const type&)
 
        
-
+
 
        bool operator < (const type&, const type&)
 
        
-
+
 
        bool operator >= (const type&, const type&)
 
        
-
+
 
        bool operator > (const type&, const type&)
 
        
-
+
 Comparison, as in C and C++.
 
 
        cl_boolean minusp (const type& x)
 
        
-
+
 Compare against zero: x < 0
 
 
        cl_boolean plusp (const type& x)
 
        
-
+
 Compare against zero: x > 0
 
 
        type max (const type& x, const type& y)
 
        
-
+
 Return the maximum of x and y.
 
 
        type min (const type& x, const type& y)
 
        
-
+
 Return the minimum of x and y.
 
 
@@ -418,9 +418,9 @@ there is no floating point number whose value is exactly 1/3.
 
 
 
-
        4.6 Rounding functions
        
+
        4.6 Rounding functions
        
 
        
-
+
 
 
 
        
@@ -491,19 +491,19 @@ defines the following operations:
 
 
        cl_I floor1 (const type& x)
 
        
-
+
 Returns floor(x).
 
        cl_I ceiling1 (const type& x)
 
        
-
+
 Returns ceiling(x).
 
        cl_I truncate1 (const type& x)
 
        
-
+
 Returns truncate(x).
 
        cl_I round1 (const type& x)
 
        
-
+
 Returns round(x).
 
 
@@ -592,16 +592,16 @@ defines the following operations:
 
        
 
        type_div_t floor2 (const type& x, const type& y)
 
        
-
+
 
        type_div_t ceiling2 (const type& x, const type& y)
 
        
-
+
 
        type_div_t truncate2 (const type& x, const type& y)
 
        
-
+
 
        type_div_t round2 (const type& x, const type& y)
 
        
-
+
 
 
 
        
@@ -620,16 +620,16 @@ defines the following operations:
 
 
        type ffloor (const type& x)
 
        
-
+
 
        type fceiling (const type& x)
 
        
-
+
 
        type ftruncate (const type& x)
 
        
-
+
 
        type fround (const type& x)
 
        
-
+
 
 
 
        
@@ -661,6 +661,11 @@ and the remainder. The suffix `2' indicates this.
 Each of the classes
 cl_F, cl_SF, cl_FF, cl_DF, cl_LF
 defines the following operations:
+
+
+
+
+
 
 
 
        
@@ -669,19 +674,20 @@ defines the following operations:
 
        
 
        type_fdiv_t ffloor2 (const type& x)
 
        
-
+
 
        type_fdiv_t fceiling2 (const type& x)
 
        
-
+
 
        type_fdiv_t ftruncate2 (const type& x)
 
        
-
+
 
        type_fdiv_t fround2 (const type& x)
 
        
-
+
 
        
 
        
 and similarly for class cl_R, but with quotient type cl_F.
+
 
 
 
        
@@ -733,15 +739,15 @@ The classes cl_R, cl_I define the following operations
 
 
        type mod (const type& x, const type& y)
 
        
-
+
 
        type rem (const type& x, const type& y)
 
        
-
+
 
 
 
 
-
        4.7 Roots
        
+
        4.7 Roots
        
 
 
        
 Each of the classes cl_R,
@@ -753,7 +759,7 @@ defines the following operation:
 
 
        type sqrt (const type& x)
 
        
-
+
 x must be >= 0. This function returns the square root of x,
 normalized to be >= 0. If x is the square of a rational number,
 sqrt(x) will be a rational number, else it will return a
@@ -768,7 +774,7 @@ The classes cl_RA, cl_I define the following operation
 
 
        cl_boolean sqrtp (const type& x, type* root)
 
        
-
+
 This tests whether x is a perfect square. If so, it returns true
 and the exact square root in *root, else it returns false.
 
@@ -781,7 +787,7 @@ Furthermore, for integers, similarly:
 
 
        cl_boolean isqrt (const type& x, type* root)
 
        
-
+
 x should be >= 0. This function sets *root to
 floor(sqrt(x)) and returns the same value as sqrtp:
 the boolean value (expt(*root,2) == x).
@@ -796,7 +802,7 @@ define the following operation:
 
 
        cl_boolean rootp (const type& x, const cl_I& n, type* root)
 
        
-
+
 x must be >= 0. n must be > 0.
 This tests whether x is an nth power of a rational number.
 If so, it returns true and the exact root in *root, else it returns
@@ -812,7 +818,7 @@ for class cl_N:
 
 
        cl_N sqrt (const cl_N& z)
 
        
-
+
 Returns the square root of z, as defined by the formula
 sqrt(z) = exp(log(z)/2). Conversion to a floating-point type
 or to a complex number are done if necessary. The range of the result is the
@@ -824,9 +830,9 @@ The result is an exact number only if z is an exact number.
 
 
 
-
        4.8 Transcendental functions
        
+
        4.8 Transcendental functions
        
 
        
-
+
 
 
 
        
@@ -838,13 +844,13 @@ For example, cos(0) = 1 returns the rational number 1.
 
 
 
-
        4.8.1 Exponential and logarithmic functions
        
+
        4.8.1 Exponential and logarithmic functions
        
 
 
        
 
 
        cl_R exp (const cl_R& x)
 
        
-
+
 
        cl_N exp (const cl_N& x)
 
        
 Returns the exponential function of x. This is e^x where
@@ -853,12 +859,12 @@ is the entire complex plane excluding 0.
 
 
        cl_R ln (const cl_R& x)
 
        
-
+
 x must be > 0. Returns the (natural) logarithm of x.
 
 
        cl_N log (const cl_N& x)
 
        
-
+
 Returns the (natural) logarithm of x. If x is real and positive,
 this is ln(x). In general, log(x) = log(abs(x)) + i*phase(x).
 The range of the result is the strip in the complex plane
@@ -866,7 +872,7 @@ The range of the result is the strip in the complex plane
 
 
        cl_R phase (const cl_N& x)
 
        
-
+
 Returns the angle part of x in its polar representation as a
 complex number. That is, phase(x) = atan(realpart(x),imagpart(x)).
 This is also the imaginary part of log(x).
@@ -888,7 +894,7 @@ Returns the logarithm of a with respect to base b.
 
 
        cl_N expt (const cl_N& x, const cl_N& y)
 
        
-
+
 Exponentiation: Returns x^y = exp(y*log(x)).
 
        
 
@@ -900,7 +906,7 @@ The constant e = exp(1) = 2.71828... is returned by the following functions:
 
 
        cl_F cl_exp1 (cl_float_format_t f)
 
        
-
+
 Returns e as a float of format f.
 
 
        cl_F cl_exp1 (const cl_F& y)
@@ -914,13 +920,13 @@ Returns e as a float of format cl_default_float_format.
 
 
 
-
        4.8.2 Trigonometric functions
        
+
        4.8.2 Trigonometric functions
        
 
 
        
 
 
        cl_R sin (const cl_R& x)
 
        
-
+
 Returns sin(x). The range of the result is the interval
 -1 <= sin(x) <= 1.
 
@@ -930,7 +936,7 @@ Returns sin(z). The range of the result is the entire complex plane
 
 
        cl_R cos (const cl_R& x)
 
        
-
+
 Returns cos(x). The range of the result is the interval
 -1 <= cos(x) <= 1.
 
@@ -940,31 +946,31 @@ Returns cos(z). The range of the result is the entire complex plane
 
 
        struct cl_cos_sin_t { cl_R cos; cl_R sin; };
 
        
-
+
 
        cl_cos_sin_t cl_cos_sin (const cl_R& x)
 
        
 Returns both sin(x) and cos(x). This is more efficient than
-
+
 computing them separately. The relation cos^2 + sin^2 = 1 will
 hold only approximately.
 
 
        cl_R tan (const cl_R& x)
 
        
-
+
 
        cl_N tan (const cl_N& x)
 
        
 Returns tan(x) = sin(x)/cos(x).
 
 
        cl_N cis (const cl_R& x)
 
        
-
+
 
        cl_N cis (const cl_N& x)
 
        
 Returns exp(i*x). The name `cis' means "cos + i sin", because
 e^(i*x) = cos(x) + i*sin(x).
 
-
-
+
+
 
        cl_N asin (const cl_N& z)
 
        
 Returns arcsin(z). This is defined as
@@ -977,7 +983,7 @@ with realpart = pi/2 and imagpart > 0.
 
 
        cl_N acos (const cl_N& z)
 
        
-
+
 Returns arccos(z). This is defined as
 arccos(z) = pi/2 - arcsin(z) = log(z+i*sqrt(1-z^2))/i
 and satisfies arccos(-z) = pi - arccos(z).
@@ -986,8 +992,8 @@ The range of the result is the strip in the complex domain
 with realpart = 0 and imagpart < 0 and the numbers
 with realpart = pi and imagpart > 0.
 
-
-
+
+
 
        cl_R atan (const cl_R& x, const cl_R& y)
 
        
 Returns the angle of the polar representation of the complex number
@@ -1016,8 +1022,8 @@ with realpart = pi/2 and imagpart <= 0.
 
        
 
 
        
-
-
+
+
 Archimedes' constant pi = 3.14... is returned by the following functions:
 
 
@@ -1025,7 +1031,7 @@ Archimedes' constant pi = 3.14... is returned by the following functions:
 
 
        cl_F cl_pi (cl_float_format_t f)
 
        
-
+
 Returns pi as a float of format f.
 
 
        cl_F cl_pi (const cl_F& y)
@@ -1039,13 +1045,13 @@ Returns pi as a float of format cl_default_float_format.
 
 
 
-
        4.8.3 Hyperbolic functions
        
+
        4.8.3 Hyperbolic functions
        
 
 
        
 
 
        cl_R sinh (const cl_R& x)
 
        
-
+
 Returns sinh(x).
 
 
        cl_N sinh (const cl_N& z)
@@ -1054,7 +1060,7 @@ Returns sinh(z). The range of the result is the entire complex plan
 
 
        cl_R cosh (const cl_R& x)
 
        
-
+
 Returns cosh(x). The range of the result is the interval
 cosh(x) >= 1.
 
@@ -1064,24 +1070,24 @@ Returns cosh(z). The range of the result is the entire complex plan
 
 
        struct cl_cosh_sinh_t { cl_R cosh; cl_R sinh; };
 
        
-
+
 
        cl_cosh_sinh_t cl_cosh_sinh (const cl_R& x)
 
        
-
+
 Returns both sinh(x) and cosh(x). This is more efficient than
 computing them separately. The relation cosh^2 - sinh^2 = 1 will
 hold only approximately.
 
 
        cl_R tanh (const cl_R& x)
 
        
-
+
 
        cl_N tanh (const cl_N& x)
 
        
 Returns tanh(x) = sinh(x)/cosh(x).
 
 
        cl_N asinh (const cl_N& z)
 
        
-
+
 Returns arsinh(z). This is defined as
 arsinh(z) = log(z+sqrt(1+z^2)) and satisfies
 arsinh(-z) = -arsinh(z).
@@ -1092,7 +1098,7 @@ with imagpart = pi/2 and realpart < 0.
 
 
        cl_N acosh (const cl_N& z)
 
        
-
+
 Returns arcosh(z). This is defined as
 arcosh(z) = 2*log(sqrt((z+1)/2)+sqrt((z-1)/2)).
 The range of the result is the half-strip in the complex domain
@@ -1101,7 +1107,7 @@ excluding the numbers with realpart = 0 and -pi < imagpar
 
 
        cl_N atanh (const cl_N& z)
 
        
-
+
 Returns artanh(z). This is defined as
 artanh(z) = (log(1+z)-log(1-z)) / 2 and satisfies
 artanh(-z) = -artanh(z). The range of the result is
@@ -1113,9 +1119,9 @@ with imagpart = pi/2 and realpart >= 0.
 
 
 
-
        4.8.4 Euler gamma
        
+
        4.8.4 Euler gamma
        
 
        
-
+
 
 
 
        
@@ -1126,7 +1132,7 @@ Euler's constant C = 0.577... is returned by the following functions:
 
 
        cl_F cl_eulerconst (cl_float_format_t f)
 
        
-
+
 Returns Euler's constant as a float of format f.
 
 
        cl_F cl_eulerconst (const cl_F& y)
@@ -1140,14 +1146,14 @@ Returns Euler's constant as a float of format cl_default_float_format
 Catalan's constant G = 0.915... is returned by the following functions:
-
+
 
 
 
        
 
 
        cl_F cl_catalanconst (cl_float_format_t f)
 
        
-
+
 Returns Catalan's constant as a float of format f.
 
 
        cl_F cl_catalanconst (const cl_F& y)
@@ -1161,9 +1167,9 @@ Returns Catalan's constant as a float of format cl_default_float_format4.8.5 Riemann zeta
+
        4.8.5 Riemann zeta
        
 
        
-
+
 
 
 
        
@@ -1175,7 +1181,7 @@ following functions:
 
 
        cl_F cl_zeta (int s, cl_float_format_t f)
 
        
-
+
 Returns Riemann's zeta function at s as a float of format f.
 
 
        cl_F cl_zeta (int s, const cl_F& y)
@@ -1190,11 +1196,11 @@ Returns Riemann's zeta function at s as a float of format
 
 
 
-
        4.9 Functions on integers
        
+
        4.9 Functions on integers
        
 
 
 
-
        4.9.1 Logical functions
        
+
        4.9.1 Logical functions
        
 
 
        
 Integers, when viewed as in two's complement notation, can be thought as
@@ -1215,69 +1221,69 @@ on each of the bit positions in parallel.
 
 
        cl_I lognot (const cl_I& x)
 
        
-
+
 
        cl_I operator ~ (const cl_I& x)
 
        
-
+
 Logical not, like ~x in C. This is the same as -1-x.
 
 
        cl_I logand (const cl_I& x, const cl_I& y)
 
        
-
+
 
        cl_I operator & (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical and, like x & y in C.
 
 
        cl_I logior (const cl_I& x, const cl_I& y)
 
        
-
+
 
        cl_I operator | (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical (inclusive) or, like x | y in C.
 
 
        cl_I logxor (const cl_I& x, const cl_I& y)
 
        
-
+
 
        cl_I operator ^ (const cl_I& x, const cl_I& y)
 
        
-
+
 Exclusive or, like x ^ y in C.
 
 
        cl_I logeqv (const cl_I& x, const cl_I& y)
 
        
-
+
 Bitwise equivalence, like ~(x ^ y) in C.
 
 
        cl_I lognand (const cl_I& x, const cl_I& y)
 
        
-
+
 Bitwise not and, like ~(x & y) in C.
 
 
        cl_I lognor (const cl_I& x, const cl_I& y)
 
        
-
+
 Bitwise not or, like ~(x | y) in C.
 
 
        cl_I logandc1 (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical and, complementing the first argument, like ~x & y in C.
 
 
        cl_I logandc2 (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical and, complementing the second argument, like x & ~y in C.
 
 
        cl_I logorc1 (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical or, complementing the first argument, like ~x | y in C.
 
 
        cl_I logorc2 (const cl_I& x, const cl_I& y)
 
        
-
+
 Logical or, complementing the second argument, like x | ~y in C.
 
        
 
@@ -1287,7 +1293,7 @@ These operations are all available though the function
 
 
        cl_I boole (cl_boole op, const cl_I& x, const cl_I& y)
 
        
-
+
 
        
 
        
 where op must have one of the 16 values (each one stands for a function
@@ -1296,13 +1302,6 @@ which combines two bits into one bit): boole_clr, boole_setboole_and, boole_ior, boole_xor, boole_eqv,
 boole_nand, boole_nor, boole_andc1, boole_andc2,
 boole_orc1, boole_orc2.
-
-
-
-
-
-
-
 
 
 
@@ -1311,6 +1310,13 @@ which combines two bits into one bit): boole_clr, boole_set
 
 
+
+
+
+
+
+
+
 
 
 
        
@@ -1321,19 +1327,19 @@ Other functions that view integers as bit strings:
 
 
        cl_boolean logtest (const cl_I& x, const cl_I& y)
 
        
-
+
 Returns true if some bit is set in both x and y, i.e. if
 logand(x,y) != 0.
 
 
        cl_boolean logbitp (const cl_I& n, const cl_I& x)
 
        
-
+
 Returns true if the nth bit (from the right) of x is set.
 Bit 0 is the least significant bit.
 
 
        uintL logcount (const cl_I& x)
 
        
-
+
 Returns the number of one bits in x, if x >= 0, or
 the number of zero bits in x, if x < 0.
 
@@ -1347,7 +1353,7 @@ struct cl_byte { uintL size; uintL position; };

        - + represents the bit interval containing the bits position...position+size-1 of an integer. The constructor cl_byte(size,position) constructs a cl_byte. @@ -1357,19 +1363,19 @@ The constructor cl_byte(size,position) constructs a cl_bytecl_I ldb (const cl_I& n, const cl_byte& b)

        - + extracts the bits of n described by the bit interval b and returns them as a nonnegative integer with b.size bits.
        cl_boolean ldb_test (const cl_I& n, const cl_byte& b)
        - + Returns true if some bit described by the bit interval b is set in n.
        cl_I dpb (const cl_I& newbyte, const cl_I& n, const cl_byte& b)
        - + Returns n, with the bits described by the bit interval b replaced by newbyte. Only the lowest b.size bits of newbyte are relevant. @@ -1384,13 +1390,13 @@ functions are their counterparts without shifting:
        cl_I mask_field (const cl_I& n, const cl_byte& b)
        - + returns an integer with the bits described by the bit interval b copied from the corresponding bits in n, the other bits zero.
        cl_I deposit_field (const cl_I& newbyte, const cl_I& n, const cl_byte& b)
        - + returns an integer where the bits described by the bit interval b come from newbyte and the other bits come from n. @@ -1421,39 +1427,39 @@ for common arithmetic operations:
        cl_boolean oddp (const cl_I& x)
        - + Returns true if the least significant bit of x is 1. Equivalent to mod(x,2) != 0.
        cl_boolean evenp (const cl_I& x)
        - + Returns true if the least significant bit of x is 0. Equivalent to mod(x,2) == 0.
        cl_I operator << (const cl_I& x, const cl_I& n)
        - + Shifts x by n bits to the left. n should be >=0. Equivalent to x * expt(2,n).
        cl_I operator >> (const cl_I& x, const cl_I& n)
        - + Shifts x by n bits to the right. n should be >=0. Bits shifted out to the right are thrown away. Equivalent to floor(x / expt(2,n)).
        cl_I ash (const cl_I& x, const cl_I& y)
        - + Shifts x by y bits to the left (if y>=0) or by -y bits to the right (if y<=0). In other words, this returns floor(x * expt(2,y)).
        uintL integer_length (const cl_I& x)
        - + Returns the number of bits (excluding the sign bit) needed to represent x in two's complement notation. This is the smallest n >= 0 such that -2^n <= x < 2^n. If x > 0, this is the unique n > 0 such that @@ -1461,14 +1467,14 @@ in two's complement notation. This is the smallest n >= 0 such that
        uintL ord2 (const cl_I& x)
        - + x must be non-zero. This function returns the number of 0 bits at the right of x in two's complement notation. This is the largest n >= 0 such that 2^n divides x.
        uintL power2p (const cl_I& x)
        - + x must be > 0. This function checks whether x is a power of 2. If x = 2^(n-1), it returns n. Else it returns 0. (See also the function logp.) @@ -1476,13 +1482,13 @@ If x = 2^(n-1), it returns n. Else it returns 0. -

        4.9.2 Number theoretic functions

        +

        4.9.2 Number theoretic functions

        uint32 gcd (uint32 a, uint32 b)
        - +
        cl_I gcd (const cl_I& a, const cl_I& b)
        This function returns the greatest common divisor of a and b, @@ -1490,7 +1496,7 @@ normalized to be >= 0.
        cl_I xgcd (const cl_I& a, const cl_I& b, cl_I* u, cl_I* v)
        - + This function ("extended gcd") returns the greatest common divisor g of a and b and at the same time the representation of g as an integral linear combination of a and b: @@ -1502,13 +1508,13 @@ value, in the following sense: If a and b are non-zero
        cl_I lcm (const cl_I& a, const cl_I& b)
        - + This function returns the least common multiple of a and b, normalized to be >= 0.
        cl_boolean logp (const cl_I& a, const cl_I& b, cl_RA* l)
        - +
        cl_boolean logp (const cl_RA& a, const cl_RA& b, cl_RA* l)
        a must be > 0. b must be >0 and != 1. If log(a,b) is @@ -1518,26 +1524,26 @@ it returns false. -

        4.9.3 Combinatorial functions

        +

        4.9.3 Combinatorial functions

        cl_I factorial (uintL n)
        - + n must be a small integer >= 0. This function returns the factorial n! = 1*2*...*n.
        cl_I doublefactorial (uintL n)
        - + n must be a small integer >= 0. This function returns the doublefactorial n!! = 1*3*...*n or n!! = 2*4*...*n, respectively.
        cl_I binomial (uintL n, uintL k)
        - + n and k must be small integers >= 0. This function returns the binomial coefficient (n choose k) = n! / k! (n-k)! @@ -1546,7 +1552,7 @@ for 0 <= k <= n, 0 else. -

        4.10 Functions on floating-point numbers

        +

        4.10 Functions on floating-point numbers

        Recall that a floating-point number consists of a sign s, an @@ -1564,7 +1570,7 @@ defines the following operations.

        type scale_float (const type& x, sintL delta)
        - +
        type scale_float (const type& x, const cl_I& delta)
        Returns x*2^delta. This is more efficient than an explicit multiplication @@ -1580,32 +1586,32 @@ representation of floating-point numbers.
        sintL float_exponent (const type& x)
        - + Returns the exponent e of x. For x = 0.0, this is 0. For x non-zero, this is the unique integer with 2^(e-1) <= abs(x) < 2^e.
        sintL float_radix (const type& x)
        - + Returns the base of the floating-point representation. This is always 2.
        type float_sign (const type& x)
        - + Returns the sign s of x as a float. The value is 1 for x >= 0, -1 for x < 0.
        uintL float_digits (const type& x)
        - + Returns the number of mantissa bits in the floating-point representation of x, including the hidden bit. The value only depends on the type of x, not on its value.
        uintL float_precision (const type& x)
        - + Returns the number of significant mantissa bits in the floating-point representation of x. Since denormalized numbers are not supported, this is the same as float_digits(x) if x is non-zero, and @@ -1614,11 +1620,11 @@ this is the same as float_digits(x) if x is non-zero,

        The complete internal representation of a float is encoded in the type - - - - - + + + + + cl_decoded_float (or cl_decoded_sfloat, cl_decoded_ffloat, cl_decoded_dfloat, cl_decoded_lfloat, respectively), defined by @@ -1636,7 +1642,7 @@ and returned by the function

        cl_decoded_typefloat decode_float (const type& x)
        - + For x non-zero, this returns (-1)^s, e, m with x = (-1)^s * 2^e * m and 0.5 <= m < 1.0. For x = 0, it returns (-1)^s=1, e=0, m=0. @@ -1647,7 +1653,7 @@ it returns (-1)^s=1, e=0, m=0. A complete decoding in terms of integers is provided as type 
        -struct cl_idecoded_float {
+struct cl_idecoded_float {
         cl_I mantissa; cl_I exponent; cl_I sign;
 };
        @@ -1660,7 +1666,7 @@ by the following function:
        cl_idecoded_float integer_decode_float (const type& x)
        - + For x non-zero, this returns (-1)^s, e, m with x = (-1)^s * 2^e * m and m an integer with float_digits(x) bits. For x = 0, it returns (-1)^s=1, e=0, m=0. @@ -1676,7 +1682,7 @@ Some other function, implemented only for class cl_F:
        cl_F float_sign (const cl_F& x, const cl_F& y)
        - + This returns a floating point number whose precision and absolute value is that of y and whose sign is that of x. If x is zero, it is treated as positive. Same for y. @@ -1684,24 +1690,25 @@ zero, it is treated as positive. Same for y. -

        4.11 Conversion functions

        +

        4.11 Conversion functions

        - + -

        4.11.1 Conversion to floating-point numbers

        +

        4.11.1 Conversion to floating-point numbers

        The type cl_float_format_t describes a floating-point format. +

        cl_float_format_t cl_float_format (uintL n)
        - + Returns the smallest float format which guarantees at least n decimal digits in the mantissa (after the decimal point). @@ -1711,7 +1718,7 @@ Returns the floating point format of x.
        cl_float_format_t cl_default_float_format
        - + Global variable: the default float format used when converting rational numbers to floats.
        @@ -1727,7 +1734,7 @@ defines the following operations:
        cl_F cl_float (const type&x, cl_float_format_t f)
        - + Returns x as a float of format f.
        cl_F cl_float (const type&x, const cl_F& y)
        @@ -1750,40 +1757,40 @@ Every floating-point format has some characteristic numbers:
        cl_F most_positive_float (cl_float_format_t f)
        - + Returns the largest (most positive) floating point number in float format f.
        cl_F most_negative_float (cl_float_format_t f)
        - + Returns the smallest (most negative) floating point number in float format f.
        cl_F least_positive_float (cl_float_format_t f)
        - + Returns the least positive floating point number (i.e. > 0 but closest to 0) in float format f.
        cl_F least_negative_float (cl_float_format_t f)
        - + Returns the least negative floating point number (i.e. < 0 but closest to 0) in float format f.
        cl_F float_epsilon (cl_float_format_t f)
        - + Returns the smallest floating point number e > 0 such that 1+e != 1.
        cl_F float_negative_epsilon (cl_float_format_t f)
        - + Returns the smallest floating point number e > 0 such that 1-e != 1.
        -

        4.11.2 Conversion to rational numbers

        +

        4.11.2 Conversion to rational numbers

        Each of the classes cl_R, cl_RA, cl_F @@ -1794,7 +1801,7 @@ defines the following operation:

        cl_RA rational (const type& x)
        - + Returns the value of x as an exact number. If x is already an exact number, this is x. If x is a floating-point number, the value is a rational number whose denominator is a power of 2. @@ -1809,7 +1816,7 @@ the function
        cl_RA rationalize (const cl_R& x)
        - + If x is a floating-point number, it actually represents an interval of real numbers, and this function returns the rational number with smallest denominator (and smallest numerator, in magnitude) @@ -1833,7 +1840,7 @@ If x is any float, one has -

        4.12 Random number generators

        +

        4.12 Random number generators

        A random generator is a machine which produces (pseudo-)random numbers. @@ -1851,7 +1858,8 @@ a complicated but deterministic way.

        The global variable - + + 

         cl_random_state cl_default_random_state
@@ -1868,14 +1876,14 @@ below are called without cl_random_state argument.
 
        
 
        uint32 random32 ()
 
        
-
+
 Returns a random unsigned 32-bit number. All bits are equally random.
 
 
        cl_I random_I (cl_random_state& randomstate, const cl_I& n)
 
        
 
        cl_I random_I (const cl_I& n)
 
        
-
+
 n must be an integer > 0. This function returns a random integer x
 in the range 0 <= x < n.
 
@@ -1883,7 +1891,7 @@ in the range 0 <= x < n.
 
        
 
        cl_F random_F (const cl_F& n)
 
        
-
+
 n must be a float > 0. This function returns a random floating-point
 number of the same format as n in the range 0 <= x < n.
 
@@ -1891,16 +1899,16 @@ number of the same format as n in the range 0 <= x <
 
        
 
        cl_R random_R (const cl_R& n)
 
        
-
+
 Behaves like random_I if n is an integer and like random_F
 if n is a float.
        -

        4.13 Obfuscating operators

        +

        4.13 Obfuscating operators

        - +

        @@ -1916,7 +1924,7 @@ to get happy, then add

        - + to the beginning of your source files, before the inclusion of any CLN include files. This flag will enable the following operators: @@ -1930,16 +1938,16 @@ For the classes cl_N, cl_R, cl_RA,

        type& operator += (type&, const type&)
        - +
        type& operator -= (type&, const type&)
        - +
        type& operator *= (type&, const type&)
        - +
        type& operator /= (type&, const type&)
        - +

        @@ -1956,19 +1964,19 @@ For the class cl_I:

        type& operator &= (type&, const type&)
        - +
        type& operator |= (type&, const type&)
        - +
        type& operator ^= (type&, const type&)
        - +
        type& operator <<= (type&, const type&)
        - +
        type& operator >>= (type&, const type&)
        - +

        @@ -1980,7 +1988,7 @@ For the classes cl_N, cl_R, cl_RA,

        type& operator ++ (type& x)
        - + The prefix operator ++x.
        void operator ++ (type& x, int) @@ -1989,7 +1997,7 @@ The postfix operator x++.
        type& operator -- (type& x)
        - + The prefix operator --x.
        void operator -- (type& x, int) diff --git a/doc/cln_5.html b/doc/cln_5.html index 7f83961..32c6e79 100644 --- a/doc/cln_5.html +++ b/doc/cln_5.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 5. Input/Output @@ -9,16 +9,16 @@ Go to the first, previous,

        -

        5. Input/Output

        +

        5. Input/Output

        - + -

        5.1 Internal and printed representation

        +

        5.1 Internal and printed representation

        - +

        @@ -33,9 +33,9 @@ Several external representations may denote the same number, for example,

        Converting an internal to an external representation is called "printing", - + converting an external to an internal representation is called "reading". - + In CLN, it is always true that conversion of an internal to an external representation and then back to an internal representation will yield the same internal representation. Symbolically: read(print(x)) == x. @@ -115,7 +115,7 @@ In Common Lisp notation: #C(realpart imagpart)5.2 Input functions +

        5.2 Input functions

        Including <cl_io.h> defines a type cl_istream, which is @@ -267,7 +267,7 @@ precision corresponding to their number of significant digits. -

        5.3 Output functions

        +

        5.3 Output functions

        Including <cl_io.h> defines a type cl_ostream, which is diff --git a/doc/cln_6.html b/doc/cln_6.html index 4ccf7aa..e75c4a4 100644 --- a/doc/cln_6.html +++ b/doc/cln_6.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 6. Rings @@ -9,7 +9,7 @@ Go to the first, previous,

        -

        6. Rings

        +

        6. Rings

        CLN has a class of abstract rings. diff --git a/doc/cln_7.html b/doc/cln_7.html index 007ae5a..b67dd03 100644 --- a/doc/cln_7.html +++ b/doc/cln_7.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 7. Modular integers @@ -9,16 +9,16 @@ Go to the first, previous,

        -

        7. Modular integers

        +

        7. Modular integers

        - + -

        7.1 Modular integer rings

        +

        7.1 Modular integer rings

        - +

        @@ -46,6 +46,10 @@ The class of modular integer rings is <cl_modinteger.h> +

        + + +

        and the class of all modular integers (elements of modular integer rings) is @@ -65,11 +69,11 @@ Modular integer rings are constructed using the function

        cl_modint_ring cl_find_modint_ring (const cl_I& N)
        - + This function returns the modular ring `Z/NZ'. It takes care of finding out about special cases of N, like powers of two and odd numbers for which Montgomery multiplication will be a win, - + and precomputes any necessary auxiliary data for computing modulo N. There is a cache table of rings, indexed by N (or, more precisely, by abs(N)). This ensures that the precomputation costs are reduced @@ -84,10 +88,10 @@ Modular integer rings can be compared for equality:
        bool operator== (const cl_modint_ring&, const cl_modint_ring&)
        - +
        bool operator!= (const cl_modint_ring&, const cl_modint_ring&)
        - + These compare two modular integer rings for equality. Two different calls to cl_find_modint_ring with the same argument necessarily return the same ring because it is memoized in the cache table. @@ -95,7 +99,7 @@ same ring because it is memoized in the cache table. -

        7.2 Functions on modular integers

        +

        7.2 Functions on modular integers

        Given a modular integer ring R, the following members can be used. @@ -105,27 +109,27 @@ Given a modular integer ring R, the following members can be used.

        cl_I R->modulus
        - + This is the ring's modulus, normalized to be nonnegative: abs(N).
        cl_MI R->zero()
        - + This returns 0 mod N.
        cl_MI R->one()
        - + This returns 1 mod N.
        cl_MI R->canonhom (const cl_I& x)
        - + This returns x mod N.
        cl_I R->retract (const cl_MI& x)
        - + This is a partial inverse function to R->canonhom. It returns the standard representative (>=0, <N) of x. @@ -133,7 +137,7 @@ standard representative (>=0, <N) of x
        cl_MI R->random()
        - + This returns a random integer modulo N. @@ -145,18 +149,18 @@ The following operations are defined on modular integers.
        cl_modint_ring x.ring ()
        - + Returns the ring to which the modular integer x belongs.
        cl_MI operator+ (const cl_MI&, const cl_MI&)
        - + Returns the sum of two modular integers. One of the arguments may also be a plain integer.
        cl_MI operator- (const cl_MI&, const cl_MI&)
        - + Returns the difference of two modular integers. One of the arguments may also be a plain integer. @@ -166,61 +170,61 @@ Returns the negative of a modular integer.
        cl_MI operator* (const cl_MI&, const cl_MI&)
        - + Returns the product of two modular integers. One of the arguments may also be a plain integer.
        cl_MI square (const cl_MI&)
        - + Returns the square of a modular integer.
        cl_MI recip (const cl_MI& x)
        - + Returns the reciprocal x^-1 of a modular integer x. x must be coprime to the modulus, otherwise an error message is issued.
        cl_MI div (const cl_MI& x, const cl_MI& y)
        - + Returns the quotient x*y^-1 of two modular integers x, y. y must be coprime to the modulus, otherwise an error message is issued.
        cl_MI expt_pos (const cl_MI& x, const cl_I& y)
        - + y must be > 0. Returns x^y.
        cl_MI expt (const cl_MI& x, const cl_I& y)
        - + Returns x^y. If y is negative, x must be coprime to the modulus, else an error message is issued.
        cl_MI operator<< (const cl_MI& x, const cl_I& y)
        - + Returns x*2^y.
        cl_MI operator>> (const cl_MI& x, const cl_I& y)
        - + Returns x*2^-y. When y is positive, the modulus must be odd, or an error message is issued.
        bool operator== (const cl_MI&, const cl_MI&)
        - +
        bool operator!= (const cl_MI&, const cl_MI&)
        - + Compares two modular integers, belonging to the same modular integer ring, for equality.
        cl_boolean zerop (const cl_MI& x)
        - + Returns true if x is 0 mod N. @@ -233,10 +237,10 @@ input/output).
        void fprint (cl_ostream stream, const cl_MI& x)
        - +
        cl_ostream operator<< (cl_ostream stream, const cl_MI& x)
        - + Prints the modular integer x on the stream. The output may depend on the global printer settings in the variable cl_default_print_flags. diff --git a/doc/cln_8.html b/doc/cln_8.html index 3dd2018..c46c223 100644 --- a/doc/cln_8.html +++ b/doc/cln_8.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 8. Symbolic data types @@ -9,9 +9,9 @@ Go to the first, previous,

        -

        8. Symbolic data types

        +

        8. Symbolic data types

        - +

        @@ -20,9 +20,9 @@ CLN implements two symbolic (non-numeric) data types: strings and symbols. -

        8.1 Strings

        +

        8.1 Strings

        - +

        @@ -48,7 +48,7 @@ Strings are constructed through the following constructors:

        cl_string (const char * s)
        - + Returns an immutable copy of the (zero-terminated) C string s.
        cl_string (const char * ptr, unsigned long len) @@ -69,30 +69,30 @@ Assignment from cl_string and const char *.
        s.length()
        - +
        strlen(s)
        - + Returns the length of the string s.
        s[i]
        - + Returns the ith character of the string s. i must be in the range 0 <= i < s.length().
        bool equal (const cl_string& s1, const cl_string& s2)
        - + Compares two strings for equality. One of the arguments may also be a plain const char *. -

        8.2 Symbols

        +

        8.2 Symbols

        - +

        @@ -112,7 +112,7 @@ Symbols are constructed through the following constructor:

        cl_symbol (const cl_string& s)
        - + Looks up or creates a new symbol with a given name. @@ -129,7 +129,7 @@ Conversion to cl_string: Returns the string which names the symbol
        bool equal (const cl_symbol& sym1, const cl_symbol& sym2)
        - + Compares two symbols for equality. This is very fast. diff --git a/doc/cln_9.html b/doc/cln_9.html index 08c8bfe..f11c049 100644 --- a/doc/cln_9.html +++ b/doc/cln_9.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - 9. Univariate polynomials @@ -9,15 +9,15 @@ Go to the first, previous,

        -

        9. Univariate polynomials

        +

        9. Univariate polynomials

        - - + + -

        9.1 Univariate polynomial rings

        +

        9.1 Univariate polynomial rings

        CLN implements univariate polynomials (polynomials in one variable) over an @@ -125,7 +125,7 @@ return the same polynomial ring.

        cl_univpoly_complex_ring cl_find_univpoly_ring (const cl_complex_ring& R)
        - +
        cl_univpoly_complex_ring cl_find_univpoly_ring (const cl_complex_ring& R, const cl_symbol& varname)
        cl_univpoly_real_ring cl_find_univpoly_ring (const cl_real_ring& R) @@ -150,7 +150,7 @@ only the return type is more specific, according to the base ring's type. -

        9.2 Functions on univariate polynomials

        +

        9.2 Functions on univariate polynomials

        Given a univariate polynomial ring R, the following members can be used. @@ -160,33 +160,33 @@ Given a univariate polynomial ring R, the following members can be

        cl_ring R->basering()
        - + This returns the base ring, as passed to `cl_find_univpoly_ring'.
        cl_UP R->zero()
        - + This returns 0 in R, a polynomial of degree -1.
        cl_UP R->one()
        - + This returns 1 in R, a polynomial of degree <= 0.
        cl_UP R->canonhom (const cl_I& x)
        - + This returns x in R, a polynomial of degree <= 0.
        cl_UP R->monomial (const cl_ring_element& x, uintL e)
        - + This returns a sparse polynomial: x * X^e, where X is the indeterminate.
        cl_UP R->create (sintL degree)
        - + Creates a new polynomial with a given degree. The zero polynomial has degree -1. After creating the polynomial, you should put in the coefficients, using the set_coeff member function, and then call the finalize @@ -201,14 +201,14 @@ The following are the only destructive operations on univariate polynomials.
        void set_coeff (cl_UP& x, uintL index, const cl_ring_element& y)
        - + This changes the coefficient of X^index in x to be y. After changing a polynomial and before applying any "normal" operation on it, you should call its finalize member function.
        void finalize (cl_UP& x)
        - + This function marks the endpoint of destructive modifications of a polynomial. It normalizes the internal representation so that subsequent computations have less overhead. Doing normal computations on unnormalized polynomials may @@ -223,17 +223,17 @@ The following operations are defined on univariate polynomials.
        cl_univpoly_ring x.ring ()
        - + Returns the ring to which the univariate polynomial x belongs.
        cl_UP operator+ (const cl_UP&, const cl_UP&)
        - + Returns the sum of two univariate polynomials.
        cl_UP operator- (const cl_UP&, const cl_UP&)
        - + Returns the difference of two univariate polynomials.
        cl_UP operator- (const cl_UP&) @@ -242,54 +242,54 @@ Returns the negative of a univariate polynomial.
        cl_UP operator* (const cl_UP&, const cl_UP&)
        - + Returns the product of two univariate polynomials. One of the arguments may also be a plain integer or an element of the base ring.
        cl_UP square (const cl_UP&)
        - + Returns the square of a univariate polynomial.
        cl_UP expt_pos (const cl_UP& x, const cl_I& y)
        - + y must be > 0. Returns x^y.
        bool operator== (const cl_UP&, const cl_UP&)
        - +
        bool operator!= (const cl_UP&, const cl_UP&)
        - + Compares two univariate polynomials, belonging to the same univariate polynomial ring, for equality.
        cl_boolean zerop (const cl_UP& x)
        - + Returns true if x is 0 in R.
        sintL degree (const cl_UP& x)
        - + Returns the degree of the polynomial. The zero polynomial has degree -1.
        cl_ring_element coeff (const cl_UP& x, uintL index)
        - + Returns the coefficient of X^index in the polynomial x.
        cl_ring_element x (const cl_ring_element& y)
        - + Evaluation: If x is a polynomial and y belongs to the base ring, then `x(y)' returns the value of the substitution of y into x.
        cl_UP deriv (const cl_UP& x)
        - + Returns the derivative of the polynomial x with respect to the indeterminate X. @@ -303,10 +303,10 @@ input/output).
        void fprint (cl_ostream stream, const cl_UP& x)
        - +
        cl_ostream operator<< (cl_ostream stream, const cl_UP& x)
        - + Prints the univariate polynomial x on the stream. The output may depend on the global printer settings in the variable cl_default_print_flags. @@ -314,7 +314,7 @@ depend on the global printer settings in the variable -

        9.3 Special polynomials

        +

        9.3 Special polynomials

        The following functions return special polynomials. @@ -324,26 +324,26 @@ The following functions return special polynomials.

        cl_UP_I cl_tschebychev (sintL n)
        - - + + Returns the n-th Tchebychev polynomial (n >= 0).
        cl_UP_I cl_hermite (sintL n)
        - - + + Returns the n-th Hermite polynomial (n >= 0).
        cl_UP_RA cl_legendre (sintL n)
        - - + + Returns the n-th Legendre polynomial (n >= 0).
        cl_UP_I cl_laguerre (sintL n)
        - - + + Returns the n-th Laguerre polynomial (n >= 0). diff --git a/doc/cln_toc.html b/doc/cln_toc.html index 5dd7415..73d2e87 100644 --- a/doc/cln_toc.html +++ b/doc/cln_toc.html @@ -1,6 +1,6 @@ - + CLN, a Class Library for Numbers - Table of Contents @@ -20,102 +20,105 @@
      • 2.1.3 Sed utility
    • 2.2 Building the library -
    • 2.3 Installing the library -
    • 2.4 Cleaning up + +
    • 2.3 Installing the library +
    • 2.4 Cleaning up
    -
  • 3. Ordinary number types +
  • 3. Ordinary number types -
  • 4. Functions on numbers +
  • 4. Functions on numbers -
  • 5. Input/Output +
  • 5. Input/Output -
  • 6. Rings -
  • 7. Modular integers +
  • 6. Rings +
  • 7. Modular integers -
  • 8. Symbolic data types +
  • 8. Symbolic data types -
  • 9. Univariate polynomials +
  • 9. Univariate polynomials -
  • 10. Internals +
  • 10. Internals -
  • 11. Using the library +
  • 11. Using the library -
  • 12. Customizing +
  • 12. Customizing -
  • Index +
  • Index

    -This document was generated on 4 May 2000 using +This document was generated on 5 May 2000 using texi2html 1.56k. diff --git a/doc/texinfo.tex b/doc/texinfo.tex index 75b7f23..5d0f53c 100644 --- a/doc/texinfo.tex +++ b/doc/texinfo.tex @@ -1,78 +1,90 @@ -%% TeX macros to handle texinfo files - -% Copyright (C) 1985, 86, 88, 90, 91, 92, 93, -% 94, 95, 1996 Free Software Foundation, Inc. - -%This texinfo.tex file is free software; you can redistribute it and/or -%modify it under the terms of the GNU General Public License as -%published by the Free Software Foundation; either version 2, or (at -%your option) any later version. - -%This texinfo.tex file is distributed in the hope that it will be -%useful, but WITHOUT ANY WARRANTY; without even the implied warranty -%of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -%General Public License for more details. - -%You should have received a copy of the GNU General Public License -%along with this texinfo.tex file; see the file COPYING. If not, write -%to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, -%Boston, MA 02111-1307, USA. - - -%In other words, you are welcome to use, share and improve this program. -%You are forbidden to forbid anyone else to use, share and improve -%what you give them. Help stamp out software-hoarding! - - -% Send bug reports to bug-texinfo@prep.ai.mit.edu. -% Please include a *precise* test case in each bug report. - - -% Make it possible to create a .fmt file just by loading this file: -% if the underlying format is not loaded, start by loading it now. -% Added by gildea November 1993. +% texinfo.tex -- TeX macros to handle Texinfo files. +% +% Load plain if necessary, i.e., if running under initex. \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi +% +\def\texinfoversion{1999-10-01.07} +% +% Copyright (C) 1985, 86, 88, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99 +% Free Software Foundation, Inc. +% +% This texinfo.tex file is free software; you can redistribute it and/or +% modify it under the terms of the GNU General Public License as +% published by the Free Software Foundation; either version 2, or (at +% your option) any later version. +% +% This texinfo.tex file is distributed in the hope that it will be +% useful, but WITHOUT ANY WARRANTY; without even the implied warranty +% of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +% General Public License for more details. +% +% You should have received a copy of the GNU General Public License +% along with this texinfo.tex file; see the file COPYING. If not, write +% to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, +% Boston, MA 02111-1307, USA. +% +% In other words, you are welcome to use, share and improve this program. +% You are forbidden to forbid anyone else to use, share and improve +% what you give them. Help stamp out software-hoarding! +% +% Please try the latest version of texinfo.tex before submitting bug +% reports; you can get the latest version from: +% ftp://ftp.gnu.org/gnu/texinfo.tex +% (and all GNU mirrors, see http://www.gnu.org/order/ftp.html) +% ftp://texinfo.org/tex/texinfo.tex +% ftp://us.ctan.org/macros/texinfo/texinfo.tex +% (and all CTAN mirrors, finger ctan@us.ctan.org for a list). +% /home/gd/gnu/doc/texinfo.tex on the GNU machines. +% The texinfo.tex in any given Texinfo distribution could well be out +% of date, so if that's what you're using, please check. +% Texinfo has a small home page at http://texinfo.org/. +% +% Send bug reports to bug-texinfo@gnu.org. Please include including a +% complete document in each bug report with which we can reproduce the +% problem. Patches are, of course, greatly appreciated. +% +% To process a Texinfo manual with TeX, it's most reliable to use the +% texi2dvi shell script that comes with the distribution. For a simple +% manual foo.texi, however, you can get away with this: +% tex foo.texi +% texindex foo.?? +% tex foo.texi +% tex foo.texi +% dvips foo.dvi -o # or whatever, to process the dvi file; this makes foo.ps. +% The extra runs of TeX get the cross-reference information correct. +% Sometimes one run after texindex suffices, and sometimes you need more +% than two; texi2dvi does it as many times as necessary. +% +% It is possible to adapt texinfo.tex for other languages. You can get +% the existing language-specific files from ftp://ftp.gnu.org/gnu/texinfo/. -% This automatically updates the version number based on RCS. -\def\deftexinfoversion$#1: #2 ${\def\texinfoversion{#2}} -\deftexinfoversion$Revision: 1.1 $ -\message{Loading texinfo package [Version \texinfoversion]:} +\message{Loading texinfo [version \texinfoversion]:} % If in a .fmt file, print the version number % and turn on active characters that we couldn't do earlier because % they might have appeared in the input file name. -\everyjob{\message{[Texinfo version \texinfoversion]}\message{} +\everyjob{\message{[Texinfo version \texinfoversion]}% \catcode`+=\active \catcode`\_=\active} % Save some parts of plain tex whose names we will redefine. - -\let\ptextilde=\~ -\let\ptexlbrace=\{ -\let\ptexrbrace=\} -\let\ptexdots=\dots -\let\ptexdot=\. -\let\ptexstar=\* -\let\ptexend=\end -\let\ptexbullet=\bullet \let\ptexb=\b +\let\ptexbullet=\bullet \let\ptexc=\c +\let\ptexcomma=\, +\let\ptexdot=\. +\let\ptexdots=\dots +\let\ptexend=\end +\let\ptexequiv=\equiv +\let\ptexexclam=\! \let\ptexi=\i +\let\ptexlbrace=\{ +\let\ptexrbrace=\} +\let\ptexstar=\* \let\ptext=\t -\let\ptexl=\l -\let\ptexL=\L -% Be sure we're in horizontal mode when doing a tie, since we make space -% equivalent to this in @example-like environments. Otherwise, a space -% at the beginning of a line will start with \penalty -- and -% since \penalty is valid in vertical mode, we'd end up putting the -% penalty on the vertical list instead of in the new paragraph. -{\catcode`@ = 11 - % Avoid using \@M directly, because that causes trouble - % if the definition is written into an index file. - \global\let\tiepenalty = \@M - \gdef\tie{\leavevmode\penalty\tiepenalty\ } -} -\let\~ = \tie % And make it available as @~. +% We never want plain's outer \+ definition in Texinfo. +% For @tex, we can use \tabalign. +\let\+ = \relax \message{Basics,} \chardef\other=12 @@ -81,18 +93,47 @@ % starts a new line in the output. \newlinechar = `^^J -% Set up fixed words for English. -\ifx\putwordChapter\undefined{\gdef\putwordChapter{Chapter}}\fi% -\def\putwordInfo{Info}% -\ifx\putwordSee\undefined{\gdef\putwordSee{See}}\fi% -\ifx\putwordsee\undefined{\gdef\putwordsee{see}}\fi% -\ifx\putwordfile\undefined{\gdef\putwordfile{file}}\fi% -\ifx\putwordpage\undefined{\gdef\putwordpage{page}}\fi% -\ifx\putwordsection\undefined{\gdef\putwordsection{section}}\fi% -\ifx\putwordSection\undefined{\gdef\putwordSection{Section}}\fi% -\ifx\putwordTableofContents\undefined{\gdef\putwordTableofContents{Table of Contents}}\fi% -\ifx\putwordShortContents\undefined{\gdef\putwordShortContents{Short Contents}}\fi% -\ifx\putwordAppendix\undefined{\gdef\putwordAppendix{Appendix}}\fi% +% Set up fixed words for English if not already set. +\ifx\putwordAppendix\undefined \gdef\putwordAppendix{Appendix}\fi +\ifx\putwordChapter\undefined \gdef\putwordChapter{Chapter}\fi +\ifx\putwordfile\undefined \gdef\putwordfile{file}\fi +\ifx\putwordin\undefined \gdef\putwordin{in}\fi +\ifx\putwordIndexIsEmpty\undefined \gdef\putwordIndexIsEmpty{(Index is empty)}\fi +\ifx\putwordIndexNonexistent\undefined \gdef\putwordIndexNonexistent{(Index is nonexistent)}\fi +\ifx\putwordInfo\undefined \gdef\putwordInfo{Info}\fi +\ifx\putwordInstanceVariableof\undefined \gdef\putwordInstanceVariableof{Instance Variable of}\fi +\ifx\putwordMethodon\undefined \gdef\putwordMethodon{Method on}\fi +\ifx\putwordNoTitle\undefined \gdef\putwordNoTitle{No Title}\fi +\ifx\putwordof\undefined \gdef\putwordof{of}\fi +\ifx\putwordon\undefined \gdef\putwordon{on}\fi +\ifx\putwordpage\undefined \gdef\putwordpage{page}\fi +\ifx\putwordsection\undefined \gdef\putwordsection{section}\fi +\ifx\putwordSection\undefined \gdef\putwordSection{Section}\fi +\ifx\putwordsee\undefined \gdef\putwordsee{see}\fi +\ifx\putwordSee\undefined \gdef\putwordSee{See}\fi +\ifx\putwordShortTOC\undefined \gdef\putwordShortTOC{Short Contents}\fi +\ifx\putwordTOC\undefined \gdef\putwordTOC{Table of Contents}\fi +% +\ifx\putwordMJan\undefined \gdef\putwordMJan{January}\fi +\ifx\putwordMFeb\undefined \gdef\putwordMFeb{February}\fi +\ifx\putwordMMar\undefined \gdef\putwordMMar{March}\fi +\ifx\putwordMApr\undefined \gdef\putwordMApr{April}\fi +\ifx\putwordMMay\undefined \gdef\putwordMMay{May}\fi +\ifx\putwordMJun\undefined \gdef\putwordMJun{June}\fi +\ifx\putwordMJul\undefined \gdef\putwordMJul{July}\fi +\ifx\putwordMAug\undefined \gdef\putwordMAug{August}\fi +\ifx\putwordMSep\undefined \gdef\putwordMSep{September}\fi +\ifx\putwordMOct\undefined \gdef\putwordMOct{October}\fi +\ifx\putwordMNov\undefined \gdef\putwordMNov{November}\fi +\ifx\putwordMDec\undefined \gdef\putwordMDec{December}\fi +% +\ifx\putwordDefmac\undefined \gdef\putwordDefmac{Macro}\fi +\ifx\putwordDefspec\undefined \gdef\putwordDefspec{Special Form}\fi +\ifx\putwordDefvar\undefined \gdef\putwordDefvar{Variable}\fi +\ifx\putwordDefopt\undefined \gdef\putwordDefopt{User Option}\fi +\ifx\putwordDeftypevar\undefined\gdef\putwordDeftypevar{Variable}\fi +\ifx\putwordDeffunc\undefined \gdef\putwordDeffunc{Function}\fi +\ifx\putwordDeftypefun\undefined\gdef\putwordDeftypefun{Function}\fi % Ignore a token. % @@ -101,89 +142,130 @@ \hyphenation{ap-pen-dix} \hyphenation{mini-buf-fer mini-buf-fers} \hyphenation{eshell} +\hyphenation{white-space} % Margin to add to right of even pages, to left of odd pages. -\newdimen \bindingoffset \bindingoffset=0pt -\newdimen \normaloffset \normaloffset=\hoffset +\newdimen \bindingoffset +\newdimen \normaloffset \newdimen\pagewidth \newdimen\pageheight -\pagewidth=\hsize \pageheight=\vsize % Sometimes it is convenient to have everything in the transcript file % and nothing on the terminal. We don't just call \tracingall here, % since that produces some useless output on the terminal. % \def\gloggingall{\begingroup \globaldefs = 1 \loggingall \endgroup}% +\ifx\eTeXversion\undefined \def\loggingall{\tracingcommands2 \tracingstats2 \tracingpages1 \tracingoutput1 \tracinglostchars1 \tracingmacros2 \tracingparagraphs1 \tracingrestores1 \showboxbreadth\maxdimen\showboxdepth\maxdimen }% +\else +\def\loggingall{\tracingcommands3 \tracingstats2 + \tracingpages1 \tracingoutput1 \tracinglostchars1 + \tracingmacros2 \tracingparagraphs1 \tracingrestores1 + \tracingscantokens1 \tracingassigns1 \tracingifs1 + \tracinggroups1 \tracingnesting2 + \showboxbreadth\maxdimen\showboxdepth\maxdimen +}% +\fi -%---------------------Begin change----------------------- +% For @cropmarks command. +% Do @cropmarks to get crop marks. % -%%%% For @cropmarks command. -% Dimensions to add cropmarks at corners Added by P. A. MacKay, 12 Nov. 1986 +\newif\ifcropmarks +\let\cropmarks = \cropmarkstrue % -\newdimen\cornerlong \newdimen\cornerthick -\newdimen \topandbottommargin -\newdimen \outerhsize \newdimen \outervsize -\cornerlong=1pc\cornerthick=.3pt % These set size of cropmarks -\outerhsize=7in -%\outervsize=9.5in -% Alternative @smallbook page size is 9.25in -\outervsize=9.25in -\topandbottommargin=.75in +% Dimensions to add cropmarks at corners. +% Added by P. A. MacKay, 12 Nov. 1986 % -%---------------------End change----------------------- +\newdimen\outerhsize \newdimen\outervsize % set by the paper size routines +\newdimen\cornerlong \cornerlong=1pc +\newdimen\cornerthick \cornerthick=.3pt +\newdimen\topandbottommargin \topandbottommargin=.75in + +% Main output routine. +\chardef\PAGE = 255 +\output = {\onepageout{\pagecontents\PAGE}} + +\newbox\headlinebox +\newbox\footlinebox % \onepageout takes a vbox as an argument. Note that \pagecontents -% does insertions itself, but you have to call it yourself. -\chardef\PAGE=255 \output={\onepageout{\pagecontents\PAGE}} -\def\onepageout#1{\hoffset=\normaloffset -\ifodd\pageno \advance\hoffset by \bindingoffset -\else \advance\hoffset by -\bindingoffset\fi -{\escapechar=`\\\relax % makes sure backslash is used in output files. -\shipout\vbox{{\let\hsize=\pagewidth \makeheadline} \pagebody{#1}% -{\let\hsize=\pagewidth \makefootline}}}% -\advancepageno \ifnum\outputpenalty>-20000 \else\dosupereject\fi} - -%%%% For @cropmarks command %%%% - -% Here is a modification of the main output routine for Near East Publications -% This provides right-angle cropmarks at all four corners. -% The contents of the page are centerlined into the cropmarks, -% and any desired binding offset is added as an \hskip on either -% site of the centerlined box. (P. A. MacKay, 12 November, 1986) -% -\def\croppageout#1{\hoffset=0pt % make sure this doesn't mess things up -{\escapechar=`\\\relax % makes sure backslash is used in output files. - \shipout - \vbox to \outervsize{\hsize=\outerhsize - \vbox{\line{\ewtop\hfill\ewtop}} - \nointerlineskip - \line{\vbox{\moveleft\cornerthick\nstop} - \hfill - \vbox{\moveright\cornerthick\nstop}} - \vskip \topandbottommargin - \centerline{\ifodd\pageno\hskip\bindingoffset\fi - \vbox{ - {\let\hsize=\pagewidth \makeheadline} - \pagebody{#1} - {\let\hsize=\pagewidth \makefootline}} - \ifodd\pageno\else\hskip\bindingoffset\fi} - \vskip \topandbottommargin plus1fill minus1fill - \boxmaxdepth\cornerthick - \line{\vbox{\moveleft\cornerthick\nsbot} - \hfill - \vbox{\moveright\cornerthick\nsbot}} - \nointerlineskip - \vbox{\line{\ewbot\hfill\ewbot}} - }} +% does insertions, but you have to call it yourself. +\def\onepageout#1{% + \ifcropmarks \hoffset=0pt \else \hoffset=\normaloffset \fi + % + \ifodd\pageno \advance\hoffset by \bindingoffset + \else \advance\hoffset by -\bindingoffset\fi + % + % Do this outside of the \shipout so @code etc. will be expanded in + % the headline as they should be, not taken literally (outputting ''code). + \setbox\headlinebox = \vbox{\let\hsize=\pagewidth \makeheadline}% + \setbox\footlinebox = \vbox{\let\hsize=\pagewidth \makefootline}% + % + {% + % Have to do this stuff outside the \shipout because we want it to + % take effect in \write's, yet the group defined by the \vbox ends + % before the \shipout runs. + % + \escapechar = `\\ % use backslash in output files. + \indexdummies % don't expand commands in the output. + \normalturnoffactive % \ in index entries must not stay \, e.g., if + % the page break happens to be in the middle of an example. + \shipout\vbox{% + \ifcropmarks \vbox to \outervsize\bgroup + \hsize = \outerhsize + \vskip-\topandbottommargin + \vtop to0pt{% + \line{\ewtop\hfil\ewtop}% + \nointerlineskip + \line{% + \vbox{\moveleft\cornerthick\nstop}% + \hfill + \vbox{\moveright\cornerthick\nstop}% + }% + \vss}% + \vskip\topandbottommargin + \line\bgroup + \hfil % center the page within the outer (page) hsize. + \ifodd\pageno\hskip\bindingoffset\fi + \vbox\bgroup + \fi + % + \unvbox\headlinebox + \pagebody{#1}% + \ifdim\ht\footlinebox > 0pt + % Only leave this space if the footline is nonempty. + % (We lessened \vsize for it in \oddfootingxxx.) + % The \baselineskip=24pt in plain's \makefootline has no effect. + \vskip 2\baselineskip + \unvbox\footlinebox + \fi + % + \ifpdfmakepagedest \pdfmkdest{\the\pageno} \fi + % + \ifcropmarks + \egroup % end of \vbox\bgroup + \hfil\egroup % end of (centering) \line\bgroup + \vskip\topandbottommargin plus1fill minus1fill + \boxmaxdepth = \cornerthick + \vbox to0pt{\vss + \line{% + \vbox{\moveleft\cornerthick\nsbot}% + \hfill + \vbox{\moveright\cornerthick\nsbot}% + }% + \nointerlineskip + \line{\ewbot\hfil\ewbot}% + }% + \egroup % \vbox from first cropmarks clause + \fi + }% end of \shipout\vbox + }% end of group with \turnoffactive \advancepageno - \ifnum\outputpenalty>-20000 \else\dosupereject\fi} -% -% Do @cropmarks to get crop marks -\def\cropmarks{\let\onepageout=\croppageout } + \ifnum\outputpenalty>-20000 \else\dosupereject\fi +} \newinsert\margin \dimen\margin=\maxdimen @@ -198,7 +280,6 @@ \ifr@ggedbottom \kern-\dimen@ \vfil \fi} } -% % Here are the rules for the cropmarks. Note that they are % offset so that the space between them is truly \outerhsize or \outervsize % (P. A. MacKay, 12 November, 1986) @@ -293,11 +374,11 @@ %% Call \inENV within environments (after a \begingroup) \newif\ifENV \ENVfalse \def\inENV{\ifENV\relax\else\ENVtrue\fi} \def\ENVcheck{% -\ifENV\errmessage{Still within an environment. Type Return to continue.} +\ifENV\errmessage{Still within an environment; press RETURN to continue} \endgroup\fi} % This is not perfect, but it should reduce lossage % @begin foo is the same as @foo, for now. -\newhelp\EMsimple{Type to continue.} +\newhelp\EMsimple{Press RETURN to continue.} \outer\def\begin{\parsearg\beginxxx} @@ -356,7 +437,7 @@ % @@ prints an @ % Kludge this until the fonts are right (grr). -\def\@{{\tt \char '100}} +\def\@{{\tt\char64}} % This is turned off because it was never documented % and you can use @w{...} around a quote to suppress ligatures. @@ -366,11 +447,55 @@ %\def\'{{'}} % Used to generate quoted braces. - -\def\mylbrace {{\tt \char '173}} -\def\myrbrace {{\tt \char '175}} +\def\mylbrace {{\tt\char123}} +\def\myrbrace {{\tt\char125}} \let\{=\mylbrace \let\}=\myrbrace +\begingroup + % Definitions to produce actual \{ & \} command in an index. + \catcode`\{ = 12 \catcode`\} = 12 + \catcode`\[ = 1 \catcode`\] = 2 + \catcode`\@ = 0 \catcode`\\ = 12 + @gdef@lbracecmd[\{]% + @gdef@rbracecmd[\}]% +@endgroup + +% Accents: @, @dotaccent @ringaccent @ubaraccent @udotaccent +% Others are defined by plain TeX: @` @' @" @^ @~ @= @v @H. +\let\, = \c +\let\dotaccent = \. +\def\ringaccent#1{{\accent23 #1}} +\let\tieaccent = \t +\let\ubaraccent = \b +\let\udotaccent = \d + +% Other special characters: @questiondown @exclamdown +% Plain TeX defines: @AA @AE @O @OE @L (and lowercase versions) @ss. +\def\questiondown{?`} +\def\exclamdown{!`} + +% Dotless i and dotless j, used for accents. +\def\imacro{i} +\def\jmacro{j} +\def\dotless#1{% + \def\temp{#1}% + \ifx\temp\imacro \ptexi + \else\ifx\temp\jmacro \j + \else \errmessage{@dotless can be used only with i or j}% + \fi\fi +} + +% Be sure we're in horizontal mode when doing a tie, since we make space +% equivalent to this in @example-like environments. Otherwise, a space +% at the beginning of a line will start with \penalty -- and +% since \penalty is valid in vertical mode, we'd end up putting the +% penalty on the vertical list instead of in the new paragraph. +{\catcode`@ = 11 + % Avoid using \@M directly, because that causes trouble + % if the definition is written into an index file. + \global\let\tiepenalty = \@M + \gdef\tie{\leavevmode\penalty\tiepenalty\ } +} % @: forces normal size whitespace following. \def\:{\spacefactor=1000 } @@ -381,14 +506,11 @@ % @. is an end-of-sentence period. \def\.{.\spacefactor=3000 } -% @enddots{} is an end-of-sentence ellipsis. -\gdef\enddots{$\mathinner{\ldotp\ldotp\ldotp\ldotp}$\spacefactor=3000} - % @! is an end-of-sentence bang. -\gdef\!{!\spacefactor=3000 } +\def\!{!\spacefactor=3000 } % @? is an end-of-sentence query. -\gdef\?{?\spacefactor=3000 } +\def\?{?\spacefactor=3000 } % @w prevents a word break. Without the \leavevmode, @w at the % beginning of a paragraph, when TeX is still in vertical mode, would @@ -472,53 +594,81 @@ where each line of input produces a line of output.} %% This method tries to make TeX break the page naturally %% if the depth of the box does not fit. %{\baselineskip=0pt% -%\vtop to #1\mil{\vfil}\kern -#1\mil\penalty 10000 +%\vtop to #1\mil{\vfil}\kern -#1\mil\nobreak %\prevdepth=-1000pt %}} \def\needx#1{% - % Go into vertical mode, so we don't make a big box in the middle of a + % Ensure vertical mode, so we don't make a big box in the middle of a % paragraph. \par % - % Don't add any leading before our big empty box, but allow a page - % break, since the best break might be right here. - \allowbreak - \nointerlineskip - \vtop to #1\mil{\vfil}% - % - % TeX does not even consider page breaks if a penalty added to the - % main vertical list is 10000 or more. But in order to see if the - % empty box we just added fits on the page, we must make it consider - % page breaks. On the other hand, we don't want to actually break the - % page after the empty box. So we use a penalty of 9999. - % - % There is an extremely small chance that TeX will actually break the - % page at this \penalty, if there are no other feasible breakpoints in - % sight. (If the user is using lots of big @group commands, which - % almost-but-not-quite fill up a page, TeX will have a hard time doing - % good page breaking, for example.) However, I could not construct an - % example where a page broke at this \penalty; if it happens in a real - % document, then we can reconsider our strategy. - \penalty9999 - % - % Back up by the size of the box, whether we did a page break or not. - \kern -#1\mil - % - % Do not allow a page break right after this kern. - \nobreak + % If the @need value is less than one line space, it's useless. + \dimen0 = #1\mil + \dimen2 = \ht\strutbox + \advance\dimen2 by \dp\strutbox + \ifdim\dimen0 > \dimen2 + % + % Do a \strut just to make the height of this box be normal, so the + % normal leading is inserted relative to the preceding line. + % And a page break here is fine. + \vtop to #1\mil{\strut\vfil}% + % + % TeX does not even consider page breaks if a penalty added to the + % main vertical list is 10000 or more. But in order to see if the + % empty box we just added fits on the page, we must make it consider + % page breaks. On the other hand, we don't want to actually break the + % page after the empty box. So we use a penalty of 9999. + % + % There is an extremely small chance that TeX will actually break the + % page at this \penalty, if there are no other feasible breakpoints in + % sight. (If the user is using lots of big @group commands, which + % almost-but-not-quite fill up a page, TeX will have a hard time doing + % good page breaking, for example.) However, I could not construct an + % example where a page broke at this \penalty; if it happens in a real + % document, then we can reconsider our strategy. + \penalty9999 + % + % Back up by the size of the box, whether we did a page break or not. + \kern -#1\mil + % + % Do not allow a page break right after this kern. + \nobreak + \fi } % @br forces paragraph break \let\br = \par -% @dots{} output some dots +% @dots{} output an ellipsis using the current font. +% We do .5em per period so that it has the same spacing in a typewriter +% font as three actual period characters. +% +\def\dots{% + \leavevmode + \hbox to 1.5em{% + \hskip 0pt plus 0.25fil minus 0.25fil + .\hss.\hss.% + \hskip 0pt plus 0.5fil minus 0.5fil + }% +} + +% @enddots{} is an end-of-sentence ellipsis. +% +\def\enddots{% + \leavevmode + \hbox to 2em{% + \hskip 0pt plus 0.25fil minus 0.25fil + .\hss.\hss.\hss.% + \hskip 0pt plus 0.5fil minus 0.5fil + }% + \spacefactor=3000 +} -\def\dots{$\ldots$} % @page forces the start of a new page - +% \def\page{\par\vfill\supereject} % @exdent text.... @@ -579,391 +729,301 @@ where each line of input produces a line of output.} % @sp n outputs n lines of vertical space \def\sp{\parsearg\spxxx} -\def\spxxx #1{\par \vskip #1\baselineskip} +\def\spxxx #1{\vskip #1\baselineskip} % @comment ...line which is ignored... % @c is the same as @comment % @ignore ... @end ignore is another way to write a comment -\def\comment{\catcode 64=\other \catcode 123=\other \catcode 125=\other% -\parsearg \commentxxx} - -\def\commentxxx #1{\catcode 64=0 \catcode 123=1 \catcode 125=2 } +\def\comment{\begingroup \catcode`\^^M=\other% +\catcode`\@=\other \catcode`\{=\other \catcode`\}=\other% +\commentxxx} +{\catcode`\^^M=\other \gdef\commentxxx#1^^M{\endgroup}} \let\c=\comment -% Prevent errors for section commands. -% Used in @ignore and in failing conditionals. -\def\ignoresections{% -\let\chapter=\relax -\let\unnumbered=\relax -\let\top=\relax -\let\unnumberedsec=\relax -\let\unnumberedsection=\relax -\let\unnumberedsubsec=\relax -\let\unnumberedsubsection=\relax -\let\unnumberedsubsubsec=\relax -\let\unnumberedsubsubsection=\relax -\let\section=\relax -\let\subsec=\relax -\let\subsubsec=\relax -\let\subsection=\relax -\let\subsubsection=\relax -\let\appendix=\relax -\let\appendixsec=\relax -\let\appendixsection=\relax -\let\appendixsubsec=\relax -\let\appendixsubsection=\relax -\let\appendixsubsubsec=\relax -\let\appendixsubsubsection=\relax -\let\contents=\relax -\let\smallbook=\relax -\let\titlepage=\relax +% @paragraphindent NCHARS +% We'll use ems for NCHARS, close enough. +% We cannot implement @paragraphindent asis, though. +% +\def\asisword{asis} % no translation, these are keywords +\def\noneword{none} +% +\def\paragraphindent{\parsearg\doparagraphindent} +\def\doparagraphindent#1{% + \def\temp{#1}% + \ifx\temp\asisword + \else + \ifx\temp\noneword + \defaultparindent = 0pt + \else + \defaultparindent = #1em + \fi + \fi + \parindent = \defaultparindent } -% Used in nested conditionals, where we have to parse the Texinfo source -% and so want to turn off most commands, in case they are used -% incorrectly. -% -\def\ignoremorecommands{% - \let\defcv = \relax - \let\deffn = \relax - \let\deffnx = \relax - \let\defindex = \relax - \let\defivar = \relax - \let\defmac = \relax - \let\defmethod = \relax - \let\defop = \relax - \let\defopt = \relax - \let\defspec = \relax - \let\deftp = \relax - \let\deftypefn = \relax - \let\deftypefun = \relax - \let\deftypevar = \relax - \let\deftypevr = \relax - \let\defun = \relax - \let\defvar = \relax - \let\defvr = \relax - \let\ref = \relax - \let\xref = \relax - \let\printindex = \relax - \let\pxref = \relax - \let\settitle = \relax - \let\setchapternewpage = \relax - \let\setchapterstyle = \relax - \let\everyheading = \relax - \let\evenheading = \relax - \let\oddheading = \relax - \let\everyfooting = \relax - \let\evenfooting = \relax - \let\oddfooting = \relax - \let\headings = \relax - \let\include = \relax - \let\lowersections = \relax - \let\down = \relax - \let\raisesections = \relax - \let\up = \relax - \let\set = \relax - \let\clear = \relax - \let\item = \relax - \let\message = \relax +% @exampleindent NCHARS +% We'll use ems for NCHARS like @paragraphindent. +% It seems @exampleindent asis isn't necessary, but +% I preserve it to make it similar to @paragraphindent. +\def\exampleindent{\parsearg\doexampleindent} +\def\doexampleindent#1{% + \def\temp{#1}% + \ifx\temp\asisword + \else + \ifx\temp\noneword + \lispnarrowing = 0pt + \else + \lispnarrowing = #1em + \fi + \fi } -% Ignore @ignore ... @end ignore. +% @asis just yields its argument. Used with @table, for example. % -\def\ignore{\doignore{ignore}} +\def\asis#1{#1} -% Also ignore @ifinfo, @ifhtml, @html, @menu, and @direntry text. +% @math means output in math mode. +% We don't use $'s directly in the definition of \math because control +% sequences like \math are expanded when the toc file is written. Then, +% we read the toc file back, the $'s will be normal characters (as they +% should be, according to the definition of Texinfo). So we must use a +% control sequence to switch into and out of math mode. % -\def\ifinfo{\doignore{ifinfo}} -\def\ifhtml{\doignore{ifhtml}} -\def\html{\doignore{html}} -\def\menu{\doignore{menu}} -\def\direntry{\doignore{direntry}} +% This isn't quite enough for @math to work properly in indices, but it +% seems unlikely it will ever be needed there. +% +\let\implicitmath = $ +\def\math#1{\implicitmath #1\implicitmath} -% @dircategory CATEGORY -- specify a category of the dir file -% which this file should belong to. Ignore this in TeX. +% @bullet and @minus need the same treatment as @math, just above. +\def\bullet{\implicitmath\ptexbullet\implicitmath} +\def\minus{\implicitmath-\implicitmath} -\def\dircategory{\comment} +% @refill is a no-op. +\let\refill=\relax -% Ignore text until a line `@end #1'. +% If working on a large document in chapters, it is convenient to +% be able to disable indexing, cross-referencing, and contents, for test runs. +% This is done with @novalidate (before @setfilename). % -\def\doignore#1{\begingroup - % Don't complain about control sequences we have declared \outer. - \ignoresections - % - % Define a command to swallow text until we reach `@end #1'. - \long\def\doignoretext##1\end #1{\enddoignore}% - % - % Make sure that spaces turn into tokens that match what \doignoretext wants. - \catcode32 = 10 - % - % And now expand that command. - \doignoretext +\newif\iflinks \linkstrue % by default we want the aux files. +\let\novalidate = \linksfalse + +% @setfilename is done at the beginning of every texinfo file. +% So open here the files we need to have open while reading the input. +% This makes it possible to make a .fmt file for texinfo. +\def\setfilename{% + \iflinks + \readauxfile + \fi % \openindices needs to do some work in any case. + \openindices + \fixbackslash % Turn off hack to swallow `\input texinfo'. + \global\let\setfilename=\comment % Ignore extra @setfilename cmds. + % + % If texinfo.cnf is present on the system, read it. + % Useful for site-wide @afourpaper, etc. + % Just to be on the safe side, close the input stream before the \input. + \openin 1 texinfo.cnf + \ifeof1 \let\temp=\relax \else \def\temp{\input texinfo.cnf }\fi + \closein1 + \temp + % + \comment % Ignore the actual filename. } -% What we do to finish off ignored text. +% Called from \setfilename. % -\def\enddoignore{\endgroup\ignorespaces}% - -\newif\ifwarnedobs\warnedobsfalse -\def\obstexwarn{% - \ifwarnedobs\relax\else - % We need to warn folks that they may have trouble with TeX 3.0. - % This uses \immediate\write16 rather than \message to get newlines. - \immediate\write16{} - \immediate\write16{***WARNING*** for users of Unix TeX 3.0!} - \immediate\write16{This manual trips a bug in TeX version 3.0 (tex hangs).} - \immediate\write16{If you are running another version of TeX, relax.} - \immediate\write16{If you are running Unix TeX 3.0, kill this TeX process.} - \immediate\write16{ Then upgrade your TeX installation if you can.} - \immediate\write16{If you are stuck with version 3.0, run the} - \immediate\write16{ script ``tex3patch'' from the Texinfo distribution} - \immediate\write16{ to use a workaround.} - \immediate\write16{} - \global\warnedobstrue - \fi +\def\openindices{% + \newindex{cp}% + \newcodeindex{fn}% + \newcodeindex{vr}% + \newcodeindex{tp}% + \newcodeindex{ky}% + \newcodeindex{pg}% } -% **In TeX 3.0, setting text in \nullfont hangs tex. For a -% workaround (which requires the file ``dummy.tfm'' to be installed), -% uncomment the following line: -%%%%%\font\nullfont=dummy\let\obstexwarn=\relax +% @bye. +\outer\def\bye{\pagealignmacro\tracingstats=1\ptexend} -% Ignore text, except that we keep track of conditional commands for -% purposes of nesting, up to an `@end #1' command. -% -\def\nestedignore#1{% - \obstexwarn - % We must actually expand the ignored text to look for the @end - % command, so that nested ignore constructs work. Thus, we put the - % text into a \vbox and then do nothing with the result. To minimize - % the change of memory overflow, we follow the approach outlined on - % page 401 of the TeXbook: make the current font be a dummy font. - % - \setbox0 = \vbox\bgroup - % Don't complain about control sequences we have declared \outer. - \ignoresections - % - % Define `@end #1' to end the box, which will in turn undefine the - % @end command again. - \expandafter\def\csname E#1\endcsname{\egroup\ignorespaces}% - % - % We are going to be parsing Texinfo commands. Most cause no - % trouble when they are used incorrectly, but some commands do - % complicated argument parsing or otherwise get confused, so we - % undefine them. - % - % We can't do anything about stray @-signs, unfortunately; - % they'll produce `undefined control sequence' errors. - \ignoremorecommands - % - % Set the current font to be \nullfont, a TeX primitive, and define - % all the font commands to also use \nullfont. We don't use - % dummy.tfm, as suggested in the TeXbook, because not all sites - % might have that installed. Therefore, math mode will still - % produce output, but that should be an extremely small amount of - % stuff compared to the main input. - % - \nullfont - \let\tenrm = \nullfont \let\tenit = \nullfont \let\tensl = \nullfont - \let\tenbf = \nullfont \let\tentt = \nullfont \let\smallcaps = \nullfont - \let\tensf = \nullfont - % Similarly for index fonts (mostly for their use in - % smallexample) - \let\indrm = \nullfont \let\indit = \nullfont \let\indsl = \nullfont - \let\indbf = \nullfont \let\indtt = \nullfont \let\indsc = \nullfont - \let\indsf = \nullfont - % - % Don't complain when characters are missing from the fonts. - \tracinglostchars = 0 - % - % Don't bother to do space factor calculations. - \frenchspacing - % - % Don't report underfull hboxes. - \hbadness = 10000 - % - % Do minimal line-breaking. - \pretolerance = 10000 - % - % Do not execute instructions in @tex - \def\tex{\doignore{tex}} -} - -% @set VAR sets the variable VAR to an empty value. -% @set VAR REST-OF-LINE sets VAR to the value REST-OF-LINE. -% -% Since we want to separate VAR from REST-OF-LINE (which might be -% empty), we can't just use \parsearg; we have to insert a space of our -% own to delimit the rest of the line, and then take it out again if we -% didn't need it. Make sure the catcode of space is correct to avoid -% losing inside @example, for instance. -% -\def\set{\begingroup\catcode` =10 \parsearg\setxxx} -\def\setxxx#1{\setyyy#1 \endsetyyy} -\def\setyyy#1 #2\endsetyyy{% - \def\temp{#2}% - \ifx\temp\empty \global\expandafter\let\csname SET#1\endcsname = \empty - \else \setzzz{#1}#2\endsetzzz % Remove the trailing space \setxxx inserted. - \fi - \endgroup -} -% Can't use \xdef to pre-expand #2 and save some time, since \temp or -% \next or other control sequences that we've defined might get us into -% an infinite loop. Consider `@set foo @cite{bar}'. -\def\setzzz#1#2 \endsetzzz{\expandafter\gdef\csname SET#1\endcsname{#2}} - -% @clear VAR clears (i.e., unsets) the variable VAR. -% -\def\clear{\parsearg\clearxxx} -\def\clearxxx#1{\global\expandafter\let\csname SET#1\endcsname=\relax} - -% @value{foo} gets the text saved in variable foo. -% -\def\value#1{\expandafter - \ifx\csname SET#1\endcsname\relax - {\{No value for ``#1''\}} - \else \csname SET#1\endcsname \fi} - -% @ifset VAR ... @end ifset reads the `...' iff VAR has been defined -% with @set. -% -\def\ifset{\parsearg\ifsetxxx} -\def\ifsetxxx #1{% - \expandafter\ifx\csname SET#1\endcsname\relax - \expandafter\ifsetfail - \else - \expandafter\ifsetsucceed - \fi -} -\def\ifsetsucceed{\conditionalsucceed{ifset}} -\def\ifsetfail{\nestedignore{ifset}} -\defineunmatchedend{ifset} -% @ifclear VAR ... @end ifclear reads the `...' iff VAR has never been -% defined with @set, or has been undefined with @clear. -% -\def\ifclear{\parsearg\ifclearxxx} -\def\ifclearxxx #1{% - \expandafter\ifx\csname SET#1\endcsname\relax - \expandafter\ifclearsucceed +\message{pdf,} +% adobe `portable' document format +\newcount\tempnum +\newcount\lnkcount +\newtoks\filename +\newcount\filenamelength +\newcount\pgn +\newtoks\toksA +\newtoks\toksB +\newtoks\toksC +\newtoks\toksD +\newbox\boxA +\newcount\countA +\newif\ifpdf +\newif\ifpdfmakepagedest + +\ifx\pdfoutput\undefined + \pdffalse + \let\pdfmkdest = \gobble + \let\pdfurl = \gobble + \let\endlink = \relax + \let\linkcolor = \relax + \let\pdfmakeoutlines = \relax +\else + \pdftrue + \pdfoutput = 1 + \input pdfcolor + \def\dopdfimage#1#2#3{% + \def\imagewidth{#2}% + \def\imageheight{#3}% + \ifnum\pdftexversion < 14 + \pdfimage + \else + \pdfximage + \fi + \ifx\empty\imagewidth\else width \imagewidth \fi + \ifx\empty\imageheight\else height \imageheight \fi + {#1.pdf}% + \ifnum\pdftexversion < 14 \else + \pdfrefximage \pdflastximage + \fi} + \def\pdfmkdest#1{\pdfdest name{#1@} xyz} + \def\pdfmkpgn#1{#1@} + \let\linkcolor = \Cyan + \def\endlink{\Black\pdfendlink} + % Adding outlines to PDF; macros for calculating structure of outlines + % come from Petr Olsak + \def\expnumber#1{\expandafter\ifx\csname#1\endcsname\relax 0% + \else \csname#1\endcsname \fi} + \def\advancenumber#1{\tempnum=\expnumber{#1}\relax + \advance\tempnum by1 + \expandafter\xdef\csname#1\endcsname{\the\tempnum}} + \def\pdfmakeoutlines{{% + \openin 1 \jobname.toc + \ifeof 1\else\bgroup + \closein 1 + \indexnofonts + \def\tt{} + % thanh's hack / proper braces in bookmarks + \edef\mylbrace{\iftrue \string{\else}\fi}\let\{=\mylbrace + \edef\myrbrace{\iffalse{\else\string}\fi}\let\}=\myrbrace + % + \def\chapentry ##1##2##3{} + \def\unnumbchapentry ##1##2{} + \def\secentry ##1##2##3##4{\advancenumber{chap##2}} + \def\unnumbsecentry ##1##2{} + \def\subsecentry ##1##2##3##4##5{\advancenumber{sec##2.##3}} + \def\unnumbsubsecentry ##1##2{} + \def\subsubsecentry ##1##2##3##4##5##6{\advancenumber{subsec##2.##3.##4}} + \def\unnumbsubsubsecentry ##1##2{} + \input \jobname.toc + \def\chapentry ##1##2##3{% + \pdfoutline goto name{\pdfmkpgn{##3}}count-\expnumber{chap##2}{##1}} + \def\unnumbchapentry ##1##2{% + \pdfoutline goto name{\pdfmkpgn{##2}}{##1}} + \def\secentry ##1##2##3##4{% + \pdfoutline goto name{\pdfmkpgn{##4}}count-\expnumber{sec##2.##3}{##1}} + \def\unnumbsecentry ##1##2{% + \pdfoutline goto name{\pdfmkpgn{##2}}{##1}} + \def\subsecentry ##1##2##3##4##5{% + \pdfoutline goto name{\pdfmkpgn{##5}}count-\expnumber{subsec##2.##3.##4}{##1}} + \def\unnumbsubsecentry ##1##2{% + \pdfoutline goto name{\pdfmkpgn{##2}}{##1}} + \def\subsubsecentry ##1##2##3##4##5##6{% + \pdfoutline goto name{\pdfmkpgn{##6}}{##1}} + \def\unnumbsubsubsecentry ##1##2{% + \pdfoutline goto name{\pdfmkpgn{##2}}{##1}} + \input \jobname.toc + \egroup\fi + }} + \def\makelinks #1,{% + \def\params{#1}\def\E{END}% + \ifx\params\E + \let\nextmakelinks=\relax + \else + \let\nextmakelinks=\makelinks + \ifnum\lnkcount>0,\fi + \picknum{#1}% + \startlink attr{/Border [0 0 0]} + goto name{\pdfmkpgn{\the\pgn}}% + \linkcolor #1% + \advance\lnkcount by 1% + \endlink + \fi + \nextmakelinks + } + \def\picknum#1{\expandafter\pn#1} + \def\pn#1{% + \def\p{#1}% + \ifx\p\lbrace + \let\nextpn=\ppn + \else + \let\nextpn=\ppnn + \def\first{#1} + \fi + \nextpn + } + \def\ppn#1{\pgn=#1\gobble} + \def\ppnn{\pgn=\first} + \def\pdfmklnk#1{\lnkcount=0\makelinks #1,END,} + \def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks} + \def\skipspaces#1{\def\PP{#1}\def\D{|}% + \ifx\PP\D\let\nextsp\relax + \else\let\nextsp\skipspaces + \ifx\p\space\else\addtokens{\filename}{\PP}% + \advance\filenamelength by 1 + \fi + \fi + \nextsp} + \def\getfilename#1{\filenamelength=0\expandafter\skipspaces#1|\relax} + \ifnum\pdftexversion < 14 + \let \startlink \pdfannotlink \else - \expandafter\ifclearfail + \let \startlink \pdfstartlink \fi -} -\def\ifclearsucceed{\conditionalsucceed{ifclear}} -\def\ifclearfail{\nestedignore{ifclear}} -\defineunmatchedend{ifclear} - -% @iftex always succeeds; we read the text following, through @end -% iftex). But `@end iftex' should be valid only after an @iftex. -% -\def\iftex{\conditionalsucceed{iftex}} -\defineunmatchedend{iftex} - -% We can't just want to start a group at @iftex (for example) and end it -% at @end iftex, since then @set commands inside the conditional have no -% effect (they'd get reverted at the end of the group). So we must -% define \Eiftex to redefine itself to be its previous value. (We can't -% just define it to fail again with an ``unmatched end'' error, since -% the @ifset might be nested.) -% -\def\conditionalsucceed#1{% - \edef\temp{% - % Remember the current value of \E#1. - \let\nece{prevE#1} = \nece{E#1}% - % - % At the `@end #1', redefine \E#1 to be its previous value. - \def\nece{E#1}{\let\nece{E#1} = \nece{prevE#1}}% - }% - \temp -} - -% We need to expand lots of \csname's, but we don't want to expand the -% control sequences after we've constructed them. -% -\def\nece#1{\expandafter\noexpand\csname#1\endcsname} - -% @asis just yields its argument. Used with @table, for example. -% -\def\asis#1{#1} - -% @math means output in math mode. -% We don't use $'s directly in the definition of \math because control -% sequences like \math are expanded when the toc file is written. Then, -% we read the toc file back, the $'s will be normal characters (as they -% should be, according to the definition of Texinfo). So we must use a -% control sequence to switch into and out of math mode. -% -% This isn't quite enough for @math to work properly in indices, but it -% seems unlikely it will ever be needed there. -% -\let\implicitmath = $ -\def\math#1{\implicitmath #1\implicitmath} - -% @bullet and @minus need the same treatment as @math, just above. -\def\bullet{\implicitmath\ptexbullet\implicitmath} -\def\minus{\implicitmath-\implicitmath} - -\def\node{\ENVcheck\parsearg\nodezzz} -\def\nodezzz#1{\nodexxx [#1,]} -\def\nodexxx[#1,#2]{\gdef\lastnode{#1}} -\let\nwnode=\node -\let\lastnode=\relax - -\def\donoderef{\ifx\lastnode\relax\else -\expandafter\expandafter\expandafter\setref{\lastnode}\fi -\global\let\lastnode=\relax} - -\def\unnumbnoderef{\ifx\lastnode\relax\else -\expandafter\expandafter\expandafter\unnumbsetref{\lastnode}\fi -\global\let\lastnode=\relax} - -\def\appendixnoderef{\ifx\lastnode\relax\else -\expandafter\expandafter\expandafter\appendixsetref{\lastnode}\fi -\global\let\lastnode=\relax} - -\let\refill=\relax - -% @setfilename is done at the beginning of every texinfo file. -% So open here the files we need to have open while reading the input. -% This makes it possible to make a .fmt file for texinfo. -\def\setfilename{% - \readauxfile - \opencontents - \openindices - \fixbackslash % Turn off hack to swallow `\input texinfo'. - \global\let\setfilename=\comment % Ignore extra @setfilename cmds. - \comment % Ignore the actual filename. -} - -\outer\def\bye{\pagealignmacro\tracingstats=1\ptexend} - -\def\inforef #1{\inforefzzz #1,,,,**} -\def\inforefzzz #1,#2,#3,#4**{\putwordSee{} \putwordInfo{} \putwordfile{} \file{\ignorespaces #3{}}, - node \samp{\ignorespaces#1{}}} - -\def\macro#1{\begingroup\ignoresections\catcode`\#=6\def\macrotemp{#1}\parsearg\macroxxx} -\def\macroxxx#1#2 \end macro{% -\expandafter\gdef\macrotemp#1{#2}% -\endgroup} - -%\def\linemacro#1{\begingroup\ignoresections\catcode`\#=6\def\macrotemp{#1}\parsearg\linemacroxxx} -%\def\linemacroxxx#1#2 \end linemacro{% -%\let\parsearg=\relax -%\edef\macrotempx{\csname M\butfirst\expandafter\string\macrotemp\endcsname}% -%\expandafter\xdef\macrotemp{\parsearg\macrotempx}% -%\expandafter\gdef\macrotempx#1{#2}% -%\endgroup} + \def\pdfurl#1{% + \begingroup + \normalturnoffactive\def\@{@}% + \leavevmode\Red + \startlink attr{/Border [0 0 0]}% + user{/Subtype /Link /A << /S /URI /URI (#1) >>}% + % #1 + \endgroup} + \def\pdfgettoks#1.{\setbox\boxA=\hbox{\toksA={#1.}\toksB={}\maketoks}} + \def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks} + \def\adn#1{\addtokens{\toksC}{#1}\global\countA=1\let\next=\maketoks} + \def\poptoks#1#2|ENDTOKS|{\let\first=#1\toksD={#1}\toksA={#2}} + \def\maketoks{% + \expandafter\poptoks\the\toksA|ENDTOKS| + \ifx\first0\adn0 + \else\ifx\first1\adn1 \else\ifx\first2\adn2 \else\ifx\first3\adn3 + \else\ifx\first4\adn4 \else\ifx\first5\adn5 \else\ifx\first6\adn6 + \else\ifx\first7\adn7 \else\ifx\first8\adn8 \else\ifx\first9\adn9 + \else + \ifnum0=\countA\else\makelink\fi + \ifx\first.\let\next=\done\else + \let\next=\maketoks + \addtokens{\toksB}{\the\toksD} + \ifx\first,\addtokens{\toksB}{\space}\fi + \fi + \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi + \next} + \def\makelink{\addtokens{\toksB}% + {\noexpand\pdflink{\the\toksC}}\toksC={}\global\countA=0} + \def\pdflink#1{% + \startlink attr{/Border [0 0 0]} goto name{\mkpgn{#1}} + \linkcolor #1\endlink} + \def\mkpgn#1{#1@} + \def\done{\edef\st{\global\noexpand\toksA={\the\toksB}}\st} +\fi % \ifx\pdfoutput -%\def\butfirst#1{} \message{fonts,} - % Font-change commands. -% Texinfo supports the sans serif font style, which plain TeX does not. +% Texinfo sort of supports the sans serif font style, which plain TeX does not. % So we set up a \sf analogous to plain's \rm, etc. \newfam\sffam \def\sf{\fam=\sffam \tensf} @@ -972,8 +1032,9 @@ where each line of input produces a line of output.} % We don't need math for this one. \def\ttsl{\tenttsl} -%% Try out Computer Modern fonts at \magstephalf -\let\mainmagstep=\magstephalf +% Use Computer Modern fonts at \magstephalf (11pt). +\newcount\mainmagstep +\mainmagstep=\magstephalf % Set the font macro #1 to the font named #2, adding on the % specified font prefix (normally `cm'). @@ -988,7 +1049,7 @@ where each line of input produces a line of output.} \fi % Support font families that don't use the same naming scheme as CM. \def\rmshape{r} -\def\rmbshape{bx} %where the normal face is bold +\def\rmbshape{bx} %where the normal face is bold \def\bfshape{b} \def\bxshape{bx} \def\ttshape{tt} @@ -1028,35 +1089,44 @@ where each line of input produces a line of output.} \setfont\deftt\ttshape{10}{\magstep1} \def\df{\let\tentt=\deftt \let\tenbf = \defbf \bf} -% Fonts for indices and small examples. -% We actually use the slanted font rather than the italic, -% because texinfo normally uses the slanted fonts for that. -% Do not make many font distinctions in general in the index, since they -% aren't very useful. -\setfont\ninett\ttshape{9}{1000} -\setfont\indrm\rmshape{9}{1000} -\setfont\indit\slshape{9}{1000} -\let\indsl=\indit -\let\indtt=\ninett -\let\indttsl=\ninett -\let\indsf=\indrm -\let\indbf=\indrm -\setfont\indsc\scshape{10}{900} -\font\indi=cmmi9 -\font\indsy=cmsy9 - -% Fonts for headings +% Fonts for indices, footnotes, small examples (9pt). +\setfont\smallrm\rmshape{9}{1000} +\setfont\smalltt\ttshape{9}{1000} +\setfont\smallbf\bfshape{10}{900} +\setfont\smallit\itshape{9}{1000} +\setfont\smallsl\slshape{9}{1000} +\setfont\smallsf\sfshape{9}{1000} +\setfont\smallsc\scshape{10}{900} +\setfont\smallttsl\ttslshape{10}{900} +\font\smalli=cmmi9 +\font\smallsy=cmsy9 + +% Fonts for title page: +\setfont\titlerm\rmbshape{12}{\magstep3} +\setfont\titleit\itbshape{10}{\magstep4} +\setfont\titlesl\slbshape{10}{\magstep4} +\setfont\titlett\ttbshape{12}{\magstep3} +\setfont\titlettsl\ttslshape{10}{\magstep4} +\setfont\titlesf\sfbshape{17}{\magstep1} +\let\titlebf=\titlerm +\setfont\titlesc\scbshape{10}{\magstep4} +\font\titlei=cmmi12 scaled \magstep3 +\font\titlesy=cmsy10 scaled \magstep4 +\def\authorrm{\secrm} + +% Chapter (and unnumbered) fonts (17.28pt). \setfont\chaprm\rmbshape{12}{\magstep2} \setfont\chapit\itbshape{10}{\magstep3} \setfont\chapsl\slbshape{10}{\magstep3} \setfont\chaptt\ttbshape{12}{\magstep2} \setfont\chapttsl\ttslshape{10}{\magstep3} -\setfont\chapsf\sfbshape{12}{\magstep2} +\setfont\chapsf\sfbshape{17}{1000} \let\chapbf=\chaprm \setfont\chapsc\scbshape{10}{\magstep3} \font\chapi=cmmi12 scaled \magstep2 \font\chapsy=cmsy10 scaled \magstep3 +% Section fonts (14.4pt). \setfont\secrm\rmbshape{12}{\magstep1} \setfont\secit\itbshape{10}{\magstep2} \setfont\secsl\slbshape{10}{\magstep2} @@ -1074,31 +1144,28 @@ where each line of input produces a line of output.} % \setfont\ssectt\ttshape{10}{\magstep1} % \setfont\ssecsf\sfshape{10}{\magstep1} -%\setfont\ssecrm\bfshape{10}{1315} % Note the use of cmb rather than cmbx. -%\setfont\ssecit\itshape{10}{1315} % Also, the size is a little larger than -%\setfont\ssecsl\slshape{10}{1315} % being scaled magstep1. +%\setfont\ssecrm\bfshape{10}{1315} % Note the use of cmb rather than cmbx. +%\setfont\ssecit\itshape{10}{1315} % Also, the size is a little larger than +%\setfont\ssecsl\slshape{10}{1315} % being scaled magstep1. %\setfont\ssectt\ttshape{10}{1315} %\setfont\ssecsf\sfshape{10}{1315} %\let\ssecbf=\ssecrm +% Subsection fonts (13.15pt). \setfont\ssecrm\rmbshape{12}{\magstephalf} \setfont\ssecit\itbshape{10}{1315} \setfont\ssecsl\slbshape{10}{1315} \setfont\ssectt\ttbshape{12}{\magstephalf} -\setfont\ssecttsl\ttslshape{10}{\magstep1} +\setfont\ssecttsl\ttslshape{10}{1315} \setfont\ssecsf\sfbshape{12}{\magstephalf} \let\ssecbf\ssecrm \setfont\ssecsc\scbshape{10}{\magstep1} \font\sseci=cmmi12 scaled \magstephalf -\font\ssecsy=cmsy10 scaled \magstep1 +\font\ssecsy=cmsy10 scaled 1315 % The smallcaps and symbol fonts should actually be scaled \magstep1.5, % but that is not a standard magnification. -% Fonts for title page: -\setfont\titlerm\rmbshape{12}{\magstep3} -\let\authorrm = \secrm - % In order for the font changes to affect most math symbols and letters, % we have to define the \textfont of the standard families. Since % texinfo doesn't allow for producing subscripts and superscripts, we @@ -1123,31 +1190,44 @@ where each line of input produces a line of output.} \let\tenbf=\textbf \let\tentt=\texttt \let\smallcaps=\textsc \let\tensf=\textsf \let\teni=\texti \let\tensy=\textsy \let\tenttsl=\textttsl \resetmathfonts} +\def\titlefonts{% + \let\tenrm=\titlerm \let\tenit=\titleit \let\tensl=\titlesl + \let\tenbf=\titlebf \let\tentt=\titlett \let\smallcaps=\titlesc + \let\tensf=\titlesf \let\teni=\titlei \let\tensy=\titlesy + \let\tenttsl=\titlettsl + \resetmathfonts \setleading{25pt}} +\def\titlefont#1{{\titlefonts\rm #1}} \def\chapfonts{% \let\tenrm=\chaprm \let\tenit=\chapit \let\tensl=\chapsl \let\tenbf=\chapbf \let\tentt=\chaptt \let\smallcaps=\chapsc \let\tensf=\chapsf \let\teni=\chapi \let\tensy=\chapsy \let\tenttsl=\chapttsl - \resetmathfonts} + \resetmathfonts \setleading{19pt}} \def\secfonts{% \let\tenrm=\secrm \let\tenit=\secit \let\tensl=\secsl \let\tenbf=\secbf \let\tentt=\sectt \let\smallcaps=\secsc \let\tensf=\secsf \let\teni=\seci \let\tensy=\secsy \let\tenttsl=\secttsl - \resetmathfonts} + \resetmathfonts \setleading{16pt}} \def\subsecfonts{% \let\tenrm=\ssecrm \let\tenit=\ssecit \let\tensl=\ssecsl \let\tenbf=\ssecbf \let\tentt=\ssectt \let\smallcaps=\ssecsc \let\tensf=\ssecsf \let\teni=\sseci \let\tensy=\ssecsy \let\tenttsl=\ssecttsl - \resetmathfonts} -\def\indexfonts{% - \let\tenrm=\indrm \let\tenit=\indit \let\tensl=\indsl - \let\tenbf=\indbf \let\tentt=\indtt \let\smallcaps=\indsc - \let\tensf=\indsf \let\teni=\indi \let\tensy=\indsy \let\tenttsl=\indttsl - \resetmathfonts} + \resetmathfonts \setleading{15pt}} +\let\subsubsecfonts = \subsecfonts % Maybe make sssec fonts scaled magstephalf? +\def\smallfonts{% + \let\tenrm=\smallrm \let\tenit=\smallit \let\tensl=\smallsl + \let\tenbf=\smallbf \let\tentt=\smalltt \let\smallcaps=\smallsc + \let\tensf=\smallsf \let\teni=\smalli \let\tensy=\smallsy + \let\tenttsl=\smallttsl + \resetmathfonts \setleading{11pt}} % Set up the default fonts, so we can use them for creating boxes. % \textfonts +% Define these so they can be easily changed for other fonts. +\def\angleleft{$\langle$} +\def\angleright{$\rangle$} + % Count depth in font-changes, for error checks \newcount\fontdepth \fontdepth=0 @@ -1162,13 +1242,14 @@ where each line of input produces a line of output.} % \smartitalic{ARG} outputs arg in italics, followed by an italic correction % unless the following character is such as not to need one. \def\smartitalicx{\ifx\next,\else\ifx\next-\else\ifx\next.\else\/\fi\fi\fi} -\def\smartitalic#1{{\sl #1}\futurelet\next\smartitalicx} +\def\smartslanted#1{{\sl #1}\futurelet\next\smartitalicx} +\def\smartitalic#1{{\it #1}\futurelet\next\smartitalicx} \let\i=\smartitalic -\let\var=\smartitalic -\let\dfn=\smartitalic +\let\var=\smartslanted +\let\dfn=\smartslanted \let\emph=\smartitalic -\let\cite=\smartitalic +\let\cite=\smartslanted \def\b#1{{\bf #1}} \let\strong=\b @@ -1185,12 +1266,22 @@ where each line of input produces a line of output.} \null } \let\ttfont=\t -\def\samp #1{`\tclose{#1}'\null} -\def\key #1{{\ttsl \nohyphenation \uppercase{#1}}\null} +\def\samp#1{`\tclose{#1}'\null} +\setfont\keyrm\rmshape{8}{1000} +\font\keysy=cmsy9 +\def\key#1{{\keyrm\textfont2=\keysy \leavevmode\hbox{% + \raise0.4pt\hbox{\angleleft}\kern-.08em\vtop{% + \vbox{\hrule\kern-0.4pt + \hbox{\raise0.4pt\hbox{\vphantom{\angleleft}}#1}}% + \kern-0.4pt\hrule}% + \kern-.06em\raise0.4pt\hbox{\angleright}}}} +% The old definition, with no lozenge: +%\def\key #1{{\ttsl \nohyphenation \uppercase{#1}}\null} \def\ctrl #1{{\tt \rawbackslash \hat}#1} +% @file, @option are the same as @samp. \let\file=\samp -\let\url=\samp % perhaps include a hypertex \special eventually +\let\option=\samp % @code is a modification of @t, % which makes spaces the same size as normal in the surrounding text. @@ -1222,57 +1313,141 @@ where each line of input produces a line of output.} % Unfortunately, TeX uses one parameter (\hyphenchar) to control % both hyphenation at - and hyphenation within words. % We must therefore turn them both off (\tclose does that) -% and arrange explicitly to hyphenate an a dash. +% and arrange explicitly to hyphenate at a dash. % -- rms. { -\catcode`\-=\active -\catcode`\_=\active -\global\def\code{\begingroup \catcode`\-=\active \let-\codedash \catcode`\_=\active \let_\codeunder \codex} -% The following is used by \doprintindex to insure that long function names -% wrap around. It is necessary for - and _ to be active before the index is -% read from the file, as \entry parses the arguments long before \code is -% ever called. -- mycroft -\global\def\indexbreaks{\catcode`\-=\active \let-\realdash \catcode`\_=\active \let_\realunder} + \catcode`\-=\active + \catcode`\_=\active + % + \global\def\code{\begingroup + \catcode`\-=\active \let-\codedash + \catcode`\_=\active \let_\codeunder + \codex + } + % + % If we end up with any active - characters when handling the index, + % just treat them as a normal -. + \global\def\indexbreaks{\catcode`\-=\active \let-\realdash} } \def\realdash{-} -\def\realunder{_} \def\codedash{-\discretionary{}{}{}} -\def\codeunder{\normalunderscore\discretionary{}{}{}} +\def\codeunder{\ifusingtt{\normalunderscore\discretionary{}{}{}}{\_}} \def\codex #1{\tclose{#1}\endgroup} %\let\exp=\tclose %Was temporary % @kbd is like @code, except that if the argument is just one @key command, % then @kbd has no effect. -% + +% @kbdinputstyle -- arg is `distinct' (@kbd uses slanted tty font always), +% `example' (@kbd uses ttsl only inside of @example and friends), +% or `code' (@kbd uses normal tty font always). +\def\kbdinputstyle{\parsearg\kbdinputstylexxx} +\def\kbdinputstylexxx#1{% + \def\arg{#1}% + \ifx\arg\worddistinct + \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\ttsl}% + \else\ifx\arg\wordexample + \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\tt}% + \else\ifx\arg\wordcode + \gdef\kbdexamplefont{\tt}\gdef\kbdfont{\tt}% + \fi\fi\fi +} +\def\worddistinct{distinct} +\def\wordexample{example} +\def\wordcode{code} + +% Default is kbdinputdistinct. (Too much of a hassle to call the macro, +% the catcodes are wrong for parsearg to work.) +\gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\ttsl} + \def\xkey{\key} \def\kbdfoo#1#2#3\par{\def\one{#1}\def\three{#3}\def\threex{??}% \ifx\one\xkey\ifx\threex\three \key{#2}% -\else{\tclose{\ttsl\look}}\fi -\else{\tclose{\ttsl\look}}\fi} +\else{\tclose{\kbdfont\look}}\fi +\else{\tclose{\kbdfont\look}}\fi} + +% For @url, @env, @command quotes seem unnecessary, so use \code. +\let\url=\code +\let\env=\code +\let\command=\code + +% @uref (abbreviation for `urlref') takes an optional (comma-separated) +% second argument specifying the text to display and an optional third +% arg as text to display instead of (rather than in addition to) the url +% itself. First (mandatory) arg is the url. Perhaps eventually put in +% a hypertex \special here. +% +\def\uref#1{\douref #1,,,\finish} +\def\douref#1,#2,#3,#4\finish{\begingroup + \unsepspaces + \pdfurl{#1}% + \setbox0 = \hbox{\ignorespaces #3}% + \ifdim\wd0 > 0pt + \unhbox0 % third arg given, show only that + \else + \setbox0 = \hbox{\ignorespaces #2}% + \ifdim\wd0 > 0pt + \ifpdf + \unhbox0 % PDF: 2nd arg given, show only it + \else + \unhbox0\ (\code{#1})% DVI: 2nd arg given, show both it and url + \fi + \else + \code{#1}% only url given, so show it + \fi + \fi + \endlink +\endgroup} + +% rms does not like angle brackets --karl, 17may97. +% So now @email is just like @uref, unless we are pdf. +% +%\def\email#1{\angleleft{\tt #1}\angleright} +\ifpdf + \def\email#1{\doemail#1,,\finish} + \def\doemail#1,#2,#3\finish{\begingroup + \unsepspaces + \pdfurl{mailto:#1}% + \setbox0 = \hbox{\ignorespaces #2}% + \ifdim\wd0>0pt\unhbox0\else\code{#1}\fi + \endlink + \endgroup} +\else + \let\email=\uref +\fi % Check if we are currently using a typewriter font. Since all the % Computer Modern typewriter fonts have zero interword stretch (and % shrink), and it is reasonable to expect all typewriter fonts to have % this property, we can check that font parameter. -% +% \def\ifmonospace{\ifdim\fontdimen3\font=0pt } % Typeset a dimension, e.g., `in' or `pt'. The only reason for the -% argument is to make the input look right: @dmn{pt} instead of -% @dmn{}pt. +% argument is to make the input look right: @dmn{pt} instead of @dmn{}pt. % \def\dmn#1{\thinspace #1} \def\kbd#1{\def\look{#1}\expandafter\kbdfoo\look??\par} -\def\l#1{{\li #1}\null} % +% @l was never documented to mean ``switch to the Lisp font'', +% and it is not used as such in any manual I can find. We need it for +% Polish suppressed-l. --karl, 22sep96. +%\def\l#1{{\li #1}\null} + +% Explicit font changes: @r, @sc, undocumented @ii. +\def\r#1{{\rm #1}} % roman font +\def\sc#1{{\smallcaps#1}} % smallcaps font +\def\ii#1{{\it #1}} % italic font + +% @acronym downcases the argument and prints in smallcaps. +\def\acronym#1{{\smallcaps \lowercase{#1}}} + +% @pounds{} is a sterling sign. +\def\pounds{{\it\$}} -\def\r#1{{\rm #1}} % roman font -% Use of \lowercase was suggested. -\def\sc#1{{\smallcaps#1}} % smallcaps font -\def\ii#1{{\it #1}} % italic font \message{page headings,} @@ -1280,20 +1455,23 @@ where each line of input produces a line of output.} \newskip\titlepagebottomglue \titlepagebottomglue = 2pc % First the title page. Must do @settitle before @titlepage. -\def\titlefont#1{{\titlerm #1}} - \newif\ifseenauthor \newif\iffinishedtitlepage +% Do an implicit @contents or @shortcontents after @end titlepage if the +% user says @setcontentsaftertitlepage or @setshortcontentsaftertitlepage. +% +\newif\ifsetcontentsaftertitlepage + \let\setcontentsaftertitlepage = \setcontentsaftertitlepagetrue +\newif\ifsetshortcontentsaftertitlepage + \let\setshortcontentsaftertitlepage = \setshortcontentsaftertitlepagetrue + \def\shorttitlepage{\parsearg\shorttitlepagezzz} \def\shorttitlepagezzz #1{\begingroup\hbox{}\vskip 1.5in \chaprm \centerline{#1}% - \endgroup\page\hbox{}\page} + \endgroup\page\hbox{}\page} \def\titlepage{\begingroup \parindent=0pt \textfonts \let\subtitlerm=\tenrm -% I deinstalled the following change because \cmr12 is undefined. -% This change was not in the ChangeLog anyway. --rms. -% \let\subtitlerm=\cmr12 \def\subtitlefont{\subtitlerm \normalbaselineskip = 13pt \normalbaselines}% % \def\authorfont{\authorrm \normalbaselineskip = 16pt \normalbaselines}% @@ -1303,10 +1481,10 @@ where each line of input produces a line of output.} % % Now you can print the title using @title. \def\title{\parsearg\titlezzz}% - \def\titlezzz##1{\leftline{\titlefont{##1}} - % print a rule at the page bottom also. - \finishedtitlepagefalse - \vskip4pt \hrule height 4pt width \hsize \vskip4pt}% + \def\titlezzz##1{\leftline{\titlefonts\rm ##1} + % print a rule at the page bottom also. + \finishedtitlepagefalse + \vskip4pt \hrule height 4pt width \hsize \vskip4pt}% % No rule at page bottom unless we print one at the top with @title. \finishedtitlepagetrue % @@ -1324,7 +1502,7 @@ where each line of input produces a line of output.} \let\oldpage = \page \def\page{% \iffinishedtitlepage\else - \finishtitlepage + \finishtitlepage \fi \oldpage \let\page = \oldpage @@ -1342,6 +1520,23 @@ where each line of input produces a line of output.} % after the title page, which we certainly don't want. \oldpage \endgroup + % + % If they want short, they certainly want long too. + \ifsetshortcontentsaftertitlepage + \shortcontents + \contents + \global\let\shortcontents = \relax + \global\let\contents = \relax + \fi + % + \ifsetcontentsaftertitlepage + \contents + \global\let\contents = \relax + \global\let\shortcontents = \relax + \fi + % + \ifpdf \pdfmakepagedesttrue \fi + % \HEADINGSon } @@ -1355,10 +1550,10 @@ where each line of input produces a line of output.} \let\thispage=\folio -\newtoks \evenheadline % Token sequence for heading line of even pages -\newtoks \oddheadline % Token sequence for heading line of odd pages -\newtoks \evenfootline % Token sequence for footing line of even pages -\newtoks \oddfootline % Token sequence for footing line of odd pages +\newtoks\evenheadline % headline on even pages +\newtoks\oddheadline % headline on odd pages +\newtoks\evenfootline % footline on even pages +\newtoks\oddfootline % footline on odd pages % Now make Tex use those variables \headline={{\textfonts\rm \ifodd\pageno \the\oddheadline @@ -1392,10 +1587,7 @@ where each line of input produces a line of output.} \gdef\oddheadingyyy #1@|#2@|#3@|#4\finish{% \global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}} -\gdef\everyheadingxxx #1{\everyheadingyyy #1@|@|@|@|\finish} -\gdef\everyheadingyyy #1@|#2@|#3@|#4\finish{% -\global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}} -\global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}} +\gdef\everyheadingxxx#1{\oddheadingxxx{#1}\evenheadingxxx{#1}}% \gdef\evenfootingxxx #1{\evenfootingyyy #1@|@|@|@|\finish} \gdef\evenfootingyyy #1@|#2@|#3@|#4\finish{% @@ -1403,23 +1595,27 @@ where each line of input produces a line of output.} \gdef\oddfootingxxx #1{\oddfootingyyy #1@|@|@|@|\finish} \gdef\oddfootingyyy #1@|#2@|#3@|#4\finish{% -\global\oddfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}} + \global\oddfootline = {\rlap{\centerline{#2}}\line{#1\hfil#3}}% + % + % Leave some space for the footline. Hopefully ok to assume + % @evenfooting will not be used by itself. + \global\advance\pageheight by -\baselineskip + \global\advance\vsize by -\baselineskip +} -\gdef\everyfootingxxx #1{\everyfootingyyy #1@|@|@|@|\finish} -\gdef\everyfootingyyy #1@|#2@|#3@|#4\finish{% -\global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}} -\global\oddfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}} +\gdef\everyfootingxxx#1{\oddfootingxxx{#1}\evenfootingxxx{#1}} % }% unbind the catcode of @. -% @headings double turns headings on for double-sided printing. -% @headings single turns headings on for single-sided printing. -% @headings off turns them off. -% @headings on same as @headings double, retained for compatibility. -% @headings after turns on double-sided headings after this page. -% @headings doubleafter turns on double-sided headings after this page. +% @headings double turns headings on for double-sided printing. +% @headings single turns headings on for single-sided printing. +% @headings off turns them off. +% @headings on same as @headings double, retained for compatibility. +% @headings after turns on double-sided headings after this page. +% @headings doubleafter turns on double-sided headings after this page. % @headings singleafter turns on single-sided headings after this page. -% By default, they are off. +% By default, they are off at the start of a document, +% and turned `on' after @end titlepage. \def\headings #1 {\csname HEADINGS#1\endcsname} @@ -1433,22 +1629,24 @@ where each line of input produces a line of output.} % title on inside top of left hand pages, and page numbers on outside top % edge of all pages. \def\HEADINGSdouble{ -%\pagealignmacro \global\pageno=1 \global\evenfootline={\hfil} \global\oddfootline={\hfil} \global\evenheadline={\line{\folio\hfil\thistitle}} \global\oddheadline={\line{\thischapter\hfil\folio}} +\global\let\contentsalignmacro = \chapoddpage } +\let\contentsalignmacro = \chappager + % For single-sided printing, chapter title goes across top left of page, % page number on top right. \def\HEADINGSsingle{ -%\pagealignmacro \global\pageno=1 \global\evenfootline={\hfil} \global\oddfootline={\hfil} \global\evenheadline={\line{\thischapter\hfil\folio}} \global\oddheadline={\line{\thischapter\hfil\folio}} +\global\let\contentsalignmacro = \chappager } \def\HEADINGSon{\HEADINGSdouble} @@ -1459,6 +1657,7 @@ where each line of input produces a line of output.} \global\oddfootline={\hfil} \global\evenheadline={\line{\folio\hfil\thistitle}} \global\oddheadline={\line{\thischapter\hfil\folio}} +\global\let\contentsalignmacro = \chapoddpage } \def\HEADINGSsingleafter{\let\HEADINGShook=\HEADINGSsinglex} @@ -1467,42 +1666,28 @@ where each line of input produces a line of output.} \global\oddfootline={\hfil} \global\evenheadline={\line{\thischapter\hfil\folio}} \global\oddheadline={\line{\thischapter\hfil\folio}} +\global\let\contentsalignmacro = \chappager } % Subroutines used in generating headings % Produces Day Month Year style of output. -\def\today{\number\day\space -\ifcase\month\or -January\or February\or March\or April\or May\or June\or -July\or August\or September\or October\or November\or December\fi -\space\number\year} - -% Use this if you want the Month Day, Year style of output. -%\def\today{\ifcase\month\or -%January\or February\or March\or April\or May\or June\or -%July\or August\or September\or October\or November\or December\fi -%\space\number\day, \number\year} - -% @settitle line... specifies the title of the document, for headings -% It generates no output of its own - -\def\thistitle{No Title} +\def\today{% + \number\day\space + \ifcase\month + \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr + \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug + \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec + \fi + \space\number\year} + +% @settitle line... specifies the title of the document, for headings. +% It generates no output of its own. +\def\thistitle{\putwordNoTitle} \def\settitle{\parsearg\settitlezzz} \def\settitlezzz #1{\gdef\thistitle{#1}} -\message{tables,} - -% @tabs -- simple alignment - -% These don't work. For one thing, \+ is defined as outer. -% So these macros cannot even be defined. - -%\def\tabs{\parsearg\tabszzz} -%\def\tabszzz #1{\settabs\+#1\cr} -%\def\tabline{\parsearg\tablinezzz} -%\def\tablinezzz #1{\+#1\cr} -%\def\&{&} +\message{tables,} % Tables -- @table, @ftable, @vtable, @item(x), @kitem(x), @xitem(x). % default indentation of table text @@ -1546,11 +1731,6 @@ July\or August\or September\or October\or November\or December\fi \itemindex{#1}% \nobreak % This prevents a break before @itemx. % - % Be sure we are not still in the middle of a paragraph. - %{\parskip = 0in - %\par - %}% - % % If the item text does not fit in the space we have, put it on a line % by itself, and do not allow a page break either before or after that % line. We do not start a paragraph here because then if the next @@ -1579,13 +1759,17 @@ July\or August\or September\or October\or November\or December\fi \itemxneedsnegativevskipfalse \else % The item text fits into the space. Start a paragraph, so that the - % following text (if any) will end up on the same line. Since that - % text will be indented by \tableindent, we make the item text be in - % a zero-width box. + % following text (if any) will end up on the same line. \noindent - \rlap{\hskip -\tableindent\box0}\ignorespaces% - \endgroup% - \itemxneedsnegativevskiptrue% + % Do this with kerns and \unhbox so that if there is a footnote in + % the item text, it can migrate to the main vertical list and + % eventually be printed. + \nobreak\kern-\tableindent + \dimen0 = \itemmax \advance\dimen0 by \itemmargin \advance\dimen0 by -\wd0 + \unhbox0 + \nobreak\kern\dimen0 + \endgroup + \itemxneedsnegativevskiptrue \fi } @@ -1596,9 +1780,10 @@ July\or August\or September\or October\or November\or December\fi \def\xitem{\errmessage{@xitem while not in a table}} \def\xitemx{\errmessage{@xitemx while not in a table}} -%% Contains a kludge to get @end[description] to work +% Contains a kludge to get @end[description] to work. \def\description{\tablez{\dontindex}{1}{}{}{}{}} +% @table, @ftable, @vtable. \def\table{\begingroup\inENV\obeylines\obeyspaces\tablex} {\obeylines\obeyspaces% \gdef\tablex #1^^M{% @@ -1658,7 +1843,7 @@ July\or August\or September\or October\or November\or December\fi \def\itemize{\parsearg\itemizezzz} \def\itemizezzz #1{% - \begingroup % ended by the @end itemsize + \begingroup % ended by the @end itemize \itemizey {#1}{\Eitemize} } @@ -1786,7 +1971,7 @@ July\or August\or September\or October\or November\or December\fi \def\itemizeitem{% \advance\itemno by 1 {\let\par=\endgraf \smallbreak}% -\ifhmode \errmessage{\in hmode at itemizeitem}\fi +\ifhmode \errmessage{In hmode at itemizeitem}\fi {\parskip=0in \hskip 0pt \hbox to 0pt{\hss \itemcontents\hskip \itemmargin}% \vadjust{\penalty 1200}}% @@ -1804,7 +1989,7 @@ July\or August\or September\or October\or November\or December\fi % To make preamble: % -% Either define widths of columns in terms of percent of \hsize: +% Either define widths of columns in terms of percent of \hsize: % @multitable @columnfractions .25 .3 .45 % @item ... % @@ -1812,6 +1997,7 @@ July\or August\or September\or October\or November\or December\fi % current hsize to be used for each column. You may use as many % columns as desired. + % Or use a template: % @multitable {Column 1 template} {Column 2 template} {Column 3 template} % @item ... @@ -1821,33 +2007,33 @@ July\or August\or September\or October\or November\or December\fi % the preamble, break the line within one argument and it % will parse correctly, i.e., % -% @multitable {Column 1 template} {Column 2 template} {Column 3 +% @multitable {Column 1 template} {Column 2 template} {Column 3 % template} % Not: -% @multitable {Column 1 template} {Column 2 template} +% @multitable {Column 1 template} {Column 2 template} % {Column 3 template} -% Each new table line starts with @item, each subsequent new column +% Each new table line starts with @item, each subsequent new column % starts with @tab. Empty columns may be produced by supplying @tab's % with nothing between them for as many times as empty columns are needed, % ie, @tab@tab@tab will produce two empty columns. -% @item, @tab, @multicolumn or @endmulticolumn do not need to be on their +% @item, @tab, @multitable or @end multitable do not need to be on their % own lines, but it will not hurt if they are. % Sample multitable: % @multitable {Column 1 template} {Column 2 template} {Column 3 template} % @item first col stuff @tab second col stuff @tab third col -% @item -% first col stuff -% @tab -% second col stuff -% @tab -% third col -% @item first col stuff @tab second col stuff +% @item +% first col stuff +% @tab +% second col stuff +% @tab +% third col +% @item first col stuff @tab second col stuff % @tab Many paragraphs of text may be used in any column. -% +% % They will wrap at the width determined by the template. % @item@tab@tab This will be in third column. % @end multitable @@ -1859,10 +2045,7 @@ July\or August\or September\or October\or November\or December\fi % @multitablelinespace is space to leave between table items, baseline % to baseline. % 0pt means it depends on current normal line spacing. - -%%%% -% Dimensions - +% \newskip\multitableparskip \newskip\multitableparindent \newdimen\multitablecolspace @@ -1872,127 +2055,512 @@ July\or August\or September\or October\or November\or December\fi \multitablecolspace=12pt \multitablelinespace=0pt -%%%% -% Macros used to set up halign preamble: -\let\endsetuptable\relax -\def\xendsetuptable{\endsetuptable} -\let\columnfractions\relax -\def\xcolumnfractions{\columnfractions} -\newif\ifsetpercent +% Macros used to set up halign preamble: +% +\let\endsetuptable\relax +\def\xendsetuptable{\endsetuptable} +\let\columnfractions\relax +\def\xcolumnfractions{\columnfractions} +\newif\ifsetpercent + +% #1 is the part of the @columnfraction before the decimal point, which +% is presumably either 0 or the empty string (but we don't check, we +% just throw it away). #2 is the decimal part, which we use as the +% percent of \hsize for this column. +\def\pickupwholefraction#1.#2 {% + \global\advance\colcount by 1 + \expandafter\xdef\csname col\the\colcount\endcsname{.#2\hsize}% + \setuptable +} + +\newcount\colcount +\def\setuptable#1{% + \def\firstarg{#1}% + \ifx\firstarg\xendsetuptable + \let\go = \relax + \else + \ifx\firstarg\xcolumnfractions + \global\setpercenttrue + \else + \ifsetpercent + \let\go\pickupwholefraction + \else + \global\advance\colcount by 1 + \setbox0=\hbox{#1\unskip }% Add a normal word space as a separator; + % typically that is always in the input, anyway. + \expandafter\xdef\csname col\the\colcount\endcsname{\the\wd0}% + \fi + \fi + \ifx\go\pickupwholefraction + % Put the argument back for the \pickupwholefraction call, so + % we'll always have a period there to be parsed. + \def\go{\pickupwholefraction#1}% + \else + \let\go = \setuptable + \fi% + \fi + \go +} + +% This used to have \hskip1sp. But then the space in a template line is +% not enough. That is bad. So let's go back to just & until we +% encounter the problem it was intended to solve again. +% --karl, nathan@acm.org, 20apr99. +\def\tab{&} + +% @multitable ... @end multitable definitions: +% +\def\multitable{\parsearg\dotable} +\def\dotable#1{\bgroup + \vskip\parskip + \let\item\crcr + \tolerance=9500 + \hbadness=9500 + \setmultitablespacing + \parskip=\multitableparskip + \parindent=\multitableparindent + \overfullrule=0pt + \global\colcount=0 + \def\Emultitable{\global\setpercentfalse\cr\egroup\egroup}% + % + % To parse everything between @multitable and @item: + \setuptable#1 \endsetuptable + % + % \everycr will reset column counter, \colcount, at the end of + % each line. Every column entry will cause \colcount to advance by one. + % The table preamble + % looks at the current \colcount to find the correct column width. + \everycr{\noalign{% + % + % \filbreak%% keeps underfull box messages off when table breaks over pages. + % Maybe so, but it also creates really weird page breaks when the table + % breaks over pages. Wouldn't \vfil be better? Wait until the problem + % manifests itself, so it can be fixed for real --karl. + \global\colcount=0\relax}}% + % + % This preamble sets up a generic column definition, which will + % be used as many times as user calls for columns. + % \vtop will set a single line and will also let text wrap and + % continue for many paragraphs if desired. + \halign\bgroup&\global\advance\colcount by 1\relax + \multistrut\vtop{\hsize=\expandafter\csname col\the\colcount\endcsname + % + % In order to keep entries from bumping into each other + % we will add a \leftskip of \multitablecolspace to all columns after + % the first one. + % + % If a template has been used, we will add \multitablecolspace + % to the width of each template entry. + % + % If the user has set preamble in terms of percent of \hsize we will + % use that dimension as the width of the column, and the \leftskip + % will keep entries from bumping into each other. Table will start at + % left margin and final column will justify at right margin. + % + % Make sure we don't inherit \rightskip from the outer environment. + \rightskip=0pt + \ifnum\colcount=1 + % The first column will be indented with the surrounding text. + \advance\hsize by\leftskip + \else + \ifsetpercent \else + % If user has not set preamble in terms of percent of \hsize + % we will advance \hsize by \multitablecolspace. + \advance\hsize by \multitablecolspace + \fi + % In either case we will make \leftskip=\multitablecolspace: + \leftskip=\multitablecolspace + \fi + % Ignoring space at the beginning and end avoids an occasional spurious + % blank line, when TeX decides to break the line at the space before the + % box from the multistrut, so the strut ends up on a line by itself. + % For example: + % @multitable @columnfractions .11 .89 + % @item @code{#} + % @tab Legal holiday which is valid in major parts of the whole country. + % Is automatically provided with highlighting sequences respectively marking + % characters. + \noindent\ignorespaces##\unskip\multistrut}\cr +} + +\def\setmultitablespacing{% test to see if user has set \multitablelinespace. +% If so, do nothing. If not, give it an appropriate dimension based on +% current baselineskip. +\ifdim\multitablelinespace=0pt +\setbox0=\vbox{X}\global\multitablelinespace=\the\baselineskip +\global\advance\multitablelinespace by-\ht0 +%% strut to put in table in case some entry doesn't have descenders, +%% to keep lines equally spaced +\let\multistrut = \strut +\else +%% FIXME: what is \box0 supposed to be? +\gdef\multistrut{\vrule height\multitablelinespace depth\dp0 +width0pt\relax} \fi +%% Test to see if parskip is larger than space between lines of +%% table. If not, do nothing. +%% If so, set to same dimension as multitablelinespace. +\ifdim\multitableparskip>\multitablelinespace +\global\multitableparskip=\multitablelinespace +\global\advance\multitableparskip-7pt %% to keep parskip somewhat smaller + %% than skip between lines in the table. +\fi% +\ifdim\multitableparskip=0pt +\global\multitableparskip=\multitablelinespace +\global\advance\multitableparskip-7pt %% to keep parskip somewhat smaller + %% than skip between lines in the table. +\fi} + + +\message{conditionals,} +% Prevent errors for section commands. +% Used in @ignore and in failing conditionals. +\def\ignoresections{% + \let\chapter=\relax + \let\unnumbered=\relax + \let\top=\relax + \let\unnumberedsec=\relax + \let\unnumberedsection=\relax + \let\unnumberedsubsec=\relax + \let\unnumberedsubsection=\relax + \let\unnumberedsubsubsec=\relax + \let\unnumberedsubsubsection=\relax + \let\section=\relax + \let\subsec=\relax + \let\subsubsec=\relax + \let\subsection=\relax + \let\subsubsection=\relax + \let\appendix=\relax + \let\appendixsec=\relax + \let\appendixsection=\relax + \let\appendixsubsec=\relax + \let\appendixsubsection=\relax + \let\appendixsubsubsec=\relax + \let\appendixsubsubsection=\relax + \let\contents=\relax + \let\smallbook=\relax + \let\titlepage=\relax +} + +% Used in nested conditionals, where we have to parse the Texinfo source +% and so want to turn off most commands, in case they are used +% incorrectly. +% +\def\ignoremorecommands{% + \let\defcodeindex = \relax + \let\defcv = \relax + \let\deffn = \relax + \let\deffnx = \relax + \let\defindex = \relax + \let\defivar = \relax + \let\defmac = \relax + \let\defmethod = \relax + \let\defop = \relax + \let\defopt = \relax + \let\defspec = \relax + \let\deftp = \relax + \let\deftypefn = \relax + \let\deftypefun = \relax + \let\deftypeivar = \relax + \let\deftypeop = \relax + \let\deftypevar = \relax + \let\deftypevr = \relax + \let\defun = \relax + \let\defvar = \relax + \let\defvr = \relax + \let\ref = \relax + \let\xref = \relax + \let\printindex = \relax + \let\pxref = \relax + \let\settitle = \relax + \let\setchapternewpage = \relax + \let\setchapterstyle = \relax + \let\everyheading = \relax + \let\evenheading = \relax + \let\oddheading = \relax + \let\everyfooting = \relax + \let\evenfooting = \relax + \let\oddfooting = \relax + \let\headings = \relax + \let\include = \relax + \let\lowersections = \relax + \let\down = \relax + \let\raisesections = \relax + \let\up = \relax + \let\set = \relax + \let\clear = \relax + \let\item = \relax +} + +% Ignore @ignore ... @end ignore. +% +\def\ignore{\doignore{ignore}} + +% Ignore @ifinfo, @ifhtml, @ifnottex, @html, @menu, and @direntry text. +% +\def\ifinfo{\doignore{ifinfo}} +\def\ifhtml{\doignore{ifhtml}} +\def\ifnottex{\doignore{ifnottex}} +\def\html{\doignore{html}} +\def\menu{\doignore{menu}} +\def\direntry{\doignore{direntry}} + +% @dircategory CATEGORY -- specify a category of the dir file +% which this file should belong to. Ignore this in TeX. +\let\dircategory = \comment + +% Ignore text until a line `@end #1'. +% +\def\doignore#1{\begingroup + % Don't complain about control sequences we have declared \outer. + \ignoresections + % + % Define a command to swallow text until we reach `@end #1'. + % This @ is a catcode 12 token (that is the normal catcode of @ in + % this texinfo.tex file). We change the catcode of @ below to match. + \long\def\doignoretext##1@end #1{\enddoignore}% + % + % Make sure that spaces turn into tokens that match what \doignoretext wants. + \catcode32 = 10 + % + % Ignore braces, too, so mismatched braces don't cause trouble. + \catcode`\{ = 9 + \catcode`\} = 9 + % + % We must not have @c interpreted as a control sequence. + \catcode`\@ = 12 + % + % Make the letter c a comment character so that the rest of the line + % will be ignored. This way, the document can have (for example) + % @c @end ifinfo + % and the @end ifinfo will be properly ignored. + % (We've just changed @ to catcode 12.) + \catcode`\c = 14 + % + % And now expand that command. + \doignoretext +} + +% What we do to finish off ignored text. +% +\def\enddoignore{\endgroup\ignorespaces}% + +\newif\ifwarnedobs\warnedobsfalse +\def\obstexwarn{% + \ifwarnedobs\relax\else + % We need to warn folks that they may have trouble with TeX 3.0. + % This uses \immediate\write16 rather than \message to get newlines. + \immediate\write16{} + \immediate\write16{WARNING: for users of Unix TeX 3.0!} + \immediate\write16{This manual trips a bug in TeX version 3.0 (tex hangs).} + \immediate\write16{If you are running another version of TeX, relax.} + \immediate\write16{If you are running Unix TeX 3.0, kill this TeX process.} + \immediate\write16{ Then upgrade your TeX installation if you can.} + \immediate\write16{ (See ftp://ftp.gnu.org/pub/gnu/TeX.README.)} + \immediate\write16{If you are stuck with version 3.0, run the} + \immediate\write16{ script ``tex3patch'' from the Texinfo distribution} + \immediate\write16{ to use a workaround.} + \immediate\write16{} + \global\warnedobstrue + \fi +} + +% **In TeX 3.0, setting text in \nullfont hangs tex. For a +% workaround (which requires the file ``dummy.tfm'' to be installed), +% uncomment the following line: +%%%%%\font\nullfont=dummy\let\obstexwarn=\relax + +% Ignore text, except that we keep track of conditional commands for +% purposes of nesting, up to an `@end #1' command. +% +\def\nestedignore#1{% + \obstexwarn + % We must actually expand the ignored text to look for the @end + % command, so that nested ignore constructs work. Thus, we put the + % text into a \vbox and then do nothing with the result. To minimize + % the change of memory overflow, we follow the approach outlined on + % page 401 of the TeXbook: make the current font be a dummy font. + % + \setbox0 = \vbox\bgroup + % Don't complain about control sequences we have declared \outer. + \ignoresections + % + % Define `@end #1' to end the box, which will in turn undefine the + % @end command again. + \expandafter\def\csname E#1\endcsname{\egroup\ignorespaces}% + % + % We are going to be parsing Texinfo commands. Most cause no + % trouble when they are used incorrectly, but some commands do + % complicated argument parsing or otherwise get confused, so we + % undefine them. + % + % We can't do anything about stray @-signs, unfortunately; + % they'll produce `undefined control sequence' errors. + \ignoremorecommands + % + % Set the current font to be \nullfont, a TeX primitive, and define + % all the font commands to also use \nullfont. We don't use + % dummy.tfm, as suggested in the TeXbook, because not all sites + % might have that installed. Therefore, math mode will still + % produce output, but that should be an extremely small amount of + % stuff compared to the main input. + % + \nullfont + \let\tenrm=\nullfont \let\tenit=\nullfont \let\tensl=\nullfont + \let\tenbf=\nullfont \let\tentt=\nullfont \let\smallcaps=\nullfont + \let\tensf=\nullfont + % Similarly for index fonts (mostly for their use in smallexample). + \let\smallrm=\nullfont \let\smallit=\nullfont \let\smallsl=\nullfont + \let\smallbf=\nullfont \let\smalltt=\nullfont \let\smallsc=\nullfont + \let\smallsf=\nullfont + % + % Don't complain when characters are missing from the fonts. + \tracinglostchars = 0 + % + % Don't bother to do space factor calculations. + \frenchspacing + % + % Don't report underfull hboxes. + \hbadness = 10000 + % + % Do minimal line-breaking. + \pretolerance = 10000 + % + % Do not execute instructions in @tex + \def\tex{\doignore{tex}}% + % Do not execute macro definitions. + % `c' is a comment character, so the word `macro' will get cut off. + \def\macro{\doignore{ma}}% +} + +% @set VAR sets the variable VAR to an empty value. +% @set VAR REST-OF-LINE sets VAR to the value REST-OF-LINE. +% +% Since we want to separate VAR from REST-OF-LINE (which might be +% empty), we can't just use \parsearg; we have to insert a space of our +% own to delimit the rest of the line, and then take it out again if we +% didn't need it. Make sure the catcode of space is correct to avoid +% losing inside @example, for instance. +% +\def\set{\begingroup\catcode` =10 + \catcode`\-=12 \catcode`\_=12 % Allow - and _ in VAR. + \parsearg\setxxx} +\def\setxxx#1{\setyyy#1 \endsetyyy} +\def\setyyy#1 #2\endsetyyy{% + \def\temp{#2}% + \ifx\temp\empty \global\expandafter\let\csname SET#1\endcsname = \empty + \else \setzzz{#1}#2\endsetzzz % Remove the trailing space \setxxx inserted. + \fi + \endgroup +} +% Can't use \xdef to pre-expand #2 and save some time, since \temp or +% \next or other control sequences that we've defined might get us into +% an infinite loop. Consider `@set foo @cite{bar}'. +\def\setzzz#1#2 \endsetzzz{\expandafter\gdef\csname SET#1\endcsname{#2}} + +% @clear VAR clears (i.e., unsets) the variable VAR. +% +\def\clear{\parsearg\clearxxx} +\def\clearxxx#1{\global\expandafter\let\csname SET#1\endcsname=\relax} -%% 2/1/96, to allow fractions to be given with more than one digit. -\def\pickupwholefraction#1 {\global\advance\colcount by1 % -\expandafter\xdef\csname col\the\colcount\endcsname{.#1\hsize}% -\setuptable} +% @value{foo} gets the text saved in variable foo. +{ + \catcode`\_ = \active + % + % We might end up with active _ or - characters in the argument if + % we're called from @code, as @code{@value{foo-bar_}}. So \let any + % such active characters to their normal equivalents. + \gdef\value{\begingroup + \catcode`\-=12 \catcode`\_=12 + \indexbreaks \let_\normalunderscore + \valuexxx} +} +\def\valuexxx#1{\expandablevalue{#1}\endgroup} + +% We have this subroutine so that we can handle at least some @value's +% properly in indexes (we \let\value to this in \indexdummies). Ones +% whose names contain - or _ still won't work, but we can't do anything +% about that. The command has to be fully expandable, since the result +% winds up in the index file. This means that if the variable's value +% contains other Texinfo commands, it's almost certain it will fail +% (although perhaps we could fix that with sufficient work to do a +% one-level expansion on the result, instead of complete). +% +\def\expandablevalue#1{% + \expandafter\ifx\csname SET#1\endcsname\relax + {[No value for ``#1'']}% + \else + \csname SET#1\endcsname + \fi +} -\newcount\colcount -\def\setuptable#1{\def\firstarg{#1}% -\ifx\firstarg\xendsetuptable\let\go\relax% -\else - \ifx\firstarg\xcolumnfractions\global\setpercenttrue% +% @ifset VAR ... @end ifset reads the `...' iff VAR has been defined +% with @set. +% +\def\ifset{\parsearg\ifsetxxx} +\def\ifsetxxx #1{% + \expandafter\ifx\csname SET#1\endcsname\relax + \expandafter\ifsetfail \else - \ifsetpercent - \let\go\pickupwholefraction % In this case arg of setuptable - % is the decimal point before the - % number given in percent of hsize. - % We don't need this so we don't use it. - \else - \global\advance\colcount by1 - \setbox0=\hbox{#1}% - \expandafter\xdef\csname col\the\colcount\endcsname{\the\wd0}% - \fi% - \fi% -\ifx\go\pickupwholefraction\else\let\go\setuptable\fi% -\fi\go} + \expandafter\ifsetsucceed + \fi +} +\def\ifsetsucceed{\conditionalsucceed{ifset}} +\def\ifsetfail{\nestedignore{ifset}} +\defineunmatchedend{ifset} -%%%% -% multitable syntax -\def\tab{&\hskip1sp\relax} % 2/2/96 - % tiny skip here makes sure this column space is - % maintained, even if it is never used. +% @ifclear VAR ... @end ifclear reads the `...' iff VAR has never been +% defined with @set, or has been undefined with @clear. +% +\def\ifclear{\parsearg\ifclearxxx} +\def\ifclearxxx #1{% + \expandafter\ifx\csname SET#1\endcsname\relax + \expandafter\ifclearsucceed + \else + \expandafter\ifclearfail + \fi +} +\def\ifclearsucceed{\conditionalsucceed{ifclear}} +\def\ifclearfail{\nestedignore{ifclear}} +\defineunmatchedend{ifclear} +% @iftex, @ifnothtml, @ifnotinfo always succeed; we read the text +% following, through the first @end iftex (etc.). Make `@end iftex' +% (etc.) valid only after an @iftex. +% +\def\iftex{\conditionalsucceed{iftex}} +\def\ifnothtml{\conditionalsucceed{ifnothtml}} +\def\ifnotinfo{\conditionalsucceed{ifnotinfo}} +\defineunmatchedend{iftex} +\defineunmatchedend{ifnothtml} +\defineunmatchedend{ifnotinfo} -%%%% -% @multitable ... @end multitable definitions: +% We can't just want to start a group at @iftex (for example) and end it +% at @end iftex, since then @set commands inside the conditional have no +% effect (they'd get reverted at the end of the group). So we must +% define \Eiftex to redefine itself to be its previous value. (We can't +% just define it to fail again with an ``unmatched end'' error, since +% the @ifset might be nested.) +% +\def\conditionalsucceed#1{% + \edef\temp{% + % Remember the current value of \E#1. + \let\nece{prevE#1} = \nece{E#1}% + % + % At the `@end #1', redefine \E#1 to be its previous value. + \def\nece{E#1}{\let\nece{E#1} = \nece{prevE#1}}% + }% + \temp +} -\def\multitable{\parsearg\dotable} +% We need to expand lots of \csname's, but we don't want to expand the +% control sequences after we've constructed them. +% +\def\nece#1{\expandafter\noexpand\csname#1\endcsname} + +% @defininfoenclose. +\let\definfoenclose=\comment -\def\dotable#1{\bgroup -\let\item\cr -\tolerance=9500 -\hbadness=9500 -\setmultitablespacing -\parskip=\multitableparskip -\parindent=\multitableparindent -\overfullrule=0pt -\global\colcount=0\relax% -\def\Emultitable{\global\setpercentfalse\global\everycr{}\cr\egroup\egroup}% - % To parse everything between @multitable and @item : -\setuptable#1 \endsetuptable - % Need to reset this to 0 after \setuptable. -\global\colcount=0\relax% - % - % This preamble sets up a generic column definition, which will - % be used as many times as user calls for columns. - % \vtop will set a single line and will also let text wrap and - % continue for many paragraphs if desired. -\halign\bgroup&\global\advance\colcount by 1\relax% -\multistrut\vtop{\hsize=\expandafter\csname col\the\colcount\endcsname - % In order to keep entries from bumping into each other - % we will add a \leftskip of \multitablecolspace to all columns after - % the first one. - % If a template has been used, we will add \multitablecolspace - % to the width of each template entry. - % If user has set preamble in terms of percent of \hsize - % we will use that dimension as the width of the column, and - % the \leftskip will keep entries from bumping into each other. - % Table will start at left margin and final column will justify at - % right margin. -\ifnum\colcount=1 -\else - \ifsetpercent - \else - % If user has set preamble in terms of percent of \hsize - % we will advance \hsize by \multitablecolspace - \advance\hsize by \multitablecolspace - \fi - % In either case we will make \leftskip=\multitablecolspace: -\leftskip=\multitablecolspace -\fi -\noindent##}\cr% - % \everycr will reset column counter, \colcount, at the end of - % each line. Every column entry will cause \colcount to advance by one. - % The table preamble - % looks at the current \colcount to find the correct column width. -\global\everycr{\noalign{% -\filbreak%% keeps underfull box messages off when table breaks over pages. -\global\colcount=0\relax}} -} -\def\setmultitablespacing{% test to see if user has set \multitablelinespace. -% If so, do nothing. If not, give it an appropriate dimension based on -% current baselineskip. -\setbox0=\vbox{Xy} -\ifdim\multitablelinespace=0pt -%% strut to put in table in case some entry doesn't have descenders, -%% to keep lines equally spaced -\gdef\multistrut{\vrule height\ht0 depth\dp0 width0pt\relax} -%% Test to see if parskip is larger than space between lines of -%% table. If not, do nothing. -%% If so, set to same dimension as multitablelinespace. -\else -\gdef\multistrut{\vrule height\multitablelinespace depth\dp0 -width0pt\relax} \fi -\ifdim\multitableparskip>\multitablelinespace -\global\multitableparskip=\multitablelinespace -\global\advance\multitableparskip-7pt %% to keep parskip somewhat smaller - %% than skip between lines in the table. -\fi% -\ifdim\multitableparskip=0pt -\global\multitableparskip=\multitablelinespace -\global\advance\multitableparskip-7pt %% to keep parskip somewhat smaller - %% than skip between lines in the table. -\fi} \message{indexing,} % Index generation facilities @@ -2005,15 +2573,17 @@ width0pt\relax} \fi % It automatically defines \fooindex such that % \fooindex ...rest of line... puts an entry in the index foo. % It also defines \fooindfile to be the number of the output channel for -% the file that accumulates this index. The file's extension is foo. +% the file that accumulates this index. The file's extension is foo. % The name of an index should be no more than 2 characters long % for the sake of vms. - -\def\newindex #1{ -\expandafter\newwrite \csname#1indfile\endcsname% Define number for output file -\openout \csname#1indfile\endcsname \jobname.#1 % Open the file -\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex -\noexpand\doindex {#1}} +% +\def\newindex#1{% + \iflinks + \expandafter\newwrite \csname#1indfile\endcsname + \openout \csname#1indfile\endcsname \jobname.#1 % Open the file + \fi + \expandafter\xdef\csname#1index\endcsname{% % Define @#1index + \noexpand\doindex{#1}} } % @defindex foo == \newindex{foo} @@ -2022,31 +2592,37 @@ width0pt\relax} \fi % Define @defcodeindex, like @defindex except put all entries in @code. -\def\newcodeindex #1{ -\expandafter\newwrite \csname#1indfile\endcsname% Define number for output file -\openout \csname#1indfile\endcsname \jobname.#1 % Open the file -\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex -\noexpand\docodeindex {#1}} +\def\newcodeindex#1{% + \iflinks + \expandafter\newwrite \csname#1indfile\endcsname + \openout \csname#1indfile\endcsname \jobname.#1 + \fi + \expandafter\xdef\csname#1index\endcsname{% + \noexpand\docodeindex{#1}} } \def\defcodeindex{\parsearg\newcodeindex} % @synindex foo bar makes index foo feed into index bar. % Do this instead of @defindex foo if you don't want it as a separate index. -\def\synindex #1 #2 {% -\expandafter\let\expandafter\synindexfoo\expandafter=\csname#2indfile\endcsname -\expandafter\let\csname#1indfile\endcsname=\synindexfoo -\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex -\noexpand\doindex {#2}}% +% The \closeout helps reduce unnecessary open files; the limit on the +% Acorn RISC OS is a mere 16 files. +\def\synindex#1 #2 {% + \expandafter\let\expandafter\synindexfoo\expandafter=\csname#2indfile\endcsname + \expandafter\closeout\csname#1indfile\endcsname + \expandafter\let\csname#1indfile\endcsname=\synindexfoo + \expandafter\xdef\csname#1index\endcsname{% define \xxxindex + \noexpand\doindex{#2}}% } % @syncodeindex foo bar similar, but put all entries made for index foo % inside @code. -\def\syncodeindex #1 #2 {% -\expandafter\let\expandafter\synindexfoo\expandafter=\csname#2indfile\endcsname -\expandafter\let\csname#1indfile\endcsname=\synindexfoo -\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex -\noexpand\docodeindex {#2}}% +\def\syncodeindex#1 #2 {% + \expandafter\let\expandafter\synindexfoo\expandafter=\csname#2indfile\endcsname + \expandafter\closeout\csname#1indfile\endcsname + \expandafter\let\csname#1indfile\endcsname=\synindexfoo + \expandafter\xdef\csname#1index\endcsname{% define \xxxindex + \noexpand\docodeindex{#2}}% } % Define \doindex, the driver for all \fooindex macros. @@ -2067,6 +2643,7 @@ width0pt\relax} \fi \def\singlecodeindexer #1{\doind{\indexname}{\code{#1}}} \def\indexdummies{% +\def\ { }% % Take care of the plain tex accent commands. \def\"{\realbackslash "}% \def\`{\realbackslash `}% @@ -2093,27 +2670,48 @@ width0pt\relax} \fi \def\L{\realbackslash L}% \def\ss{\realbackslash ss}% % Take care of texinfo commands likely to appear in an index entry. +% (Must be a way to avoid doing expansion at all, and thus not have to +% laboriously list every single command here.) +\def\@{@}% will be @@ when we switch to @ as escape char. +% Need these in case \tex is in effect and \{ is a \delimiter again. +% But can't use \lbracecmd and \rbracecmd because texindex assumes +% braces and backslashes are used only as delimiters. +\let\{ = \mylbrace +\let\} = \myrbrace \def\_{{\realbackslash _}}% \def\w{\realbackslash w }% \def\bf{\realbackslash bf }% -\def\rm{\realbackslash rm }% +%\def\rm{\realbackslash rm }% \def\sl{\realbackslash sl }% \def\sf{\realbackslash sf}% \def\tt{\realbackslash tt}% \def\gtr{\realbackslash gtr}% \def\less{\realbackslash less}% \def\hat{\realbackslash hat}% -\def\char{\realbackslash char}% \def\TeX{\realbackslash TeX}% \def\dots{\realbackslash dots }% -\def\copyright{\realbackslash copyright }% +\def\result{\realbackslash result}% +\def\equiv{\realbackslash equiv}% +\def\expansion{\realbackslash expansion}% +\def\print{\realbackslash print}% +\def\error{\realbackslash error}% +\def\point{\realbackslash point}% +\def\copyright{\realbackslash copyright}% \def\tclose##1{\realbackslash tclose {##1}}% \def\code##1{\realbackslash code {##1}}% +\def\uref##1{\realbackslash uref {##1}}% +\def\url##1{\realbackslash url {##1}}% +\def\env##1{\realbackslash env {##1}}% +\def\command##1{\realbackslash command {##1}}% +\def\option##1{\realbackslash option {##1}}% +\def\dotless##1{\realbackslash dotless {##1}}% \def\samp##1{\realbackslash samp {##1}}% -\def\t##1{\realbackslash r {##1}}% +\def\,##1{\realbackslash ,{##1}}% +\def\t##1{\realbackslash t {##1}}% \def\r##1{\realbackslash r {##1}}% \def\i##1{\realbackslash i {##1}}% \def\b##1{\realbackslash b {##1}}% +\def\sc##1{\realbackslash sc {##1}}% \def\cite##1{\realbackslash cite {##1}}% \def\key##1{\realbackslash key {##1}}% \def\file##1{\realbackslash file {##1}}% @@ -2121,7 +2719,16 @@ width0pt\relax} \fi \def\kbd##1{\realbackslash kbd {##1}}% \def\dfn##1{\realbackslash dfn {##1}}% \def\emph##1{\realbackslash emph {##1}}% +\def\acronym##1{\realbackslash acronym {##1}}% +% +% Handle some cases of @value -- where the variable name does not +% contain - or _, and the value does not contain any +% (non-fully-expandable) commands. +\let\value = \expandablevalue +% \unsepspaces +% Turn off macro expansion +\turnoffmacros } % If an index command is used in an @example environment, any spaces @@ -2138,6 +2745,7 @@ width0pt\relax} \fi \def\indexnofonts{% % Just ignore accents. +\let\,=\indexdummyfont \let\"=\indexdummyfont \let\`=\indexdummyfont \let\'=\indexdummyfont @@ -2150,6 +2758,7 @@ width0pt\relax} \fi \let\u=\indexdummyfont \let\v=\indexdummyfont \let\H=\indexdummyfont +\let\dotless=\indexdummyfont % Take care of the plain tex special European modified letters. \def\oe{oe}% \def\ae{ae}% @@ -2176,6 +2785,12 @@ width0pt\relax} \fi %\let\tt=\indexdummyfont \let\tclose=\indexdummyfont \let\code=\indexdummyfont +\let\url=\indexdummyfont +\let\uref=\indexdummyfont +\let\env=\indexdummyfont +\let\acronym=\indexdummyfont +\let\command=\indexdummyfont +\let\option=\indexdummyfont \let\file=\indexdummyfont \let\samp=\indexdummyfont \let\kbd=\indexdummyfont @@ -2183,6 +2798,7 @@ width0pt\relax} \fi \let\var=\indexdummyfont \let\TeX=\indexdummytex \let\dots=\indexdummydots +\def\@{@}% } % To define \realbackslash, we must make \ not be an escape. @@ -2190,57 +2806,102 @@ width0pt\relax} \fi % so we do not become unable to do a definition. {\catcode`\@=0 \catcode`\\=\other -@gdef@realbackslash{\}} + @gdef@realbackslash{\}} \let\indexbackslash=0 %overridden during \printindex. +\let\SETmarginindex=\relax % put index entries in margin (undocumented)? -\let\SETmarginindex=\relax %initialize! -% workhorse for all \fooindexes -% #1 is name of index, #2 is stuff to put there -\def\doind #1#2{% -% Put the index entry in the margin if desired. -\ifx\SETmarginindex\relax\else% -\insert\margin{\hbox{\vrule height8pt depth3pt width0pt #2}}% -\fi% -{\count10=\lastpenalty % -{\indexdummies % Must do this here, since \bf, etc expand at this stage -\escapechar=`\\% -{\let\folio=0% Expand all macros now EXCEPT \folio -\def\rawbackslashxx{\indexbackslash}% \indexbackslash isn't defined now -% so it will be output as is; and it will print as backslash in the indx. -% -% Now process the index-string once, with all font commands turned off, -% to get the string to sort the index by. -{\indexnofonts -\xdef\temp1{#2}% -}% -% Now produce the complete index entry. We process the index-string again, -% this time with font commands expanded, to get what to print in the index. -\edef\temp{% -\write \csname#1indfile\endcsname{% -\realbackslash entry {\temp1}{\folio}{#2}}}% -\temp }% -}\penalty\count10}} - -\def\dosubind #1#2#3{% -{\count10=\lastpenalty % -{\indexdummies % Must do this here, since \bf, etc expand at this stage -\escapechar=`\\% -{\let\folio=0% -\def\rawbackslashxx{\indexbackslash}% -% -% Now process the index-string once, with all font commands turned off, -% to get the string to sort the index by. -{\indexnofonts -\xdef\temp1{#2 #3}% -}% -% Now produce the complete index entry. We process the index-string again, -% this time with font commands expanded, to get what to print in the index. -\edef\temp{% -\write \csname#1indfile\endcsname{% -\realbackslash entry {\temp1}{\folio}{#2}{#3}}}% -\temp }% -}\penalty\count10}} +% For \ifx comparisons. +\def\emptymacro{\empty} + +% Most index entries go through here, but \dosubind is the general case. +% +\def\doind#1#2{\dosubind{#1}{#2}\empty} + +% Workhorse for all \fooindexes. +% #1 is name of index, #2 is stuff to put there, #3 is subentry -- +% \empty if called from \doind, as we usually are. The main exception +% is with defuns, which call us directly. +% +\def\dosubind#1#2#3{% + % Put the index entry in the margin if desired. + \ifx\SETmarginindex\relax\else + \insert\margin{\hbox{\vrule height8pt depth3pt width0pt #2}}% + \fi + {% + \count255=\lastpenalty + {% + \indexdummies % Must do this here, since \bf, etc expand at this stage + \escapechar=`\\ + {% + \let\folio = 0% We will expand all macros now EXCEPT \folio. + \def\rawbackslashxx{\indexbackslash}% \indexbackslash isn't defined now + % so it will be output as is; and it will print as backslash. + % + \def\thirdarg{#3}% + % + % If third arg is present, precede it with space in sort key. + \ifx\thirdarg\emptymacro + \let\subentry = \empty + \else + \def\subentry{ #3}% + \fi + % + % First process the index entry with all font commands turned + % off to get the string to sort by. + {\indexnofonts \xdef\indexsorttmp{#2\subentry}}% + % + % Now the real index entry with the fonts. + \toks0 = {#2}% + % + % If third (subentry) arg is present, add it to the index + % string. And include a space. + \ifx\thirdarg\emptymacro \else + \toks0 = \expandafter{\the\toks0 \space #3}% + \fi + % + % Set up the complete index entry, with both the sort key + % and the original text, including any font commands. We write + % three arguments to \entry to the .?? file, texindex reduces to + % two when writing the .??s sorted result. + \edef\temp{% + \write\csname#1indfile\endcsname{% + \realbackslash entry{\indexsorttmp}{\folio}{\the\toks0}}% + }% + % + % If a skip is the last thing on the list now, preserve it + % by backing up by \lastskip, doing the \write, then inserting + % the skip again. Otherwise, the whatsit generated by the + % \write will make \lastskip zero. The result is that sequences + % like this: + % @end defun + % @tindex whatever + % @defun ... + % will have extra space inserted, because the \medbreak in the + % start of the @defun won't see the skip inserted by the @end of + % the previous defun. + % + % But don't do any of this if we're not in vertical mode. We + % don't want to do a \vskip and prematurely end a paragraph. + % + % Avoid page breaks due to these extra skips, too. + % + \iflinks + \ifvmode + \skip0 = \lastskip + \ifdim\lastskip = 0pt \else \nobreak\vskip-\lastskip \fi + \fi + % + \temp % do the write + % + % + \ifvmode \ifdim\skip0 = 0pt \else \nobreak\vskip\skip0 \fi \fi + \fi + }% + }% + \penalty\count255 + }% +} % The index entry written in the file actually looks like % \entry {sortstring}{page}{topic} @@ -2274,78 +2935,85 @@ width0pt\relax} \fi % Define the macros used in formatting output of the sorted index material. -% This is what you call to cause a particular index to get printed. -% Write -% @unnumbered Function Index -% @printindex fn - +% @printindex causes a particular index (the ??s file) to get printed. +% It does not print any chapter heading (usually an @unnumbered). +% \def\printindex{\parsearg\doprintindex} - -\def\doprintindex#1{% - \tex - \dobreak \chapheadingskip {10000} - \catcode`\%=\other\catcode`\&=\other\catcode`\#=\other - \catcode`\$=\other - \catcode`\~=\other - \indexbreaks +\def\doprintindex#1{\begingroup + \dobreak \chapheadingskip{10000}% % - % The following don't help, since the chars were translated - % when the raw index was written, and their fonts were discarded - % due to \indexnofonts. - %\catcode`\"=\active - %\catcode`\^=\active - %\catcode`\_=\active - %\catcode`\|=\active - %\catcode`\<=\active - %\catcode`\>=\active - % % - \def\indexbackslash{\rawbackslashxx} - \indexfonts\rm \tolerance=9500 \advance\baselineskip -1pt - \begindoublecolumns + \smallfonts \rm + \tolerance = 9500 + \indexbreaks % % See if the index file exists and is nonempty. + % Change catcode of @ here so that if the index file contains + % \initial {@} + % as its first line, TeX doesn't complain about mismatched braces + % (because it thinks @} is a control sequence). + \catcode`\@ = 11 \openin 1 \jobname.#1s \ifeof 1 % \enddoublecolumns gets confused if there is no text in the index, % and it loses the chapter title and the aux file entries for the % index. The easiest way to prevent this problem is to make sure % there is some text. - (Index is nonexistent) - \else + \putwordIndexNonexistent + \else % % If the index file exists but is empty, then \openin leaves \ifeof % false. We have to make TeX try to read something from the file, so % it can discover if there is anything in it. \read 1 to \temp \ifeof 1 - (Index is empty) + \putwordIndexIsEmpty \else + % Index files are almost Texinfo source, but we use \ as the escape + % character. It would be better to use @, but that's too big a change + % to make right now. + \def\indexbackslash{\rawbackslashxx}% + \catcode`\\ = 0 + \escapechar = `\\ + \begindoublecolumns \input \jobname.#1s + \enddoublecolumns \fi \fi \closein 1 - \enddoublecolumns - \Etex -} +\endgroup} % These macros are used by the sorted index file itself. % Change them to control the appearance of the index. -% Same as \bigskipamount except no shrink. -% \balancecolumns gets confused if there is any shrink. -\newskip\initialskipamount \initialskipamount 12pt plus4pt - -\def\initial #1{% -{\let\tentt=\sectt \let\tt=\sectt \let\sf=\sectt -\ifdim\lastskip<\initialskipamount -\removelastskip \penalty-200 \vskip \initialskipamount\fi -\line{\secbf#1\hfill}\kern 2pt\penalty10000}} +\def\initial#1{{% + % Some minor font changes for the special characters. + \let\tentt=\sectt \let\tt=\sectt \let\sf=\sectt + % + % Remove any glue we may have, we'll be inserting our own. + \removelastskip + % + % We like breaks before the index initials, so insert a bonus. + \penalty -300 + % + % Typeset the initial. Making this add up to a whole number of + % baselineskips increases the chance of the dots lining up from column + % to column. It still won't often be perfect, because of the stretch + % we need before each entry, but it's better. + % + % No shrink because it confuses \balancecolumns. + \vskip 1.67\baselineskip plus .5\baselineskip + \leftline{\secbf #1}% + \vskip .33\baselineskip plus .1\baselineskip + % + % Do our best not to break after the initial. + \nobreak +}} % This typesets a paragraph consisting of #1, dot leaders, and then #2 % flush to the right margin. It is used for index and table of contents % entries. The paragraph is indented by \leftskip. % -\def\entry #1#2{\begingroup +\def\entry#1#2{\begingroup % % Start a new paragraph if necessary, so our assignments below can't % affect previous text. @@ -2368,12 +3036,15 @@ width0pt\relax} \fi % % \hangafter is reset to 1 (which is the value we want) at the start % of each paragraph, so we need not do anything with that. - \hangindent=2em + \hangindent = 2em % % When the entry text needs to be broken, just fill out the first line % with blank space. \rightskip = 0pt plus1fil % + % A bit of stretch before each entry for the benefit of balancing columns. + \vskip 0pt plus1pt + % % Start a ``paragraph'' for the index entry so the line breaking % parameters we've set above will have an effect. \noindent @@ -2398,7 +3069,11 @@ width0pt\relax} \fi % The `\ ' here is removed by the implicit \unskip that TeX does as % part of (the primitive) \par. Without it, a spurious underfull % \hbox ensues. - \ #2% The page number ends the paragraph. + \ifpdf + \pdfgettoks#2.\ \the\toksA % The page number ends the paragraph. + \else + \ #2% The page number ends the paragraph. + \fi \fi% \par \endgroup} @@ -2417,34 +3092,51 @@ width0pt\relax} \fi \noindent\hskip\secondaryindent\hbox{#1}\indexdotfill #2\par }} -%% Define two-column mode, which is used in indexes. -%% Adapted from the TeXbook, page 416. -\catcode `\@=11 +% Define two-column mode, which we use to typeset indexes. +% Adapted from the TeXbook, page 416, which is to say, +% the manmac.tex format used to print the TeXbook itself. +\catcode`\@=11 \newbox\partialpage - \newdimen\doublecolumnhsize -\def\begindoublecolumns{\begingroup +\def\begindoublecolumns{\begingroup % ended by \enddoublecolumns % Grab any single-column material above us. - \output = {\global\setbox\partialpage - =\vbox{\unvbox255\kern -\topskip \kern \baselineskip}}% - \eject + \output = {% + % + % Here is a possibility not foreseen in manmac: if we accumulate a + % whole lot of material, we might end up calling this \output + % routine twice in a row (see the doublecol-lose test, which is + % essentially a couple of indexes with @setchapternewpage off). In + % that case we just ship out what is in \partialpage with the normal + % output routine. Generally, \partialpage will be empty when this + % runs and this will be a no-op. See the indexspread.tex test case. + \ifvoid\partialpage \else + \onepageout{\pagecontents\partialpage}% + \fi + % + \global\setbox\partialpage = \vbox{% + % Unvbox the main output page. + \unvbox\PAGE + \kern-\topskip \kern\baselineskip + }% + }% + \eject % run that output routine to set \partialpage % - % Now switch to the double-column output routine. - \output={\doublecolumnout}% + % Use the double-column output routine for subsequent pages. + \output = {\doublecolumnout}% % % Change the page size parameters. We could do this once outside this % routine, in each of @smallbook, @afourpaper, and the default 8.5x11 % format, but then we repeat the same computation. Repeating a couple % of assignments once per index is clearly meaningless for the - % execution time, so we may as well do it once. + % execution time, so we may as well do it in one place. % % First we halve the line length, less a little for the gutter between % the columns. We compute the gutter based on the line length, so it % changes automatically with the paper format. The magic constant - % below is chosen so that the gutter has the same value (well, +- < - % 1pt) as it did when we hard-coded it. + % below is chosen so that the gutter has the same value (well, +-<1pt) + % as it did when we hard-coded it. % % We put the result in a separate register, \doublecolumhsize, so we % can restore it in \pagesofar, after \hsize itself has (potentially) @@ -2457,109 +3149,140 @@ width0pt\relax} \fi % % Double the \vsize as well. (We don't need a separate register here, % since nobody clobbers \vsize.) + \advance\vsize by -\ht\partialpage \vsize = 2\vsize - \doublecolumnpagegoal } -\def\enddoublecolumns{\eject \endgroup \pagegoal=\vsize \unvbox\partialpage} - -\def\doublecolumnsplit{\splittopskip=\topskip \splitmaxdepth=\maxdepth - \global\dimen@=\pageheight \global\advance\dimen@ by-\ht\partialpage - \global\setbox1=\vsplit255 to\dimen@ \global\setbox0=\vbox{\unvbox1} - \global\setbox3=\vsplit255 to\dimen@ \global\setbox2=\vbox{\unvbox3} - \ifdim\ht0>\dimen@ \setbox255=\vbox{\unvbox0\unvbox2} \global\setbox255=\copy5 \fi - \ifdim\ht2>\dimen@ \setbox255=\vbox{\unvbox0\unvbox2} \global\setbox255=\copy5 \fi +% The double-column output routine for all double-column pages except +% the last. +% +\def\doublecolumnout{% + \splittopskip=\topskip \splitmaxdepth=\maxdepth + % Get the available space for the double columns -- the normal + % (undoubled) page height minus any material left over from the + % previous page. + \dimen@ = \vsize + \divide\dimen@ by 2 + % + % box0 will be the left-hand column, box2 the right. + \setbox0=\vsplit255 to\dimen@ \setbox2=\vsplit255 to\dimen@ + \onepageout\pagesofar + \unvbox255 + \penalty\outputpenalty } -\def\doublecolumnpagegoal{% - \dimen@=\vsize \advance\dimen@ by-2\ht\partialpage \global\pagegoal=\dimen@ +\def\pagesofar{% + % Re-output the contents of the output page -- any previous material, + % followed by the two boxes we just split, in box0 and box2. + \unvbox\partialpage + % + \hsize = \doublecolumnhsize + \wd0=\hsize \wd2=\hsize + \hbox to\pagewidth{\box0\hfil\box2}% } -\def\pagesofar{\unvbox\partialpage % - \hsize=\doublecolumnhsize % have to restore this since output routine - \wd0=\hsize \wd2=\hsize \hbox to\pagewidth{\box0\hfil\box2}} -\def\doublecolumnout{% - \setbox5=\copy255 - {\vbadness=10000 \doublecolumnsplit} - \ifvbox255 - \setbox0=\vtop to\dimen@{\unvbox0} - \setbox2=\vtop to\dimen@{\unvbox2} - \onepageout\pagesofar \unvbox255 \penalty\outputpenalty - \else - \setbox0=\vbox{\unvbox5} - \ifvbox0 - \dimen@=\ht0 \advance\dimen@ by\topskip \advance\dimen@ by-\baselineskip - \divide\dimen@ by2 \splittopskip=\topskip \splitmaxdepth=\maxdepth - {\vbadness=10000 - \loop \global\setbox5=\copy0 - \setbox1=\vsplit5 to\dimen@ - \setbox3=\vsplit5 to\dimen@ - \ifvbox5 \global\advance\dimen@ by1pt \repeat - \setbox0=\vbox to\dimen@{\unvbox1} - \setbox2=\vbox to\dimen@{\unvbox3} - \global\setbox\partialpage=\vbox{\pagesofar} - \doublecolumnpagegoal - } - \fi - \fi +\def\enddoublecolumns{% + \output = {% + % Split the last of the double-column material. Leave it on the + % current page, no automatic page break. + \balancecolumns + % + % If we end up splitting too much material for the current page, + % though, there will be another page break right after this \output + % invocation ends. Having called \balancecolumns once, we do not + % want to call it again. Therefore, reset \output to its normal + % definition right away. (We hope \balancecolumns will never be + % called on to balance too much material, but if it is, this makes + % the output somewhat more palatable.) + \global\output = {\onepageout{\pagecontents\PAGE}}% + }% + \eject + \endgroup % started in \begindoublecolumns + % + % \pagegoal was set to the doubled \vsize above, since we restarted + % the current page. We're now back to normal single-column + % typesetting, so reset \pagegoal to the normal \vsize (after the + % \endgroup where \vsize got restored). + \pagegoal = \vsize +} +\def\balancecolumns{% + % Called at the end of the double column material. + \setbox0 = \vbox{\unvbox255}% like \box255 but more efficient, see p.120. + \dimen@ = \ht0 + \advance\dimen@ by \topskip + \advance\dimen@ by-\baselineskip + \divide\dimen@ by 2 % target to split to + %debug\message{final 2-column material height=\the\ht0, target=\the\dimen@.}% + \splittopskip = \topskip + % Loop until we get a decent breakpoint. + {% + \vbadness = 10000 + \loop + \global\setbox3 = \copy0 + \global\setbox1 = \vsplit3 to \dimen@ + \ifdim\ht3>\dimen@ + \global\advance\dimen@ by 1pt + \repeat + }% + %debug\message{split to \the\dimen@, column heights: \the\ht1, \the\ht3.}% + \setbox0=\vbox to\dimen@{\unvbox1}% + \setbox2=\vbox to\dimen@{\unvbox3}% + % + \pagesofar } +\catcode`\@ = \other + -\catcode `\@=\other \message{sectioning,} -% Define chapters, sections, etc. +% Chapters, sections, etc. -\newcount \chapno -\newcount \secno \secno=0 -\newcount \subsecno \subsecno=0 -\newcount \subsubsecno \subsubsecno=0 +\newcount\chapno +\newcount\secno \secno=0 +\newcount\subsecno \subsecno=0 +\newcount\subsubsecno \subsubsecno=0 % This counter is funny since it counts through charcodes of letters A, B, ... -\newcount \appendixno \appendixno = `\@ -\def\appendixletter{\char\the\appendixno} - -\newwrite \contentsfile -% This is called from \setfilename. -\def\opencontents{\openout \contentsfile = \jobname.toc} +\newcount\appendixno \appendixno = `\@ +% \def\appendixletter{\char\the\appendixno} +% We do the following for the sake of pdftex, which needs the actual +% letter in the expansion, not just typeset. +\def\appendixletter{% + \ifnum\appendixno=`A A% + \else\ifnum\appendixno=`B B% + \else\ifnum\appendixno=`C C% + \else\ifnum\appendixno=`D D% + \else\ifnum\appendixno=`E E% + \else\ifnum\appendixno=`F F% + \else\ifnum\appendixno=`G G% + \else\ifnum\appendixno=`H H% + \else\ifnum\appendixno=`I I% + \else\ifnum\appendixno=`J J% + \else\ifnum\appendixno=`K K% + \else\ifnum\appendixno=`L L% + \else\ifnum\appendixno=`M M% + \else\ifnum\appendixno=`N N% + \else\ifnum\appendixno=`O O% + \else\ifnum\appendixno=`P P% + \else\ifnum\appendixno=`Q Q% + \else\ifnum\appendixno=`R R% + \else\ifnum\appendixno=`S S% + \else\ifnum\appendixno=`T T% + \else\ifnum\appendixno=`U U% + \else\ifnum\appendixno=`V V% + \else\ifnum\appendixno=`W W% + \else\ifnum\appendixno=`X X% + \else\ifnum\appendixno=`Y Y% + \else\ifnum\appendixno=`Z Z% + % The \the is necessary, despite appearances, because \appendixletter is + % expanded while writing the .toc file. \char\appendixno is not + % expandable, thus it is written literally, thus all appendixes come out + % with the same letter (or @) in the toc without it. + \else\char\the\appendixno + \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi + \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi} % Each @chapter defines this as the name of the chapter. -% page headings and footings can use it. @section does likewise - -\def\thischapter{} \def\thissection{} -\def\seccheck#1{\if \pageno<0 % -\errmessage{@#1 not allowed after generating table of contents}\fi -% -} - -\def\chapternofonts{% -\let\rawbackslash=\relax% -\let\frenchspacing=\relax% -\def\result{\realbackslash result} -\def\equiv{\realbackslash equiv} -\def\expansion{\realbackslash expansion} -\def\print{\realbackslash print} -\def\TeX{\realbackslash TeX} -\def\dots{\realbackslash dots} -\def\copyright{\realbackslash copyright} -\def\tt{\realbackslash tt} -\def\bf{\realbackslash bf } -\def\w{\realbackslash w} -\def\less{\realbackslash less} -\def\gtr{\realbackslash gtr} -\def\hat{\realbackslash hat} -\def\char{\realbackslash char} -\def\tclose##1{\realbackslash tclose {##1}} -\def\code##1{\realbackslash code {##1}} -\def\samp##1{\realbackslash samp {##1}} -\def\r##1{\realbackslash r {##1}} -\def\b##1{\realbackslash b {##1}} -\def\key##1{\realbackslash key {##1}} -\def\file##1{\realbackslash file {##1}} -\def\kbd##1{\realbackslash kbd {##1}} -% These are redefined because @smartitalic wouldn't work inside xdef. -\def\i##1{\realbackslash i {##1}} -\def\cite##1{\realbackslash cite {##1}} -\def\var##1{\realbackslash var {##1}} -\def\emph##1{\realbackslash emph {##1}} -\def\dfn##1{\realbackslash dfn {##1}} -} +% page headings and footings can use it. @section does likewise. +\def\thischapter{} +\def\thissection{} \newcount\absseclevel % used to calculate proper heading level \newcount\secbase\secbase=0 % @raise/lowersections modify this count @@ -2631,57 +3354,59 @@ width0pt\relax} \fi \fi } - +% @chapter, @appendix, @unnumbered. \def\thischaptername{No Chapter Title} \outer\def\chapter{\parsearg\chapteryyy} \def\chapteryyy #1{\numhead0{#1}} % normally numhead0 calls chapterzzz -\def\chapterzzz #1{\seccheck{chapter}% +\def\chapterzzz #1{% \secno=0 \subsecno=0 \subsubsecno=0 -\global\advance \chapno by 1 \message{\putwordChapter \the\chapno}% +\global\advance \chapno by 1 \message{\putwordChapter\space \the\chapno}% \chapmacro {#1}{\the\chapno}% \gdef\thissection{#1}% \gdef\thischaptername{#1}% % We don't substitute the actual chapter name into \thischapter % because we don't want its macros evaluated now. \xdef\thischapter{\putwordChapter{} \the\chapno: \noexpand\thischaptername}% -{\chapternofonts% -\edef\temp{{\realbackslash chapentry {#1}{\the\chapno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\donoderef % +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash chapentry{\the\toks0}% + {\the\chapno}}}% +\temp +\donoderef \global\let\section = \numberedsec \global\let\subsection = \numberedsubsec \global\let\subsubsection = \numberedsubsubsec -}} +} \outer\def\appendix{\parsearg\appendixyyy} \def\appendixyyy #1{\apphead0{#1}} % normally apphead0 calls appendixzzz -\def\appendixzzz #1{\seccheck{appendix}% +\def\appendixzzz #1{% \secno=0 \subsecno=0 \subsubsecno=0 -\global\advance \appendixno by 1 \message{Appendix \appendixletter}% +\global\advance \appendixno by 1 +\message{\putwordAppendix\space \appendixletter}% \chapmacro {#1}{\putwordAppendix{} \appendixletter}% \gdef\thissection{#1}% \gdef\thischaptername{#1}% \xdef\thischapter{\putwordAppendix{} \appendixletter: \noexpand\thischaptername}% -{\chapternofonts% -\edef\temp{{\realbackslash chapentry - {#1}{\putwordAppendix{} \appendixletter}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\appendixnoderef % +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash chapentry{\the\toks0}% + {\putwordAppendix{} \appendixletter}}}% +\temp +\appendixnoderef \global\let\section = \appendixsec \global\let\subsection = \appendixsubsec \global\let\subsubsection = \appendixsubsubsec -}} +} % @centerchap is like @unnumbered, but the heading is centered. \outer\def\centerchap{\parsearg\centerchapyyy} \def\centerchapyyy #1{{\let\unnumbchapmacro=\centerchapmacro \unnumberedyyy{#1}}} +% @top is like @unnumbered. \outer\def\top{\parsearg\unnumberedyyy} + \outer\def\unnumbered{\parsearg\unnumberedyyy} \def\unnumberedyyy #1{\unnmhead0{#1}} % normally unnmhead0 calls unnumberedzzz -\def\unnumberedzzz #1{\seccheck{unnumbered}% +\def\unnumberedzzz #1{% \secno=0 \subsecno=0 \subsubsecno=0 % % This used to be simply \message{#1}, but TeX fully expands the @@ -2693,146 +3418,139 @@ width0pt\relax} \fi % Anyway, we don't want the fully-expanded definition of @cite to appear % as a result of the \message, we just want `@cite' itself. We use % \the to achieve this: TeX expands \the only once, -% simply yielding the contents of the . +% simply yielding the contents of . (We also do this for +% the toc entries.) \toks0 = {#1}\message{(\the\toks0)}% % \unnumbchapmacro {#1}% \gdef\thischapter{#1}\gdef\thissection{#1}% -{\chapternofonts% -\edef\temp{{\realbackslash unnumbchapentry {#1}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\unnumbnoderef % +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash unnumbchapentry{\the\toks0}}}% +\temp +\unnumbnoderef \global\let\section = \unnumberedsec \global\let\subsection = \unnumberedsubsec \global\let\subsubsection = \unnumberedsubsubsec -}} +} +% Sections. \outer\def\numberedsec{\parsearg\secyyy} \def\secyyy #1{\numhead1{#1}} % normally calls seczzz -\def\seczzz #1{\seccheck{section}% +\def\seczzz #1{% \subsecno=0 \subsubsecno=0 \global\advance \secno by 1 % \gdef\thissection{#1}\secheading {#1}{\the\chapno}{\the\secno}% -{\chapternofonts% -\edef\temp{{\realbackslash secentry % -{#1}{\the\chapno}{\the\secno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\donoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash secentry{\the\toks0}% + {\the\chapno}{\the\secno}}}% +\temp +\donoderef +\nobreak +} \outer\def\appendixsection{\parsearg\appendixsecyyy} \outer\def\appendixsec{\parsearg\appendixsecyyy} \def\appendixsecyyy #1{\apphead1{#1}} % normally calls appendixsectionzzz -\def\appendixsectionzzz #1{\seccheck{appendixsection}% +\def\appendixsectionzzz #1{% \subsecno=0 \subsubsecno=0 \global\advance \secno by 1 % \gdef\thissection{#1}\secheading {#1}{\appendixletter}{\the\secno}% -{\chapternofonts% -\edef\temp{{\realbackslash secentry % -{#1}{\appendixletter}{\the\secno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\appendixnoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash secentry{\the\toks0}% + {\appendixletter}{\the\secno}}}% +\temp +\appendixnoderef +\nobreak +} \outer\def\unnumberedsec{\parsearg\unnumberedsecyyy} \def\unnumberedsecyyy #1{\unnmhead1{#1}} % normally calls unnumberedseczzz -\def\unnumberedseczzz #1{\seccheck{unnumberedsec}% +\def\unnumberedseczzz #1{% \plainsecheading {#1}\gdef\thissection{#1}% -{\chapternofonts% -\edef\temp{{\realbackslash unnumbsecentry{#1}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\unnumbnoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash unnumbsecentry{\the\toks0}}}% +\temp +\unnumbnoderef +\nobreak +} +% Subsections. \outer\def\numberedsubsec{\parsearg\numberedsubsecyyy} \def\numberedsubsecyyy #1{\numhead2{#1}} % normally calls numberedsubseczzz -\def\numberedsubseczzz #1{\seccheck{subsection}% +\def\numberedsubseczzz #1{% \gdef\thissection{#1}\subsubsecno=0 \global\advance \subsecno by 1 % \subsecheading {#1}{\the\chapno}{\the\secno}{\the\subsecno}% -{\chapternofonts% -\edef\temp{{\realbackslash subsecentry % -{#1}{\the\chapno}{\the\secno}{\the\subsecno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\donoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash subsecentry{\the\toks0}% + {\the\chapno}{\the\secno}{\the\subsecno}}}% +\temp +\donoderef +\nobreak +} \outer\def\appendixsubsec{\parsearg\appendixsubsecyyy} \def\appendixsubsecyyy #1{\apphead2{#1}} % normally calls appendixsubseczzz -\def\appendixsubseczzz #1{\seccheck{appendixsubsec}% +\def\appendixsubseczzz #1{% \gdef\thissection{#1}\subsubsecno=0 \global\advance \subsecno by 1 % \subsecheading {#1}{\appendixletter}{\the\secno}{\the\subsecno}% -{\chapternofonts% -\edef\temp{{\realbackslash subsecentry % -{#1}{\appendixletter}{\the\secno}{\the\subsecno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\appendixnoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash subsecentry{\the\toks0}% + {\appendixletter}{\the\secno}{\the\subsecno}}}% +\temp +\appendixnoderef +\nobreak +} \outer\def\unnumberedsubsec{\parsearg\unnumberedsubsecyyy} \def\unnumberedsubsecyyy #1{\unnmhead2{#1}} %normally calls unnumberedsubseczzz -\def\unnumberedsubseczzz #1{\seccheck{unnumberedsubsec}% -\plainsecheading {#1}\gdef\thissection{#1}% -{\chapternofonts% -\edef\temp{{\realbackslash unnumbsubsecentry{#1}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\unnumbnoderef % -\penalty 10000 % -}} +\def\unnumberedsubseczzz #1{% +\plainsubsecheading {#1}\gdef\thissection{#1}% +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash unnumbsubsecentry% + {\the\toks0}}}% +\temp +\unnumbnoderef +\nobreak +} +% Subsubsections. \outer\def\numberedsubsubsec{\parsearg\numberedsubsubsecyyy} \def\numberedsubsubsecyyy #1{\numhead3{#1}} % normally numberedsubsubseczzz -\def\numberedsubsubseczzz #1{\seccheck{subsubsection}% +\def\numberedsubsubseczzz #1{% \gdef\thissection{#1}\global\advance \subsubsecno by 1 % \subsubsecheading {#1} {\the\chapno}{\the\secno}{\the\subsecno}{\the\subsubsecno}% -{\chapternofonts% -\edef\temp{{\realbackslash subsubsecentry % - {#1} - {\the\chapno}{\the\secno}{\the\subsecno}{\the\subsubsecno} - {\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\donoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash subsubsecentry{\the\toks0}% + {\the\chapno}{\the\secno}{\the\subsecno}{\the\subsubsecno}}}% +\temp +\donoderef +\nobreak +} \outer\def\appendixsubsubsec{\parsearg\appendixsubsubsecyyy} \def\appendixsubsubsecyyy #1{\apphead3{#1}} % normally appendixsubsubseczzz -\def\appendixsubsubseczzz #1{\seccheck{appendixsubsubsec}% +\def\appendixsubsubseczzz #1{% \gdef\thissection{#1}\global\advance \subsubsecno by 1 % \subsubsecheading {#1} {\appendixletter}{\the\secno}{\the\subsecno}{\the\subsubsecno}% -{\chapternofonts% -\edef\temp{{\realbackslash subsubsecentry{#1}% - {\appendixletter} - {\the\secno}{\the\subsecno}{\the\subsubsecno}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\appendixnoderef % -\penalty 10000 % -}} +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash subsubsecentry{\the\toks0}% + {\appendixletter}{\the\secno}{\the\subsecno}{\the\subsubsecno}}}% +\temp +\appendixnoderef +\nobreak +} \outer\def\unnumberedsubsubsec{\parsearg\unnumberedsubsubsecyyy} \def\unnumberedsubsubsecyyy #1{\unnmhead3{#1}} %normally unnumberedsubsubseczzz -\def\unnumberedsubsubseczzz #1{\seccheck{unnumberedsubsubsec}% -\plainsecheading {#1}\gdef\thissection{#1}% -{\chapternofonts% -\edef\temp{{\realbackslash unnumbsubsubsecentry{#1}{\noexpand\folio}}}% -\escapechar=`\\% -\write \contentsfile \temp % -\unnumbnoderef % -\penalty 10000 % -}} +\def\unnumberedsubsubseczzz #1{% +\plainsubsubsecheading {#1}\gdef\thissection{#1}% +\toks0 = {#1}% +\edef\temp{\noexpand\writetocentry{\realbackslash unnumbsubsubsecentry% + {\the\toks0}}}% +\temp +\unnumbnoderef +\nobreak +} % These are variants which are not "outer", so they can appear in @ifinfo. % Actually, they should now be obsolete; ordinary section commands should work. @@ -2861,12 +3579,11 @@ width0pt\relax} \fi % Define @majorheading, @heading and @subheading -% NOTE on use of \vbox for chapter headings, section headings, and -% such: -% 1) We use \vbox rather than the earlier \line to permit -% overlong headings to fold. -% 2) \hyphenpenalty is set to 10000 because hyphenation in a -% heading is obnoxious; this forbids it. +% NOTE on use of \vbox for chapter headings, section headings, and such: +% 1) We use \vbox rather than the earlier \line to permit +% overlong headings to fold. +% 2) \hyphenpenalty is set to 10000 because hyphenation in a +% heading is obnoxious; this forbids it. % 3) Likewise, headings look best if no \parindent is used, and % if justification is not attempted. Hence \raggedright. @@ -2884,11 +3601,10 @@ width0pt\relax} \fi \parindent=0pt\raggedright \rm #1\hfill}}\bigskip \par\penalty 200} -\def\heading{\parsearg\secheadingi} - -\def\subheading{\parsearg\subsecheadingi} - -\def\subsubheading{\parsearg\subsubsecheadingi} +% @heading, @subheading, @subsubheading. +\def\heading{\parsearg\plainsecheading} +\def\subheading{\parsearg\plainsubsecheading} +\def\subsubheading{\parsearg\plainsubsubsecheading} % These macros generate a chapter, section, etc. heading only % (including whitespace, linebreaking, etc. around it), @@ -2902,7 +3618,7 @@ width0pt\relax} \fi %%% Define plain chapter starts, and page on/off switching for it % Parameter controlling skip before chapter headings (if needed) -\newskip \chapheadingskip \chapheadingskip = 30pt plus 8pt minus 4pt +\newskip\chapheadingskip \def\chapbreak{\dobreak \chapheadingskip {-4000}} \def\chappager{\par\vfill\supereject} @@ -2910,16 +3626,19 @@ width0pt\relax} \fi \def\setchapternewpage #1 {\csname CHAPPAG#1\endcsname} -\def\CHAPPAGoff{ +\def\CHAPPAGoff{% +\global\let\contentsalignmacro = \chappager \global\let\pchapsepmacro=\chapbreak \global\let\pagealignmacro=\chappager} -\def\CHAPPAGon{ +\def\CHAPPAGon{% +\global\let\contentsalignmacro = \chappager \global\let\pchapsepmacro=\chappager \global\let\pagealignmacro=\chappager \global\def\HEADINGSon{\HEADINGSsingle}} \def\CHAPPAGodd{ +\global\let\contentsalignmacro = \chapoddpage \global\let\pchapsepmacro=\chapoddpage \global\let\pagealignmacro=\chapoddpage \global\def\HEADINGSon{\HEADINGSdouble}} @@ -2931,37 +3650,42 @@ width0pt\relax} \fi \global\let\unnumbchapmacro=\unnchfplain \global\let\centerchapmacro=\centerchfplain} -\def\chfplain #1#2{% +% Plain chapter opening. +% #1 is the text, #2 the chapter number or empty if unnumbered. +\def\chfplain#1#2{% \pchapsepmacro {% - \chapfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt\raggedright - \rm #2\enspace #1}% + \chapfonts \rm + \def\chapnum{#2}% + \setbox0 = \hbox{#2\ifx\chapnum\empty\else\enspace\fi}% + \vbox{\hyphenpenalty=10000 \tolerance=5000 \parindent=0pt \raggedright + \hangindent = \wd0 \centerparametersmaybe + \unhbox0 #1\par}% }% - \bigskip - \penalty5000 + \nobreak\bigskip % no page break after a chapter title + \nobreak } -\def\unnchfplain #1{% -\pchapsepmacro % -{\chapfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt\raggedright - \rm #1\hfill}}\bigskip \par\penalty 10000 % -} +% Plain opening for unnumbered. +\def\unnchfplain#1{\chfplain{#1}{}} -\def\centerchfplain #1{% -\pchapsepmacro % -{\chapfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt - {\rm #1}\hfill}}\bigskip \par\penalty 10000 % -} +% @centerchap -- centered and unnumbered. +\let\centerparametersmaybe = \relax +\def\centerchfplain#1{{% + \def\centerparametersmaybe{% + \advance\rightskip by 3\rightskip + \leftskip = \rightskip + \parfillskip = 0pt + }% + \chfplain{#1}{}% +}} \CHAPFplain % The default \def\unnchfopen #1{% \chapoddpage {\chapfonts \vbox{\hyphenpenalty=10000\tolerance=5000 \parindent=0pt\raggedright - \rm #1\hfill}}\bigskip \par\penalty 10000 % + \rm #1\hfill}}\bigskip \par\nobreak } \def\chfopen #1#2{\chapoddpage {\chapfonts @@ -2972,7 +3696,7 @@ width0pt\relax} \fi \def\centerchfopen #1{% \chapoddpage {\chapfonts \vbox{\hyphenpenalty=10000\tolerance=5000 \parindent=0pt - \hfill {\rm #1}\hfill}}\bigskip \par\penalty 10000 % + \hfill {\rm #1}\hfill}}\bigskip \par\nobreak } \def\CHAPFopen{ @@ -2980,87 +3704,122 @@ width0pt\relax} \fi \global\let\unnumbchapmacro=\unnchfopen \global\let\centerchapmacro=\centerchfopen} -% Parameter controlling skip before section headings. -\newskip \subsecheadingskip \subsecheadingskip = 17pt plus 8pt minus 4pt +% Section titles. +\newskip\secheadingskip +\def\secheadingbreak{\dobreak \secheadingskip {-1000}} +\def\secheading#1#2#3{\sectionheading{sec}{#2.#3}{#1}} +\def\plainsecheading#1{\sectionheading{sec}{}{#1}} + +% Subsection titles. +\newskip \subsecheadingskip \def\subsecheadingbreak{\dobreak \subsecheadingskip {-500}} +\def\subsecheading#1#2#3#4{\sectionheading{subsec}{#2.#3.#4}{#1}} +\def\plainsubsecheading#1{\sectionheading{subsec}{}{#1}} -\newskip \secheadingskip \secheadingskip = 21pt plus 8pt minus 4pt -\def\secheadingbreak{\dobreak \secheadingskip {-1000}} +% Subsubsection titles. +\let\subsubsecheadingskip = \subsecheadingskip +\let\subsubsecheadingbreak = \subsecheadingbreak +\def\subsubsecheading#1#2#3#4#5{\sectionheading{subsubsec}{#2.#3.#4.#5}{#1}} +\def\plainsubsubsecheading#1{\sectionheading{subsubsec}{}{#1}} -% @paragraphindent is defined for the Info formatting commands only. -\let\paragraphindent=\comment - -% Section fonts are the base font at magstep2, which produces -% a size a bit more than 14 points in the default situation. - -\def\secheading #1#2#3{\secheadingi {#2.#3\enspace #1}} -\def\plainsecheading #1{\secheadingi {#1}} -\def\secheadingi #1{{\advance \secheadingskip by \parskip % -\secheadingbreak}% -{\secfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt\raggedright - \rm #1\hfill}}% -\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000 } - - -% Subsection fonts are the base font at magstep1, -% which produces a size of 12 points. - -\def\subsecheading #1#2#3#4{\subsecheadingi {#2.#3.#4\enspace #1}} -\def\subsecheadingi #1{{\advance \subsecheadingskip by \parskip % -\subsecheadingbreak}% -{\subsecfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt\raggedright - \rm #1\hfill}}% -\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000 } - -\def\subsubsecfonts{\subsecfonts} % Maybe this should change: - % Perhaps make sssec fonts scaled - % magstep half -\def\subsubsecheading #1#2#3#4#5{\subsubsecheadingi {#2.#3.#4.#5\enspace #1}} -\def\subsubsecheadingi #1{{\advance \subsecheadingskip by \parskip % -\subsecheadingbreak}% -{\subsubsecfonts \vbox{\hyphenpenalty=10000\tolerance=5000 - \parindent=0pt\raggedright - \rm #1\hfill}}% -\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000} + +% Print any size section title. +% +% #1 is the section type (sec/subsec/subsubsec), #2 is the section +% number (maybe empty), #3 the text. +\def\sectionheading#1#2#3{% + {% + \expandafter\advance\csname #1headingskip\endcsname by \parskip + \csname #1headingbreak\endcsname + }% + {% + % Switch to the right set of fonts. + \csname #1fonts\endcsname \rm + % + % Only insert the separating space if we have a section number. + \def\secnum{#2}% + \setbox0 = \hbox{#2\ifx\secnum\empty\else\enspace\fi}% + % + \vbox{\hyphenpenalty=10000 \tolerance=5000 \parindent=0pt \raggedright + \hangindent = \wd0 % zero if no section number + \unhbox0 #3}% + }% + \ifdim\parskip<10pt \nobreak\kern10pt\nobreak\kern-\parskip\fi \nobreak +} -\message{toc printing,} +\message{toc,} +% Table of contents. +\newwrite\tocfile -% Finish up the main text and prepare to read what we've written -% to \contentsfile. +% Write an entry to the toc file, opening it if necessary. +% Called from @chapter, etc. We supply {\folio} at the end of the +% argument, which will end up as the last argument to the \...entry macro. +% +% We open the .toc file here instead of at @setfilename or any other +% given time so that @contents can be put in the document anywhere. +% +\newif\iftocfileopened +\def\writetocentry#1{% + \iftocfileopened\else + \immediate\openout\tocfile = \jobname.toc + \global\tocfileopenedtrue + \fi + \iflinks \write\tocfile{#1{\folio}}\fi +} \newskip\contentsrightmargin \contentsrightmargin=1in +\newcount\savepageno +\newcount\lastnegativepageno \lastnegativepageno = -1 + +% Finish up the main text and prepare to read what we've written +% to \tocfile. +% \def\startcontents#1{% - \pagealignmacro - \immediate\closeout \contentsfile - \ifnum \pageno>0 - \pageno = -1 % Request roman numbered pages. - \fi + % If @setchapternewpage on, and @headings double, the contents should + % start on an odd page, unlike chapters. Thus, we maintain + % \contentsalignmacro in parallel with \pagealignmacro. + % From: Torbjorn Granlund + \contentsalignmacro + \immediate\closeout\tocfile + % % Don't need to put `Contents' or `Short Contents' in the headline. % It is abundantly clear what they are. \unnumbchapmacro{#1}\def\thischapter{}% - \begingroup % Set up to handle contents files properly. + \savepageno = \pageno + \begingroup % Set up to handle contents files properly. \catcode`\\=0 \catcode`\{=1 \catcode`\}=2 \catcode`\@=11 - \catcode`\^=7 % to see ^^e4 as \"a etc. juha@piuha.ydi.vtt.fi + % We can't do this, because then an actual ^ in a section + % title fails, e.g., @chapter ^ -- exponentiation. --karl, 9jul97. + %\catcode`\^=7 % to see ^^e4 as \"a etc. juha@piuha.ydi.vtt.fi \raggedbottom % Worry more about breakpoints than the bottom. \advance\hsize by -\contentsrightmargin % Don't use the full line length. + % + % Roman numerals for page numbers. + \ifnum \pageno>0 \pageno = \lastnegativepageno \fi } % Normal (long) toc. -\outer\def\contents{% - \startcontents{\putwordTableofContents}% - \input \jobname.toc +\def\contents{% + \startcontents{\putwordTOC}% + \openin 1 \jobname.toc + \ifeof 1 \else + \closein 1 + \input \jobname.toc + \fi + \vfill \eject + \contentsalignmacro % in case @setchapternewpage odd is in effect + \pdfmakeoutlines \endgroup - \vfill \eject + \lastnegativepageno = \pageno + \pageno = \savepageno } % And just the chapters. -\outer\def\summarycontents{% - \startcontents{\putwordShortContents}% +\def\summarycontents{% + \startcontents{\putwordShortTOC}% % \let\chapentry = \shortchapentry \let\unnumbchapentry = \shortunnumberedentry @@ -3068,6 +3827,7 @@ width0pt\relax} \fi \secfonts \let\rm=\shortcontrm \let\bf=\shortcontbf \let\sl=\shortcontsl \rm + \hyphenpenalty = 10000 \advance\baselineskip by 1pt % Open it up a little. \def\secentry ##1##2##3##4{} \def\unnumbsecentry ##1##2{} @@ -3075,12 +3835,23 @@ width0pt\relax} \fi \def\unnumbsubsecentry ##1##2{} \def\subsubsecentry ##1##2##3##4##5##6{} \def\unnumbsubsubsecentry ##1##2{} - \input \jobname.toc + \openin 1 \jobname.toc + \ifeof 1 \else + \closein 1 + \input \jobname.toc + \fi + \vfill \eject + \contentsalignmacro % in case @setchapternewpage odd is in effect \endgroup - \vfill \eject + \lastnegativepageno = \pageno + \pageno = \savepageno } \let\shortcontents = \summarycontents +\ifpdf + \pdfcatalog{/PageMode /UseOutlines}% +\fi + % These macros generate individual entries in the table of contents. % The first argument is the chapter or section name. % The last argument is the page number. @@ -3091,7 +3862,7 @@ width0pt\relax} \fi % See comments in \dochapentry re vbox and related settings \def\shortchapentry#1#2#3{% - \tocentry{\shortchaplabel{#2}\labelspace #1}{\doshortpageno{#3}}% + \tocentry{\shortchaplabel{#2}\labelspace #1}{\doshortpageno\bgroup#3\egroup}% } % Typeset the label for a chapter or appendix for the short contents. @@ -3099,10 +3870,14 @@ width0pt\relax} \fi % We could simplify the code here by writing out an \appendixentry % command in the toc file for appendices, instead of using \chapentry % for both, but it doesn't seem worth it. -\setbox0 = \hbox{\shortcontrm \putwordAppendix } -\newdimen\shortappendixwidth \shortappendixwidth = \wd0 - +% +\newdimen\shortappendixwidth +% \def\shortchaplabel#1{% + % Compute width of word "Appendix", may change with language. + \setbox0 = \hbox{\shortcontrm \putwordAppendix}% + \shortappendixwidth = \wd0 + % % We typeset #1 in a box of constant width, regardless of the text of % #1, so the chapter titles will come out aligned. \setbox0 = \hbox{#1}% @@ -3111,13 +3886,13 @@ width0pt\relax} \fi % This space should be plenty, since a single number is .5em, and the % widest letter (M) is 1em, at least in the Computer Modern fonts. % (This space doesn't include the extra space that gets added after - % the label; that gets put in in \shortchapentry above.) + % the label; that gets put in by \shortchapentry above.) \advance\dimen0 by 1.1em \hbox to \dimen0{#1\hfil}% } \def\unnumbchapentry#1#2{\dochapentry{#1}{#2}} -\def\shortunnumberedentry#1#2{\tocentry{#1}{\doshortpageno{#2}}} +\def\shortunnumberedentry#1#2{\tocentry{#1}{\doshortpageno\bgroup#2\egroup}} % Sections. \def\secentry#1#2#3#4{\dosecentry{#2.#3\labelspace#1}{#4}} @@ -3132,48 +3907,48 @@ width0pt\relax} \fi \dosubsubsecentry{#2.#3.#4.#5\labelspace#1}{#6}} \def\unnumbsubsubsecentry#1#2{\dosubsubsecentry{#1}{#2}} - % This parameter controls the indentation of the various levels. \newdimen\tocindent \tocindent = 3pc % Now for the actual typesetting. In all these, #1 is the text and #2 is the % page number. % -% If the toc has to be broken over pages, we would want to be at chapters +% If the toc has to be broken over pages, we want it to be at chapters % if at all possible; hence the \penalty. \def\dochapentry#1#2{% - \penalty-300 \vskip\baselineskip + \penalty-300 \vskip1\baselineskip plus.33\baselineskip minus.25\baselineskip \begingroup \chapentryfonts - \tocentry{#1}{\dopageno{#2}}% + \tocentry{#1}{\dopageno\bgroup#2\egroup}% \endgroup - \nobreak\vskip .25\baselineskip + \nobreak\vskip .25\baselineskip plus.1\baselineskip } \def\dosecentry#1#2{\begingroup \secentryfonts \leftskip=\tocindent - \tocentry{#1}{\dopageno{#2}}% + \tocentry{#1}{\dopageno\bgroup#2\egroup}% \endgroup} \def\dosubsecentry#1#2{\begingroup \subsecentryfonts \leftskip=2\tocindent - \tocentry{#1}{\dopageno{#2}}% + \tocentry{#1}{\dopageno\bgroup#2\egroup}% \endgroup} \def\dosubsubsecentry#1#2{\begingroup \subsubsecentryfonts \leftskip=3\tocindent - \tocentry{#1}{\dopageno{#2}}% + \tocentry{#1}{\dopageno\bgroup#2\egroup}% \endgroup} % Final typesetting of a toc entry; we use the same \entry macro as for % the index entries, but we want to suppress hyphenation here. (We % can't do that in the \entry macro, since index entries might consist % of hyphenated-identifiers-that-do-not-fit-on-a-line-and-nothing-else.) -% -% \turnoffactive is for the sake of @" used for umlauts. \def\tocentry#1#2{\begingroup - \hyphenpenalty = 10000 - \entry{\turnoffactive #1}{\turnoffactive #2}% + \vskip 0pt plus1pt % allow a little stretch for the sake of nice page breaks + % Do not use \turnoffactive in these arguments. Since the toc is + % typeset in cmr, so characters such as _ would come out wrong; we + % have to do the usual translation tricks. + \entry{#1}{#2}% \endgroup} % Space between chapter (or whatever) number and the title. @@ -3189,6 +3964,7 @@ width0pt\relax} \fi \message{environments,} +% @foo ... @end foo. % Since these characters are used in examples, it should be an even number of % \tt widths. Each \tt character is 1en, so two makes it 1em. @@ -3197,8 +3973,6 @@ width0pt\relax} \fi \newbox\pushcharbox \newbox\bullbox \newbox\equivbox \newbox\errorbox -\let\ptexequiv = \equiv - %{\tentt %\global\setbox\dblarrowbox = \hbox to 1em{\hfil$\Rightarrow$\hfil} %\global\setbox\longdblarrowbox = \hbox to 1em{\hfil$\mapsto$\hfil} @@ -3209,12 +3983,11 @@ width0pt\relax} \fi % depth .1ex\hfil} %} +% @point{}, @result{}, @expansion{}, @print{}, @equiv{}. \def\point{$\star$} - \def\result{\leavevmode\raise.15ex\hbox to 1em{\hfil$\Rightarrow$\hfil}} \def\expansion{\leavevmode\raise.1ex\hbox to 1em{\hfil$\mapsto$\hfil}} \def\print{\leavevmode\lower.1ex\hbox to 1em{\hfil$\dashv$\hfil}} - \def\equiv{\leavevmode\lower.1ex\hbox to 1em{\hfil$\ptexequiv$\hfil}} % Adapted from the TeXbook's \boxit. @@ -3242,31 +4015,36 @@ width0pt\relax} \fi % But \@ or @@ will get a plain tex @ character. \def\tex{\begingroup -\catcode `\\=0 \catcode `\{=1 \catcode `\}=2 -\catcode `\$=3 \catcode `\&=4 \catcode `\#=6 -\catcode `\^=7 \catcode `\_=8 \catcode `\~=13 \let~=\tie -\catcode `\%=14 -\catcode 43=12 -\catcode`\"=12 -\catcode`\==12 -\catcode`\|=12 -\catcode`\<=12 -\catcode`\>=12 -\escapechar=`\\ -% -\let\~=\ptextilde -\let\{=\ptexlbrace -\let\}=\ptexrbrace -\let\.=\ptexdot -\let\*=\ptexstar -\let\dots=\ptexdots -\def\endldots{\mathinner{\ldots\ldots\ldots\ldots}} -\def\enddots{\relax\ifmmode\endldots\else$\mathsurround=0pt \endldots\,$\fi} -\def\@{@}% -\let\bullet=\ptexbullet -\let\b=\ptexb \let\c=\ptexc \let\i=\ptexi \let\t=\ptext \let\l=\ptexl -\let\L=\ptexL -% + \catcode `\\=0 \catcode `\{=1 \catcode `\}=2 + \catcode `\$=3 \catcode `\&=4 \catcode `\#=6 + \catcode `\^=7 \catcode `\_=8 \catcode `\~=13 \let~=\tie + \catcode `\%=14 + \catcode 43=12 % plus + \catcode`\"=12 + \catcode`\==12 + \catcode`\|=12 + \catcode`\<=12 + \catcode`\>=12 + \escapechar=`\\ + % + \let\b=\ptexb + \let\bullet=\ptexbullet + \let\c=\ptexc + \let\,=\ptexcomma + \let\.=\ptexdot + \let\dots=\ptexdots + \let\equiv=\ptexequiv + \let\!=\ptexexclam + \let\i=\ptexi + \let\{=\ptexlbrace + \let\+=\tabalign + \let\}=\ptexrbrace + \let\*=\ptexstar + \let\t=\ptext + % + \def\endldots{\mathinner{\ldots\ldots\ldots\ldots}}% + \def\enddots{\relax\ifmmode\endldots\else$\mathsurround=0pt \endldots\,$\fi}% + \def\@{@}% \let\Etex=\endgroup} % Define @lisp ... @endlisp. @@ -3311,8 +4089,8 @@ width0pt\relax} \fi % \nonarrowing is a flag. If "set", @lisp etc don't narrow margins. \let\nonarrowing=\relax -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% \cartouche: draw rectangle w/rounded corners around argument +% @cartouche ... @end cartouche: draw rectangle w/rounded corners around +% environment contents. \font\circle=lcircle10 \newdimen\circthick \newdimen\cartouter\newdimen\cartinner @@ -3324,50 +4102,50 @@ width0pt\relax} \fi \def\cbl{{\circle\char'012\hskip -6pt}} \def\cbr{{\hskip 6pt\circle\char'011}} \def\carttop{\hbox to \cartouter{\hskip\lskip - \ctl\leaders\hrule height\circthick\hfil\ctr - \hskip\rskip}} + \ctl\leaders\hrule height\circthick\hfil\ctr + \hskip\rskip}} \def\cartbot{\hbox to \cartouter{\hskip\lskip - \cbl\leaders\hrule height\circthick\hfil\cbr - \hskip\rskip}} + \cbl\leaders\hrule height\circthick\hfil\cbr + \hskip\rskip}} % \newskip\lskip\newskip\rskip \long\def\cartouche{% \begingroup - \lskip=\leftskip \rskip=\rightskip - \leftskip=0pt\rightskip=0pt %we want these *outside*. - \cartinner=\hsize \advance\cartinner by-\lskip - \advance\cartinner by-\rskip - \cartouter=\hsize - \advance\cartouter by 18pt % allow for 3pt kerns on either -% side, and for 6pt waste from -% each corner char - \normbskip=\baselineskip \normpskip=\parskip \normlskip=\lineskip - % Flag to tell @lisp, etc., not to narrow margin. - \let\nonarrowing=\comment - \vbox\bgroup - \baselineskip=0pt\parskip=0pt\lineskip=0pt - \carttop - \hbox\bgroup - \hskip\lskip - \vrule\kern3pt - \vbox\bgroup - \hsize=\cartinner - \kern3pt - \begingroup - \baselineskip=\normbskip - \lineskip=\normlskip - \parskip=\normpskip - \vskip -\parskip + \lskip=\leftskip \rskip=\rightskip + \leftskip=0pt\rightskip=0pt %we want these *outside*. + \cartinner=\hsize \advance\cartinner by-\lskip + \advance\cartinner by-\rskip + \cartouter=\hsize + \advance\cartouter by 18.4pt % allow for 3pt kerns on either +% side, and for 6pt waste from +% each corner char, and rule thickness + \normbskip=\baselineskip \normpskip=\parskip \normlskip=\lineskip + % Flag to tell @lisp, etc., not to narrow margin. + \let\nonarrowing=\comment + \vbox\bgroup + \baselineskip=0pt\parskip=0pt\lineskip=0pt + \carttop + \hbox\bgroup + \hskip\lskip + \vrule\kern3pt + \vbox\bgroup + \hsize=\cartinner + \kern3pt + \begingroup + \baselineskip=\normbskip + \lineskip=\normlskip + \parskip=\normpskip + \vskip -\parskip \def\Ecartouche{% - \endgroup - \kern3pt - \egroup - \kern3pt\vrule - \hskip\rskip - \egroup - \cartbot - \egroup + \endgroup + \kern3pt + \egroup + \kern3pt\vrule + \hskip\rskip + \egroup + \cartbot + \egroup \endgroup }} @@ -3395,49 +4173,52 @@ width0pt\relax} \fi \fi } -% To ending an @example-like environment, we first end the paragraph -% (via \afterenvbreak's vertical glue), and then the group. That way we -% keep the zero \parskip that the environments set -- \parskip glue -% will be inserted at the beginning of the next paragraph in the -% document, after the environment. +% Define the \E... control sequence only if we are inside the particular +% environment, so the error checking in \end will work. +% +% To end an @example-like environment, we first end the paragraph (via +% \afterenvbreak's vertical glue), and then the group. That way we keep +% the zero \parskip that the environments set -- \parskip glue will be +% inserted at the beginning of the next paragraph in the document, after +% the environment. % -\def\nonfillfinish{\afterenvbreak\endgroup}% +\def\nonfillfinish{\afterenvbreak\endgroup} -% This macro is +% @lisp: indented, narrowed, typewriter font. \def\lisp{\begingroup \nonfillstart \let\Elisp = \nonfillfinish \tt - \rawbackslash % have \ input char produce \ char from current font - \gobble + \let\kbdfont = \kbdexamplefont % Allow @kbd to do something special. + \gobble % eat return } -% Define the \E... control sequence only if we are inside the -% environment, so the error checking in \end will work. -% -% We must call \lisp last in the definition, since it reads the -% return following the @example (or whatever) command. -% +% @example: Same as @lisp. \def\example{\begingroup \def\Eexample{\nonfillfinish\endgroup}\lisp} -\def\smallexample{\begingroup \def\Esmallexample{\nonfillfinish\endgroup}\lisp} -\def\smalllisp{\begingroup \def\Esmalllisp{\nonfillfinish\endgroup}\lisp} -% @smallexample and @smalllisp. This is not used unless the @smallbook -% command is given. Originally contributed by Pavel@xerox. +% @small... is usually equivalent to the non-small (@smallbook +% redefines). We must call \example (or whatever) last in the +% definition, since it reads the return following the @example (or +% whatever) command. % +% This actually allows (for example) @end display inside an +% @smalldisplay. Too bad, but makeinfo will catch the error anyway. +% +\def\smalldisplay{\begingroup\def\Esmalldisplay{\nonfillfinish\endgroup}\display} +\def\smallexample{\begingroup\def\Esmallexample{\nonfillfinish\endgroup}\lisp} +\def\smallformat{\begingroup\def\Esmallformat{\nonfillfinish\endgroup}\format} +\def\smalllisp{\begingroup\def\Esmalllisp{\nonfillfinish\endgroup}\lisp} + +% Real @smallexample and @smalllisp (when @smallbook): use smaller fonts. +% Originally contributed by Pavel@xerox. \def\smalllispx{\begingroup - \nonfillstart - \let\Esmalllisp = \nonfillfinish - \let\Esmallexample = \nonfillfinish - % - % Smaller interline space and fonts for small examples. - \setleading{10pt}% - \indexfonts \tt - \rawbackslash % make \ output the \ character from the current font (tt) - \gobble + \def\Esmalllisp{\nonfillfinish\endgroup}% + \def\Esmallexample{\nonfillfinish\endgroup}% + \smallfonts + \lisp } -% This is @display; same as @lisp except use roman font. +% @display: same as @lisp except keep current font. % \def\display{\begingroup \nonfillstart @@ -3445,7 +4226,15 @@ width0pt\relax} \fi \gobble } -% This is @format; same as @display except don't narrow margins. +% @smalldisplay (when @smallbook): @display plus smaller fonts. +% +\def\smalldisplayx{\begingroup + \def\Esmalldisplay{\nonfillfinish\endgroup}% + \smallfonts \rm + \display +} + +% @format: same as @display except don't narrow margins. % \def\format{\begingroup \let\nonarrowing = t @@ -3454,20 +4243,27 @@ width0pt\relax} \fi \gobble } -% @flushleft (same as @format) and @flushright. +% @smallformat (when @smallbook): @format plus smaller fonts. % -\def\flushleft{\begingroup - \let\nonarrowing = t - \nonfillstart - \let\Eflushleft = \nonfillfinish - \gobble +\def\smallformatx{\begingroup + \def\Esmallformat{\nonfillfinish\endgroup}% + \smallfonts \rm + \format } + +% @flushleft (same as @format). +% +\def\flushleft{\begingroup \def\Eflushleft{\nonfillfinish\endgroup}\format} + +% @flushright. +% \def\flushright{\begingroup \let\nonarrowing = t \nonfillstart \let\Eflushright = \nonfillfinish \advance\leftskip by 0pt plus 1fill - \gobble} + \gobble +} % @quotation does normal linebreaking (hence we can't use \nonfillstart) % and narrows the margins. @@ -3490,9 +4286,11 @@ width0pt\relax} \fi \fi } + \message{defuns,} -% Define formatter for defuns -% First, allow user to change definition object font (\df) internally +% @defun etc. + +% Allow user to change definition object font (\df) internally \def\setdeffont #1 {\csname DEF#1\endcsname} \newskip\defbodyindent \defbodyindent=.4in @@ -3526,16 +4324,17 @@ width0pt\relax} \fi % Definitions of (, ) and & used in args for functions. % This is the definition of ( outside of all parentheses. -\gdef\oprm#1 {{\rm\char`\(}#1 \bf \let(=\opnested % -\global\advance\parencount by 1 } +\gdef\oprm#1 {{\rm\char`\(}#1 \bf \let(=\opnested + \global\advance\parencount by 1 +} % % This is the definition of ( when already inside a level of parens. \gdef\opnested{\char`\(\global\advance\parencount by 1 } % \gdef\clrm{% Print a paren in roman if it is taking us back to depth of 0. -% also in that case restore the outer-level definition of (. -\ifnum \parencount=1 {\rm \char `\)}\sl \let(=\oprm \else \char `\) \fi -\global\advance \parencount by -1 } + % also in that case restore the outer-level definition of (. + \ifnum \parencount=1 {\rm \char `\)}\sl \let(=\oprm \else \char `\) \fi + \global\advance \parencount by -1 } % If we encounter &foo, then turn on ()-hacking afterwards \gdef\amprm#1 {{\rm\}\let(=\oprm \let)=\clrm\ } % @@ -3543,8 +4342,17 @@ width0pt\relax} \fi } % End of definition inside \activeparens %% These parens (in \boldbrax) actually are a little bolder than the %% contained text. This is especially needed for [ and ] -\def\opnr{{\sf\char`\(}} \def\clnr{{\sf\char`\)}} \def\ampnr{\&} -\def\lbrb{{\bf\char`\[}} \def\rbrb{{\bf\char`\]}} +\def\opnr{{\sf\char`\(}\global\advance\parencount by 1 } +\def\clnr{{\sf\char`\)}\global\advance\parencount by -1 } +\let\ampnr = \& +\def\lbrb{{\bf\char`\[}} +\def\rbrb{{\bf\char`\]}} + +% Active &'s sneak into the index arguments, so make sure it's defined. +{ + \catcode`& = 13 + \global\let& = \ampnr +} % First, defname, which formats the header line itself. % #1 should be the function name. @@ -3555,20 +4363,18 @@ width0pt\relax} \fi % outside the @def... \dimen2=\leftskip \advance\dimen2 by -\defbodyindent -\dimen3=\rightskip -\advance\dimen3 by -\defbodyindent -\noindent % +\noindent \setbox0=\hbox{\hskip \deflastargmargin{\rm #2}\hskip \deftypemargin}% \dimen0=\hsize \advance \dimen0 by -\wd0 % compute size for first line \dimen1=\hsize \advance \dimen1 by -\defargsindent %size for continuations -\parshape 2 0in \dimen0 \defargsindent \dimen1 % +\parshape 2 0in \dimen0 \defargsindent \dimen1 % Now output arg 2 ("Function" or some such) % ending at \deftypemargin from the right margin, % but stuck inside a box of width 0 so it does not interfere with linebreaking {% Adjust \hsize to exclude the ambient margins, % so that \rightline will obey them. -\advance \hsize by -\dimen2 \advance \hsize by -\dimen3 -\rlap{\rightline{{\rm #2}\hskip \deftypemargin}}}% +\advance \hsize by -\dimen2 +\rlap{\rightline{{\rm #2}\hskip -1.25pc }}}% % Make all lines underfull and no complaints: \tolerance=10000 \hbadness=10000 \advance\leftskip by -\defbodyindent @@ -3589,23 +4395,62 @@ width0pt\relax} \fi \def#1{\endgraf\endgroup\medbreak}% \def#2{\begingroup\obeylines\activeparens\spacesplit#3}% \parindent=0in -\advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent +\advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup % \catcode 61=\active % 61 is `=' \obeylines\activeparens\spacesplit#3} -\def\defmethparsebody #1#2#3#4 {\begingroup\inENV % +% #1 is the \E... control sequence to end the definition (which we define). +% #2 is the \...x control sequence for consecutive fns (which we define). +% #3 is the control sequence to call to resume processing. +% #4, delimited by the space, is the class name. +% +\def\defmethparsebody#1#2#3#4 {\begingroup\inENV % \medbreak % % Define the end token that this defining construct specifies % so that it will exit this group. \def#1{\endgraf\endgroup\medbreak}% \def#2##1 {\begingroup\obeylines\activeparens\spacesplit{#3{##1}}}% \parindent=0in -\advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent +\advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup\obeylines\activeparens\spacesplit{#3{#4}}} +% Used for @deftypemethod and @deftypeivar. +% #1 is the \E... control sequence to end the definition (which we define). +% #2 is the \...x control sequence for consecutive fns (which we define). +% #3 is the control sequence to call to resume processing. +% #4, delimited by a space, is the class name. +% #5 is the method's return type. +% +\def\deftypemethparsebody#1#2#3#4 #5 {\begingroup\inENV + \medbreak + \def#1{\endgraf\endgroup\medbreak}% + \def#2##1 ##2 {\begingroup\obeylines\activeparens\spacesplit{#3{##1}{##2}}}% + \parindent=0in + \advance\leftskip by \defbodyindent + \exdentamount=\defbodyindent + \begingroup\obeylines\activeparens\spacesplit{#3{#4}{#5}}} + +% Used for @deftypeop. The change from \deftypemethparsebody is an +% extra argument at the beginning which is the `category', instead of it +% being the hardwired string `Method' or `Instance Variable'. We have +% to account for this both in the \...x definition and in parsing the +% input at hand. Thus also need a control sequence (passed as #5) for +% the \E... definition to assign the category name to. +% +\def\deftypeopparsebody#1#2#3#4#5 #6 {\begingroup\inENV + \medbreak + \def#1{\endgraf\endgroup\medbreak}% + \def#2##1 ##2 ##3 {% + \def#4{##1}% + \begingroup\obeylines\activeparens\spacesplit{#3{##2}{##3}}}% + \parindent=0in + \advance\leftskip by \defbodyindent + \exdentamount=\defbodyindent + \begingroup\obeylines\activeparens\spacesplit{#3{#5}{#6}}} + \def\defopparsebody #1#2#3#4#5 {\begingroup\inENV % \medbreak % % Define the end token that this defining construct specifies @@ -3614,7 +4459,7 @@ width0pt\relax} \fi \def#2##1 ##2 {\def#4{##1}% \begingroup\obeylines\activeparens\spacesplit{#3{##2}}}% \parindent=0in -\advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent +\advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup\obeylines\activeparens\spacesplit{#3{#5}}} @@ -3629,7 +4474,7 @@ width0pt\relax} \fi \def#1{\endgraf\endgroup\medbreak}% \def#2{\begingroup\obeylines\spacesplit#3}% \parindent=0in -\advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent +\advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup % \catcode 61=\active % @@ -3637,7 +4482,7 @@ width0pt\relax} \fi % This is used for \def{tp,vr}parsebody. It could probably be used for % some of the others, too, with some judicious conditionals. -% +% \def\parsebodycommon#1#2#3{% \begingroup\inENV % \medbreak % @@ -3646,7 +4491,7 @@ width0pt\relax} \fi \def#1{\endgraf\endgroup\medbreak}% \def#2##1 {\begingroup\obeylines\spacesplit{#3{##1}}}% \parindent=0in - \advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent + \advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup\obeylines } @@ -3671,17 +4516,16 @@ width0pt\relax} \fi } % Fine, but then we have to eventually remove the \empty *and* the -% braces (if any). That's what this does, putting the result in \tptemp. -% -\def\removeemptybraces\empty#1\relax{\def\tptemp{#1}}% +% braces (if any). That's what this does. +% +\def\removeemptybraces\empty#1\relax{#1} % After \spacesplit has done its work, this is called -- #1 is the final % thing to call, #2 the type name (which starts with \empty), and #3 % (which might be empty) the arguments. -% +% \def\parsetpheaderline#1#2#3{% - \removeemptybraces#2\relax - #1{\tptemp}{#3}% + #1{\removeemptybraces#2\relax}{#3}% }% \def\defopvarparsebody #1#2#3#4#5 {\begingroup\inENV % @@ -3692,7 +4536,7 @@ width0pt\relax} \fi \def#2##1 ##2 {\def#4{##1}% \begingroup\obeylines\spacesplit{#3{##2}}}% \parindent=0in -\advance\leftskip by \defbodyindent \advance \rightskip by \defbodyindent +\advance\leftskip by \defbodyindent \exdentamount=\defbodyindent \begingroup\obeylines\spacesplit{#3{#5}}} @@ -3716,16 +4560,17 @@ width0pt\relax} \fi % First, define the processing that is wanted for arguments of \defun % Use this to expand the args and terminate the paragraph they make up -\def\defunargs #1{\functionparens \sl +\def\defunargs#1{\functionparens \sl % Expand, preventing hyphenation at `-' chars. % Note that groups don't affect changes in \hyphenchar. -\hyphenchar\tensl=0 +% Set the font temporarily and use \font in case \setfont made \tensl a macro. +{\tensl\hyphenchar\font=0}% #1% -\hyphenchar\tensl=45 -\ifnum\parencount=0 \else \errmessage{unbalanced parens in @def arguments}\fi% +{\tensl\hyphenchar\font=45}% +\ifnum\parencount=0 \else \errmessage{Unbalanced parentheses in @def}\fi% \interlinepenalty=10000 \advance\rightskip by 0pt plus 1fil -\endgraf\penalty 10000\vskip -\parskip\penalty 10000% +\endgraf\nobreak\vskip -\parskip\nobreak } \def\deftypefunargs #1{% @@ -3736,7 +4581,7 @@ width0pt\relax} \fi \tclose{#1}% avoid \code because of side effects on active chars \interlinepenalty=10000 \advance\rightskip by 0pt plus 1fil -\endgraf\penalty 10000\vskip -\parskip\penalty 10000% +\endgraf\nobreak\vskip -\parskip\nobreak } % Do complete processing of one @defun or @defunx line already parsed. @@ -3755,7 +4600,7 @@ width0pt\relax} \fi \def\defun{\defparsebody\Edefun\defunx\defunheader} \def\defunheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index -\begingroup\defname {#1}{Function}% +\begingroup\defname {#1}{\putwordDeffunc}% \defunargs {#2}\endgroup % \catcode 61=\other % Turn off change made in \defparsebody } @@ -3769,7 +4614,7 @@ width0pt\relax} \fi % #1 is the data type, #2 the name, #3 the args. \def\deftypefunheaderx #1#2 #3\relax{% \doind {fn}{\code{#2}}% Make entry in function index -\begingroup\defname {\defheaderxcond#1\relax$$$#2}{Function}% +\begingroup\defname {\defheaderxcond#1\relax$$$#2}{\putwordDeftypefun}% \deftypefunargs {#3}\endgroup % \catcode 61=\other % Turn off change made in \defparsebody } @@ -3800,7 +4645,7 @@ width0pt\relax} \fi \def\defmac{\defparsebody\Edefmac\defmacx\defmacheader} \def\defmacheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index -\begingroup\defname {#1}{Macro}% +\begingroup\defname {#1}{\putwordDefmac}% \defunargs {#2}\endgroup % \catcode 61=\other % Turn off change made in \defparsebody } @@ -3810,42 +4655,77 @@ width0pt\relax} \fi \def\defspec{\defparsebody\Edefspec\defspecx\defspecheader} \def\defspecheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index -\begingroup\defname {#1}{Special Form}% +\begingroup\defname {#1}{\putwordDefspec}% \defunargs {#2}\endgroup % \catcode 61=\other % Turn off change made in \defparsebody } -% This definition is run if you use @defunx -% anywhere other than immediately after a @defun or @defunx. - -\def\deffnx #1 {\errmessage{@deffnx in invalid context}} -\def\defunx #1 {\errmessage{@defunx in invalid context}} -\def\defmacx #1 {\errmessage{@defmacx in invalid context}} -\def\defspecx #1 {\errmessage{@defspecx in invalid context}} -\def\deftypefnx #1 {\errmessage{@deftypefnx in invalid context}} -\def\deftypeunx #1 {\errmessage{@deftypeunx in invalid context}} - -% @defmethod, and so on - -% @defop {Funny Method} foo-class frobnicate argument - +% @defop CATEGORY CLASS OPERATION ARG... +% \def\defop #1 {\def\defoptype{#1}% \defopparsebody\Edefop\defopx\defopheader\defoptype} - -\def\defopheader #1#2#3{% -\dosubind {fn}{\code{#2}}{on #1}% Make entry in function index -\begingroup\defname {#2}{\defoptype{} on #1}% +% +\def\defopheader#1#2#3{% +\dosubind {fn}{\code{#2}}{\putwordon\ #1}% Make entry in function index +\begingroup\defname {#2}{\defoptype\ \putwordon\ #1}% \defunargs {#3}\endgroup % } -% @defmethod == @defop Method +% @deftypeop CATEGORY CLASS TYPE OPERATION ARG... +% +\def\deftypeop #1 {\def\deftypeopcategory{#1}% + \deftypeopparsebody\Edeftypeop\deftypeopx\deftypeopheader + \deftypeopcategory} +% +% #1 is the class name, #2 the data type, #3 the operation name, #4 the args. +\def\deftypeopheader#1#2#3#4{% + \dosubind{fn}{\code{#3}}{\putwordon\ \code{#1}}% entry in function index + \begingroup + \defname{\defheaderxcond#2\relax$$$#3} + {\deftypeopcategory\ \putwordon\ \code{#1}}% + \deftypefunargs{#4}% + \endgroup +} -\def\defmethod{\defmethparsebody\Edefmethod\defmethodx\defmethodheader} +% @deftypemethod CLASS TYPE METHOD ARG... +% +\def\deftypemethod{% + \deftypemethparsebody\Edeftypemethod\deftypemethodx\deftypemethodheader} +% +% #1 is the class name, #2 the data type, #3 the method name, #4 the args. +\def\deftypemethodheader#1#2#3#4{% + \dosubind{fn}{\code{#3}}{\putwordon\ \code{#1}}% entry in function index + \begingroup + \defname{\defheaderxcond#2\relax$$$#3}{\putwordMethodon\ \code{#1}}% + \deftypefunargs{#4}% + \endgroup +} -\def\defmethodheader #1#2#3{% -\dosubind {fn}{\code{#2}}{on #1}% entry in function index -\begingroup\defname {#2}{Method on #1}% -\defunargs {#3}\endgroup % +% @deftypeivar CLASS TYPE VARNAME +% +\def\deftypeivar{% + \deftypemethparsebody\Edeftypeivar\deftypeivarx\deftypeivarheader} +% +% #1 is the class name, #2 the data type, #3 the variable name. +\def\deftypeivarheader#1#2#3{% + \dosubind{vr}{\code{#3}}{\putwordof\ \code{#1}}% entry in variable index + \begingroup + \defname{#3}{\putwordInstanceVariableof\ \code{#1}}% + \defvarargs{#3}% + \endgroup +} + +% @defmethod == @defop Method +% +\def\defmethod{\defmethparsebody\Edefmethod\defmethodx\defmethodheader} +% +% #1 is the class name, #2 the method name, #3 the args. +\def\defmethodheader#1#2#3{% + \dosubind{fn}{\code{#2}}{\putwordon\ \code{#1}}% entry in function index + \begingroup + \defname{#2}{\putwordMethodon\ \code{#1}}% + \defunargs{#3}% + \endgroup } % @defcv {Class Option} foo-class foo-flag @@ -3854,37 +4734,30 @@ width0pt\relax} \fi \defopvarparsebody\Edefcv\defcvx\defcvarheader\defcvtype} \def\defcvarheader #1#2#3{% -\dosubind {vr}{\code{#2}}{of #1}% Make entry in var index -\begingroup\defname {#2}{\defcvtype{} of #1}% +\dosubind {vr}{\code{#2}}{\putwordof\ #1}% Make entry in var index +\begingroup\defname {#2}{\defcvtype\ \putwordof\ #1}% \defvarargs {#3}\endgroup % } -% @defivar == @defcv {Instance Variable} - +% @defivar CLASS VARNAME == @defcv {Instance Variable} CLASS VARNAME +% \def\defivar{\defvrparsebody\Edefivar\defivarx\defivarheader} - -\def\defivarheader #1#2#3{% -\dosubind {vr}{\code{#2}}{of #1}% Make entry in var index -\begingroup\defname {#2}{Instance Variable of #1}% -\defvarargs {#3}\endgroup % +% +\def\defivarheader#1#2#3{% + \dosubind {vr}{\code{#2}}{\putwordof\ #1}% entry in var index + \begingroup + \defname{#2}{\putwordInstanceVariableof\ #1}% + \defvarargs{#3}% + \endgroup } -% These definitions are run if you use @defmethodx, etc., -% anywhere other than immediately after a @defmethod, etc. - -\def\defopx #1 {\errmessage{@defopx in invalid context}} -\def\defmethodx #1 {\errmessage{@defmethodx in invalid context}} -\def\defcvx #1 {\errmessage{@defcvx in invalid context}} -\def\defivarx #1 {\errmessage{@defivarx in invalid context}} - -% Now @defvar - +% @defvar % First, define the processing that is wanted for arguments of @defvar. % This is actually simple: just print them in roman. % This must expand the args and terminate the paragraph they make up \def\defvarargs #1{\normalparens #1% \interlinepenalty=10000 -\endgraf\penalty 10000\vskip -\parskip\penalty 10000} +\endgraf\nobreak\vskip -\parskip\nobreak} % @defvr Counter foo-count @@ -3898,7 +4771,7 @@ width0pt\relax} \fi \def\defvar{\defvarparsebody\Edefvar\defvarx\defvarheader} \def\defvarheader #1#2{\doind {vr}{\code{#1}}% Make entry in var index -\begingroup\defname {#1}{Variable}% +\begingroup\defname {#1}{\putwordDefvar}% \defvarargs {#2}\endgroup % } @@ -3907,7 +4780,7 @@ width0pt\relax} \fi \def\defopt{\defvarparsebody\Edefopt\defoptx\defoptheader} \def\defoptheader #1#2{\doind {vr}{\code{#1}}% Make entry in var index -\begingroup\defname {#1}{User Option}% +\begingroup\defname {#1}{\putwordDefopt}% \defvarargs {#2}\endgroup % } @@ -3915,33 +4788,26 @@ width0pt\relax} \fi \def\deftypevar{\defvarparsebody\Edeftypevar\deftypevarx\deftypevarheader} -% #1 is the data type. #2 is the name. +% #1 is the data type. #2 is the name, perhaps followed by text that +% is actually part of the data type, which should not be put into the index. \def\deftypevarheader #1#2{% -\doind {vr}{\code{#2}}% Make entry in variables index -\begingroup\defname {\defheaderxcond#1\relax$$$#2}{Variable}% +\dovarind#2 \relax% Make entry in variables index +\begingroup\defname {\defheaderxcond#1\relax$$$#2}{\putwordDeftypevar}% \interlinepenalty=10000 -\endgraf\penalty 10000\vskip -\parskip\penalty 10000 +\endgraf\nobreak\vskip -\parskip\nobreak \endgroup} +\def\dovarind#1 #2\relax{\doind{vr}{\code{#1}}} % @deftypevr {Global Flag} int enable \def\deftypevr{\defvrparsebody\Edeftypevr\deftypevrx\deftypevrheader} -\def\deftypevrheader #1#2#3{\doind {vr}{\code{#3}}% +\def\deftypevrheader #1#2#3{\dovarind#3 \relax% \begingroup\defname {\defheaderxcond#2\relax$$$#3}{#1} \interlinepenalty=10000 -\endgraf\penalty 10000\vskip -\parskip\penalty 10000 +\endgraf\nobreak\vskip -\parskip\nobreak \endgroup} -% This definition is run if you use @defvarx -% anywhere other than immediately after a @defvar or @defvarx. - -\def\defvrx #1 {\errmessage{@defvrx in invalid context}} -\def\defvarx #1 {\errmessage{@defvarx in invalid context}} -\def\defoptx #1 {\errmessage{@defoptx in invalid context}} -\def\deftypevarx #1 {\errmessage{@deftypevarx in invalid context}} -\def\deftypevrx #1 {\errmessage{@deftypevrx in invalid context}} - % Now define @deftp % Args are printed in bold, a slight difference from @defvar. @@ -3954,45 +4820,394 @@ width0pt\relax} \fi \def\deftpheader #1#2#3{\doind {tp}{\code{#2}}% \begingroup\defname {#2}{#1}\deftpargs{#3}\endgroup} -% This definition is run if you use @deftpx, etc -% anywhere other than immediately after a @deftp, etc. +% These definitions are used if you use @defunx (etc.) +% anywhere other than immediately after a @defun or @defunx. +% +\def\defcvx#1 {\errmessage{@defcvx in invalid context}} +\def\deffnx#1 {\errmessage{@deffnx in invalid context}} +\def\defivarx#1 {\errmessage{@defivarx in invalid context}} +\def\defmacx#1 {\errmessage{@defmacx in invalid context}} +\def\defmethodx#1 {\errmessage{@defmethodx in invalid context}} +\def\defoptx #1 {\errmessage{@defoptx in invalid context}} +\def\defopx#1 {\errmessage{@defopx in invalid context}} +\def\defspecx#1 {\errmessage{@defspecx in invalid context}} +\def\deftpx#1 {\errmessage{@deftpx in invalid context}} +\def\deftypefnx#1 {\errmessage{@deftypefnx in invalid context}} +\def\deftypefunx#1 {\errmessage{@deftypefunx in invalid context}} +\def\deftypeivarx#1 {\errmessage{@deftypeivarx in invalid context}} +\def\deftypemethodx#1 {\errmessage{@deftypemethodx in invalid context}} +\def\deftypeopx#1 {\errmessage{@deftypeopx in invalid context}} +\def\deftypevarx#1 {\errmessage{@deftypevarx in invalid context}} +\def\deftypevrx#1 {\errmessage{@deftypevrx in invalid context}} +\def\defunx#1 {\errmessage{@defunx in invalid context}} +\def\defvarx#1 {\errmessage{@defvarx in invalid context}} +\def\defvrx#1 {\errmessage{@defvrx in invalid context}} + + +\message{macros,} +% @macro. + +% To do this right we need a feature of e-TeX, \scantokens, +% which we arrange to emulate with a temporary file in ordinary TeX. +\ifx\eTeXversion\undefined + \newwrite\macscribble + \def\scanmacro#1{% + \begingroup \newlinechar`\^^M + % Undo catcode changes of \startcontents and \doprintindex + \catcode`\@=0 \catcode`\\=12 \escapechar=`\@ + % Append \endinput to make sure that TeX does not see the ending newline. + \toks0={#1\endinput}% + \immediate\openout\macscribble=\jobname.tmp + \immediate\write\macscribble{\the\toks0}% + \immediate\closeout\macscribble + \let\xeatspaces\eatspaces + \input \jobname.tmp + \endgroup +} +\else +\def\scanmacro#1{% +\begingroup \newlinechar`\^^M +% Undo catcode changes of \startcontents and \doprintindex +\catcode`\@=0 \catcode`\\=12 \escapechar=`\@ +\let\xeatspaces\eatspaces\scantokens{#1\endinput}\endgroup} +\fi + +\newcount\paramno % Count of parameters +\newtoks\macname % Macro name +\newif\ifrecursive % Is it recursive? +\def\macrolist{} % List of all defined macros in the form + % \do\macro1\do\macro2... + +% Utility routines. +% Thisdoes \let #1 = #2, except with \csnames. +\def\cslet#1#2{% +\expandafter\expandafter +\expandafter\let +\expandafter\expandafter +\csname#1\endcsname +\csname#2\endcsname} + +% Trim leading and trailing spaces off a string. +% Concepts from aro-bend problem 15 (see CTAN). +{\catcode`\@=11 +\gdef\eatspaces #1{\expandafter\trim@\expandafter{#1 }} +\gdef\trim@ #1{\trim@@ @#1 @ #1 @ @@} +\gdef\trim@@ #1@ #2@ #3@@{\trim@@@\empty #2 @} +\def\unbrace#1{#1} +\unbrace{\gdef\trim@@@ #1 } #2@{#1} +} + +% Trim a single trailing ^^M off a string. +{\catcode`\^^M=12\catcode`\Q=3% +\gdef\eatcr #1{\eatcra #1Q^^MQ}% +\gdef\eatcra#1^^MQ{\eatcrb#1Q}% +\gdef\eatcrb#1Q#2Q{#1}% +} + +% Macro bodies are absorbed as an argument in a context where +% all characters are catcode 10, 11 or 12, except \ which is active +% (as in normal texinfo). It is necessary to change the definition of \. + +% It's necessary to have hard CRs when the macro is executed. This is +% done by making ^^M (\endlinechar) catcode 12 when reading the macro +% body, and then making it the \newlinechar in \scanmacro. + +\def\macrobodyctxt{% + \catcode`\~=12 + \catcode`\^=12 + \catcode`\_=12 + \catcode`\|=12 + \catcode`\<=12 + \catcode`\>=12 + \catcode`\+=12 + \catcode`\{=12 + \catcode`\}=12 + \catcode`\@=12 + \catcode`\^^M=12 + \usembodybackslash} + +\def\macroargctxt{% + \catcode`\~=12 + \catcode`\^=12 + \catcode`\_=12 + \catcode`\|=12 + \catcode`\<=12 + \catcode`\>=12 + \catcode`\+=12 + \catcode`\@=12 + \catcode`\\=12} + +% \mbodybackslash is the definition of \ in @macro bodies. +% It maps \foo\ => \csname macarg.foo\endcsname => #N +% where N is the macro parameter number. +% We define \csname macarg.\endcsname to be \realbackslash, so +% \\ in macro replacement text gets you a backslash. + +{\catcode`@=0 @catcode`@\=@active + @gdef@usembodybackslash{@let\=@mbodybackslash} + @gdef@mbodybackslash#1\{@csname macarg.#1@endcsname} +} +\expandafter\def\csname macarg.\endcsname{\realbackslash} + +\def\macro{\recursivefalse\parsearg\macroxxx} +\def\rmacro{\recursivetrue\parsearg\macroxxx} + +\def\macroxxx#1{% + \getargs{#1}% now \macname is the macname and \argl the arglist + \ifx\argl\empty % no arguments + \paramno=0% + \else + \expandafter\parsemargdef \argl;% + \fi + \if1\csname ismacro.\the\macname\endcsname + \message{Warning: redefining \the\macname}% + \else + \expandafter\ifx\csname \the\macname\endcsname \relax + \else \errmessage{The name \the\macname\space is reserved}\fi + \global\cslet{macsave.\the\macname}{\the\macname}% + \global\expandafter\let\csname ismacro.\the\macname\endcsname=1% + % Add the macroname to \macrolist + \toks0 = \expandafter{\macrolist\do}% + \xdef\macrolist{\the\toks0 + \expandafter\noexpand\csname\the\macname\endcsname}% + \fi + \begingroup \macrobodyctxt + \ifrecursive \expandafter\parsermacbody + \else \expandafter\parsemacbody + \fi} + +\def\unmacro{\parsearg\unmacroxxx} +\def\unmacroxxx#1{% + \if1\csname ismacro.#1\endcsname + \global\cslet{#1}{macsave.#1}% + \global\expandafter\let \csname ismacro.#1\endcsname=0% + % Remove the macro name from \macrolist + \begingroup + \edef\tempa{\expandafter\noexpand\csname#1\endcsname}% + \def\do##1{% + \def\tempb{##1}% + \ifx\tempa\tempb + % remove this + \else + \toks0 = \expandafter{\newmacrolist\do}% + \edef\newmacrolist{\the\toks0\expandafter\noexpand\tempa}% + \fi}% + \def\newmacrolist{}% + % Execute macro list to define \newmacrolist + \macrolist + \global\let\macrolist\newmacrolist + \endgroup + \else + \errmessage{Macro #1 not defined}% + \fi +} + +% This makes use of the obscure feature that if the last token of a +% is #, then the preceding argument is delimited by +% an opening brace, and that opening brace is not consumed. +\def\getargs#1{\getargsxxx#1{}} +\def\getargsxxx#1#{\getmacname #1 \relax\getmacargs} +\def\getmacname #1 #2\relax{\macname={#1}} +\def\getmacargs#1{\def\argl{#1}} + +% Parse the optional {params} list. Set up \paramno and \paramlist +% so \defmacro knows what to do. Define \macarg.blah for each blah +% in the params list, to be ##N where N is the position in that list. +% That gets used by \mbodybackslash (above). + +% We need to get `macro parameter char #' into several definitions. +% The technique used is stolen from LaTeX: let \hash be something +% unexpandable, insert that wherever you need a #, and then redefine +% it to # just before using the token list produced. +% +% The same technique is used to protect \eatspaces till just before +% the macro is used. + +\def\parsemargdef#1;{\paramno=0\def\paramlist{}% + \let\hash\relax\let\xeatspaces\relax\parsemargdefxxx#1,;,} +\def\parsemargdefxxx#1,{% + \if#1;\let\next=\relax + \else \let\next=\parsemargdefxxx + \advance\paramno by 1% + \expandafter\edef\csname macarg.\eatspaces{#1}\endcsname + {\xeatspaces{\hash\the\paramno}}% + \edef\paramlist{\paramlist\hash\the\paramno,}% + \fi\next} + +% These two commands read recursive and nonrecursive macro bodies. +% (They're different since rec and nonrec macros end differently.) + +\long\def\parsemacbody#1@end macro% +{\xdef\temp{\eatcr{#1}}\endgroup\defmacro}% +\long\def\parsermacbody#1@end rmacro% +{\xdef\temp{\eatcr{#1}}\endgroup\defmacro}% + +% This defines the macro itself. There are six cases: recursive and +% nonrecursive macros of zero, one, and many arguments. +% Much magic with \expandafter here. +% \xdef is used so that macro definitions will survive the file +% they're defined in; @include reads the file inside a group. +\def\defmacro{% + \let\hash=##% convert placeholders to macro parameter chars + \ifrecursive + \ifcase\paramno + % 0 + \expandafter\xdef\csname\the\macname\endcsname{% + \noexpand\scanmacro{\temp}}% + \or % 1 + \expandafter\xdef\csname\the\macname\endcsname{% + \bgroup\noexpand\macroargctxt + \noexpand\braceorline + \expandafter\noexpand\csname\the\macname xxx\endcsname}% + \expandafter\xdef\csname\the\macname xxx\endcsname##1{% + \egroup\noexpand\scanmacro{\temp}}% + \else % many + \expandafter\xdef\csname\the\macname\endcsname{% + \bgroup\noexpand\macroargctxt + \noexpand\csname\the\macname xx\endcsname}% + \expandafter\xdef\csname\the\macname xx\endcsname##1{% + \expandafter\noexpand\csname\the\macname xxx\endcsname ##1,}% + \expandafter\expandafter + \expandafter\xdef + \expandafter\expandafter + \csname\the\macname xxx\endcsname + \paramlist{\egroup\noexpand\scanmacro{\temp}}% + \fi + \else + \ifcase\paramno + % 0 + \expandafter\xdef\csname\the\macname\endcsname{% + \noexpand\norecurse{\the\macname}% + \noexpand\scanmacro{\temp}\egroup}% + \or % 1 + \expandafter\xdef\csname\the\macname\endcsname{% + \bgroup\noexpand\macroargctxt + \noexpand\braceorline + \expandafter\noexpand\csname\the\macname xxx\endcsname}% + \expandafter\xdef\csname\the\macname xxx\endcsname##1{% + \egroup + \noexpand\norecurse{\the\macname}% + \noexpand\scanmacro{\temp}\egroup}% + \else % many + \expandafter\xdef\csname\the\macname\endcsname{% + \bgroup\noexpand\macroargctxt + \expandafter\noexpand\csname\the\macname xx\endcsname}% + \expandafter\xdef\csname\the\macname xx\endcsname##1{% + \expandafter\noexpand\csname\the\macname xxx\endcsname ##1,}% + \expandafter\expandafter + \expandafter\xdef + \expandafter\expandafter + \csname\the\macname xxx\endcsname + \paramlist{% + \egroup + \noexpand\norecurse{\the\macname}% + \noexpand\scanmacro{\temp}\egroup}% + \fi + \fi} + +\def\norecurse#1{\bgroup\cslet{#1}{macsave.#1}} + +% \braceorline decides whether the next nonwhitespace character is a +% {. If so it reads up to the closing }, if not, it reads the whole +% line. Whatever was read is then fed to the next control sequence +% as an argument (by \parsebrace or \parsearg) +\def\braceorline#1{\let\next=#1\futurelet\nchar\braceorlinexxx} +\def\braceorlinexxx{% + \ifx\nchar\bgroup\else + \expandafter\parsearg + \fi \next} -\def\deftpx #1 {\errmessage{@deftpx in invalid context}} +% We mant to disable all macros during \shipout so that they are not +% expanded by \write. +\def\turnoffmacros{\begingroup \def\do##1{\let\noexpand##1=\relax}% + \edef\next{\macrolist}\expandafter\endgroup\next} -\message{cross reference,} -% Define cross-reference macros -\newwrite \auxfile -\newif\ifhavexrefs % True if xref values are known. +% @alias. +% We need some trickery to remove the optional spaces around the equal +% sign. Just make them active and then expand them all to nothing. +\def\alias{\begingroup\obeyspaces\parsearg\aliasxxx} +\def\aliasxxx #1{\aliasyyy#1\relax} +\def\aliasyyy #1=#2\relax{\ignoreactivespaces +\edef\next{\global\let\expandafter\noexpand\csname#1\endcsname=% + \expandafter\noexpand\csname#2\endcsname}% +\expandafter\endgroup\next} + + +\message{cross references,} +% @xref etc. + +\newwrite\auxfile + +\newif\ifhavexrefs % True if xref values are known. \newif\ifwarnedxrefs % True if we warned once that they aren't known. -% \setref{foo} defines a cross-reference point named foo. +% @inforef is relatively simple. +\def\inforef #1{\inforefzzz #1,,,,**} +\def\inforefzzz #1,#2,#3,#4**{\putwordSee{} \putwordInfo{} \putwordfile{} \file{\ignorespaces #3{}}, + node \samp{\ignorespaces#1{}}} + +% @node's job is to define \lastnode. +\def\node{\ENVcheck\parsearg\nodezzz} +\def\nodezzz#1{\nodexxx [#1,]} +\def\nodexxx[#1,#2]{\gdef\lastnode{#1}} +\let\nwnode=\node +\let\lastnode=\relax -\def\setref#1{% -\dosetq{#1-title}{Ytitle}% -\dosetq{#1-pg}{Ypagenumber}% -\dosetq{#1-snt}{Ysectionnumberandtype}} +% The sectioning commands (@chapter, etc.) call these. +\def\donoderef{% + \ifx\lastnode\relax\else + \expandafter\expandafter\expandafter\setref{\lastnode}% + {Ysectionnumberandtype}% + \global\let\lastnode=\relax + \fi +} +\def\unnumbnoderef{% + \ifx\lastnode\relax\else + \expandafter\expandafter\expandafter\setref{\lastnode}{Ynothing}% + \global\let\lastnode=\relax + \fi +} +\def\appendixnoderef{% + \ifx\lastnode\relax\else + \expandafter\expandafter\expandafter\setref{\lastnode}% + {Yappendixletterandtype}% + \global\let\lastnode=\relax + \fi +} -\def\unnumbsetref#1{% -\dosetq{#1-title}{Ytitle}% -\dosetq{#1-pg}{Ypagenumber}% -\dosetq{#1-snt}{Ynothing}} -\def\appendixsetref#1{% -\dosetq{#1-title}{Ytitle}% -\dosetq{#1-pg}{Ypagenumber}% -\dosetq{#1-snt}{Yappendixletterandtype}} +% @anchor{NAME} -- define xref target at arbitrary point. +% +\newcount\savesfregister +\gdef\savesf{\relax \ifhmode \savesfregister=\spacefactor \fi} +\gdef\restoresf{\relax \ifhmode \spacefactor=\savesfregister \fi} +\gdef\anchor#1{\savesf \setref{#1}{Ynothing}\restoresf \ignorespaces} + +% \setref{NAME}{SNT} defines a cross-reference point NAME, namely +% NAME-title, NAME-pg, and NAME-SNT. Called from \foonoderef. We have +% to set \indexdummies so commands such as @code in a section title +% aren't expanded. It would be nicer not to expand the titles in the +% first place, but there's so many layers that that is hard to do. +% +\def\setref#1#2{{% + \indexdummies + \pdfmkdest{#1}% + \dosetq{#1-title}{Ytitle}% + \dosetq{#1-pg}{Ypagenumber}% + \dosetq{#1-snt}{#2}% +}} -% \xref, \pxref, and \ref generate cross-references to specified points. -% For \xrefX, #1 is the node name, #2 the name of the Info -% cross-reference, #3 the printed node name, #4 the name of the Info -% file, #5 the name of the printed manual. All but the node name can be -% omitted. +% @xref, @pxref, and @ref generate cross-references. For \xrefX, #1 is +% the node name, #2 the name of the Info cross-reference, #3 the printed +% node name, #4 the name of the Info file, #5 the name of the printed +% manual. All but the node name can be omitted. % \def\pxref#1{\putwordsee{} \xrefX[#1,,,,,,,]} \def\xref#1{\putwordSee{} \xrefX[#1,,,,,,,]} \def\ref#1{\xrefX[#1,,,,,,,]} \def\xrefX[#1,#2,#3,#4,#5,#6]{\begingroup + \unsepspaces \def\printedmanual{\ignorespaces #5}% \def\printednodename{\ignorespaces #3}% \setbox1=\hbox{\printedmanual}% @@ -4005,7 +5220,7 @@ width0pt\relax} \fi \else % Use the actual chapter/section title appear inside % the square brackets. Use the real section title if we have it. - \ifdim \wd1>0pt% + \ifdim \wd1 > 0pt % It is in another manual, so we don't have it. \def\printednodename{\ignorespaces #1}% \else @@ -4026,27 +5241,54 @@ width0pt\relax} \fi % are best written with fairly long node names, containing hyphens, this % is a loss. Therefore, we give the text of the node name again, so it % is as if TeX is seeing it for the first time. + \ifpdf + \leavevmode + \getfilename{#4}% + \ifnum\filenamelength>0 + \startlink attr{/Border [0 0 0]}% + goto file{\the\filename.pdf} name{#1@}% + \else + \startlink attr{/Border [0 0 0]}% + goto name{#1@}% + \fi + \linkcolor + \fi + % \ifdim \wd1 > 0pt - \putwordsection{} ``\printednodename'' in \cite{\printedmanual}% + \putwordsection{} ``\printednodename'' \putwordin{} \cite{\printedmanual}% \else % _ (for example) has to be the character _ for the purposes of the % control sequence corresponding to the node, but it has to expand % into the usual \leavevmode...\vrule stuff for purposes of % printing. So we \turnoffactive for the \refx-snt, back on for the % printing, back off for the \refx-pg. - {\turnoffactive \refx{#1-snt}{}}% - \space [\printednodename],\space + {\normalturnoffactive + % Only output a following space if the -snt ref is nonempty; for + % @unnumbered and @anchor, it won't be. + \setbox2 = \hbox{\ignorespaces \refx{#1-snt}{}}% + \ifdim \wd2 > 0pt \refx{#1-snt}\space\fi + }% + % [mynode], + [\printednodename],\space + % page 3 \turnoffactive \putwordpage\tie\refx{#1-pg}{}% \fi + \endlink \endgroup} % \dosetq is the interface for calls from other macros -% Use \turnoffactive so that punctuation chars such as underscore -% work in node names. -\def\dosetq #1#2{{\let\folio=0 \turnoffactive \auxhat% -\edef\next{\write\auxfile{\internalsetq {#1}{#2}}}% -\next}} +% Use \normalturnoffactive so that punctuation chars such as underscore +% and backslash work in node names. (\turnoffactive doesn't do \.) +\def\dosetq#1#2{% + {\let\folio=0% + \normalturnoffactive + \edef\next{\write\auxfile{\internalsetq{#1}{#2}}}% + \iflinks + \next + \fi + }% +} % \internalsetq {foo}{page} expands into % CHARACTERS 'xrdef {foo}{...expansion of \Ypage...} @@ -4097,13 +5339,15 @@ width0pt\relax} \fi \def\refx#1#2{% \expandafter\ifx\csname X#1\endcsname\relax % If not defined, say something at least. - $\langle$un\-de\-fined$\rangle$% - \ifhavexrefs - \message{\linenumber Undefined cross reference `#1'.}% - \else - \ifwarnedxrefs\else - \global\warnedxrefstrue - \message{Cross reference values unknown; you must run TeX again.}% + \angleleft un\-de\-fined\angleright + \iflinks + \ifhavexrefs + \message{\linenumber Undefined cross reference `#1'.}% + \else + \ifwarnedxrefs\else + \global\warnedxrefstrue + \message{Cross reference values unknown; you must run TeX again.}% + \fi \fi \fi \else @@ -4113,84 +5357,101 @@ width0pt\relax} \fi #2% Output the suffix in any case. } -% Read the last existing aux file, if any. No error if none exists. - % This is the macro invoked by entries in the aux file. -\def\xrdef #1#2{ -{\catcode`\'=\other\expandafter \gdef \csname X#1\endcsname {#2}}} +% +\def\xrdef#1{\begingroup + % Reenable \ as an escape while reading the second argument. + \catcode`\\ = 0 + \afterassignment\endgroup + \expandafter\gdef\csname X#1\endcsname +} -\def\readauxfile{% -\begingroup -\catcode `\^^@=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\^^C=\other -\catcode `\^^D=\other -\catcode `\^^E=\other -\catcode `\^^F=\other -\catcode `\^^G=\other -\catcode `\^^H=\other -\catcode `\ =\other -\catcode `\^^L=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode `\=\other -\catcode 26=\other -\catcode `\^^[=\other -\catcode `\^^\=\other -\catcode `\^^]=\other -\catcode `\^^^=\other -\catcode `\^^_=\other -\catcode `\@=\other -\catcode `\^=\other -\catcode `\~=\other -\catcode `\[=\other -\catcode `\]=\other -\catcode`\"=\other -\catcode`\_=\other -\catcode`\|=\other -\catcode`\<=\other -\catcode`\>=\other -\catcode `\$=\other -\catcode `\#=\other -\catcode `\&=\other -% `\+ does not work, so use 43. -\catcode 43=\other -% Make the characters 128-255 be printing characters -{% - \count 1=128 - \def\loop{% - \catcode\count 1=\other - \advance\count 1 by 1 - \ifnum \count 1<256 \loop \fi +% Read the last existing aux file, if any. No error if none exists. +\def\readauxfile{\begingroup + \catcode`\^^@=\other + \catcode`\^^A=\other + \catcode`\^^B=\other + \catcode`\^^C=\other + \catcode`\^^D=\other + \catcode`\^^E=\other + \catcode`\^^F=\other + \catcode`\^^G=\other + \catcode`\^^H=\other + \catcode`\^^K=\other + \catcode`\^^L=\other + \catcode`\^^N=\other + \catcode`\^^P=\other + \catcode`\^^Q=\other + \catcode`\^^R=\other + \catcode`\^^S=\other + \catcode`\^^T=\other + \catcode`\^^U=\other + \catcode`\^^V=\other + \catcode`\^^W=\other + \catcode`\^^X=\other + \catcode`\^^Z=\other + \catcode`\^^[=\other + \catcode`\^^\=\other + \catcode`\^^]=\other + \catcode`\^^^=\other + \catcode`\^^_=\other + \catcode`\@=\other + \catcode`\^=\other + % It was suggested to define this as 7, which would allow ^^e4 etc. + % in xref tags, i.e., node names. But since ^^e4 notation isn't + % supported in the main text, it doesn't seem desirable. Furthermore, + % that is not enough: for node names that actually contain a ^ + % character, we would end up writing a line like this: 'xrdef {'hat + % b-title}{'hat b} and \xrdef does a \csname...\endcsname on the first + % argument, and \hat is not an expandable control sequence. It could + % all be worked out, but why? Either we support ^^ or we don't. + % + % The other change necessary for this was to define \auxhat: + % \def\auxhat{\def^{'hat }}% extra space so ok if followed by letter + % and then to call \auxhat in \setq. + % + \catcode`\~=\other + \catcode`\[=\other + \catcode`\]=\other + \catcode`\"=\other + \catcode`\_=\other + \catcode`\|=\other + \catcode`\<=\other + \catcode`\>=\other + \catcode`\$=\other + \catcode`\#=\other + \catcode`\&=\other + \catcode`+=\other % avoid \+ for paranoia even though we've turned it off + % Make the characters 128-255 be printing characters + {% + \count 1=128 + \def\loop{% + \catcode\count 1=\other + \advance\count 1 by 1 + \ifnum \count 1<256 \loop \fi + }% }% -}% -% the aux file uses ' as the escape. -% Turn off \ as an escape so we do not lose on -% entries which were dumped with control sequences in their names. -% For example, 'xrdef {$\leq $-fun}{page ...} made by @defun ^^ -% Reference to such entries still does not work the way one would wish, -% but at least they do not bomb out when the aux file is read in. -\catcode `\{=1 \catcode `\}=2 -\catcode `\%=\other -\catcode `\'=0 -\catcode`\^=7 % to make ^^e4 etc usable in xref tags -\catcode `\\=\other -\openin 1 \jobname.aux -\ifeof 1 \else \closein 1 \input \jobname.aux \global\havexrefstrue -\global\warnedobstrue -\fi -% Open the new aux file. Tex will close it automatically at exit. -\openout \auxfile=\jobname.aux + % The aux file uses ' as the escape (for now). + % Turn off \ as an escape so we do not lose on + % entries which were dumped with control sequences in their names. + % For example, 'xrdef {$\leq $-fun}{page ...} made by @defun ^^ + % Reference to such entries still does not work the way one would wish, + % but at least they do not bomb out when the aux file is read in. + \catcode`\{=1 + \catcode`\}=2 + \catcode`\%=\other + \catcode`\'=0 + \catcode`\\=\other + % + \openin 1 \jobname.aux + \ifeof 1 \else + \closein 1 + \input \jobname.aux + \global\havexrefstrue + \global\warnedobstrue + \fi + % Open the new aux file. TeX will close it automatically at exit. + \openout\auxfile=\jobname.aux \endgroup} @@ -4201,10 +5462,11 @@ width0pt\relax} \fi % The trailing space in the following definition for supereject is % vital for proper filling; pages come out unaligned when you do a % pagealignmacro call if that space before the closing brace is -% removed. +% removed. (Generally, numeric constants should always be followed by a +% space to prevent strange expansion errors.) \def\supereject{\par\penalty -20000\footnoteno =0 } -% @footnotestyle is meaningful for info output only.. +% @footnotestyle is meaningful for info output only. \let\footnotestyle=\comment \let\ptexfootnote=\footnote @@ -4230,7 +5492,11 @@ width0pt\relax} \fi % Don't bother with the trickery in plain.tex to not require the % footnote text as a parameter. Our footnotes don't need to be so general. % -\long\gdef\footnotezzz#1{\insert\footins{% +% Oh yes, they do; otherwise, @ifset and anything else that uses +% \parseargline fail inside footnotes because the tokens are fixed when +% the footnote is read. --karl, 16nov96. +% +\long\gdef\footnotezzz{\insert\footins\bgroup % We want to typeset this text as a normal paragraph, even if the % footnote reference occurs in (for example) a display environment. % So reset some parameters. @@ -4244,6 +5510,8 @@ width0pt\relax} \fi \xspaceskip\z@skip \parindent\defaultparindent % + \smallfonts \rm + % % Hang the footnote text off the number. \hang \textindent{\thisfootno}% @@ -4252,8 +5520,13 @@ width0pt\relax} \fi % expands into a box, it must come within the paragraph, lest it % provide a place where TeX can split the footnote. \footstrut - #1\strut}% + \futurelet\next\fo@t } +\def\fo@t{\ifcat\bgroup\noexpand\next \let\next\f@@t + \else\let\next\f@t\fi \next} +\def\f@@t{\bgroup\aftergroup\@foot\let\next} +\def\f@t#1{#1\@foot} +\def\@foot{\strut\par\egroup} }%end \catcode `\@=11 @@ -4310,31 +5583,117 @@ width0pt\relax} \fi % \def\finalout{\overfullrule=0pt} +% @image. We use the macros from epsf.tex to support this. +% If epsf.tex is not installed and @image is used, we complain. +% +% Check for and read epsf.tex up front. If we read it only at @image +% time, we might be inside a group, and then its definitions would get +% undone and the next image would fail. +\openin 1 = epsf.tex +\ifeof 1 \else + \closein 1 + % Do not bother showing banner with post-v2.7 epsf.tex (available in + % doc/epsf.tex until it shows up on ctan). + \def\epsfannounce{\toks0 = }% + \input epsf.tex +\fi +% +% We will only complain once about lack of epsf.tex. +\newif\ifwarnednoepsf +\newhelp\noepsfhelp{epsf.tex must be installed for images to + work. It is also included in the Texinfo distribution, or you can get + it from ftp://tug.org/tex/epsf.tex.} +% +\def\image#1{% + \ifx\epsfbox\undefined + \ifwarnednoepsf \else + \errhelp = \noepsfhelp + \errmessage{epsf.tex not found, images will be ignored}% + \global\warnednoepsftrue + \fi + \else + \imagexxx #1,,,\finish + \fi +} +% +% Arguments to @image: +% #1 is (mandatory) image filename; we tack on .eps extension. +% #2 is (optional) width, #3 is (optional) height. +% #4 is just the usual extra ignored arg for parsing this stuff. +\def\imagexxx#1,#2,#3,#4\finish{% + \ifpdf + \centerline{\dopdfimage{#1}{#2}{#3}}% + \else + % \epsfbox itself resets \epsf?size at each figure. + \setbox0 = \hbox{\ignorespaces #2}\ifdim\wd0 > 0pt \epsfxsize=#2\relax \fi + \setbox0 = \hbox{\ignorespaces #3}\ifdim\wd0 > 0pt \epsfysize=#3\relax \fi + \begingroup + \catcode`\^^M = 5 % in case we're inside an example + % If the image is by itself, center it. + \ifvmode + \nobreak\bigskip + % Usually we'll have text after the image which will insert + % \parskip glue, so insert it here too to equalize the space + % above and below. + \nobreak\vskip\parskip + \nobreak + \centerline{\epsfbox{#1.eps}}% + \bigbreak + \else + % In the middle of a paragraph, no extra space. + \epsfbox{#1.eps}% + \fi + \endgroup + \fi +} -% End of control word definitions. -\message{and turning on texinfo input format.} +\message{localization,} +% and i18n. -\def\openindices{% - \newindex{cp}% - \newcodeindex{fn}% - \newcodeindex{vr}% - \newcodeindex{tp}% - \newcodeindex{ky}% - \newcodeindex{pg}% +% @documentlanguage is usually given very early, just after +% @setfilename. If done too late, it may not override everything +% properly. Single argument is the language abbreviation. +% It would be nice if we could set up a hyphenation file here. +% +\def\documentlanguage{\parsearg\dodocumentlanguage} +\def\dodocumentlanguage#1{% + \tex % read txi-??.tex file in plain TeX. + % Read the file if it exists. + \openin 1 txi-#1.tex + \ifeof1 + \errhelp = \nolanghelp + \errmessage{Cannot read language file txi-#1.tex}% + \let\temp = \relax + \else + \def\temp{\input txi-#1.tex }% + \fi + \temp + \endgroup } +\newhelp\nolanghelp{The given language definition file cannot be found or +is empty. Maybe you need to install it? In the current directory +should work if nowhere else does.} -% Set some numeric style parameters, for 8.5 x 11 format. -%\hsize = 6.5in +% @documentencoding should change something in TeX eventually, most +% likely, but for now just recognize it. +\let\documentencoding = \comment + + +% Page size parameters. +% \newdimen\defaultparindent \defaultparindent = 15pt -\parindent = \defaultparindent -\parskip 18pt plus 1pt -\setleading{15pt} -\advance\topskip by 1.2cm + +\chapheadingskip = 15pt plus 4pt minus 2pt +\secheadingskip = 12pt plus 3pt minus 2pt +\subsecheadingskip = 9pt plus 2pt minus 2pt % Prevent underfull vbox error messages. -\vbadness=10000 +\vbadness = 10000 + +% Don't be so finicky about underfull hboxes, either. +\hbadness = 2000 % Following George Bush, just get rid of widows and orphans. \widowpenalty=10000 @@ -4343,98 +5702,127 @@ width0pt\relax} \fi % Use TeX 3.0's \emergencystretch to help line breaking, but if we're % using an old version of TeX, don't do anything. We want the amount of % stretch added to depend on the line length, hence the dependence on -% \hsize. This makes it come to about 9pt for the 8.5x11 format. +% \hsize. We call this whenever the paper size is set. % -\ifx\emergencystretch\thisisundefined - % Allow us to assign to \emergencystretch anyway. - \def\emergencystretch{\dimen0}% -\else - \emergencystretch = \hsize - \divide\emergencystretch by 45 -\fi - -% Use @smallbook to reset parameters for 7x9.5 format (or else 7x9.25) -\def\smallbook{ - -% These values for secheadingskip and subsecheadingskip are -% experiments. RJC 7 Aug 1992 -\global\secheadingskip = 17pt plus 6pt minus 3pt -\global\subsecheadingskip = 14pt plus 6pt minus 3pt +\def\setemergencystretch{% + \ifx\emergencystretch\thisisundefined + % Allow us to assign to \emergencystretch anyway. + \def\emergencystretch{\dimen0}% + \else + \emergencystretch = .15\hsize + \fi +} -\global\lispnarrowing = 0.3in -\setleading{12pt} -\advance\topskip by -1cm -\global\parskip 3pt plus 1pt -\global\hsize = 5in -\global\vsize=7.5in -\global\tolerance=700 -\global\hfuzz=1pt -\global\contentsrightmargin=0pt -\global\deftypemargin=0pt -\global\defbodyindent=.5cm +% Parameters in order: 1) textheight; 2) textwidth; 3) voffset; +% 4) hoffset; 5) binding offset; 6) topskip. Then whoever calls us can +% set \parskip and call \setleading for \baselineskip. +% +\def\internalpagesizes#1#2#3#4#5#6{% + \voffset = #3\relax + \topskip = #6\relax + \splittopskip = \topskip + % + \vsize = #1\relax + \advance\vsize by \topskip + \outervsize = \vsize + \advance\outervsize by 2\topandbottommargin + \pageheight = \vsize + % CLN wants a little wider page, hence we enlarge the width by 0.6in... + \hsize = #2\relax + \outerhsize = \hsize + \advance\outerhsize by 0.5in + \advance\hsize by 0.6in + \pagewidth = \hsize + % ...wich also calls for a change in the hoffset. + \normaloffset = #4\relax + \advance\normaloffset by -0.3in + \bindingoffset = #5\relax + % + \parindent = \defaultparindent + \setemergencystretch +} -\global\pagewidth=\hsize -\global\pageheight=\vsize +% @letterpaper (the default). +\def\letterpaper{{\globaldefs = 1 + \parskip = 3pt plus 2pt minus 1pt + \setleading{13.2pt}% + % + % If page is nothing but text, make it come out even. + \internalpagesizes{46\baselineskip}{6in}{\voffset}{.25in}{\bindingoffset}{36pt}% +}} -\global\let\smalllisp=\smalllispx -\global\let\smallexample=\smalllispx -\global\def\Esmallexample{\Esmalllisp} -} +% Use @smallbook to reset parameters for 7x9.5 (or so) format. +\def\smallbook{{\globaldefs = 1 + \parskip = 2pt plus 1pt + \setleading{12pt}% + % + \internalpagesizes{7.5in}{5.in}{\voffset}{.25in}{\bindingoffset}{16pt}% + % + \lispnarrowing = 0.3in + \tolerance = 700 + \hfuzz = 1pt + \contentsrightmargin = 0pt + \deftypemargin = 0pt + \defbodyindent = .5cm + % + \let\smalldisplay = \smalldisplayx + \let\smallexample = \smalllispx + \let\smallformat = \smallformatx + \let\smalllisp = \smalllispx +}} % Use @afourpaper to print on European A4 paper. -\def\afourpaper{ -\global\tolerance=700 -\global\hfuzz=1pt -\setleading{12pt} -\global\parskip 15pt plus 1pt - -\global\vsize= 53\baselineskip -\advance\vsize by \topskip -%\global\hsize= 5.85in % A4 wide 10pt -\global\hsize= 6.5in -\global\outerhsize=\hsize -\global\advance\outerhsize by 0.5in -\global\outervsize=\vsize -\global\advance\outervsize by 0.6in - -\global\pagewidth=\hsize -\global\pageheight=\vsize -} - -% Allow control of the text dimensions. Parameters in order: textheight; -% textwidth; voffset; hoffset; binding offset; topskip. -% All require a dimension; -% header is additional; added length extends the bottom of the page. - -\def\changepagesizes#1#2#3#4#5#6{ - \global\vsize= #1 - \global\topskip= #6 - \advance\vsize by \topskip - \global\voffset= #3 - \global\hsize= #2 - \global\outerhsize=\hsize - \global\advance\outerhsize by 0.5in - \global\outervsize=\vsize - \global\advance\outervsize by 0.6in - \global\pagewidth=\hsize - \global\pageheight=\vsize - \global\normaloffset= #4 - \global\bindingoffset= #5} +\def\afourpaper{{\globaldefs = 1 + \setleading{12pt}% + \parskip = 3pt plus 2pt minus 1pt + % + \internalpagesizes{53\baselineskip}{160mm}{\voffset}{4mm}{\bindingoffset}{44pt}% + % + \tolerance = 700 + \hfuzz = 1pt +}} % A specific text layout, 24x15cm overall, intended for A4 paper. Top margin % 29mm, hence bottom margin 28mm, nominal side margin 3cm. -\def\afourlatex - {\global\tolerance=700 - \global\hfuzz=1pt - \setleading{12pt} - \global\parskip 15pt plus 1pt - \advance\baselineskip by 1.6pt - \changepagesizes{237mm}{150mm}{3.6mm}{3.6mm}{3mm}{7mm} - } +\def\afourlatex{{\globaldefs = 1 + \setleading{13.6pt}% + % + \afourpaper + \internalpagesizes{237mm}{150mm}{3.6mm}{3.6mm}{3mm}{7mm}% + % + \globaldefs = 0 +}} % Use @afourwide to print on European A4 paper in wide format. -\def\afourwide{\afourpaper -\changepagesizes{9.5in}{6.5in}{\hoffset}{\normaloffset}{\bindingoffset}{7mm}} +\def\afourwide{% + \afourpaper + \internalpagesizes{6.5in}{9.5in}{\hoffset}{\normaloffset}{\bindingoffset}{7mm}% + % + \globaldefs = 0 +} + +% @pagesizes TEXTHEIGHT[,TEXTWIDTH] +% Perhaps we should allow setting the margins, \topskip, \parskip, +% and/or leading, also. Or perhaps we should compute them somehow. +% +\def\pagesizes{\parsearg\pagesizesxxx} +\def\pagesizesxxx#1{\pagesizesyyy #1,,\finish} +\def\pagesizesyyy#1,#2,#3\finish{{% + \setbox0 = \hbox{\ignorespaces #2}\ifdim\wd0 > 0pt \hsize=#2\relax \fi + \globaldefs = 1 + % + \parskip = 3pt plus 2pt minus 1pt + \setleading{13.2pt}% + % + \internalpagesizes{#1}{\hsize}{\voffset}{\normaloffset}{\bindingoffset}{44pt}% +}} + +% Set default to letter. +% +\letterpaper + + +\message{and turning on texinfo input format.} % Define macros to output various characters with catcode for normal text. \catcode`\"=\other @@ -4445,6 +5833,7 @@ width0pt\relax} \fi \catcode`\<=\other \catcode`\>=\other \catcode`\+=\other +\catcode`\$=\other \def\normaldoublequote{"} \def\normaltilde{~} \def\normalcaret{^} @@ -4453,6 +5842,7 @@ width0pt\relax} \fi \def\normalless{<} \def\normalgreater{>} \def\normalplus{+} +\def\normaldollar{$} % This macro is used to make a character print one way in ttfont % where it can probably just be output, and another way in other fonts, @@ -4463,7 +5853,13 @@ width0pt\relax} \fi % interword stretch (and shrink), and it is reasonable to expect all % typewriter fonts to have this, we can check that font parameter. % -\def\ifusingtt#1#2{\ifdim \fontdimen3\the\font=0pt #1\else #2\fi} +\def\ifusingtt#1#2{\ifdim \fontdimen3\font=0pt #1\else #2\fi} + +% Same as above, but check for italic font. Actually this also catches +% non-italic slanted fonts since it is impossible to distinguish them from +% italic fonts. But since this is only used by $ and it uses \sl anyway +% this is not a problem. +\def\ifusingit#1#2{\ifdim \fontdimen1\font>0pt #1\else #2\fi} % Turn off all special characters except @ % (and those which the user can use as if they were ordinary). @@ -4471,13 +5867,12 @@ width0pt\relax} \fi % use math or other variants that look better in normal text. \catcode`\"=\active -\def\activedoublequote{{\tt \char '042}} +\def\activedoublequote{{\tt\char34}} \let"=\activedoublequote \catcode`\~=\active -\def~{{\tt \char '176}} +\def~{{\tt\char126}} \chardef\hat=`\^ \catcode`\^=\active -\def\auxhat{\def^{'hat}} \def^{{\tt \hat}} \catcode`\_=\active @@ -4486,7 +5881,7 @@ width0pt\relax} \fi \def\_{\leavevmode \kern.06em \vbox{\hrule width.3em height.1ex}} \catcode`\|=\active -\def|{{\tt \char '174}} +\def|{{\tt\char124}} \chardef \less=`\< \catcode`\<=\active \def<{{\tt \less}} @@ -4495,6 +5890,8 @@ width0pt\relax} \fi \def>{{\tt \gtr}} \catcode`\+=\active \def+{{\tt \char 43}} +\catcode`\$=\active +\def${\ifusingit{{\sl\$}}\normaldollar} %\catcode 27=\active %\def^^[{$\diamondsuit$} @@ -4525,9 +5922,6 @@ width0pt\relax} \fi % \normalbackslash outputs one backslash in fixed width font. \def\normalbackslash{{\tt\rawbackslashxx}} -% Say @foo, not \foo, in error messages. -\escapechar=`\@ - % \catcode 17=0 % Define control-q \catcode`\\=\active @@ -4541,7 +5935,8 @@ width0pt\relax} \fi @let|=@normalverticalbar @let<=@normalless @let>=@normalgreater -@let+=@normalplus} +@let+=@normalplus +@let$=@normaldollar} @def@normalturnoffactive{@let"=@normaldoublequote @let\=@normalbackslash @@ -4551,7 +5946,8 @@ width0pt\relax} \fi @let|=@normalverticalbar @let<=@normalless @let>=@normalgreater -@let+=@normalplus} +@let+=@normalplus +@let$=@normaldollar} % Make _ and + \other characters, temporarily. % This is canceled by @fixbackslash. @@ -4570,16 +5966,29 @@ width0pt\relax} \fi % Also back turn on active characters that might appear in the input % file name, in case not using a pre-dumped format. % -@gdef@fixbackslash{@ifx\@eatinput @let\ = @normalbackslash @fi - @catcode`+=@active @catcode`@_=@active} +@gdef@fixbackslash{% + @ifx\@eatinput @let\ = @normalbackslash @fi + @catcode`+=@active + @catcode`@_=@active +} + +% Say @foo, not \foo, in error messages. +@escapechar = `@@ -%% These look ok in all fonts, so just make them not special. The @rm below -%% makes sure that the current font starts out as the newly loaded cmr10 -@catcode`@$=@other @catcode`@%=@other @catcode`@&=@other @catcode`@#=@other +% These look ok in all fonts, so just make them not special. +@catcode`@& = @other +@catcode`@# = @other +@catcode`@% = @other +@c Set initial fonts. @textfonts @rm + @c Local variables: +@c eval: (add-hook 'write-file-hooks 'time-stamp) @c page-delimiter: "^\\\\message" +@c time-stamp-start: "def\\\\texinfoversion{" +@c time-stamp-format: "%:y-%02m-%02d.%02H" +@c time-stamp-end: "}" @c End: -- 2.49.0

  • 2.1.3 Sed utility