NumericShaper (Java Platform SE 7)

java.lang.Object
- java.awt.font.NumericShaper

すべての実装されたインタフェース:: Serializable

public final class NumericShaper
extends Object
implements Serializable

NumericShaper クラスは、Latin-1 (ヨーロッパ言語) の数字をほかの Unicode 10 進数に変換するために使用します。このクラスは主に、データの提示に各国の数字の形状を使いながら内部的には Latin-1 (ヨーロッパ言語) の数字を使ったほうが便利な場合に使用します。非推奨の数字形状セレクタ文字 (U+206E) は解釈しません。

NumericShaper のインスタンスは通常、TextAttribute クラスの NUMERIC_SHAPING 属性を持つテキストの属性として適用されます。たとえば次のコード部分では、アラビア語のコンテキスト内では 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);

ビットマスクベースおよび enum ベースの Unicode 範囲

このクラスは、スクリプト固有の数字の Unicode 範囲を表すために異なる 2 つのプログラミングインタフェースをサポートしています。つまり、NumericShaper.ARABIC のようなビットマスクベースのものと、NumericShaper.Range.ARABIC のような enum ベースのものです。複数の範囲を指定するには、次のようにビットマスクベースの定数の論理和を使用します。

 NumericShaper.ARABIC | NumericShaper.TAMIL

あるいは、次のように NumericShaper.Range 定数を使用して Set を作成します。

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

enum ベースの範囲は、ビットマスクベースの範囲のスーパーセットです。

2 つのインタフェースが混在する場合 (直列化も含む)、マッピングが可能であれば、Unicode 範囲の値は互いに対応する値にマップされます。たとえば、NumericShaper.Range.ARABIC と NumericShaper.ARABIC がマップされます。NumericShaper.Range.BALINESE などのマップできない範囲値が指定された場合、そのような範囲は無視されます。

10 進数の優先順位

1 つの Unicode 範囲に 10 進数のセットが複数含まれることがあります。同じ Unicode 範囲に 10 進数のセットが複数指定されている場合は、次のようにセットの 1 つが優先されます。

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`

導入されたバージョン:: 1.4
関連項目:: 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス
修飾子と型	クラスと説明
`static class`	`NumericShaper.Range` `NumericShaper.Range` は固有の 10 進数を持つスクリプトの Unicode 範囲を表します。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`ALL_RANGES` すべての範囲を識別します。完全なコンテキスト依存の形状決定に使用します。
`static int`	`ARABIC` ARABIC の範囲と 10 進数を識別します。
`static int`	`BENGALI` BENGALI の範囲と 10 進数を識別します。
`static int`	`DEVANAGARI` DEVANAGARI の範囲と 10 進数を識別します。
`static int`	`EASTERN_ARABIC` ARABIC の範囲と ARABIC_EXTENDED の 10 進数を識別します。
`static int`	`ETHIOPIC` ETHIOPIC の範囲と 10 進数を識別します。
`static int`	`EUROPEAN` Latin-1 (ヨーロッパ言語) と拡張範囲、および Latin-1 (ヨーロッパ言語) の 10 進数を識別します。
`static int`	`GUJARATI` GUJARATI の範囲と 10 進数を識別します。
`static int`	`GURMUKHI` GURMUKHI の範囲と 10 進数を識別します。
`static int`	`KANNADA` KANNADA の範囲と 10 進数を識別します。
`static int`	`KHMER` KHMER の範囲と 10 進数を識別します。
`static int`	`LAO` LAO の範囲と 10 進数を識別します。
`static int`	`MALAYALAM` MALAYALAM の範囲と 10 進数を識別します。
`static int`	`MONGOLIAN` MONGOLIAN の範囲と 10 進数を識別します。
`static int`	`MYANMAR` MYANMAR の範囲と 10 進数を識別します。
`static int`	`ORIYA` ORIYA の範囲と 10 進数を識別します。
`static int`	`TAMIL` TAMIL の範囲と 10 進数を識別します。
`static int`	`TELUGU` TELUGU の範囲と 10 進数を識別します。
`static int`	`THAI` THAI の範囲と 10 進数を識別します。
`static int`	`TIBETAN` TIBETAN の範囲と 10 進数を識別します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`boolean`	`equals(Object o)` 指定されたオブジェクトが `NumericShaper` のインスタンスで、範囲表現、ビットマスク、または列挙と関係なく、これと同じ方法で形状決定を行う場合は `true` を返します。
`static NumericShaper`	`getContextualShaper(int ranges)` 指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。
`static NumericShaper`	`getContextualShaper(int ranges, int defaultContext)` 指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。
`static NumericShaper`	`getContextualShaper(Set<NumericShaper.Range> ranges)` 指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。
`static NumericShaper`	`getContextualShaper(Set<NumericShaper.Range> ranges, NumericShaper.Range defaultContext)` 指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。
`int`	`getRanges()` 形状決定を行うすべての範囲に対する値の論理和を求める `int` を返します。
`Set<NumericShaper.Range>`	`getRangeSet()` 形状決定を行うこの `NumericShaper` のすべての Unicode 範囲を表す `Set` を返します。
`static NumericShaper`	`getShaper(int singleRange)` 指定された Unicode の範囲に対する形状決定要因を返します。
`static NumericShaper`	`getShaper(NumericShaper.Range singleRange)` 指定された Unicode の範囲に対する形状決定要因を返します。
`int`	`hashCode()` この形状決定要因のハッシュコードを返します。
`boolean`	`isContextual()` この形状決定要因がコンテキスト依存かどうかを示す `boolean` を返します。
`void`	`shape(char[] text, int start, int count)` start と start + count の間に出現する、テキスト内の数字を変換します。
`void`	`shape(char[] text, int start, int count, int context)` 指定されたコンテキストを使用して、start と start + count の間に出現するテキスト内の数字を変換します。
`void`	`shape(char[] text, int start, int count, NumericShaper.Range context)` 指定された `context` を使用して、`start` と `start + count` の間に出現するテキスト内の数字を変換します。
`String`	`toString()` この形状決定要因を記述する `String` を返します。

クラス java.lang.Object から継承されたメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- フィールドの詳細
  - EUROPEAN
```
public static final int EUROPEAN
```
    Latin-1 (ヨーロッパ言語) と拡張範囲、および Latin-1 (ヨーロッパ言語) の 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - ARABIC
```
public static final int ARABIC
```
    ARABIC の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - EASTERN_ARABIC
```
public static final int EASTERN_ARABIC
```
    ARABIC の範囲と ARABIC_EXTENDED の 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - DEVANAGARI
```
public static final int DEVANAGARI
```
    DEVANAGARI の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - BENGALI
```
public static final int BENGALI
```
    BENGALI の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - GURMUKHI
```
public static final int GURMUKHI
```
    GURMUKHI の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - GUJARATI
```
public static final int GUJARATI
```
    GUJARATI の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - ORIYA
```
public static final int ORIYA
```
    ORIYA の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - TAMIL
```
public static final int TAMIL
```
    TAMIL の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - TELUGU
```
public static final int TELUGU
```
    TELUGU の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - KANNADA
```
public static final int KANNADA
```
    KANNADA の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - MALAYALAM
```
public static final int MALAYALAM
```
    MALAYALAM の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - THAI
```
public static final int THAI
```
    THAI の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - LAO
```
public static final int LAO
```
    LAO の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - TIBETAN
```
public static final int TIBETAN
```
    TIBETAN の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - MYANMAR
```
public static final int MYANMAR
```
    MYANMAR の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - ETHIOPIC
```
public static final int ETHIOPIC
```
    ETHIOPIC の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - KHMER
```
public static final int KHMER
```
    KHMER の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - MONGOLIAN
```
public static final int MONGOLIAN
```
    MONGOLIAN の範囲と 10 進数を識別します。
    
    関連項目:
    定数フィールド値
  - ALL_RANGES
```
public static final int ALL_RANGES
```
    すべての範囲を識別します。完全なコンテキスト依存の形状決定に使用します。
    この定数は、ビットマスクベースのすべての範囲を指定します。enum ベースのすべての範囲を指定するには、EmunSet.allOf(NumericShaper.Range.class) を使用してください。
    
    関連項目:
    定数フィールド値
- メソッドの詳細
  - getShaper
```
public static NumericShaper getShaper(int singleRange)
```
    指定された Unicode の範囲に対する形状決定要因を返します。Latin-1 (EUROPEAN) の数字はすべて、対応する Unicode の 10 進数に変換されます。
    
    パラメータ:
    singleRange - 指定された Unicode の範囲
    
    戻り値:
    コンテキスト依存でない数字の形状決定要因
    
    例外:
    
    IllegalArgumentException - 範囲が 1 つでない場合
  - getShaper
```
public static NumericShaper getShaper(NumericShaper.Range singleRange)
```
    指定された Unicode の範囲に対する形状決定要因を返します。Latin-1 (EUROPEAN) の数字はすべて、指定された Unicode 範囲の、対応する 10 進数に変換されます。
    
    パラメータ:
    singleRange - NumericShaper.Range 定数で指定された Unicode 範囲。
    
    戻り値:
    コンテキスト依存でない NumericShaper。
    
    例外:
    
    NullPointerException - singleRange が null である場合
    導入されたバージョン:
    
    1.7
  - getContextualShaper
```
public static NumericShaper getContextualShaper(int ranges)
```
    指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。範囲が指定された範囲の 1 つであれば、Latin-1 (EUROPEAN) の数字は前にあるテキストの範囲に対応する 10 進数に変換されます。複数の範囲は、NumericShaper.ARABIC | NumericShaper.THAI のように、値の論理和によって表されます。形状決定要因は、EUROPEAN を開始コンテキストとして想定します。つまり、文字列内で方向性の強いテキストの前に EUROPEAN の数字が検出された場合、コンテキストは EUROPEAN であると見なされ、数字は形状決定されません。
    
    パラメータ:
    ranges - 指定された Unicode の範囲
    
    戻り値:
    指定された範囲に対する形状決定要因
  - getContextualShaper
```
public static NumericShaper getContextualShaper(Set<NumericShaper.Range> ranges)
```
    指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。範囲が指定された範囲の 1 つであれば、Latin-1 (EUROPEAN) の数字は前にあるテキストの範囲に対応する 10 進数に変換されます。
    形状決定要因は、EUROPEAN を開始コンテキストとして想定します。つまり、文字列内で方向性の強いテキストの前に EUROPEAN の数字が検出された場合、コンテキストは EUROPEAN であると見なされ、数字は形状決定されません。
    
    パラメータ:
    ranges - 指定された Unicode の範囲
    
    戻り値:
    指定された範囲に対するコンテキスト依存の形状決定要因
    
    例外:
    
    NullPointerException - ranges が null である場合。
    導入されたバージョン:
    
    1.7
  - getContextualShaper
```
public static NumericShaper getContextualShaper(int ranges,
                                int defaultContext)
```
    指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。範囲が指定された範囲の 1 つであれば、Latin-1 (EUROPEAN) の数字は前にあるテキストの範囲に対応する 10 進数に変換されます。複数の範囲は、NumericShaper.ARABIC | NumericShaper.THAI のように、値の論理和によって表されます。形状決定要因は、defaultContext を開始コンテキストとして使います。
    
    パラメータ:
    ranges - 指定された Unicode の範囲
    defaultContext - 次のような開始コンテキスト: NumericShaper.EUROPEAN
    
    戻り値:
    指定された Unicode の範囲に対する形状決定要因。
    
    例外:
    
    IllegalArgumentException - 指定された defaultContext が単一の有効な範囲でない場合。
  - getContextualShaper
```
public static NumericShaper getContextualShaper(Set<NumericShaper.Range> ranges,
                                NumericShaper.Range defaultContext)
```
    指定された Unicode の 1 つまたは複数の範囲に対する、コンテキスト依存の形状決定要因を返します。範囲が指定された範囲の 1 つであれば、Latin-1 (EUROPEAN) の数字は前にあるテキストの範囲に対応する 10 進数に変換されます。形状決定要因は、defaultContext を開始コンテキストとして使います。
    
    パラメータ:
    ranges - 指定された Unicode の範囲
    defaultContext - 次のような開始コンテキスト: NumericShaper.Range.EUROPEAN
    
    戻り値:
    指定された Unicode 範囲に対するコンテキスト依存の形状決定要因。
    
    例外:
    
    NullPointerException - ranges または defaultContext が null の場合
    導入されたバージョン:
    
    1.7
  - shape
```
public void shape(char[] text,
         int start,
         int count)
```
    start と start + count の間に出現する、テキスト内の数字を変換します。
    
    パラメータ:
    text - 変換する文字の配列
    start - 変換を開始する text 内のインデックス
    count - text 内の変換する文字数
    
    例外:
    
    IndexOutOfBoundsException - start または start + count が範囲外の場合
    
    NullPointerException - text が null の場合
  - shape
```
public void shape(char[] text,
         int start,
         int count,
         int context)
```
    指定されたコンテキストを使用して、start と start + count の間に出現するテキスト内の数字を変換します。形状決定要因がコンテキスト依存でない場合、コンテキストは無視されます。
    
    パラメータ:
    text - 文字の配列
    start - 変換を開始する text 内のインデックス
    count - text 内の変換する文字数
    context - 次のような文字の変換先のコンテキスト: NumericShaper.EUROPEAN
    
    例外:
    
    IndexOutOfBoundsException - start または start + count が範囲外の場合
    
    NullPointerException - text が null の場合
    
    IllegalArgumentException - これがコンテキスト依存の形状決定要因であり、指定された context が単一の有効な範囲でない場合。
  - shape
```
public void shape(char[] text,
         int start,
         int count,
         NumericShaper.Range context)
```
    指定された context を使用して、start と start + count の間に出現するテキスト内の数字を変換します。形状決定要因がコンテキスト依存でない場合、Context は無視されます。
    
    パラメータ:
    text - char 配列
    start - 変換を開始する text 内のインデックス
    count - text 内の変換する char の数
    context - 次のような文字の変換先のコンテキスト: NumericShaper.Range.EUROPEAN
    
    例外:
    
    IndexOutOfBoundsException - start または start + count が範囲外にある場合
    
    NullPointerException - text または context が null の場合
    導入されたバージョン:
    
    1.7
  - isContextual
```
public boolean isContextual()
```
    この形状決定要因がコンテキスト依存かどうかを示す boolean を返します。
    
    戻り値:
    この形状決定要因がコンテキスト依存の場合は true、そうでない場合は false。
  - getRanges
```
public int getRanges()
```
    形状決定を行うすべての範囲に対する値の論理和を求める int を返します。
    たとえば、アラビア語への形状決定が行われるかどうかを調べるには、次のようにします。
    if ((shaper.getRanges() & shaper.ARABIC) != 0) { ...
    
    このメソッドはビットマスクベースの範囲だけをサポートしています。enum ベースの範囲の場合は getRangeSet() を呼び出してください。
    
    戻り値:
    形状決定を行うすべての範囲に対する値。
  - getRangeSet
```
public Set<NumericShaper.Range> getRangeSet()
```
    形状決定を行うこの NumericShaper のすべての Unicode 範囲を表す Set を返します。
    
    戻り値:
    形状決定を行うすべての Unicode 範囲。
    導入されたバージョン:
    
    1.7
  - hashCode
```
public int hashCode()
```
    この形状決定要因のハッシュコードを返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    この形状決定要因のハッシュコード。
    関連項目:
    Object.hashCode()
  - equals
```
public boolean equals(Object o)
```
    指定されたオブジェクトが NumericShaper のインスタンスで、範囲表現、ビットマスク、または列挙と関係なく、これと同じ方法で形状決定を行う場合は true を返します。たとえば、次のコードでは "true" が生成されます。
    NumericShaper ns1 = NumericShaper.getShaper(NumericShaper.ARABIC); NumericShaper ns2 = NumericShaper.getShaper(NumericShaper.Range.ARABIC); System.out.println(ns1.equals(ns2));
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    o - 次と比較する、指定されたオブジェクト: NumericShaper
    
    戻り値:
    o が NumericShaper のインスタンスであり、同じ方法で形状決定を行う場合は true、そうでない場合は false。
    関連項目:
    Object.equals(java.lang.Object)
  - toString
```
public String toString()
```
    この形状決定要因を記述する String を返します。このメソッドはデバッグの場合にだけ使用します。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    この形状決定要因を記述する String。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス NumericShaper

ネストされたクラスのサマリー

フィールドのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

フィールドの詳細

EUROPEAN

ARABIC

EASTERN_ARABIC

DEVANAGARI

BENGALI

GURMUKHI

GUJARATI

ORIYA

TAMIL

TELUGU

KANNADA

MALAYALAM

THAI

LAO

TIBETAN

MYANMAR

ETHIOPIC

KHMER

MONGOLIAN

ALL_RANGES

メソッドの詳細

getShaper

getShaper

getContextualShaper

getContextualShaper

getContextualShaper

getContextualShaper

shape

shape

shape

isContextual

getRanges

getRangeSet

hashCode

equals

toString