Annotation of 43BSD/usr.lib/libm/pow.c, revision 1.1.1.1

1.1       root        1: /* 
                      2:  * Copyright (c) 1985 Regents of the University of California.
                      3:  * 
                      4:  * Use and reproduction of this software are granted  in  accordance  with
                      5:  * the terms and conditions specified in  the  Berkeley  Software  License
                      6:  * Agreement (in particular, this entails acknowledgement of the programs'
                      7:  * source, and inclusion of this notice) with the additional understanding
                      8:  * that  all  recipients  should regard themselves as participants  in  an
                      9:  * ongoing  research  project and hence should  feel  obligated  to report
                     10:  * their  experiences (good or bad) with these elementary function  codes,
                     11:  * using "sendbug 4bsd-bugs@BERKELEY", to the authors.
                     12:  */
                     13: 
                     14: #ifndef lint
                     15: static char sccsid[] = "@(#)pow.c      4.5 (Berkeley) 8/21/85";
                     16: #endif not lint
                     17: 
                     18: /* POW(X,Y)  
                     19:  * RETURN X**Y 
                     20:  * DOUBLE PRECISION (VAX D format 56 bits, IEEE DOUBLE 53 BITS)
                     21:  * CODED IN C BY K.C. NG, 1/8/85; 
                     22:  * REVISED BY K.C. NG on 7/10/85.
                     23:  *
                     24:  * Required system supported functions:
                     25:  *      scalb(x,n)      
                     26:  *      logb(x)         
                     27:  *     copysign(x,y)   
                     28:  *     finite(x)       
                     29:  *     drem(x,y)
                     30:  *
                     31:  * Required kernel functions:
                     32:  *     exp__E(a,c)     ...return  exp(a+c) - 1 - a*a/2
                     33:  *     log__L(x)       ...return  (log(1+x) - 2s)/s, s=x/(2+x) 
                     34:  *     pow_p(x,y)      ...return  +(anything)**(finite non zero)
                     35:  *
                     36:  * Method
                     37:  *     1. Compute and return log(x) in three pieces:
                     38:  *             log(x) = n*ln2 + hi + lo,
                     39:  *        where n is an integer.
                     40:  *     2. Perform y*log(x) by simulating muti-precision arithmetic and 
                     41:  *        return the answer in three pieces:
                     42:  *             y*log(x) = m*ln2 + hi + lo,
                     43:  *        where m is an integer.
                     44:  *     3. Return x**y = exp(y*log(x))
                     45:  *             = 2^m * ( exp(hi+lo) ).
                     46:  *
                     47:  * Special cases:
                     48:  *     (anything) ** 0  is 1 ;
                     49:  *     (anything) ** 1  is itself;
                     50:  *     (anything) ** NaN is NaN;
                     51:  *     NaN ** (anything except 0) is NaN;
                     52:  *     +-(anything > 1) ** +INF is +INF;
                     53:  *     +-(anything > 1) ** -INF is +0;
                     54:  *     +-(anything < 1) ** +INF is +0;
                     55:  *     +-(anything < 1) ** -INF is +INF;
                     56:  *     +-1 ** +-INF is NaN and signal INVALID;
                     57:  *     +0 ** +(anything except 0, NaN)  is +0;
                     58:  *     -0 ** +(anything except 0, NaN, odd integer)  is +0;
                     59:  *     +0 ** -(anything except 0, NaN)  is +INF and signal DIV-BY-ZERO;
                     60:  *     -0 ** -(anything except 0, NaN, odd integer)  is +INF with signal;
                     61:  *     -0 ** (odd integer) = -( +0 ** (odd integer) );
                     62:  *     +INF ** +(anything except 0,NaN) is +INF;
                     63:  *     +INF ** -(anything except 0,NaN) is +0;
                     64:  *     -INF ** (odd integer) = -( +INF ** (odd integer) );
                     65:  *     -INF ** (even integer) = ( +INF ** (even integer) );
                     66:  *     -INF ** -(anything except integer,NaN) is NaN with signal;
                     67:  *     -(x=anything) ** (k=integer) is (-1)**k * (x ** k);
                     68:  *     -(anything except 0) ** (non-integer) is NaN with signal;
                     69:  *
                     70:  * Accuracy:
                     71:  *     pow(x,y) returns x**y nearly rounded. In particular, on a SUN, a VAX,
                     72:  *     and a Zilog Z8000,
                     73:  *                     pow(integer,integer)
                     74:  *     always returns the correct integer provided it is representable.
                     75:  *     In a test run with 100,000 random arguments with 0 < x, y < 20.0
                     76:  *     on a VAX, the maximum observed error was 1.79 ulps (units in the 
                     77:  *     last place).
                     78:  *
                     79:  * Constants :
                     80:  * The hexadecimal values are the intended ones for the following constants.
                     81:  * The decimal values may be used, provided that the compiler will convert
                     82:  * from decimal to binary accurately enough to produce the hexadecimal values
                     83:  * shown.
                     84:  */
                     85: 
                     86: #ifdef VAX     /* VAX D format */
                     87: #include <errno.h>
                     88: extern double infnan();
                     89: 
                     90: /* double static */
                     91: /* ln2hi  =  6.9314718055829871446E-1    , Hex  2^  0   *  .B17217F7D00000 */
                     92: /* ln2lo  =  1.6465949582897081279E-12   , Hex  2^-39   *  .E7BCD5E4F1D9CC */
                     93: /* invln2 =  1.4426950408889634148E0     , Hex  2^  1   *  .B8AA3B295C17F1 */
                     94: /* sqrt2  =  1.4142135623730950622E0     ; Hex  2^  1   *  .B504F333F9DE65 */
                     95: static long     ln2hix[] = { 0x72174031, 0x0000f7d0};
                     96: static long     ln2lox[] = { 0xbcd52ce7, 0xd9cce4f1};
                     97: static long    invln2x[] = { 0xaa3b40b8, 0x17f1295c};
                     98: static long     sqrt2x[] = { 0x04f340b5, 0xde6533f9};
                     99: #define    ln2hi    (*(double*)ln2hix)
                    100: #define    ln2lo    (*(double*)ln2lox)
                    101: #define   invln2    (*(double*)invln2x)
                    102: #define    sqrt2    (*(double*)sqrt2x)
                    103: #else  /* IEEE double */
                    104: double static
                    105: ln2hi  =  6.9314718036912381649E-1    , /*Hex  2^ -1   *  1.62E42FEE00000 */
                    106: ln2lo  =  1.9082149292705877000E-10   , /*Hex  2^-33   *  1.A39EF35793C76 */
                    107: invln2 =  1.4426950408889633870E0     , /*Hex  2^  0   *  1.71547652B82FE */
                    108: sqrt2  =  1.4142135623730951455E0     ; /*Hex  2^  0   *  1.6A09E667F3BCD */
                    109: #endif
                    110: 
                    111: double static zero=0.0, half=1.0/2.0, one=1.0, two=2.0, negone= -1.0;
                    112: 
                    113: double pow(x,y)        
                    114: double x,y;
                    115: {
                    116:        double drem(),pow_p(),copysign(),t;
                    117:        int finite();
                    118: 
                    119:        if     (y==zero)      return(one);
                    120:        else if(y==one
                    121: #ifndef VAX
                    122:                ||x!=x
                    123: #endif
                    124:                ) return( x );      /* if x is NaN or y=1 */
                    125: #ifndef VAX
                    126:        else if(y!=y)         return( y );      /* if y is NaN */
                    127: #endif
                    128:        else if(!finite(y))                     /* if y is INF */
                    129:             if((t=copysign(x,one))==one) return(zero/zero);
                    130:             else if(t>one) return((y>zero)?y:zero);
                    131:             else return((y<zero)?-y:zero);
                    132:        else if(y==two)       return(x*x);
                    133:        else if(y==negone)    return(one/x);
                    134: 
                    135:     /* sign(x) = 1 */
                    136:        else if(copysign(one,x)==one) return(pow_p(x,y));
                    137: 
                    138:     /* sign(x)= -1 */
                    139:        /* if y is an even integer */
                    140:        else if ( (t=drem(y,two)) == zero)      return( pow_p(-x,y) );
                    141: 
                    142:        /* if y is an odd integer */
                    143:        else if (copysign(t,one) == one) return( -pow_p(-x,y) );
                    144: 
                    145:        /* Henceforth y is not an integer */
                    146:        else if(x==zero)        /* x is -0 */
                    147:            return((y>zero)?-x:one/(-x));
                    148:        else {                  /* return NaN */
                    149: #ifdef VAX
                    150:            return (infnan(EDOM));      /* NaN */
                    151: #else  /* IEEE double */
                    152:            return(zero/zero);
                    153: #endif
                    154:        }
                    155: }
                    156: 
                    157: /* pow_p(x,y) return x**y for x with sign=1 and finite y */
                    158: static double pow_p(x,y)       
                    159: double x,y;
                    160: {
                    161:         double logb(),scalb(),copysign(),log__L(),exp__E();
                    162:         double c,s,t,z,tx,ty;
                    163:         float sx,sy;
                    164:        long k=0;
                    165:         int n,m;
                    166: 
                    167:        if(x==zero||!finite(x)) {           /* if x is +INF or +0 */
                    168: #ifdef VAX
                    169:             return((y>zero)?x:infnan(ERANGE)); /* if y<zero, return +INF */
                    170: #else
                    171:             return((y>zero)?x:one/x);
                    172: #endif
                    173:        }
                    174:        if(x==1.0) return(x);   /* if x=1.0, return 1 since y is finite */
                    175: 
                    176:     /* reduce x to z in [sqrt(1/2)-1, sqrt(2)-1] */
                    177:         z=scalb(x,-(n=logb(x)));  
                    178: #ifndef VAX    /* IEEE double */       /* subnormal number */
                    179:         if(n <= -1022) {n += (m=logb(z)); z=scalb(z,-m);} 
                    180: #endif
                    181:         if(z >= sqrt2 ) {n += 1; z *= half;}  z -= one ;
                    182: 
                    183:     /* log(x) = nlog2+log(1+z) ~ nlog2 + t + tx */
                    184:        s=z/(two+z); c=z*z*half; tx=s*(c+log__L(s*s)); 
                    185:        t= z-(c-tx); tx += (z-t)-c;
                    186: 
                    187:    /* if y*log(x) is neither too big nor too small */
                    188:        if((s=logb(y)+logb(n+t)) < 12.0) 
                    189:            if(s>-60.0) {
                    190: 
                    191:        /* compute y*log(x) ~ mlog2 + t + c */
                    192:                s=y*(n+invln2*t);
                    193:                 m=s+copysign(half,s);   /* m := nint(y*log(x)) */ 
                    194:                k=y; 
                    195:                if((double)k==y) {      /* if y is an integer */
                    196:                    k = m-k*n;
                    197:                    sx=t; tx+=(t-sx); }
                    198:                else    {               /* if y is not an integer */    
                    199:                    k =m;
                    200:                    tx+=n*ln2lo;
                    201:                    sx=(c=n*ln2hi)+t; tx+=(c-sx)+t; }
                    202:           /* end of checking whether k==y */
                    203: 
                    204:                 sy=y; ty=y-sy;          /* y ~ sy + ty */
                    205:                s=(double)sx*sy-k*ln2hi;        /* (sy+ty)*(sx+tx)-kln2 */
                    206:                z=(tx*ty-k*ln2lo);
                    207:                tx=tx*sy; ty=sx*ty;
                    208:                t=ty+z; t+=tx; t+=s;
                    209:                c= -((((t-s)-tx)-ty)-z);
                    210: 
                    211:            /* return exp(y*log(x)) */
                    212:                t += exp__E(t,c); return(scalb(one+t,m));
                    213:             }
                    214:        /* end of if log(y*log(x)) > -60.0 */
                    215:            
                    216:            else
                    217:                /* exp(+- tiny) = 1 with inexact flag */
                    218:                        {ln2hi+ln2lo; return(one);}
                    219:            else if(copysign(one,y)*(n+invln2*t) <zero)
                    220:                /* exp(-(big#)) underflows to zero */
                    221:                        return(scalb(one,-5000)); 
                    222:            else
                    223:                /* exp(+(big#)) overflows to INF */
                    224:                        return(scalb(one, 5000)); 
                    225: 
                    226: }

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.