<?xml version="1.0" encoding="UTF-8"?><api:function-page xml:base="/apidoc/8.0/fn.round.xml" generated="2015-10-07T16:36:00.016766-07:00" mode="javascript" xmlns:api="http://marklogic.com/rundmc/api"><api:function-name>fn.round</api:function-name><api:suggest>fn.round</api:suggest><api:suggest>fn</api:suggest><api:suggest>round</api:suggest><api:function-link mode="xquery" fullname="fn:round">/apidoc/8.0/fn:round.xml</api:function-link><api:function mode="javascript" name="round" type="builtin" lib="fn" category="NumericBuiltins" bucket="W3C-Standard Functions" hidden="false" prefix="fn" namespace="http://www.w3.org/2005/xpath-functions" fullname="fn.round"><api:summary>
<p xmlns="http://www.w3.org/1999/xhtml">
Returns the number with no fractional part that is closest to the argument. If
there are two such numbers, then the one that is closest to positive infinity
is returned. If type of $arg is one of the four numeric types xs:float,
xs:double, xs:decimal or xs:integer the type of the result is the same as the
type of $arg. If the type of $arg is a type derived from one of the numeric
types, the result is an instance of the base numeric type.
</p><p xmlns="http://www.w3.org/1999/xhtml">
For xs:float and xs:double arguments, if the argument is positive infinity,
then positive infinity is returned. If the argument is negative infinity, then
negative infinity is returned. If the argument is positive zero, then positive
zero is returned. If the argument is negative zero, then negative zero is
returned. If the argument is less than zero, but greater than or equal to -0.5,
then negative zero is returned. In the cases where positive zero or negative
zero is returned, negative zero or positive zero may be returned as [XML Schema
Part 2: Datatypes Second Edition] does not distinguish between the values
positive zero and negative zero.
</p><p xmlns="http://www.w3.org/1999/xhtml">
For the last two cases, note that the result is not the same as fn:floor(x+0.5).
</p><p xmlns="http://www.w3.org/1999/xhtml">
For detailed type semantics, see Section 7.2.3 The fn:abs, fn:ceiling, fn:floor,
fn:round, and fn:round-half-to-even functions[FS].
</p>
</api:summary><api:params><api:param name="arg" type="numeric?"><api:param-description>
A numeric value to round.
  </api:param-description><api:param-name>arg</api:param-name><api:param-type>numeric?</api:param-type></api:param></api:params><api:return>numeric?</api:return><api:example class="javascript"><pre xml:space="preserve" xmlns="http://www.w3.org/1999/xhtml">
fn.round(2.5) 
=&gt; 3

fn.round(2.4999) 
=&gt; 2

fn:round(-2.5) 
=&gt; -2 (not the possible alternative, -3)
</pre></api:example></api:function></api:function-page>