DBE_OUTPUT

当使用DBE_OUTPUT.PUT_LINE打印DBE_FILE.READ_LINE_NCHAR接口得到的结果时，需要确保UTF-8字符集编码能够转换成当前数据库字符集编码，满足上述条件后可以正常输出结果。DBE_OUTPUT.PRINT_LINE不支持该功能。

接口介绍

高级功能包DBE_OUTPUT支持的所有接口请参见表 DBE_OUTPUT。

表1 DBE_OUTPUT
接口名称	描述
DBE_OUTPUT.PRINT_LINE	输出指定的文本,并添加换行符。
DBE_OUTPUT.PRINT	输出指定的文本，不添加换行符。
DBE_OUTPUT.SET_BUFFER_SIZE	设置输出缓冲区的大小，如果不指定则缓冲区最大能容忍20000字节，如果指定小于等于2000字节，则缓冲区允许容纳2000字节。
DBE_OUTPUT.DISABLE	禁用put、put_line、new_line、get_line、get_lines调用，并清空输出缓冲区。
DBE_OUTPUT.ENABLE	开启缓冲区，允许对PUT、PUT_LINE、NEW_LINE、GET_LINE和GET_LINES的调用，设置缓冲区大小。
DBE_OUTPUT.GET_LINE	从缓冲区中以换行符作为分界获取一行数据，获取的数据将不会输出到客户端。
DBE_OUTPUT.GET_LINES	以VARCHAR数组的形式获取缓冲区的指定行数的字符串，被取出的内容将会在缓冲区中清除，不会输出到客户端。
DBE_OUTPUT.NEW_LINE	放置一行在缓冲区末尾，放置行尾标记，空出新的一行。
DBE_OUTPUT.PUT	将输入字符串放入到缓冲区，末尾不加换行符，在存储过程结束时会将以换行符结尾的行输出显示。
DBE_OUTPUT.PUT_LINE	将输入字符串放入到缓冲区，并末尾添加换行符，在存储过程结束时会将以换行符结尾的行输出显示。

DBE_OUTPUT.PRINT_LINE

存储过程PRINT_LINE向消息缓冲区写入一行带有行结束符的文本。DBE_OUTPUT.PRINT_LINE函数原型为：

      
           DBE_OUTPUT.PRINT_LINE (
format IN VARCHAR2);

表2 DBE_OUTPUT.PRINT_LINE接口参数说明
参数	描述
format	写入消息缓冲区的文本。

DBE_OUTPUT.PRINT

存储过程PRINT将指定的文本输出到指定文本的前面，不添加换行符。DBE_OUTPUT.PRINT函数原型为：

      
           DBE_OUTPUT.PRINT (
format IN VARCHAR2);

表3 DBE_OUTPUT.PRINT接口参数说明
参数	描述
format	写入指定文本前的文本。

DBE_OUTPUT.SET_BUFFER_SIZE

存储过程SET_BUFFER_SIZE设置输出缓冲区的大小，如果不指定的话缓冲区最大只能容纳20000字节。DBE_OUTPUT.SET_BUFFER_SIZE函数原型为：

      
           DBE_OUTPUT.SET_BUFFER_SIZE (
size IN INTEGER default 20000);

表4 DBE_OUTPUT.SET_BUFFER_SIZE接口参数说明
参数	描述
size	设置输出缓冲区的大小。

DBE_OUTPUT.DISABLE
存储过程DISABLE禁用put、put_line、new_line、get_line、get_lines调用，并清空输出缓冲区。DBE_OUTPUT.DISABLE函数原型为：
1

DBE_OUTPUT.DISABLE;

DBE_OUTPUT.ENABLE

存储过程ENABLE开启缓冲区，允许对 PUT、PUT_LINE、NEW_LINE、GET_LINE 和 GET_LINES 的调用，设置缓冲区大小。DBE_OUTPUT.ENABLE函数原型为：

      
           DBE_OUTPUT.ENABLE (
    buffer_size IN INTEGER DEFAULT 20000
);

表5 DBE_OUTPUT.ENABLE接口参数说明
参数	描述
buffer_size	缓冲大小的上限，以字节为单位。将 buffer_size 设置为 NULL 表示使用默认值。

DBE_OUTPUT.GET_LINE

存储过程GET_LINE从缓冲区中以换行符作为分界获取一行数据，获取的数据将不会输出到客户端。DBE_OUTPUT.GET_LINE函数原型为：

     
          DBE_OUTPUT.GET_LINE (
    line   OUT VARCHAR2,
    status OUT INTEGER
);

表6 DBE_OUTPUT.GET_LINE接口参数说明
参数	描述
line	表示获取到的字符串。
status	表示调用状态是否正常，如果获取到字符串则为0，否则为1。

DBE_OUTPUT.GET_LINES

存储过程GET_LINES以VARCHAR数组的形式获取缓冲区的指定行数的字符串，被取出的内容将会在缓冲区中清除，不会输出到客户端。DBE_OUTPUT.GET_LINES函数原型为：

     
          DBE_OUTPUT.GET_LINES (
    lines    OUT   VARCHAR[],
    numlines IN OUT INTEGER
);

表7 DBE_OUTPUT.GET_LINES接口参数说明
参数	描述
lines	输出从缓冲区读取的多行字符串数组。
numlines	输入值为需要从缓冲区检索的行数。输出值为实际检索到的行数，如果输出值小于输入值，则缓冲区中没有更多的行。

DBE_OUTPUT.NEW_LINE
存储过程NEW_LINE放置一行在缓冲区末尾，放置行尾标记，空出新的一行。DBE_OUTPUT.NEW_LINE函数原型为：
1

DBE_OUTPUT.NEW_LINE;

DBE_OUTPUT.PUT

存储过程PUT将输入字符串放入到缓冲区，末尾不加换行符，在存储过程结束时会将以换行符结尾的行输出显示。DBE_OUTPUT.PUT函数原型为：

     
          DBE_OUTPUT.PUT (
    item IN VARCHAR2);

表8 DBE_OUTPUT.PUT接口参数说明
参数	描述
item	待放在缓存区的字符或字符串item。

DBE_OUTPUT.PUT_LINE

存储过程PUT_LINE将输入字符串放入到缓冲区，并末尾添加换行符，在存储过程结束时会将以换行符结尾的行输出显示。DBE_OUTPUT.PUT_LINE函数原型为：

     
          DBE_OUTPUT.PUT_LINE (
    item IN VARCHAR2);

表9 DBE_OUTPUT.PUT_LINE接口参数说明
参数	描述
item	待放在缓存区的字符或字符串item。

示例

    
     
       
       
         BEGIN
    DBE_OUTPUT.SET_BUFFER_SIZE(50);
    DBE_OUTPUT.PRINT('hello, ');
    DBE_OUTPUT.PRINT_LINE('database!');--输出hello, database!
END;
/

-- 测试disable禁用put、put_line、new_line、get_line、get_lines调用,测试put_line不输出
BEGIN
 dbe_output.disable();
        dbe_output.put_line('1');
END; 
/

-- 测试enable启用put、put_line、new_line、get_line、get_lines调用，测试put_line输出1
BEGIN
 dbe_output.enable();
        dbe_output.put_line('1');
END; 
/

-- 测试put，输入字符串a放入到缓冲区，末尾不加换行符，a不输出
BEGIN
 dbe_output.enable();
 dbe_output.put('a');
END; 
/

-- 测试new_line,添加换行，输出a
BEGIN
 dbe_output.enable();
 dbe_output.put('a');
        dbe_output.new_line;
END; 
/

-- 测试get_line获取缓冲区数据保存到变量，使用put_line输出
DECLARE
 line VARCHAR(32672);
 status INTEGER := 0;
BEGIN
 dbe_output.put_line('hello');
 dbe_output.get_line(line, status);
 dbe_output.put_line('-----------');
 dbe_output.put_line(line);
 dbe_output.put_line(status);
END; 
/
-- 预期结果为：
-----------
hello
0

-- 测试get_line获取缓冲区多行内容，使用put_line输出
DECLARE
    lines dbms_output.chararr;
    numlines integer;
BEGIN
    dbe_output.put_line('output line 1');
    dbe_output.put_line('output line 2');
    dbe_output.put_line('output line 3');
    numlines := 100;
    dbe_output.get_lines(lines, numlines);
    dbe_output.put_line('num: ' || numlines);
    dbe_output.put_line('get line 1: ' || lines(1));
    dbe_output.put_line('get line 2: ' || lines(2));
    dbe_output.put_line('get line 3: ' || lines(3));
END;
/
-- 预期结果为：
num: 3
get line 1: output line 1
get line 2: output line 2
get line 3: output line 3

        

      

    
   