c_cpp/etc/calc/help/arg

   1 NAME
   2     arg - argument (the angle or phase) of a complex number
   3
   4 SYNOPSIS
   5     arg(x [,eps])
   6
   7 TYPES
   8     x           number
   9     eps         nonzero real, defaults to epsilon()
  10
  11     return      real
  12
  13 DESCRIPTION
  14     Returns the argument of x to the nearest or next to nearest multiple of
  15     eps; the error will be less in absolute value than 0.75 * abs(eps),
  16     but usually less than 0.5 * abs(eps).
  17
  18 EXAMPLE
  19     ; print arg(2), arg(2+3i, 1e-5), arg(2+3i, 1e-10), arg(2+3i, 1e-20)
  20     0 .98279 .9827937232 .98279372324732906799
  21
  22     ; pi = pi(1e-10); deg = pi/180; eps = deg/10000
  23     ; print arg(2+3i, eps)/deg, arg(-1 +1i, eps)/deg, arg(-1 - 1i,eps)/deg
  24     56.3099 135 -135
  25
  26 LIMITS
  27     none
  28
  29 LINK LIBRARY
  30     none
  31
  32 SEE ALSO
  33     conj, im, polar, re
  34
  35 ## Copyright (C) 1999  Landon Curt Noll
  36 ##
  37 ## Calc is open software; you can redistribute it and/or modify it under
  38 ## the terms of the version 2.1 of the GNU Lesser General Public License
  39 ## as published by the Free Software Foundation.
  40 ##
  41 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  42 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  43 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  44 ## Public License for more details.
  45 ##
  46 ## A copy of version 2.1 of the GNU Lesser General Public License is
  47 ## distributed with calc under the filename COPYING-LGPL.  You should have
  48 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  49 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  50 ##
  51 ## @(#) $Revision: 30.1 $
  52 ## @(#) $Id: arg,v 30.1 2007/03/16 11:10:42 chongo Exp $
  53 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/arg,v $
  54 ##
  55 ## Under source code control:   1994/09/25 20:22:31
  56 ## File existed as early as:    1994
  57 ##
  58 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  59 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/