c_cpp/etc/calc/help/mmin

   1 NAME
   2     mmin - least-absolute-value residues modulo a specified number
   3
   4 SYNOPSIS
   5     mmin(x, md)
   6
   7 TYPES
   8     x           number (real or complex), matrix, list, object
   9     md          real
  10
  11     return      real
  12
  13 DESCRIPTION
  14     If x is real and md is nonzero, mmin(x, md) returns the real
  15     number v congruent to x modulo md for which abs(v) <= md/2
  16     and if abs(v) = md/2, then v = md/2.
  17
  18     If x is real and md is zero, mmin(x, md) returns x.
  19
  20     For complex, matrix, list or object x, see the help file for mod: for
  21     all x and md, mmin(x, md) returns the same as mod(x, md, 16).
  22
  23 EXAMPLE
  24     ; print mmin(3,6), mmin(4,6), mmin(5,6), mmin(6,6), mmin(7,6)
  25     3 -2 -1 0 1
  26
  27     ; print mmin(1.25, 2.5), mmin(-1.25,2.5), mmin(1.25, -2.5)
  28     1.25 1.25 -1.25
  29
  30 LIMITS
  31     none
  32
  33 LINK LIBRARY
  34     none
  35
  36 SEE ALSO
  37     mod
  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: mmin,v 30.1 2007/03/16 11:10:42 chongo Exp $
  57 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/mmin,v $
  58 ##
  59 ## Under source code control:   1995/12/18 03:30:59
  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/