Advanced Oracle PL/SQL Programming with Packages

Advanced Oracle PL/SQL Programming with PackagesSearch this book
Previous: III. Building Block PackagesChapter 6Next: 6.2 Setting the PL/Vision Date Mask
 

6. PLV: Top-Level Constants and Functions

Contents:
Null Substitution Value
Setting the PL/Vision Date Mask
Assertion Routines
PLV Utilities
The Predefined Datatypes
The Predefined Constants

Let's start our exploration into PL/Vision with the PLV package, which can be considered the lowest-level package or perhaps even the "miscellaneous" package. It provides a single collection point for constants and basic functions used throughout PL/Vision. Whenever I thought of something useful that was needed in more than one package but that did not belong in any particular functional package, it ended up in PLV.

The PLV (PL/Vision) package offers the following:

The following sections show how to use each of the different elements in the PLV package.

6.1 Null Substitution Value

It has been my experience that when I display a variable that is NULL, I want to see some evidence of that fact. In fact, I have found that in several places in PL/Vision I want to be able to substitute a NULL value for some other string. Rather than hard code that value into my package, I added the ability in the PLV package to decide what the substitution value would be with the set_nullval procedure:

PROCEDURE set_nullval (nullval_in IN VARCHAR2);

The default value for NULL substitutions is the string NULL. You can obtain the current setting of the substitution value by calling the nullval function:

FUNCTION nullval RETURN VARCHAR2;

The p package makes use of the substitute value for NULLs. When you call p.l to display text that RTRIMs to a NULL, it will automatically display the string that you have specified for substitution. In the following example, I set the NULL substitution value to N/A and then demonstrate its use in a call to the p.l procedure.

SQL> exec PLV.set_nullval ('N/A');
SQL> VARIABLE v NUMBER;
SQL> exec p.l (:v);
N/A


Previous: III. Building Block PackagesAdvanced Oracle PL/SQL Programming with PackagesNext: 6.2 Setting the PL/Vision Date Mask
III. Building Block PackagesBook Index6.2 Setting the PL/Vision Date Mask

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