Класс NumericShaper

public final class NumericShaper extends Object implements Serializable

Класс NumericShaper используется для преобразования цифр Латинской-1 (европейские) в другие десятичные цифры Юникода. Пользователи этого класса, в основном, люди, которые хотят представить данные с использованием национальных форм цифр, но считают более удобным представлять данные во внутреннем виде с использованием цифр Латинской-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);
 

Битовые маски и перечисления диапазонов Юникода

Этот класс поддерживает два разных программных интерфейса для представления диапазонов Юникода для цифр, специфичных для сценария: на основе битовых масок, таких как 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