Технология XSLT
вернуться

Валиков Алексей Н.
Шрифт:

 <chapter format="I" title="First Chapter">

<section title="First Section"/>

<section title="Second Section"/>

<section title="Third Section"/>

 </chapter>

</doc>

нумерация секций будет выглядеть как

I-1 First Section

I-2 Second Section

I-3 Third Section

Если же атрибут

format
элемента
chapter
будет иметь значение
1
, секции будут пронумерованы в виде

1-1 First Section

1-2 Second Section

1-3 Third Section

Форматирование чисел

Мы уже познакомились с функцией языка XPath

string
, которая конвертирует свой аргумент в строку. Эта функция может преобразовать в строку и численное значение, но возможности ее при этом сильно ограничены.

К счастью, XSLT предоставляет мощные возможности для форматирования строкового представления чисел при помощи функции

format-number
и элемента
xsl:decimal-format
.

Функция format-number

Запись функции имеет следующий вид:

string format-number(number, string, string?)

Функция

format-number
принимает на вход три параметра. Первым параметром является число, которое необходимо преобразовать в строку, применив при этом форматирование. Вторым параметром является образец, в соответствии с которым будет форматироваться число. Третий параметр указывает название десятичного формата, который следует применять.

Образец форматирования в XSLT определяется точно так же, как в классе

DecimalFormat
языка Java. Для того чтобы читателю, не знакомому с Java, не пришлось изучать документацию этого языка, мы приведем полный синтаксис образцов форматирования. Продукции образца форматирования мы будем помечать номерами с префиксом
NF
, чтобы не путать их с другими продукциями.

Прежде всего, образец форматирования может состоять из двух частей: первая часть определяет форматирование положительного числа, вторая часть — отрицательного. Запишем это в виде EBNF-продукции:

[NF 1] NFPattern ::= NFSubpattern (NFSubpatternDelim NFSubpattern)?

Двум частям образца форматирования соответствуют нетерминалы

NFSubpattern
, которые разделены нетерминалом
NFSubpatternDelim
.

В случае если вторая часть образца форматирования опушена, отрицательные числа форматируются точно так же, как и положительные, но им предшествует префикс отрицательного числа (по умолчанию — знак "минус", "

–
").

Примеры

format-number(1234.567,'#.00;negative #.00')
→
'1234.57'

format-number(-1234.567,'#.00/negative #.00')
→
'negative 1234.57'

format-number(-1234.567,'#.00')
→
'-1234.57'

Каждая из частей образца форматирования состоит из префикса (

NFPrefix
), целой части (
NFInteger
), необязательной дробной части (
NFFractional
) и суффикса (
NFSuffix
).

[NF 2] NFSubpattern ::= NFPrefix NFinteger NFFractional? NFSuffix

Префикс или суффикс образца форматирования могут содержать символ процента. Если суффикс содержит символ процента, число должно быть умножено на

100
и выведено со знаком процента. Наличие символа процента в префиксе на форматирование не влияет.

Пример

format-number(0.45,'0.00%')
→
'45.00%'

format-number(0.45,'0.##%')
→
'45.00%'

format-number(0.45678,'%0.00')
→
'%0.46'

format-number(0.45678,'0.####%')
→
'45.678%'

Префикс задает строку, которая будет предшествовать числу, это может быть последовательность любых неформатирующих символов (

NFChar
) плюс символ процента (
NFPercent
). Аналогично, суффикс будет следовать за числом, и он тоже не может содержать форматирующих символов (за исключением символа процента).

[NF 3] NFPrefix ::= (NFChar NFPercent?)*