modified: diffout.py
[GalaxyCodeBases.git] / c_cpp / etc / calc / help / places
blobc16a930498701100e477b1b2cf5178d06282e293
1 NAME
2     places - return number of "decimal" places in a fractional part
4 SYNOPSIS
5     places(x [,b])
7 TYPES
8     x           real
9     b           integer >= 2, defaults to 10
11     return      integer
13 DESCRIPTION
14     Returns the least non-negative integer n for which  b^n * x  is an
15     integer, or -1 if there is no such integer.
17     places(x,b) = 0 if and only if x is an integer.
19     If omitted, b is assumed to be 10.  If given, b must be an
20     integer > 1.
22     places(x,b) = n > 0 if and only if the fractional part of abs(x)
23     has a finite base-b "decimal" representation with n digits of which
24     the last digit is nonzero.  This occurs if and only if every prime
25     factor of den(x) is a factor of b.
27 EXAMPLE
28     ; print places(3), places(0.0123), places(3.70), places(1e-10), places(3/7)
29     0 4 1 10 -1
31     ; print places(0.0123, 2), places(.625, 2), places(.625, 8)
32     -1 3 1
34 LIMITS
35     b > 1
37 LINK LIBRARY
38     long qplaces(NUMBER *q, ZVALUE base)
40 SEE ALSO
41     digit, digits
43 ## Copyright (C) 1999-2003  Landon Curt Noll
45 ## Calc is open software; you can redistribute it and/or modify it under
46 ## the terms of the version 2.1 of the GNU Lesser General Public License
47 ## as published by the Free Software Foundation.
49 ## Calc is distributed in the hope that it will be useful, but WITHOUT
50 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
51 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
52 ## Public License for more details.
54 ## A copy of version 2.1 of the GNU Lesser General Public License is
55 ## distributed with calc under the filename COPYING-LGPL.  You should have
56 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
57 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
59 ## @(#) $Revision: 30.1 $
60 ## @(#) $Id: places,v 30.1 2007/03/16 11:10:42 chongo Exp $
61 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/places,v $
63 ## Under source code control:   1995/10/03 10:40:02
64 ## File existed as early as:    1995
66 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
67 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/