Template:Floor

From Vigyanwiki
Revision as of 12:54, 3 May 2006 by Template>Verdy p

Template:Template documentation Implements the mathematical floor function, i.e. returns the input value if it is an integer, otherwise returns the largest integer below the input value.

For negative numbers, the decimals will be simply dropped. For positive numbers, it will also truncate the displayed decimals but the integer part of the absolute value displayed is incremented. This is the mathematical definition of the IEEE rounding mode toward plus infinite.

Usage:
{{Floor|value}}
Examples:
  • {{Floor|3.9}} = 3.
  • {{Floor|3.5}} = 3.
  • {{Floor|3.1}} = 3.
  • {{Floor|3.0}} = 3.
  • {{Floor|1.0}} = 1.
  • {{Floor|0.9}} = 0.
  • {{Floor|0.5}} = 0.
  • {{Floor|0.1}} = 0.
  • {{Floor|0.0}} = 0.
  • {{Floor|-0.1}} = -1.
  • {{Floor|-0.5}} = -1.
  • {{Floor|-0.9}} = -1.
  • {{Floor|-1.0}} = -1.
  • {{Floor|-3.0}} = -3.
  • {{Floor|-3.2}} = -4.
  • {{Floor|-3.5}} = -4.
  • {{Floor|-3.9}} = -4.
Known bug (should appear extremely rarely as this goes beyond the precision of math performed in pages using this template)
  • {{Floor|0.99999999999999983}} = 1 (OK).
  • {{Floor|0.99999999999999984}} = 1 (wrong but comes from limited floating point precision, the input is 1-epsilon, adding 0.5 yields 1.5-epsilon which rounds to 2 exactly, then substracting 1 gives 1 exactly).
  • {{Floor|0.99999999999999999}} = 1 (wrong but comes from limited floating point precision, the input is considered equal to the exact integer 1).
  • {{Floor|-0.99999999999999983}} = -2 (OK).
  • {{Floor|-0.99999999999999984}} = -2 (wrong but comes from limited floating point precision, the input is not exactly equal to the integer -1, but substracting 0.5 yields -1.5 exactly due to precision limits, which then rounds to -2).
  • {{Floor|-0.99999999999999999}} = -1 (OK, the input is considered equal to the exact integer -1, so this exact -1 integer is returned).
See also: