c_cpp/etc/calc/help/display

   1 NAME
   2     display - set and/or return decimal digits for displaying numbers
   3
   4 SYNOPSIS
   5     display([d])
   6
   7 TYPES
   8     d           integer >= 0
   9
  10     return      integer
  11
  12 DESCRIPTION
  13     When given an argument, this function sets the maximum number of
  14     digits after the decimal point to be printed in real or exponential
  15     mode in normal unformatted printing (print, strprint, fprint) or in
  16     formatted printing (printf, strprintf, fprintf) when precision is
  17     not specified.  The return value is the previous display digit value.
  18
  19     When given no arguments, this function returns the current
  20     display digit value.
  21
  22     The builtin function:
  23
  24         display(d)
  25         display()
  26
  27     is an alias for:
  28
  29         config("display", d)
  30         config("display")
  31
  32     The display digit value does not change the stored value of a number.
  33     It only changes how a stored value is displayed.
  34
  35     Where rounding is necessary to display up to d decimal places,
  36     the type of rounding to be used is controlled by config("outround").
  37
  38 EXAMPLE
  39     ; print display(), 2/3
  40     20 ~0.66666666666666666667
  41
  42     ; print display(40), 2/3
  43     20 ~0.6666666666666666666666666666666666666667
  44
  45     ; print display(5), 2/3
  46     40 ~0.66667
  47
  48 LIMITS
  49     d >= 0
  50
  51 LINK LIBRARY
  52     none
  53
  54 SEE ALSO
  55     config
  56
  57 ## Copyright (C) 2004  Landon Curt Noll
  58 ##
  59 ## Calc is open software; you can redistribute it and/or modify it under
  60 ## the terms of the version 2.1 of the GNU Lesser General Public License
  61 ## as published by the Free Software Foundation.
  62 ##
  63 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  64 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  65 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  66 ## Public License for more details.
  67 ##
  68 ## A copy of version 2.1 of the GNU Lesser General Public License is
  69 ## distributed with calc under the filename COPYING-LGPL.  You should have
  70 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  71 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  72 ##
  73 ## @(#) $Revision: 30.1 $
  74 ## @(#) $Id: display,v 30.1 2007/03/16 11:10:42 chongo Exp $
  75 ## @(#) $Source: /usr/local/src/cmd/calc/help/RCS/display,v $
  76 ##
  77 ## Under source code control:   2004/07/25 23:50:40
  78 ## File existed as early as:    2004
  79 ##
  80 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  81 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/