c_cpp/etc/calc/help/frem

   1 NAME
   2     frem - remove specified integer factors from specified integer
   3
   4 SYNOPSIS
   5     frem(x,y)
   6
   7 TYPES
   8     x           integer
   9     y           integer
  10
  11     return      non-negative integer
  12
  13 DESCRIPTION
  14     If x and y are not zero and n is the largest non-negative integer
  15     for which y^n is a divisor of x, frem(x,y) returns abs(x/y^n).
  16     In particular, abs(x) is returned if x is not divisible by
  17     y or if abs(y) = 1.  If abs(y) > 1, frem(x,y) is the greatest
  18     divisor of x not divisible by y.
  19
  20     For all x, frem(x,0) is defined to equal abs(x).
  21
  22     For all y, frem(0,y) is defined to be zero.
  23
  24     For all x and y, abs(x) = frem(x,y) * abs(y) ^ fcnt(x,y).
  25
  26 EXAMPLE
  27     ; print frem(7,4), frem(24,4), frem(48,4), frem(-48,4)
  28     7 6 3 3
  29
  30 LIMITS
  31     none
  32
  33 LINK LIBRARY
  34     NUMBER *qfacrem(NUMBER *x, NUMBER *y);
  35
  36 SEE ALSO
  37     fcnt, gcdrem
  38
  39 ## Copyright (C) 1999  Landon Curt Noll
  40 ##
  41 ## Calc is open software; you can redistribute it and/or modify it under
  42 ## the terms of the version 2.1 of the GNU Lesser General Public License
  43 ## as published by the Free Software Foundation.
  44 ##
  45 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  46 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  47 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  48 ## Public License for more details.
  49 ##
  50 ## A copy of version 2.1 of the GNU Lesser General Public License is
  51 ## distributed with calc under the filename COPYING-LGPL.  You should have
  52 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  53 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  54 ##
  55 ## @(#) $Revision: 30.1 $
  56 ## @(#) $Id: frem,v 30.1 2007/03/16 11:10:42 chongo Exp $
  57 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/frem,v $
  58 ##
  59 ## Under source code control:   1995/12/18 12:03:02
  60 ## File existed as early as:    1995
  61 ##
  62 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  63 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/