Advanced Oracle PL/SQL Programming with Packages

Advanced Oracle PL/SQL Programming with PackagesSearch this book
Previous: 7.4 Controlling Output from pChapter 8Next: 8.2 Displaying PLVtab Tables
 

8. PLVtab: Easy Access to PL/SQL Tables

Contents:
Using PLVtab-Based PL/SQL Table Types
Displaying PLVtab Tables
Showing Header Toggle
Showing Row Number Toggle
Setting the Display Prefix
Emptying Tables with PLVtab
Implementing PLVtab.display

The PLVtab (PL/Vision TABle) package offers predefined PL/SQL table types and programs to make it easier to declare, use, and display the contents of PL/SQL tables. PL/SQL tables are the closest things to arrays in PL/SQL, but there are a number of complications. First, to use a PL/SQL table, you first have to declare a table type. Then you can declare and use the PL/SQL table itself. Beyond the definition of the PL/SQL table, the fact that it is a sparse, unbounded, homogeneous data structure can lead to complications, particularly when it comes to scanning and displaying those structures (see Chapter 10 of Oracle PL/SQL Programming).

By using PLVtab, you can avoid (in most cases) having to define your own PL/SQL table types. You can also take advantage of flexible, powerful display procedures to view table contents.

When you display the contents of PL/SQL tables, PLVtab allows you to:

This chapter shows how to use the different aspects of PLVtab.

8.1 Using PLVtab-Based PL/SQL Table Types

When you use PL/SQL tables, you normally perform a number of common actions, including defining the table type, declaring the table, filling up the rows, referencing the rows, and emptying the table when done. When using a PLVtab-based table, you do not have to declare the table type. Instead you simply reference the package-based type in your declaration. PLVtab predefines the following PL/SQL table TYPEs, shown in Table 8.1:


Table 8.1: Table Types Predefined in PLVtab

Type

Description

boolean_table

PL/SQL table of Booleans

date_table

PL/SQL table of dates

integer_table

PL/SQL table of integers

number_table

PL/SQL table of numbers

vc30_table

PL/SQL table of VARCHAR2(30) strings

vc60_table

PL/SQL table of VARCHAR2(60) strings

vc80_table

PL/SQL table of VARCHAR2(80) strings

vc2000_table

PL/SQL table of VARCHAR2(2000) strings

ident_table

PL/SQL table of VARCHAR2(100) strings; matches PLV.plsql_identifier declaration.

vcmax_table

PL/SQL table of VARCHAR2(32767) strings

Let's compare the "native" and PL/Vision approaches to defining PL/SQL tables. In the following anonymous block, I define a PL/SQL table of Booleans without the assistance of PLVtab.

DECLARE
   TYPE bool_tabtype IS TABLE OF BOOLEAN
      INDEX BY BINARY_INTEGER;
   yesno_tab bool_tabtype;
BEGIN

With the PLVtab package in place, all I have to is the following:

DECLARE
   yesno_tab PLVtab.boolean_table;
BEGIN

Once you have declared a table using PLVtab, you manipulate that table as you would a table based on your own table TYPE statement.


Previous: 7.4 Controlling Output from pAdvanced Oracle PL/SQL Programming with PackagesNext: 8.2 Displaying PLVtab Tables
7.4 Controlling Output from pBook Index8.2 Displaying PLVtab Tables

The Oracle Library Navigation

Copyright (c) 2000 O'Reilly & Associates. All rights reserved.

Library Home Oracle PL/SQL Programming, 2nd. Ed. Guide to Oracle 8i Features Oracle Built-in Packages Advanced PL/SQL Programming with Packages Oracle Web Applications Oracle PL/SQL Language Pocket Reference Oracle PL/SQL Built-ins Pocket Reference