Класс NumericShaper

public final class NumericShaper extends Object implements Serializable

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

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

 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);
 

Диапазоны Юникода, основанные на битовых масках и перечислениях

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

 NumericShaper.ARABIC | NumericShaper.TAMIL
 

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

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

Перечисления — это надмножество битовых масок.

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

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

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

Приоритет констант NumericShaper

Диапазон Юникода	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