DUMP

Syntax

Purpose

DUMP returns a VARCHAR2 value containing the datatype code, length in bytes, and internal representation of expr. The returned result is always in the database character set. For the datatype corresponding to each code, see Table 2-1.

The argument return_fmt specifies the format of the return value and can have any of the following values:

• 8 returns result in octal notation

• 10 returns result in decimal notation

• 16 returns result in hexadecimal notation

• 17 returns result as single characters

By default, the return value contains no character set information. To retrieve the character set name of expr, specify any of the format values above, plus 1000. For example, a return_fmt of 1008 returns the result in octal, plus provides the character set name of expr.

The arguments start_position and length combine to determine which portion of the internal representation to return. The default is to return the entire internal representation in decimal notation.

If expr is null, this function returns a null.

Example 1

SELECT DUMP('abc', 1016)
   FROM DUAL;

DUMP('ABC',1016)                          
------------------------------------------ 

Typ=96 Len=3 CharacterSet=WE8DEC: 61,62,63

Example 2

SELECT DUMP(ename, 8, 3, 2) "OCTAL"
   FROM emp
   WHERE ename = 'SCOTT';

OCTAL
----------------------------
Type=1 Len=5: 117,124 

Example 3

SELECT DUMP(ename, 10, 3, 2) "ASCII"
   FROM emp
   WHERE ename = 'SCOTT';

ASCII
----------------------------
Type=1 Len=5: 79,84