1. Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス
  2. OWA_TEXT

227 OWA_TEXT

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

参照:

このパッケージの実装の詳細は、次のマニュアルを参照してください。

この章の内容は次のとおりです。

227.1 OWA_OPT_LOCKのタイプ

OWA_OPT_LOCKロック・タイプは3つあります。

227.1.1 MULTI_LINEデータ・タイプ

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

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

227.1.2 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;

227.1.3 VC_ARRデータ・タイプ

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

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

関連項目

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

この表は、OWA_TEXTサブプログラムを示し、簡単に説明しています。

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

サブプログラム 説明

ADD2MULTIプロシージャ

既存のMULTI_LINEタイプにテキストを追加します。

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

新しいROW_LISTを作成します。

PRINT_MULTIプロシージャ

MULTI_LISTの内容を印刷します。

PRINT_ROW_LISTプロシージャ

ROW_LISTの内容を印刷します。

STREAM2MULTIプロシージャ

VARCHAR2をMULTI_LINEタイプに変換します。

227.2.1 ADD2MULTIプロシージャ

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

構文

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

   continue       IN       BOOLEAN   DEFAULT TRUE);

パラメータ

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

パラメータ 説明

stream

追加するテキスト。

mline

OWA_TEXT.MULTI_LINEデータ・タイプ。このパラメータの出力には、streamが含まれます。

continue

TRUEの場合、プロシージャは前の最後の行内にstreamを付加します(32K以下であることを前提として)。FALSEの場合、プロシージャは新しい行内にstreamを配置します。

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

このファンクションまたはプロシージャは、新しいOWA_TEX.ROW_LIST DATA TYPEデータ・タイプを作成します。

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

構文

OWA_TEXT.NEW_ROW_LIST 
  RETURN ROW_LIST;

OWA_TEXT.NEW_ROW_LIST(
  rlist    OUT     row_list);

パラメータ

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

パラメータ 説明

rlist

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

戻り値

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

227.2.3 PRINT_MULTIプロシージャ

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

構文

OWA_TEXT.PRINT_MULTI(
   mline       IN       multi_line);

パラメータ

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

パラメータ 説明

mline

印刷するMULTI_LINEデータ・タイプ。

戻り値

MULTI_LINEの内容。

関連項目

227.2.4 PRINT_ROW_LISTプロシージャ

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

構文

OWA_TEXT.PRINT_ROW_LIST(
   rlist       IN       multi_line);

パラメータ

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

パラメータ 説明

rlist

印刷するROW_LISTデータ・タイプ。

戻り値

ROW_LISTの内容。

関連項目

227.2.5 STREAM2MULTIプロシージャ

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

構文

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

パラメータ

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

パラメータ 説明

stream

変換する文字列。

mline

OWA_TEXT.MULTI_LINEデータ・タイプのストリーム。