Release calc version 2.11.4t1

help/digits

@@ -1,30 +1,36 @@
 NAME
-    digits - return number of digits in an integer or integer part
+    digits - return number of "decimal" digits in an integral part
 
 SYNOPSIS
-    digits(x)
+    digits(x [,b])
 
 TYPES
     x		real
+    b		integer >= 2, defaults to 10
 
     return	integer
 
 DESCRIPTION
-    For real x, digits(x) returns the number of digits in the decimal
-    representation of int(abs(x)).  If x >= 1, digits(x) = 1 + ilog10(x).
+    Returns the least non-negative integer n for which abs(x) < b^n.
+
+    digits(x, b) = 0  if and only if abs(x) < 1.
+
+    For real x with absolute value >= 1, digits(x, b) is the number
+    of digits in the standard base-b "decimal" representation of int(abs(x));
+    this is also given by  1 + ilog(x, b).
 
 EXAMPLE
     > print digits(0), digits(0.0123), digits(3.7), digits(-27), digits(-99.7)
-    1 1 1 2 2
+    0 0 1 2 2
 
 LIMITS
     none
 
 LINK LIBRARY
-    long qdigits(NUMBER *x)
+    long qdigits(NUMBER *q, ZVALUE base)
 
 SEE ALSO
-    places
+    digit, places
 
 ## Copyright (C) 1999  Landon Curt Noll
 ##
@@ -42,8 +48,8 @@ SEE ALSO
 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
 ## 59 Temple Place, Suite 330, Boston, MA  02111-1307, USA.
 ##
-## @(#) $Revision: 29.2 $
-## @(#) $Id: digits,v 29.2 2000/06/07 14:02:33 chongo Exp $
+## @(#) $Revision: 29.3 $
+## @(#) $Id: digits,v 29.3 2000/12/14 10:32:24 chongo Exp $
 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/digits,v $
 ##
 ## Under source code control:	1995/10/03 10:40:01