|
|
1.1 ! root 1: .TH ARITH 3 ! 2: .CT 2 math ! 3: .SH NAME ! 4: abs, sgn, gcd, lcm, min, max, labs \(mi integer arithmetic functions: ! 5: absolute value, sign, ! 6: greatest common divisor, least common multiple, minimum, maximum ! 7: .SH SYNOPSIS ! 8: .B int abs(a) ! 9: .PP ! 10: .B int sgn(a) ! 11: .PP ! 12: .B int gcd(a, b) ! 13: .PP ! 14: .B long lcm(a, b) ! 15: .PP ! 16: .B int min(a, b) ! 17: .PP ! 18: .B int max(a, b) ! 19: .PP ! 20: .B long labs(a) ! 21: .br ! 22: .B long a; ! 23: .SH DESCRIPTION ! 24: .I Abs ! 25: returns ! 26: the absolute value of ! 27: .I a. ! 28: .PP ! 29: .I Sgn ! 30: returns ! 31: \-1, 0, 1, ! 32: if ! 33: .L ! 34: \fIa\fR<0, \fIa\fR=0, \fIa\fR>0, ! 35: respectively. ! 36: .PP ! 37: .I Gcd ! 38: returns the greatest common divisor of ! 39: .I a ! 40: and ! 41: .I b. ! 42: More precisely, ! 43: .I gcd ! 44: returns the largest machine-representable ! 45: generator of the ideal generated by ! 46: .I a ! 47: and ! 48: .I b. ! 49: This means that ! 50: .B gcd(0,0) ! 51: = 0, and ! 52: .B gcd(N,0) ! 53: = ! 54: .B gcd(N,N) ! 55: = ! 56: .BR N , ! 57: where ! 58: .B N ! 59: is the most negative integer. ! 60: .PP ! 61: .I Lcm ! 62: returns the least common multiple of ! 63: .I a ! 64: and ! 65: .I b. ! 66: When the result is representable, it satisfies ! 67: .BR "abs(a*b)== lcm(a,b)*gcd(a,b)" . ! 68: .PP ! 69: .I Min ! 70: .RI ( max ) ! 71: returns the minimum (maximum) of ! 72: .I a ! 73: and ! 74: .I b. ! 75: .SH SEE ALSO ! 76: .IR floor (3) ! 77: for ! 78: .I fabs ! 79: .SH DIAGNOSTICS ! 80: .I Abs ! 81: returns ! 82: the most negative integer when the true result is unrepresentable. ! 83: .PP ! 84: There are no guarantees about the value of ! 85: .I lcm ! 86: when the true value is unrepresentable. ! 87: .SH BUGS ! 88: The result of ! 89: .I lcm ! 90: is undefined when it doesn't fit in a long. ! 91: .br ! 92: .I Labs, ! 93: provided for ! 94: .SM ANSI ! 95: compatibility, is lonely; there is no ! 96: .I lsign, lmax, ! 97: etc.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.