Перейти к содержанию

ceiling()

Функция ceiling возвращает наименьшее число (ближайшее в отрицательной бесконечности), которое не меньше значения представленного аргумента и является целым.

Синтаксис

number ceiling( number )

Ввод

Число.

Если аргумент не является числом, он преобразуется в число так, как если бы он был обработан функцией number(). Если аргумент не удается преобразовать в число, функция ceiling() возвращает значение NaN («нечисло»).

Вывод

Наименьшее целое, не меньшее аргумента.

Если аргумент не может быть преобразован в число, в XSLT 1.0 функция ceiling() возвращает NaN.

Где определяется

  • XPath 1.0 — XPath, раздел 4.4 «Number Functions».

Описание и примеры

Пример 1

ceiling(2.3) ? 3
ceiling(-2.3) ? -2
ceiling(-1 div 0) ? -Infinity
ceiling(-1 div (-1 div 0)) ? 0

Пример 2

Следующая таблица стилей демонстрирует результаты вызова функции ceiling() для разных значений. В качестве входных данных будет использоваться следующий документ XML:

<?xml version="1.0" encoding="utf-8" ?>
<!-- chocolate.xml -->
<report month="8" year="2006">
  <title>Chocolate bar sales</title>
  <brand>
    <name>Lindt</name>
    <units>27408</units>
  </brand>
  <brand>
    <name>Callebaut</name>
    <units>8203</units>
  </brand>
  <brand>
    <name>Valrhona</name>
    <units>22101</units>
  </brand>
  <brand>
    <name>Perugina</name>
    <units>14336</units>
  </brand>
  <brand>
    <name>Ghirardelli</name>
    <units>19268</units>
  </brand>
</report>

Таблица стилей, использующая функцию ceiling():

<?xml version="1.0" ?>
<!-- ceiling.xsl -->
<xsl:stylesheet
  version="2.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
>
  <xsl:output method="text" />
  <xsl:template match="/">
    <xsl:text>Tests of the ceiling() function:</xsl:text>
    <xsl:text>ceiling(7.983) =</xsl:text>
    <xsl:value-of select="ceiling(7.983)" />
    <xsl:text>ceiling(-7.893) =</xsl:text>
    <xsl:value-of select="ceiling(-7.893)" />
    <xsl:text>ceiling(avg(/report/brand/units)) =</xsl:text>
    <xsl:value-of
      select="ceiling(avg(/report/brand/units))"
    />
    <xsl:text>ceiling('blue') =</xsl:text>
    <xsl:value-of version="1.0" select="ceiling('blue')" />
  </xsl:template>
</xsl:stylesheet>

Результат преобразования документа XML по таблице стилей:

Tests of the ceiling() function:
ceiling(7.983) = 8
ceiling(-7.893) = -7
ceiling(avg(/report/brand/units)) = 18264
ceiling('blue') = NaN

В последнем тесте в последнем элементе <xsl:value-of> мы указали версию "1.0". В режиме XSLT 1.0 функция возвращает результат NaN («нечисло»).

См. также

  • floor() — округление до ближайшего не большего целого
  • number() — конвертирует аргумент в числовой тип
  • round() — округляет число до ближайшего целого
  • sum() — суммирует значения узлов

Ссылки