php_libraries/php_lib_uculib_com/rat_string_arithmetic.inc

<?php
//********************************************************************************
//Copyright (C) 2007 David T. Ashley
//********************************************************************************
//This program or source file is free software; you can redistribute it and/or
//modify it under the terms of the GNU Lesser General Public License as published
//by the Free Software Foundation; either version 2 of the License, or (at your
//option) any later version.
//
//This program or source 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 may have received a copy of the GNU Lesser General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//********************************************************************************
//Arithmetic on rational numbers expressed as strings.
//--------------------------------------------------------------------------------
//Format of rational numbers expressed as strings:
//
//  a)Each rational number is "x:y", where x is an integer with an optional 
//    unary "-" sign, and y is a positive integer.
//
//  b)In addition to numerical values, the string "NAN" (not a number) is
//    recognized.   "NAN" combined with anything else is "NAN".
//
//  c)The canonical representation of zero is 0:y, where y is any positive
//    integer.
//
//  d)Rational numbers are not required to be reduced except where otherwise
//    documented.
//
//       d1)The arithmetic functions reduce results by default, but
//          each has an optional argument to suppress reduction.  The typical reasons
//          for suppressing reduction are:
//
//             d1a)Efficiency.
//
//             d1b)Aesthetics -- some reason the output should be left as-is.
//
//       d2)Functions that require reduced rational numbers must reduce
//          them (in general).
//
//  e)Only the numerator may carry an optional minus sign.  The denominator
//    must not have a negative sign.
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//----  R E D U C T I O N    -----------------------------------------------------
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//Reduces a rational number as two components.
//
function RATSTRARITH_reduce_rn_components(&$arg_num, &$arg_den)
   {
   }
//
//--------------------------------------------------------------------------------
//Reduces a rational number in the allowable canonical form.
//
function RATSTRARITH_reduce_rn_integrated($in_rn)
   {
   }
//
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//----  A S S I G N M E N T  -----------------------------------------------------
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//Assigns a rational number from two integers.  Reduction can be suppressed, but
//treatment of sign and the canonical representation of zero cannot be
//suppressed.
//
//Arguments may be integers or strings or any mix.
//
function RATSTRARITH_assign_from_ints($in_num, $in_den, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//Splits a rational number in the canonical form as a string into components.
//
function RATSTRARITH_split($in_rn, &out_num, &$out_den, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//Assigns a rational number from a string.  The formats accepted are:
//  a)Integer format (i.e. "25", "-2,352", etc.).
//  b)Scientific notation, i.e. "3.12451234e+3".
//  c)Integer fraction, i.e. "412/332234".
//  
//
function RATSTRARITH_assign_from_string($in_rn, &out_num, &$out_den, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//----  T E S T S  ---------------------------------------------------------------
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//Compares two rational numbers.  NAN's in either operand always cause
//zero to be returned.  Returned values are the traditional -1, 0, 1.
//
function RATSTRARITH_cmp($in_rn1, $in_rn2)
   {
   }
//
//--------------------------------------------------------------------------------
//Returns -1 if the rational number is < 0, 0 if it is 0, or 1 if it is
//positive.  Returned value is integer rather than string.  NAN causes
//return value of zero.
//
function RATSTRARITH_sgn($in_arg)
   {
   }
//
//--------------------------------------------------------------------------------
//Returns TRUE if the rational number is NAN, or FALSE otherwise.
//
function RATSTRARITH_is_nan($in_arg)
   {
   }
//
//--------------------------------------------------------------------------------
//Returns TRUE if the rational number is a whole integer, or FALSE otherwise.
//NAN causes return value of zero.
//
function RATSTRARITH_is_int($in_arg)
   {
   }
//
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//----  E L E M E N T A L    O P E R A T I O N S  --------------------------------
//--------------------------------------------------------------------------------
//--------------------------------------------------------------------------------
//Adds two rational numbers.
//
function RATSTRARITH_add($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//Subtracts two rational numbers.
//
function RATSTRARITH_sub($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//Multiplies two rational numbers.
//
function RATSTRARITH_sub($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
   {
   }
//
//--------------------------------------------------------------------------------
//Divides two rational numbers.
//
function RATSTRARITH_div($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
   {
   }
//
//
?>
1	dashley	35	<?php
2			//********************************************************************************
3			//Copyright (C) 2007 David T. Ashley
4			//********************************************************************************
5			//This program or source file is free software; you can redistribute it and/or
6			//modify it under the terms of the GNU Lesser General Public License as published
7			//by the Free Software Foundation; either version 2 of the License, or (at your
8			//option) any later version.
9			//
10			//This program or source file is distributed in the hope that it will
11			//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
12			//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13			//GNU General Public License for more details.
14			//
15			//You may have received a copy of the GNU Lesser General Public License
16			//along with this program; if not, write to the Free Software
17			//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18			//********************************************************************************
19			//Arithmetic on rational numbers expressed as strings.
20			//--------------------------------------------------------------------------------
21			//Format of rational numbers expressed as strings:
22			//
23			// a)Each rational number is "x:y", where x is an integer with an optional
24			// unary "-" sign, and y is a positive integer.
25			//
26			// b)In addition to numerical values, the string "NAN" (not a number) is
27			// recognized. "NAN" combined with anything else is "NAN".
28			//
29			// c)The canonical representation of zero is 0:y, where y is any positive
30			// integer.
31			//
32			// d)Rational numbers are not required to be reduced except where otherwise
33			// documented.
34			//
35			// d1)The arithmetic functions reduce results by default, but
36			// each has an optional argument to suppress reduction. The typical reasons
37			// for suppressing reduction are:
38			//
39			// d1a)Efficiency.
40			//
41			// d1b)Aesthetics -- some reason the output should be left as-is.
42			//
43			// d2)Functions that require reduced rational numbers must reduce
44			// them (in general).
45			//
46			// e)Only the numerator may carry an optional minus sign. The denominator
47			// must not have a negative sign.
48			//--------------------------------------------------------------------------------
49			//--------------------------------------------------------------------------------
50			//---- R E D U C T I O N -----------------------------------------------------
51			//--------------------------------------------------------------------------------
52			//--------------------------------------------------------------------------------
53			//Reduces a rational number as two components.
54			//
55			function RATSTRARITH_reduce_rn_components(&$arg_num, &$arg_den)
56			{
57			}
58			//
59			//--------------------------------------------------------------------------------
60			//Reduces a rational number in the allowable canonical form.
61			//
62			function RATSTRARITH_reduce_rn_integrated($in_rn)
63			{
64			}
65			//
66			//--------------------------------------------------------------------------------
67			//--------------------------------------------------------------------------------
68			//---- A S S I G N M E N T -----------------------------------------------------
69			//--------------------------------------------------------------------------------
70			//--------------------------------------------------------------------------------
71			//Assigns a rational number from two integers. Reduction can be suppressed, but
72			//treatment of sign and the canonical representation of zero cannot be
73			//suppressed.
74			//
75			//Arguments may be integers or strings or any mix.
76			//
77			function RATSTRARITH_assign_from_ints($in_num, $in_den, $in_suppress_reduction = FALSE)
78			{
79			}
80			//
81			//--------------------------------------------------------------------------------
82			//Splits a rational number in the canonical form as a string into components.
83			//
84			function RATSTRARITH_split($in_rn, &out_num, &$out_den, $in_suppress_reduction = FALSE)
85			{
86			}
87			//
88			//--------------------------------------------------------------------------------
89			//Assigns a rational number from a string. The formats accepted are:
90			// a)Integer format (i.e. "25", "-2,352", etc.).
91			// b)Scientific notation, i.e. "3.12451234e+3".
92			// c)Integer fraction, i.e. "412/332234".
93			//
94			//
95			function RATSTRARITH_assign_from_string($in_rn, &out_num, &$out_den, $in_suppress_reduction = FALSE)
96			{
97			}
98			//
99			//--------------------------------------------------------------------------------
100			//--------------------------------------------------------------------------------
101			//---- T E S T S ---------------------------------------------------------------
102			//--------------------------------------------------------------------------------
103			//--------------------------------------------------------------------------------
104			//Compares two rational numbers. NAN's in either operand always cause
105			//zero to be returned. Returned values are the traditional -1, 0, 1.
106			//
107			function RATSTRARITH_cmp($in_rn1, $in_rn2)
108			{
109			}
110			//
111			//--------------------------------------------------------------------------------
112			//Returns -1 if the rational number is < 0, 0 if it is 0, or 1 if it is
113			//positive. Returned value is integer rather than string. NAN causes
114			//return value of zero.
115			//
116			function RATSTRARITH_sgn($in_arg)
117			{
118			}
119			//
120			//--------------------------------------------------------------------------------
121			//Returns TRUE if the rational number is NAN, or FALSE otherwise.
122			//
123			function RATSTRARITH_is_nan($in_arg)
124			{
125			}
126			//
127			//--------------------------------------------------------------------------------
128			//Returns TRUE if the rational number is a whole integer, or FALSE otherwise.
129			//NAN causes return value of zero.
130			//
131			function RATSTRARITH_is_int($in_arg)
132			{
133			}
134			//
135			//--------------------------------------------------------------------------------
136			//--------------------------------------------------------------------------------
137			//---- E L E M E N T A L O P E R A T I O N S --------------------------------
138			//--------------------------------------------------------------------------------
139			//--------------------------------------------------------------------------------
140			//Adds two rational numbers.
141			//
142			function RATSTRARITH_add($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
143			{
144			}
145			//
146			//--------------------------------------------------------------------------------
147			//Subtracts two rational numbers.
148			//
149			function RATSTRARITH_sub($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
150			{
151			}
152			//
153			//--------------------------------------------------------------------------------
154			//Multiplies two rational numbers.
155			//
156			function RATSTRARITH_sub($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
157			{
158			}
159			//
160			//--------------------------------------------------------------------------------
161			//Divides two rational numbers.
162			//
163			function RATSTRARITH_div($in_rn1, $in_rn2, $in_suppress_reduction = FALSE)
164			{
165			}
166			//
167			//
168			?>