Класс NumericShaper

public final class NumericShaper
extends Object
implements Serializable

Класс NumericShaper используется для преобразования цифр Latin-1 (европейские) в другие десятичные цифры Unicode. Пользователи этого класса в основном будут теми, кто хочет представить данные с использованием национальных форм цифр, но считают более удобным представлять данные во внутренней форме с использованием цифр Latin-1 (европейские). Это не интерпретирует устаревший символ селектора числовой формы (U+206E).

Экземпляры NumericShaper обычно применяются как атрибуты к тексту с атрибутом NUMERIC_SHAPING класса TextAttribute. Например, этот фрагмент кода заставляет TextLayout преобразовывать европейские цифры в арабские в арабском контексте:

Map map = new HashMap();
map.put(TextAttribute.NUMERIC_SHAPING,
    NumericShaper.getContextualShaper(NumericShaper.ARABIC));
FontRenderContext frc = ...;
TextLayout layout = new TextLayout(text, map, frc);
layout.draw(g2d, x, y);

Также можно выполнить числовое форматирование явно с использованием экземпляров NumericShaper, как показано в этом фрагменте кода:

char[] text = ...;
// shape all EUROPEAN digits (except zero) to ARABIC digits
NumericShaper shaper = NumericShaper.getShaper(NumericShaper.ARABIC);
shaper.shape(text, start, count);

// shape European digits to ARABIC digits if preceding text is Arabic, or
// shape European digits to TAMIL digits if preceding text is Tamil, or
// leave European digits alone if there is no preceding text, or
// preceding text is neither Arabic nor Tamil
NumericShaper shaper =
    NumericShaper.getContextualShaper(NumericShaper.ARABIC |
                                        NumericShaper.TAMIL,
                                      NumericShaper.EUROPEAN);
shaper.shape(text, start, count);

Маски битов и перечисления для диапазонов Unicode

Этот класс поддерживает два разных программистских интерфейса для представления диапазонов Unicode для цифр, специфичных для письменности: основанные на масках битов, такие как NumericShaper.ARABIC, и основанные на перечислениях, такие как NumericShaper.Range.ARABIC. Несколько диапазонов можно указать, объединив битовые маски, такие как:

NumericShaper.ARABIC | NumericShaper.TAMIL

или создав Set с помощью констант NumericShaper.Range, например:

EnumSet.of(NumericShaper.Range.ARABIC, NumericShaper.Range.TAMIL)

Перечисления диапазонов являются надмножеством диапазонов, основанных на масках битов.

Если два интерфейса смешаны (включая сериализацию), значения диапазонов Unicode отображаются в их эквиваленты, где такое отображение возможно, например, NumericShaper.Range.ARABIC из/в NumericShaper.ARABIC. Если указаны какие-либо значения диапазонов, которые невозможно отобразить, например, NumericShaper.Range.BALINESE, эти диапазоны игнорируются.

Приоритет десятичных цифр

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

Диапазон Unicode	NumericShaper Константы	Приоритет
Арабский	NumericShaper.ARABIC NumericShaper.EASTERN_ARABIC	NumericShaper.EASTERN_ARABIC
	NumericShaper.Range.ARABIC NumericShaper.Range.EASTERN_ARABIC	NumericShaper.Range.EASTERN_ARABIC
Тай Там	NumericShaper.Range.TAI_THAM_HORA NumericShaper.Range.TAI_THAM_THAM	NumericShaper.Range.TAI_THAM_THAM