The OWA_TEXT
package contains subprograms used by OWA_PATTERN
for manipulating strings. They are externalized so you can use them directly.
See Also:
For more information about implementation of this package:The chapter contains the following topics:
This data type is a PL/SQL record that holds large amounts of text. The rows field, of type OWA_TEXT
.VC_ARR
DATA
TYPE
, contains the text data in the record.
TYPE multi_line IS RECORD ( rows vc_arr, num_rows INTEGER, partial_row BOOLEAN);
This is the data type for holding data to be processed.
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;
This is a component of the MULTI_LINE DATA TYPE and is used for holding large amounts of text.
TYPE vc_arr IS TABLE OF VARCHAR2(32767) INDEX BY BINARY_INTEGER;
Table 148-1 OWA_TEXT Package Subprograms
Subprogram | Description |
---|---|
Adds text to an existing |
|
Creates a new |
|
Prints out the contents of a |
|
Prints out the contents of a |
|
Converts a varchar2 to a |
This procedure adds content to an existing MULTI_LINE DATA TYPE.
OWA_TEXT.ADD2MULTI( stream IN VARCHAR2, mline IN OUT multi_line,
continue IN BOOLEAN DEFAULT TRUE);
Table 148-2 ADD2MULTI Procedure Parameters
Parameter | Description |
---|---|
|
The text to add. |
|
The |
|
If |
This function or procedure creates a new OWA_TEXT
.ROW_LIST
DATA
TYPE
. The function version uses no parameters and returns a new empty row_list
. The procedure version creates the row_list
data type as an output parameter.
OWA_TEXT.NEW_ROW_LIST RETURN ROW_LIST; OWA_TEXT.NEW_ROW_LIST( rlist OUT row_list);
Table 148-3 NEW_ROW_LIST Procedure Parameters
Parameter | Description |
---|---|
|
This is an output parameter containing the new |
The function version returns the new row_list
data type.
This procedure uses the PRINT Procedures or the PRN Procedures to print the "rows" field of the OWA_TEXT
.MULTI_LINE
DATA
TYPE
.
OWA_TEXT.PRINT_MULTI( mline IN multi_line);
Table 148-4 PRINT_MULTI Procedure Parameters
Parameter | Description |
---|---|
|
The multi_line data type to print. |
The contents of the multi_line
.
This procedure uses the PRINT Procedures or the PRN Procedures to print the "rows" field of the OWA_TEXT
.ROW_LIST
DATA
TYPE
.
OWA_TEXT.PRINT_ROW_LIST( rlist IN multi_line);
Table 148-5 PRINT_ROW_LIST Procedure Parameters
Parameter | Description |
---|---|
|
The row_list data type to print. |
The contents of the row_list
.
This procedure converts a string to a multi_line
data type.
OWA_TEXT.STREAM2MULTI( stream IN VARCHAR2 mline OUT multi_line);