194 OWA_TEXT

OWA_TEXTパッケージには、OWA_PATTERNが文字列操作に使用するサブプログラムが含まれています。これは外部化されているため、直接使用できます。

関連項目: このパッケージの実装の詳細は、次のマニュアルを参照してください。 『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』 『Oracle Fusion Middleware mod_plsqlユーザーズ・ガイド』

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

• OWA_TEXTの使用方法

  • タイプ

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

---

OWA_TEXTの使用方法

• タイプ

---

タイプ

• MULTI_LINEデータ・タイプ

• ROW_LISTデータ・タイプ

• VC_ARRデータ・タイプ

MULTI_LINEデータ・タイプ

このデータ・タイプは、大量のテキストを保持するPL/SQLレコードです。OWA_TEXT.VC_ARRデータ・タイプのrowsフィールドに、このレコードのテキスト・データが含まれます。

TYPE multi_line IS RECORD (
   rows           vc_arr,
   num_rows       INTEGER,
   partial_row    BOOLEAN);

ROW_LISTデータ・タイプ

これは、処理するデータを保持するためのデータ・タイプです。

TYPE row_list IS RECORD (
   rows           int_arr,
   num_rows       INTEGER);

int_arr IS DEFINED AS:

TYPE int_arr IS TABLE OF INTEGER INDEX BY BINARY_INTEGER;

VC_ARRデータ・タイプ

これは、MULTI_LINEデータ・タイプのコンポーネントで、大量のテキストを保持する場合に使用します。

TYPE vc_arr IS TABLE OF VARCHAR2(32767) INDEX BY BINARY_INTEGER;

---

OWA_TEXTサブプログラムの要約

表194-1 OWA_TEXTパッケージのサブプログラム

サブプログラム	説明
ADD2MULTIプロシージャ	既存のMULTI_LINEタイプにテキストを追加します。
NEW_ROW_LISTファンクションおよびプロシージャ	新しいROW_LISTを作成します。
PRINT_MULTIプロシージャ	MULTI_LISTの内容を印刷します。
PRINT_ROW_LISTプロシージャ	ROW_LISTの内容を印刷します。
STREAM2MULTIプロシージャ	VARCHAR2をMULTI_LINEタイプに変換します。

---

ADD2MULTIプロシージャ

このプロシージャは、既存のMULTI_LINEデータ・タイプに内容を追加します。

構文

OWA_TEXT.ADD2MULTI(
   stream         IN       VARCHAR2,
   mline          IN OUT   multi_line,

   continue       IN       BOOLEAN   DEFAULT TRUE);

パラメータ

表194-2 ADD2MULTIプロシージャのパラメータ

パラメータ	説明
stream	追加するテキスト。
mline	OWA_TEXT.MULTI_LINEデータ・タイプ。このパラメータの出力には、streamが含まれます。
continue	TRUEの場合、プロシージャは前の最後の行内にstreamを付加します(32K以下であることを前提として)。FALSEの場合、プロシージャは新しい行内にstreamを配置します。

---

NEW_ROW_LISTファンクションおよびプロシージャ

このファンクションまたはプロシージャは、新しいOWA_TEXT.ROW_LISTデータ・タイプを作成します。ファンクションのバージョンは、パラメータを使用せず、新しいROW_LISTを空で戻します。プロシージャのバージョンは、出力パラメータとしてROW_LISTデータ・タイプを作成します。

構文

OWA_TEXT.NEW_ROW_LIST 
  RETURN ROW_LIST;

OWA_TEXT.NEW_ROW_LIST(
  rlist    OUT     row_list);

パラメータ

表194-3 NEW_ROW_LISTプロシージャのパラメータ

パラメータ	説明
rlist	これは、新しいROW_LISTデータ・タイプを含む出力パラメータです。

戻り値

ファンクションのバージョンは、新しいROW_LISTデータ・タイプを戻します。

---

PRINT_MULTIプロシージャ

このプロシージャは、PRINTプロシージャまたはPRNプロシージャを使用して、OWA_TEXT.MULTI_LINEデータ・タイプの"rows"フィールドを印刷します。

構文

OWA_TEXT.PRINT_MULTI(
   mline       IN       multi_line);

パラメータ

表194-4 PRINT_MULTIプロシージャのパラメータ

パラメータ	説明
mline	印刷するMULTI_LINEデータ・タイプ。

戻り値

MULTI_LINEの内容。

---

PRINT_ROW_LISTプロシージャ

このプロシージャは、PRINTプロシージャまたはPRNプロシージャを使用して、OWA_TEXT.ROW_LISTデータ・タイプの"rows"フィールドを印刷します。

構文

OWA_TEXT.PRINT_ROW_LIST(
   rlist       IN       multi_line);

パラメータ

表194-5 PRINT_ROW_LISTプロシージャのパラメータ

パラメータ	説明
rlist	印刷するROW_LISTデータ・タイプ。

戻り値

ROW_LISTの内容。

---

STREAM2MULTIプロシージャ

このプロシージャは、文字列をMULTI_LINEデータ・タイプに変換します。

構文

OWA_TEXT.STREAM2MULTI(
   stream         IN       VARCHAR2
   mline          OUT      multi_line);

パラメータ

表194-6 STREAM2MULTIプロシージャのパラメータ

パラメータ	説明
stream	変換する文字列。
mline	OWA_TEXT.MULTI_LINEデータ・タイプのストリーム。