178 OWA_TEXT

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

関連項目: このパッケージの実装の詳細は、次のマニュアルを参照してください。 『Oracle Fusion Middleware Administrator's Guide for Oracle HTTP Server』 『Oracle Fusion Middleware User's Guide for 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サブプログラムの要約

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

パラメータ

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

パラメータ

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

パラメータ

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

パラメータ

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

パラメータ	説明
rlist	印刷するROW_LISTデータ型。

戻り値

ROW_LISTの内容。

---

STREAM2MULTIプロシージャ

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

構文

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

パラメータ

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

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