8 owa_textパッケージ

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

8.1 サマリー

owa_text.add2multiプロシージャ: 既存のmulti_line型にテキストを追加します。

owa_text.multi_lineデータ型: 大量のテキストを保持するためのデータ型です。

owa_text.new_row_list: 新しいrow_listを作成します。

owa_text.print_multiプロシージャ: multi_listの内容を出力します。

owa_text.print_row_listプロシージャ: row_listの内容を出力します。

owa_text.row_listデータ型: 処理するデータを保持するためのデータ型です。

owa_text.stream2multiプロシージャ: varchar2をmulti_line型に変換します。

owa_text.vc_arrデータ型: 大量のテキストを保持するためのデータ型です。

8.2 owa_text.add2multiプロシージャ

既存のowa_text.multi_lineデータ型に内容を追加します。

表8-1にowa_text.add2multiプロシージャのプロパティを示します。

表8-1 owa_text.add2multiプロシージャ

プロパティ	定義
構文:	owa_text.add2multi( stream in varchar2 mline in out multi_line continue in boolean DEFAULT TRUE);
パラメータ:	stream: 追加するテキスト。 mline: owa_text.multi_lineデータ型。このパラメータの出力には、streamが含まれる。 continue: TRUEの場合、前回の最後の行にstreamが追加される（32K未満の場合）。FALSEの場合、新しい行にstreamが格納される。
戻り値:	なし

8.3 owa_text.multi_lineデータ型

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

表8-2にowa_text.multi_lineデータ型のプロパティを示します。

表8-2 owa_text.multi_lineデータ型

プロパティ	定義
構文:	type multi_line is record ( rows vc_arr, num_rows integer, partial_row boolean);
戻り値:	なし

8.4 owa_text.new_row_list

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

表8-3にowa_text.new_row_listのプロパティを示します。

表8-3 owa_text.new_row_list

プロパティ	定義
構文:	/* procedure */ owa_text.new_row_list(rlist out row_list); /* function */ owa_text.new_row_list return row_list;
パラメータ:	rlist: 新しいrow_listデータ型を含む出力パラメータ。
戻り値:	ファンクション・バージョンは、新しいrow_listデータ型を返す。

8.5 owa_text.print_multiプロシージャ

htp.printおよびhtp.prnを使用して、owa_text.multi_lineデータ型のrowsフィールドを出力します。

表8-4にowa_text.print_multiプロシージャのプロパティを示します。

表8-4 owa_text.print_multiプロシージャ

プロパティ	定義
構文:	owa_text.print_multi(mline in multi_line);
パラメータ:	mline: 出力するmulti_lineデータ型。
戻り値:	multi_lineの内容。

8.6 owa_text.print_row_listプロシージャ

htp.printおよびhtp.prnを使用して、owa_text.row_listデータ型のrowsフィールドを出力します。

表8-5にowa_text.print_row_listプロシージャのプロパティを示します。

表8-5 owa_text.print_row_listプロシージャ

プロパティ	定義
構文:	owa_text.print_row_list(rlist in row_list);
パラメータ:	rlist: 出力するrow_listデータ型。
戻り値:	row_listの内容。

8.7 owa_text.row_listデータ型

処理するデータを保持するデータ型です。

表8-6にowa_text.row_listデータ型のプロパティを示します。

表8-6 owa_text.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;
戻り値:	なし

8.8 owa_text.stream2multiプロシージャ

文字列をmulti_lineデータ型に変換します。

表8-7にowa_text.stream2multiプロシージャのプロパティを示します。

表8-7 owa_text.stream2multiプロシージャ

プロパティ	定義
構文:	owa_text.stream2multi(    stream         in       varchar2    mline          out      multi_line);
パラメータ:	stream: 変換する文字列。 mline: owa_text.multi_lineデータ型形式のstream。
戻り値:	なし

8.9 owa_text.vc_arrデータ型

owa_text.multi_lineデータ型の構成要素です。

表8-8にowa_text.vc_arrデータ型のプロパティを示します。

表8-8 owa_text.vc_arrデータ型

プロパティ	定義
構文:	type vc_arr is table of varchar2(32767) index by binary_integer;
戻り値:	なし