226 UTL_I18N

UTL_I18Nは、PL/SQLで作成されたアプリケーションに追加のグローバリゼーション機能を提供するサービスを集めたものです。

関連項目: 『Oracle Databaseグローバリゼーション・サポート・ガイド』

この章では、次の項目について説明します。

• UTL_I18Nの使用方法

  • 概要

  • セキュリティ・モデル

  • 定数

• UTL_I18Nサブプログラムの要約

---

UTL_I18Nの使用方法

この項では、UTL_I18Nパッケージの使用に関連する項目について説明します。

• 概要

• セキュリティ・モデル

• 定数

---

概要

UTL_I18N PL/SQLパッケージは、次のカテゴリのサービスで構成されています。

• 各種データ・タイプに対応した文字列変換ファンクション

• テキスト文字列と文字参照の間で変換を実行するファンクション

• Oracle、JavaおよびISOの各言語と各テリトリの間でマップするファンクション

• Oracle、Internet Assigned Numbers Authority (IANA)および電子メールで安全なキャラクタ・セット間でマップするファンクション

• Oracleの言語名からOracleのキャラクタ・セット名を戻すファンクション

• スクリプト変換を実行するファンクション

• 指定したテリトリでサポートされているISO通貨コード、ローカル・タイムゾーンおよびローカル言語を戻すファンクション

• 指定した言語でサポートされている最適な言語ソート、すべての適切な言語ソートのリストおよびローカル・テリトリを戻すファンクション

• Oracleの完全言語名と短縮言語名の間でマップするファンクション

• 指定した言語およびテリトリ名の言語変換を戻すファンクション

• 最も一般的に使用されるタイムゾーンのリストを戻すファンクション

---

セキュリティ・モデル

UTL_I18Nパッケージのファンクションは、データベースの内容の読取りも変更も行いません。これらのファンクションは、ファンクションの引数でのみ操作を行うか、またはNLSデータ・ファイルから静的な国際化情報を取得します(あるいはその両方を行います)。このパッケージの実行権限は、デフォルトでPUBLICに付与されます。

---

定数

UTL_I18Nパッケージでは、表226-1に示す定数が使用されます。

表226-1 UTL_I18Nの定数

定数	タイプ	値	説明
GENERIC_CONTEXT	PLS_INTEGER	0	一般に使用するデフォルトのキャラクタ・セットを戻します。
MAIL_GENERIC	PLS_INTEGER	0	Windows以外のプラットフォーム上で、Oracleのキャラクタ・セット名から電子メールで安全なキャラクタ・セット名にマップします。
ORACLE_TO_IANA	PLS_INTEGER	0	Oracleのキャラクタ・セット名からIANAのキャラクタ・セット名にマップします。
SHIFT_IN	PLS_INTEGER	0	shift_statusとともに使用します。ピース単位の変換で初めてコールするときに設定する必要があります。
IANA_TO_ORACLE	PLS_INTEGER	1	IANAのキャラクタ・セット名からOracleのキャラクタ・セット名にマップします。
MAIL_CONTEXT	PLS_INTEGER	1	Oracleのキャラクタ・セット名と電子メールで安全なキャラクタ・セット名の間でマッピングが行われます。
MAIL_WINDOWS	PLS_INTEGER	1	Windowsプラットフォーム上で、Oracleのキャラクタ・セット名から電子メールで安全なキャラクタ・セット名にマップします。
SHIFT_OUT	PLS_INTEGER	1
FWKATAKANA_HIRAGANA	VARCHAR2(30)	'fwkatakana_hiragana'	全角カタカナのみを全角ひらがなに変換します。
FWKATAKANA_HWKATAKANA	VARCHAR2(30)	'fwkatakana_hwkatakana'	全角カタカナのみを半角カタカナに変換します。
HIRAGANA_FWKATAKANA	VARCHAR2(30)	'hiragana_fwkatakana'	全角ひらがなのみを全角カタカナに変換します。
HIRAGANA_HWKATAKANA	VARCHAR2(30)	'hiragana_hwkatakana'	全角ひらがなのみを半角カタカナに変換します。
HWKATAKANA_FWKATAKANA	VARCHAR2(30)	'hwkatakana_fwkatakana'	半角カタカナのみを全角カタカナに変換します。
HWKATAKANA_HIRAGANA	VARCHAR2(30)	'hwkatakana_hiragana'	半角カタカナのみを全角ひらがなに変換します。
KANA_FWKATAKANA	VARCHAR2(30)	'kana_fwkatakana'	すべてのタイプの仮名文字を全角カタカナに変換します。
KANA_HIRAGANA	VARCHAR2(30)	'kana_hiragana'	すべてのタイプの仮名文字を全角ひらがなに変換します。
KANA_HWKATAKANA	VARCHAR2(30)	'kana_hwkatakana'	すべてのタイプの仮名文字を半角カタカナに変換します。

---

UTL_I18Nサブプログラムの要約

表226-2 UTL_I18Nパッケージのサブプログラム

プロシージャ	説明
ESCAPE_REFERENCEファンクション	指定したテキスト文字列をドキュメントのキャラクタ・セット以外の文字に対応する文字参照に変換します。
GET_COMMON_TIME_ZONESファンクション	ロケールとは無関係な共通タイムゾーンIDのリストを戻します。
GET_DEFAULT_CHARSETファンクション	Oracleの言語名から、デフォルトのOracleのキャラクタ・セット名または電子メールで安全なデフォルトのキャラクタ・セット名を戻します。
GET_DEFAULT_ISO_CURRENCYファンクション	指定したテリトリのデフォルトのISO 4217通貨コードを戻します。
GET_DEFAULT_LINGUISTIC_SORTファンクション	指定した言語のデフォルトの言語ソート名を戻します。
GET_LOCAL_LANGUAGESファンクション	指定したテリトリのローカル言語名を戻します。
GET_LOCAL_LINGUISTIC_SORTSファンクション	指定した言語のローカル言語ソート名を戻します。
GET_LOCAL_TERRITORIESファンクション	指定した言語のローカル・テリトリ名を戻します。
GET_LOCAL_TIME_ZONESファンクション	指定したテリトリのローカル・タイムゾーンIDを戻します。
GET_TRANSLATIONファンクション	指定した変換言語の言語およびテリトリ名の変換を戻します。
MAP_CHARSETファンクション	Oracleのキャラクタ・セット名をIANAのキャラクタ・セット名にマップします。 IANAのキャラクタ・セット名をOracleのキャラクタ・セット名にマップします。 Oracleのキャラクタ・セット名を電子メールで安全なキャラクタ・セット名にマップします。
MAP_FROM_SHORT_LANGUAGEファンクション	Oracleの短縮言語名をOracleの言語名にマップします。
MAP_LANGUAGE_FROM_ISOファンクション	ISOのロケール名からOracleの言語名を戻します。
MAP_LOCALE_TO_ISOファンクション	Oracleの言語名およびテリトリ名からISOのロケール名を戻します。
MAP_TERRITORY_FROM_ISOファンクション	ISOのロケール名からOracleのテリトリ名を戻します。
MAP_TO_SHORT_LANGUAGEファンクション	Oracleの言語名をOracleの短縮言語名にマップします。
RAW_TO_CHARファンクション	データベース・キャラクタ・セットにエンコードされていないRAWデータをVARCHAR2文字列に変換します。
RAW_TO_NCHARファンクション	各国語キャラクタ・セットにエンコードされていないRAWデータをNVARCHAR2文字列に変換します。
STRING_TO_RAWファンクション	VARCHAR2文字列またはNVARCHAR2文字列を別のキャラクタ・セットに変換します。結果はRAWデータ・タイプとして戻されます。
TRANSLITERATEファンクション	日本語のひらがなとカタカナの変換を実行します。
UNESCAPE_REFERENCEファンクション	文字参照を含む入力文字列をテキスト文字列に変換します。

---

ESCAPE_REFERENCEファンクション

このファンクションは、テキスト文字列を現行のドキュメントで使用されているキャラクタ・セット以外の文字に対応する文字参照に変換します。文字参照は、ドキュメントのエンコーディングとは無関係に文字を表すためにHTMLドキュメントおよびXMLドキュメントで主に使用されます。文字参照は、数値文字参照および文字エンティティ参照の2つの形式で表示できます。数値文字参照では文字のUnicodeコード・ポイント値を指定し、文字エンティティ参照では同じ文字を参照するために記号名を使用します。たとえば、åは上に丸の付いた小文字aを表す数値文字参照で、åは同じ文字の文字エンティティ参照です。また、文字エンティティ参照を使用して、< (より小)記号を表す<などの特殊文字をエスケープすることもできます。これによって、マークアップ言語のタグの開始で発生する可能性がある混同を回避します。

構文

UTL_I18N.ESCAPE_REFERENCE(
    str            IN VARCHAR2 CHARACTER SET ANY_CS,
    page_cs_name   IN VARCHAR2 DEFAULT NULL)
 RETURN VARCHAR2 CHARACTER SET str%CHARSET;

パラメータ

表226-3 ESCAPE_REFERENCEファンクションのパラメータ

パラメータ	説明
str	入力文字列を指定します。
page_cs_name	ドキュメントのキャラクタ・セットを指定します。page_cs_nameがNULLの場合は、データベース・キャラクタ・セットがCHARデータに使用され、各国語キャラクタ・セットがNCHARデータに使用されます。

使用上の注意

ユーザーが無効なキャラクタ・セットまたはNULL文字列を指定すると、ファンクションはNULL文字列を戻します。

例

UTL_I18N.ESCAPE_REFERENCE('hello < '||chr(229),'us7ascii')

'hello < å'が戻されます。

---

GET_COMMON_TIME_ZONESファンクション

このファンクションは、最も一般的に使用されるタイムゾーンのリストを戻します。このリストには、データベースでサポートされているタイムゾーンのサブセットが示されます。

構文

UTL_I18N.GET_COMMON_TIME_ZONES
 RETURN STRING_ARRAY;

例

最も一般的に使用されるタイムゾーンのリストを戻します。

DECLARE
   retval UTL_I18N.STRING_ARRAY;
BEGIN
   retval := UTL_I18N.GET_COMMON_TIME_ZONES;
END;
/

---

GET_DEFAULT_CHARSETファンクション

このファンクションは、Oracleの言語名から、デフォルトのOracleのキャラクタ・セット名またはデフォルトの電子メールで安全なキャラクタ・セット名を戻します。

関連項目: 電子メールで安全なキャラクタ・セットについては、「MAP_CHARSETファンクション」を参照してください。

構文

UTL_I18N.GET_DEFAULT_CHARSET( 
   language  IN VARCHAR2,
   context   IN PLS_INTEGER DEFAULT GENERIC_CONTEXT,
   iswindows IN BOOLEAN DEFAULT FALSE)
 RETURN VARCHAR2;

パラメータ

表226-4 GET_DEFAULT_CHARSETファンクションのパラメータ

パラメータ	説明
language	有効なOracle言語を指定します。
context	GENERIC_CONTEXT | MAIL_CONTEXT GENERIC_CONTEXT: 一般に使用するデフォルトのキャラクタ・セットを戻します。 MAIL_CONTEXT: 電子メールで安全なキャラクタ・セット名を戻します。
iswindows	contextがMAIL_CONTEXTとして設定されている場合は、プラットフォームがWindowsであればiswindowsをTRUEに設定し、プラットフォームがWindows以外であればFALSEに設定する必要があります。デフォルトはFALSEです。 contextをGENERIC_CONTEXTに設定した場合、iswindowsは無効です。

使用上の注意

ユーザーが無効な言語名や無効なフラグを指定すると、ファンクションはNULL文字列を戻します。

例

GENERIC_CONTEXT, iswindows=FALSE

UTL_I18N.GET_DEFAULT_CHARSET('French', UTL_I18N.GENERIC_CONTEXT, FALSE)

'WE8ISO8859P1'が戻されます。

MAIL_CONTEXT, iswindows=TRUE

UTL_I18N.GET_DEFAULT_CHARSET('French', UTL_I18N.MAIL_CONTEXT, TRUE)

'WE8MSWIN1252'が戻されます。

MAIL_CONTEXT, iswindows=FALSE

UTL_I18N.GET_DEFAULT_CHARSET('French', UTL_I18N.MAIL_CONTEXT, FALSE)

'WE8ISO8859P1'が戻されます。

---

GET_DEFAULT_ISO_CURRENCYファンクション

このファンクションは、指定したテリトリのデフォルトのISO 4217通貨コードを戻します。

構文

UTL_I18N.GET_DEFAULT_ISO_CURRENCY (
   territory    IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN VARCHAR2;

パラメータ

表226-5 GET_DEFAULT_ISO_CURRENCYファンクションのパラメータ

パラメータ	説明
territory	有効なOracleテリトリを指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効なテリトリ名を指定した場合、ファンクションはNULL文字列を戻します。

例

中国のデフォルトのISO通貨コードを表示します。

DECLARE
   retval VARCHAR2(50);
BEGIN
   retval := UTL_I18N.GET_DEFAULT_ISO_CURRENCY('CHINA');
   DBMS_OUTPUT.PUT_LINE(retval);
END;
/

---

GET_DEFAULT_LINGUISTIC_SORTファンクション

このファンクションは、指定した言語の最も一般的に使用されるOracle言語ソート名を戻します。

構文

UTL_I18N.GET_DEFAULT_LINGUISTIC_SORT (
   language  IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN VARCHAR2;

パラメータ

表226-6 GET_DEFAULT_LINGUISTIC_SORTファンクションのパラメータ

パラメータ	説明
language	有効なOracle言語を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な言語名を指定した場合、ファンクションはNULL文字列を戻します。

例

現行のSQLセッションで使用されている言語の最適な言語ソート名を表示します。

DECLARE
   retval VARCHAR2(50);
BEGIN
  SELECT value INTO retval FROM nls_session_parameters
   WHERE parameter = 'NLS_LANGUAGE';
   retval := UTL_I18N.GET_DEFAULT_LINGUISTIC_SORT(retval);
   DBMS_OUTPUT.PUT_LINE(retval);
END;
/

---

GET_LOCAL_LANGUAGESファンクション

このファンクションは、指定したテリトリのローカル言語名を戻します。

構文

UTL_I18N.GET_LOCAL_LANGUAGES (
   territory    IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN STRING_ARRAY;

パラメータ

表226-7 GET_LOCAL_LANGUAGESファンクションのパラメータ

パラメータ	説明
territory	有効なOracleテリトリを指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効なテリトリ名を指定した場合、ファンクションはNULL文字列を戻します。

例

ベルギーで使用されているローカル言語のリストを戻します。

DECLARE
   retval UTL_I18N.STRING_ARRAY;
   cnt    INTEGER;
BEGIN
   retval   :=  UTL_I18N.GET_LOCAL_LANGUAGES('BELGIUM');
   DBMS_OUTPUT.PUT('Count = ');
   DBMS_OUTPUT.PUT_LINE(retval.LAST);
   cnt := retval.FIRST;
   WHILE cnt IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(retval(cnt));
      cnt := retval.NEXT(cnt);
   END LOOP;
END;
/
...
Count = 2
DUTCH
FRENCH

---

GET_LOCAL_LINGUISTIC_SORTSファンクション

このファンクションは、指定した言語に適したOracle言語ソート名のリストを戻します。BINARYソートはすべての言語に含まれています。

構文

UTL_I18N.GET_LOCAL_LINGUISTIC_SORTS (
   language  IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN STRING_ARRAY;

パラメータ

表226-8 GET_LOCAL_LINGUISTIC_SORTSファンクションのパラメータ

パラメータ	説明
language	有効なOracle言語を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な言語名を指定した場合、ファンクションはNULL文字列を戻します。

例

JAPANESEのローカル言語ソート名を表示します。

DECLARE
   retval UTL_I18N.STRING_ARRAY;
   cnt INTEGER;
BEGIN
  retval := UTL_I18N.GET_LOCAL_LINGUISTIC_SORTS('Japanese');
  DBMS_OUTPUT.PUT('Count = ');
  DBMS_OUTPUT.PUT_LINE(retval.COUNT);
  cnt := retval.FIRST;
   WHILE cnt IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(retval(cnt));
      cnt := retval.NEXT(cnt);
    END LOOP;
END;
/

...
Count = 2
JAPANESE_M
BINARY

---

GET_LOCAL_TERRITORIESファンクション

このファンクションは、指定した言語のローカル・テリトリ名を戻します。

構文

UTL_I18N.GET_LOCAL_TERRITORIES (
   language  IN VARCHAR2 CHARACTER SET ANY_CS)
 RETURN STRING_ARRAY;

パラメータ

表226-9 GET_LOCAL_TERRITORIESファンクションのパラメータ

パラメータ	説明
language	有効なOracle言語を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な言語名を指定した場合、ファンクションはNULL文字列を戻します。

例

ローカル言語の1つとしてドイツ語を使用するOracleテリトリのリストを戻します。

DECLARE
   retval  UTL_I18N.STRING_ARRAY;
   cnt     INTEGER;
BEGIN
   retval  := UTL_I18N.GET_LCOAL_TERRITORIIES('GERMAN');
   DBMS_OUTPUT.PUT('Count = ');
   DBMS_OUTPUT.PUT_LINE(retval.LAST);
  cnt := retval.FIRST;
   WHILE cnt IS NOT NULL LOOP
      DBMS_OUTPUT.PUT_LINE(retval(cnt));
      cnt := retval.NEXT(cnt));
   END LOOP;
END;
/
...
Count = 4
GERMANY
AUSTRIA
LUXEMBOURG
SWITZERLAND

---

GET_LOCAL_TIME_ZONESファンクション

このファンクションは、指定したテリトリのローカル・タイムゾーンIDを戻します。

構文

UTL_I18N.GET_LOCAL_TIME_ZONES ( 
   territory      IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL)
RETURN STRING_ARRAY;

パラメータ

表226-10 GET_LOCAL_TIME_ZONESファンクションのパラメータ

パラメータ	説明
territory	有効なOracleテリトリを指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効なテリトリ名を指定した場合、ファンクションはNULL文字列を戻します。

例

テリトリAZERBAIJANでローカルに使用されているタイムゾーンのリストの後に一般的な共通タイムゾーンを戻すファンクションを作成します。このファンクションは、ユーザーのテリトリがわかっていて、アプリケーションでユーザーが他のタイムゾーンをユーザーのプリファレンスとして選択できる場合に有効です。

CREATE OR REPLACE FUNCTION get_time_zones
(territory IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN utl_i18n.string_array
IS
  retval  utl_i18n.string_array;
  retval2 utl_i18n.string_array;
  stpos   INTEGER;
BEGIN
  retval  := utl_i18n.get_local_time_zones(
    territory);
  retval2 := utl_i18n.get_common_time_zones;
  stpos := retval.LAST + 1;
  retval(stpos) := '-----'; -- a separator
  FOR i IN retval2.FIRST..retval2.LAST LOOP
    stpos := stpos + 1;
    retval(stpos) := retval2(i);
  END LOOP;
  RETURN retval;
END;
/

AZERBAIJANのローカル・タイムゾーンが戻され、続いてセパレータ文字列である5つのダッシュ(-----)の下に共通タイムゾーンが戻されます。

DECLARE
   retval UTL_I18N.STRING_ARRAY;
   cnt INTEGER;
BEGIN
   DBMS_OUTPUT.ENABLE(100000);
   retval UTL_I18N.GET_TIME_ZONES('AZERBAIJAN');
   cnt := retval.FIRST;
  WHILE cnt IS NOT NULL LOOP
    DBMS_OUTPUT.PUT_LINE(retval(cnt));
    cnt := retval.NEXT(cnt);
  END LOOP;
END;
/

Asia/Baku
-----
Pacific/Pago_Pago
Pacific/Honolulu
America/Anchorage
America/Vancouver
America/Los_Angeles
America/Tijuana
America/Edmonton
America/Denver
America/Phoenix
America/Mazatlan
America/Winnipeg
America/Regina
America/Chicago
America/Mexico_City
America/Guatemala
America/El_Salvador
America/Managua
America/Costa_Rica
America/Montreal
...

---

GET_TRANSLATIONファンクション

このファンクションは、指定した変換言語の言語およびテリトリ名の変換を戻します。

構文

UTL_I18N.GET_TRANSLATION ( 
   parameter        IN VARCHAR2 CHARACTER SET ANY_CS,
   trans_language   IN VARCHAR2 'AMERICAN',
   flag             IN PLS_INTEGER DEFAULT LANGUAGE_TRANS)
RETURN VARCHAR2 CHARACTER SET parameter%CHARSET;

パラメータ

表226-11 GET_TRANSLATIONファンクションのパラメータ

パラメータ	説明
parameter	有効な言語名、テリトリ名またはlanguage_territoryの形式の組合せ文字列を指定します。大文字と小文字は区別されません。
trans_language	変換言語名を指定します。たとえば、イタリア語の場合はITALIANを指定します。デフォルトは、米語を示すAMERICANです。
flag	変換タイプを指定します。 LANGUAGE_TRANS: このファンクションは言語変換を戻します。 TERRITORY_TRANS: このファンクションはテリトリ変換を戻します。 LANGUAGE_TERRITORY_TRANS: このファンクションは言語およびテリトリの変換を戻します。 デフォルトの変換タイプはLANGUAGE_TRANSです。

使用上の注意

パラメータのタイプとしてVARCHAR2を使用すると、データベース・キャラクタ・セットへの変換が原因で、戻される変換テキストが破損する場合があります。パラメータのタイプとしてNVARCHAR2を使用すると、Unicodeですべての変換言語をエンコードできるため、変換テキストが保持されます。

指定した変換言語を使用できないか、または無効な名前が指定されている場合は、デフォルトの米語変換が戻されます。たとえば、OracleではGUJARATI変換は提供されていないため、米語変換が戻されます。

例

次の例では、Oracleでサポートサポートされているすべての言語の名前がイタリア語で戻されます。

DECLARE
   CURSOR c1 IS
     SELECT value FROM V$NLS_VALID_VALUES
     WHERE parameter = 'LANGUAGE'
  ORDER BY value;
  retval NVARCHAR2(100);
BEGIN
   FOR item IN c1 LOOP
     retval := UTL_I18N.GET_TRANSLATION (TO_NCHAR(item.value), 'italian');
   END LOOP;
END;

---

MAP_CHARSETファンクション

このファンクションは、次のマッピングを行います。

• Oracleのキャラクタ・セット名からIANAのキャラクタ・セット名へのマッピング。

• IANAのキャラクタ・セット名からOracleのキャラクタ・セット名へのマッピング。

• Oracleのキャラクタ・セット名から電子メールで安全なキャラクタ・セット名へのマッピング。

構文

UTL_I18N.MAP_CHARSET( 
   charset   IN VARCHAR2,
   context   IN PLS_INTEGER DEFAULT GENERIC_CONTEXT,
   flag      IN PLS_INTEGER DEFAULT ORACLE_TO_IANA)
RETURN VARCHAR2;

パラメータ

表226-12 MAP_CHARSETファンクションのパラメータ

パラメータ	説明
charset	マップするキャラクタ・セット名を指定します。マッピングでは大文字と小文字は区別されません。
context	GENERIC_CONTEXT | MAIL_CONTEXT GENERIC_CONTEXT: Oracleのキャラクタ・セット名とIANAキャラクタ・セット名の間でマッピングが行われます。これがデフォルト値です。 MAIL_CONTEXT: Oracleのキャラクタ・セット名と電子メールで安全なキャラクタ・セット名の間でマッピングが行われます。
flag	ORACLE_TO_IANA | IANA_TO_ORACLE(GENERIC_CONTEXTを設定した場合) ORACLE_TO_IANA: Oracleのキャラクタ・セット名からIANAのキャラクタ・セット名にマップします。これがデフォルトです。 IANA_TO_ORACLE: IANAのキャラクタ・セット名からOracleのキャラクタ・セット名にマップします。 MAIL_GENERIC | MAIL_WINDOWS(MAIL_CONTEXTを設定した場合) MAIL_GENERIC: Windows以外のプラットフォーム上で、Oracleのキャラクタ・セット名から電子メールで安全なキャラクタ・セット名にマップします。 MAIL_WINDOWS: Windowsのプラットフォーム上で、Oracleのキャラクタ・セット名から電子メールで安全なキャラクタ・セット名にマップします。

使用上の注意

電子メールで安全なキャラクタ・セットとは、アプリケーションで電子メール・メッセージを送信するとき通常に使用されるOracleのキャラクタ・セットのことです。通常、このキャラクタ・セットは、データベース・キャラクタ・セットの内容を電子メールで安全な内容に変換するために使用されます。メール・ヘッダーにキャラクタ・セット名を指定するには、MAP_CHARSETファンクションにORACLE_TO_IANAオプションを指定してコールすることによって取得される、対応するIANAのキャラクタ・セット名を使用して、電子メールで安全なキャラクタ・セット名を入力として指定する必要があります。

たとえば、対応するIANA名がDEC-MCSであるWE8DECキャラクタ・セットのメッセージ内容を認識できる電子メール・クライアントは存在しません。WE8DECが、MAIL_CONTEXTオプションを指定したMAP_CHARSETファンクションに渡されると、ファンクションはWE8ISO8859P1を戻します。これに対応するIANA名であるISO-8859-1は、ほとんどの電子メール・クライアントで認識されます。

この例の手順は次のとおりです。

1. データベース・キャラクタ・セット名WE8DECをMAIL_CONTEXT | MAIL_GENERICオプションに指定して、MAP_CHARSETファンクションをコールします。この結果WE8ISO8859P1が戻されます。

2. データベースに格納されている内容を、WE8ISO8859P1に変換します。

3. 電子メールで安全なキャラクタ・セットWE8ISO8859P1をORACLE_TO_IANA | GENERIC_CONTEXTオプションに指定して、MAP_CHARSETファンクションをコールします。この結果ISO-8859-1が戻されます。

4. 電子メール・メッセージの送信時に、メール・ヘッダーにISO-8859-1を指定します。

一致するものが見つかると、ファンクションはキャラクタ・セット名を戻します。一致するものが見つからないか、フラグが無効の場合、ファンクションはNULLを戻します。

注意: Oracleのキャラクタ・セットの多くは、電子メールで安全な1つのキャラクタ・セットに対してマップできます。電子メールで安全なキャラクタ・セットをOracleのキャラクタ・セット名にマップするファンクションはありません。

例

一般的なコンテキスト

UTL_I18N.MAP_CHARSET('iso-8859-1',UTL_I18N.GENERIC_CONTEXT,UTL_I18N.IANA_TO_ORACLE)

'WE8ISO8859P1'が戻されます。

コンテキスト

UTL_I18N.MAP_CHARSET('WE8DEC', utl_i18n.mail_context,  utl_i18n.mail_generic)

'WE8ISO8859P1'が戻されます。

関連項目: 有効なOracleのキャラクタ・セットのリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

---

MAP_FROM_SHORT_LANGUAGEファンクション

このファンクションは、Oracleの短縮言語名をOracleの言語名にマップします。

構文

UTL_I18N.MAP_FROM_SHORT_LANGUAGE (
   language           IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN VARCHAR2;

パラメータ

表226-13 MAP_FROM_SHORT_LANGUAGEファンクションのパラメータ

パラメータ	説明
language	有効な短縮言語名を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な言語名を指定した場合、ファンクションはNULL文字列を戻します。

例

IDが9000の顧客のデフォルトの言語ソート名を戻します。表customersは共通スキーマのoeユーザーから取得されます。顧客の言語プリファレンスは短縮言語名で格納されるため、GET_DEFAULT_LINGUISTIC_SORTプロシージャをコールして完全言語名に変換する必要があります。

DECLARE
   short_n VARCHAR2(10);
   ling_n VARCHAR2(50);
BEGIN
   SELECT nls_language INTO short 
   FROM customers WHERE customer_id = 9000;
   ling_n := UTL_I18N.GET_DEFAULT_LINGUISTIC_SORT (
   UTL_I18N.MAP_FROM_SHORT_LANGUAGE(short_n));
   DBMS_OUTPUT.PUT_LINE(ling_n);
END;
/

---

MAP_LANGUAGE_FROM_ISOファンクション

このファンクションは、ISOのロケール名からOracleの言語名を戻します。

構文

UTL_I18N.MAP_LANGUAGE_FROM_ISO( 
  isolocale IN VARCHAR2)
RETURN VARCHAR2;

パラメータ

表226-14 MAP_LANGUAGE_FROM_ISOファンクションのパラメータ

パラメータ	説明
isolocale	ISOのロケールを指定します。マッピングでは大文字と小文字は区別されません。

使用上の注意

ユーザーが無効なロケール文字列を指定した場合、ファンクションはNULL文字列を戻します。

ユーザーが言語のみを含むロケール文字列を指定した場合(たとえばen_USではなくen_)、ファンクションは指定した言語のデフォルトの言語名(Americanなど)を戻します。

例

UTL_I18N.MAP_LANGUAGE_FROM_ISO('en_US')

'American'が戻されます。

関連項目: 有効なOracleの言語のリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

---

MAP_LOCALE_TO_ISOファンクション

このファンクションは、Oracleの言語名およびOracleのテリトリ名からISOのロケール名を戻します。有効な文字列には、少なくとも有効なOracleの言語名または有効なOracleのテリトリ名のいずれかが指定されている必要があります。

構文

UTL_I18N.MAP_LOCALE_TO_ISO ( 
   ora_language   IN VARCHAR2,
   ora_territory  IN VARCHAR2)
 RETURN VARCHAR2;

パラメータ

表226-15 MAP_LOCALE_TO_ISOファンクションのパラメータ

パラメータ	説明
ora_language	Oracleの言語名を指定します。大文字と小文字は区別されません。
ora_territory	Oracleのテリトリ名を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な文字列を指定した場合、ファンクションはNULL文字列を戻します。

例

UTL_I18N.MAP_LOCALE_TO_ISO('American','America')

'en_US'が戻されます。

関連項目: 有効なOracleの言語およびテリトリのリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

---

MAP_TERRITORY_FROM_ISOファンクション

このファンクションは、ISOのロケールからOracleのテリトリ名を戻します。

構文

UTL_I18N.MAP_TERRITORY_FROM_ISO (
  isolocale IN VARCHAR2)
 RETURN VARCHAR2;

パラメータ

表226-16 MAP_TERRITORY_FROM_ISOファンクションのパラメータ

パラメータ	説明
isolocale	ISOのロケールを指定します。マッピングでは大文字と小文字は区別されません。

使用上の注意

ユーザーが無効なロケール文字列を指定した場合、ファンクションはNULL文字列を戻します。

ユーザーがテリトリのみを含むロケール文字列を指定した場合(たとえば、fr_frではなく_fr)、ファンクションは指定したテリトリのデフォルトのテリトリ名(Franceなど)を戻します。

例

UTL_I18N.MAP_TERRITORY_FROM_ISO('en_US')

'America'が戻されます。

関連項目: 有効なOracleのテリトリのリストは、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

---

MAP_TO_SHORT_LANGUAGEファンクション

このファンクションは、Oracleの言語名をOracleの短縮言語名にマップします。

構文

UTL_I18N.MAP_TO_SHORT_LANGUAGE (
   language    IN VARCHAR2 CHARACTER SET ANY_CS)
RETURN VARCHAR2;

パラメータ

表226-17 MAP_TO_SHORT_LANGUAGEファンクションのパラメータ

パラメータ	説明
language	有効な完全言語名を指定します。大文字と小文字は区別されません。

使用上の注意

ユーザーが無効な言語名を指定した場合、ファンクションはNULL文字列を戻します。

例

言語の短縮言語名を戻します。

DECLARE  retval VARCHAR2(100);BEGIN  retval := UTL_I18N.MAP_TO_SHORT_LANGUAGE('american');  DBMS_OUTPUT.PUT_LINE(retval);END;/US

---

RAW_TO_CHARファンクション

このファンクションは、有効なOracleのキャラクタ・セットのRAWデータを、データベース・キャラクタ・セットのVARCHAR2文字列に変換します。

このファンクションはオーバーロードされています。機能の各種形式は、構文宣言の箇所に併記してあります。

構文

バッファ変換:

UTL_I18N.RAW_TO_CHAR(
   data          IN RAW,
   src_charset   IN VARCHAR2 DEFAULT NULL)
 RETURN VARCHAR2;

ピース単位の変換では、生データが1つずつ文字データに変換されます。

UTL_I18N.RAW_TO_CHAR (
   data            IN RAW,
   src_charset     IN VARCHAR2 DEFAULT NULL,
   scanned_length  OUT PLS_INTEGER,
   shift_status    IN OUT PLS_INTEGER)
RETURN VARCHAR2;

パラメータ

表226-18 RAW_TO_CHARファンクションのパラメータ

パラメータ	説明
data	VARCHAR2文字列に変換するRAWデータを指定します。
src_charset	RAWデータを導出したキャラクタ・セットを指定します。src_charsetがNULLの場合は、データベース・キャラクタ・セットが使用されます。
scanned_length	スキャンするソース・データのバイト数を指定します。
shift_status	スキャン終了時のシフト状態を指定します。ピース単位の変換で初めてコールするときは、SHIFT_INに設定する必要があります。 注意: ISO 2022キャラクタ・セットでは、エンコード方法を示すためにシフト文字ではなくエスケープ・シーケンスが使用されます。shift_statusは、次に行われるファンクション・コールのエスケープ・シーケンスで提供されるエンコード方法の情報を保持できません。そのため、入力の各単位がクローズされた文字列であることが保証されないかぎり、このファンクションを使用して、ピース単位の方法で生データからISO 2022文字を再構築することはできません。クローズされた文字列の最初と最後は、7ビットのエスケープ状態になります。

使用上の注意

ユーザーが無効なキャラクタ・セット、NULLデータまたは長さが0のデータを指定すると、ファンクションはNULL文字列を戻します。

例

バッファ変換

UTL_I18N.RAW_TO_CHAR(hextoraw('616263646566C2AA'), 'utf8')

次の文字列がデータベース・キャラクタ・セットで戻されます。

'abcde'||chr(170)

ピース単位の変換

UTL_I18N.RAW_TO_CHAR(hextoraw('616263646566C2AA'),'utf8',shf,slen)

次の文字列がデータベース・キャラクタ・セットで戻されます。

'abcde'||chr(170)

さらに、shfがSHIFT_INに、slenが8に設定されます。

次の例では、インターネットからのデータを1つずつデータベース・キャラクタ・セットに変換します。

rvalue RAW(1050); 
  nvalue VARCHAR2(1024); 
  conversion_state  PLS_INTEGER = 0; 
  converted_len   PLS_INTEGER; 
  rtemp  RAW(10) = ''; 
  conn   utl_tcp.connection; 
  tlen PLS_INTEGER;

  ... 
  conn := utl_tcp.open_connection ( remote_host => 'localhost', 
                                    remote_port => 2000); 
  LOOP 
      tlen := utl_tcp.read_raw(conn, rvalue, 1024); 
      rvalue := utl_raw.concat(rtemp, rvalue); 
      nvalue := utl_i18n.raw_to_char(rvalue, 'JA16SJIS', converted_len, conversion_stat); 
      if (converted_len < utl_raw.length(rvalue) ) 
      then 
        rtemp := utl_raw.substr(rvalue, converted_len+1); 
      else 
        rtemp := ''; 
      end if; 
      /* do anything you want with nvalue */ 
      /* e.g htp.prn(nvalue); */ 
    END LOOP; 
    utl_tcp.close_connection(conn); 
  EXCEPTION 
    WHEN utl_tcp.end_of_input THEN 
      utl_tcp.close_connection(conn);
END;

---

RAW_TO_NCHARファンクション

このファンクションは、有効なOracleのキャラクタ・セットのRAWデータを、各国語キャラクタ・セットのNVARCHAR2文字列に変換します。

このファンクションはオーバーロードされています。機能の各種形式は、構文宣言の箇所に併記してあります。

構文

バッファ変換:

UTL_I18N.RAW_TO_NCHAR ( 
   data         IN RAW,
   src_charset  IN VARCHAR2 DEFAULT NULL)
 RETURN NVARCHAR2;

ピース単位の変換では、生データが1つずつ文字データに変換されます。

UTL_I18N.RAW_TO_NCHAR ( 
   data            IN RAW,
   src_charset      IN VARCHAR2 DEFAULT NULL,
   scanned_length   OUT PLS_INTEGER,
   shift_status     IN OUT PLS_INTEGER)
 RETURN NVARCHAR2;

パラメータ

表226-19 RAW_TO_NCHARファンクションのパラメータ

パラメータ	説明
data	NVARCHAR2文字列に変換するRAWデータを指定します。
src_charset	RAWデータを導出したキャラクタ・セットを指定します。src_charsetがNULLの場合は、データベース・キャラクタ・セットが使用されます。
scanned_length	スキャンするソース・データのバイト数を指定します。
shift_status	スキャン終了時のシフト状態を指定します。ピース単位の変換で初めてコールするときは、SHIFT_INに設定する必要があります。 注意: ISO 2022キャラクタ・セットでは、エンコード方法を示すためにシフト文字ではなくエスケープ・シーケンスが使用されます。shift_statusは、次に行われるファンクション・コールのエスケープ・シーケンスで提供されるエンコード方法の情報を保持できません。そのため、入力の各単位がクローズされた文字列であることが保証されないかぎり、このファンクションを使用して、ピース単位の方法で生データからISO 2022文字を再構築することはできません。クローズされた文字列の最初と最後は、7ビットのエスケープ状態になります。

使用上の注意

ユーザーが無効なキャラクタ・セット、NULLデータまたは長さが0のデータを指定すると、ファンクションはNULL文字列を戻します。

例

バッファ変換

UTL_I18N.RAW_TO_NCHAR(hextoraw('616263646566C2AA'),'utf8')

次の文字列が各国語キャラクタ・セットで戻されます。

'abcde'||chr(170)

ピース単位の変換

UTL_I18N.RAW_TO_NCHAR(hextoraw('616263646566C2AA'),'utf8', shf, slen)

次の文字列が各国語キャラクタ・セットで戻されます。

'abcde'||chr(170)

さらに、shfがSHIFT_INに、slenが8に設定されます。

次の例では、インターネットからのデータを1つずつ各国語キャラクタ・セットに変換します。

rvalue RAW(1050); 
  nvalue NVARCHAR2(1024); 
  converstion_state  PLS_INTEGER = 0; 
  converted_len   PLS_INTEGER; 
  rtemp  RAW(10) = ''; 
  conn   utl_tcp.connection; 
  tlen PLS_INTEGER;

  ... 
  conn := utl_tcp.open_connection ( remote_host => 'localhost', 
                                    remote_port => 2000); 
  LOOP 
      tlen := utl_tcp.read_raw(conn, rvalue, 1024); 
      rvalue := utl_raw.concat(rtemp, rvalue); 
      nvalue := utl_i18n.raw_to_nchar(rvalue, 'JA16SJIS', converted_len, conversion_stat); 
      if (converted_len < utl_raw.length(rvalue) ) 
      then 
        rtemp := utl_raw.substr(rvalue, converted_len+1); 
      else 
        rtemp := ''; 
      end if; 
      /* do anything you want with nvalue */ 
      /* e.g htp.prn(nvalue); */ 
    END LOOP; 
    utl_tcp.close_connection(conn); 
  EXCEPTION 
    WHEN utl_tcp.end_of_input THEN 
      utl_tcp.close_connection(conn); 
  END; 

---

STRING_TO_RAWファンクション

このファンクションは、VARCHAR2またはNVARCHAR2の文字列を別の有効なOracleのキャラクタ・セットに変換し、その結果をRAWデータとして戻します。

構文

UTL_I18N.STRING_TO_RAW( 
   data          IN VARCHAR2 CHARACTER SET ANY_CS,
   dst_charset   IN VARCHAR2 DEFAULT NULL)
RETURN RAW;

パラメータ

表226-20 STRING_TO_RAWファンクションのパラメータ

パラメータ	説明
data	変換するVARCHAR2またはNVARCHAR2の文字列を指定します。
dst_charset	宛先となるキャラクタ・セットを指定します。dst_charsetがNULLの場合は、データベース・キャラクタ・セットがCHARデータに使用され、各国語キャラクタ・セットがNCHARデータに使用されます。

使用上の注意

ユーザーが無効なキャラクタ・セット、NULL文字列または長さが0の文字列を指定すると、ファンクションはNULL文字列を戻します。

例

DECLARE 
    r raw(50); 
    s varchar2(20); 
  BEGIN 
    s:='abcdef'||chr(170); 
    r:=utl_i18n.string_to_raw(s,'utf8'); 
    dbms_output.put_line(rawtohex(r)); 
  end; 
/ 

16進数の値'616263646566C2AA'が戻されます。

---

TRANSLITERATEファンクション

このファンクションは、スクリプト変換を実行します。このリリースでは、TRANSLITERATEファンクションは日本語の仮名変換のみをサポートします。

構文

UTL_I18N.TRANSLITERATE (
  data IN VARCHAR2 CHARACTER SET ANY_CS,
  name IN VARCHAR2)
RETURN VARCHAR2 CHARACTER SET data%CHARSET;

パラメータ

表226-21 TRANSLITERATEファンクションのパラメータ

パラメータ	説明
data	変換するデータを指定します。CHARまたはNCHARのいずれかのデータ・タイプを指定できます。
name	変換名文字列を指定します。有効な名前のリストについては、表226-22を参照してください。

定数

次のオプションは、日本語の仮名変換を指定します。

表226-22 TRANSLITERATEファンクションの定数

定数名	値	説明
KANA_FWKATAKANA	'kana_fwkatakana'	すべてのタイプの仮名文字を全角カタカナに変換します。
KANA_HWKATAKANA	'kana_hwkatakana'	すべてのタイプの仮名文字を半角カタカナに変換します。
KANA_HIRAGANA	'kana_hiragana'	すべてのタイプの仮名文字を全角ひらがなに変換します。
FWKATAKANA_HWKATAKANA	'fwkatakana_hwkatakana'	全角カタカナのみを半角カタカナに変換します。
FWKATAKANA_HIRAGANA	'fwkatakana_hiragana'	全角カタカナのみを全角ひらがなに変換します。
HWKATAKANA_FWKATAKANA	'hwkatakana_fwkatakana'	半角カタカナのみを全角カタカナに変換します。
HWKATAKANA_HIRAGANA	'hwkatakana_hiragana'	半角カタカナのみを全角ひらがなに変換します。
HIRAGANA_FWKATAKANA	'hiragana_fwkatakana'	全角ひらがなのみを全角カタカナに変換します。
HIRAGANA_HWKATAKANA	'hiragana_hwkatakana'	全角ひらがなのみを半角カタカナに変換します。

使用上の注意

このファンクションは、変換された文字列を戻します。

例

NVARCHAR2列enameを含む表japanese_empの場合は、次の文を使用して、enameのすべての仮名の名前をひらがなに正規化することができます。

UPDATE japanese_emp
   SET ename = UTL_I18N.TRANSLITERATE (ename, 'kana_hiragana');

次の図に、出力例を示します。

図226-1 データベースへのロケール固有のデータのロード

「図226-1 データベースへのロケール固有のデータのロード」の説明

次の文は、1つの仮名の名前をひらがなに正規化します。

DECLARE
   Name  japanese_emp.ename%TYPE;
   Eno   CONSTANT  NUMBER(4) := 1;
BEGIN
   SELECT ename INTO name FROM japanese_emp WHERE enumber = eno;
   name := UTL_I18N.TRANSLITERATE(name, UTL_I18N.KANA_HIRAGANA);
   UPDATE japanese_emp SET ename = name WHERE enumber = eno;
EXCEPTION
   WHEN  UTL_I18N.UNSUPPORTED_TRANSLITERATION THEN
   DBMS_OUTPUT.PUT_LINE('transliteration not supported');
END;
/

---

UNESCAPE_REFERENCEファンクション

このファンクションは、文字参照を含む入力文字列から文字列を1つ戻します。それぞれの文字参照は、対応する文字の値にデコードされます。

関連項目: エスケープ・シーケンスの詳細は、「ESCAPE_REFERENCEファンクション」を参照してください。

構文

UTL_I18N.UNESCAPE_REFERENCE ( 
   str IN VARCHAR2 CHARACTER SET ANY_CS)
 RETURN VARCHAR2 CHARACTER SET str%CHARSET;

パラメータ

表226-23 UNESCAPE_REFERENCEファンクションのパラメータ

パラメータ	説明
str	入力文字列を指定します。

使用上の注意

ユーザーがNULL文字列または長さが0の文字列を指定すると、ファンクションはNULL文字列を戻します。ファンクションが失敗すると、元の文字列が戻されます。

例

UTL_I18N.UNESCAPE_REFERENCE('hello < å')

'hello <'||chr(229)が戻されます。