DBE_OUTPUT
当使用DBE_OUTPUT.PUT_LINE打印DBE_FILE.READ_LINE_NCHAR接口得到的结果时，需要确保UTF8字符集编码能够转换成当前数据库字符集编码，满足上述条件后可以正常输出结果。DBE_OUTPUT.PRINT_LINE不支持该功能。
接口介绍
高级功能包DBE_OUTPUT支持的接口请参见表1。
| 接口名称 | 描述 |
|---|---|
| 输出指定的文本，并添加换行符。 | |
| 输出指定的文本，不添加换行符。 | |
| 设置输出缓冲区的大小，如果不指定则缓冲区最大能容纳20000字节，如果指定小于等于2000字节，则缓冲区允许容纳2000字节。 | |
| 禁用PUT、PUT_LINE、NEW_LINE、GET_LINE、GET_LINES调用，并清空输出缓冲区。 | |
| 开启缓冲区，允许对PUT、PUT_LINE、NEW_LINE、GET_LINE和GET_LINES的调用，设置缓冲区大小。 | |
| 从缓冲区中以换行符作为分界获取一行数据，获取的数据将不会输出到客户端。 | |
| 以VARCHAR数组的形式获取缓冲区的指定行数的字符串，被取出的内容将会在缓冲区中清除，不会输出到客户端。 | |
| 放置一行在缓冲区末尾，放置行尾标记，空出新的一行。 | |
| 将输入字符串放入到缓冲区，末尾不加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。 | |
| 将输入字符串放入到缓冲区，并末尾添加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。 |
- DBE_OUTPUT.PRINT_LINE
DBE_OUTPUT.PRINT_LINE原型为：
DBE_OUTPUT.PRINT_LINE ( format IN VARCHAR2);
- DBE_OUTPUT.PRINT
DBE_OUTPUT.PRINT原型为：
DBE_OUTPUT.PRINT ( format IN VARCHAR2);
- DBE_OUTPUT.ENABLE
存储过程ENABLE开启缓冲区，允许对PUT、PUT_LINE、NEW_LINE、GET_LINE和GET_LINES的调用，并设置缓冲区大小，如果未指定缓冲区大小则默认容纳20000字节。
DBE_OUTPUT.ENABLE原型为：DBE_OUTPUT.ENABLE ( buffer_size IN INTEGER DEFAULT 20000 );表5 DBE_OUTPUT.ENABLE接口参数说明 参数
描述
buffer_size
缓冲区大小的上限，以字节为单位。将buffer_size设置为NULL表示使用默认值（20000字节）。
- 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
输入值为需要从缓冲区检索的行数。输出值为实际检索到的行数，取值范围为大于0且不能为NULL，如果输出值小于输入值，则表明缓冲区中存在的行数小于输入的行数。
- DBE_OUTPUT.NEW_LINE
存储过程NEW_LINE放置一行在缓冲区末尾，放置行尾标记，空出新的一行。
DBE_OUTPUT.NEW_LINE原型为：
DBE_OUTPUT.NEW_LINE;
- DBE_OUTPUT.PUT
存储过程PUT将输入字符串放入到缓冲区，末尾不加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。
DBE_OUTPUT.PUT原型为：
DBE_OUTPUT.PUT ( item IN VARCHAR2);表8 DBE_OUTPUT.PUT接口参数说明 参数
描述
item
待放在缓存区的字符或字符串item。单行最大长度限制为32767字节。
- DBE_OUTPUT.PUT_LINE
存储过程PUT_LINE将输入字符串放入到缓冲区，并且末尾添加换行符，在匿名块执行结束时会将以换行符结尾的行输出显示。
DBE_OUTPUT.PUT_LINE原型为：
DBE_OUTPUT.PUT_LINE ( item IN VARCHAR2);表9 DBE_OUTPUT.PUT_LINE接口参数说明 参数
描述
item
待放在缓存区的字符或字符串。单行最大长度限制为32767字节。
示例
BEGIN
DBE_OUTPUT.SET_BUFFER_SIZE(50);
DBE_OUTPUT.PRINT('hello, ');
DBE_OUTPUT.PRINT_LINE('database!'); -- 输出hello, database!。
END;
/
-- 预期结果为：
hello, database!
ANONYMOUS BLOCK EXECUTE
-- 测试disable禁用put、put_line、new_line、get_line、get_lines调用,测试put_line不输出。
BEGIN
dbe_output.disable();
dbe_output.put_line('1');
END;
/
-- 预期结果为：
ANONYMOUS BLOCK EXECUTE
-- 测试enable启用put、put_line、new_line、get_line、get_lines调用，测试put_line输出1。
BEGIN
dbe_output.enable();
dbe_output.put_line('1');
END;
/
-- 预期结果为：
1
ANONYMOUS BLOCK EXECUTE
-- 测试put，输入字符串a放入到缓冲区，末尾不加换行符，a不输出。
BEGIN
dbe_output.enable();
dbe_output.put('a');
END;
/
-- 预期结果为：
ANONYMOUS BLOCK EXECUTE
-- 测试new_line,添加换行，输出a。
BEGIN
dbe_output.enable();
dbe_output.put('a');
dbe_output.new_line;
END;
/
-- 预期结果为：
a
ANONYMOUS BLOCK EXECUTE
-- 测试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
ANONYMOUS BLOCK EXECUTE
-- 测试get_lines获取缓冲区多行内容，使用put_line输出。
DECLARE
lines varchar[];
linenum integer;
BEGIN
dbe_output.put_line('line 1');
dbe_output.put_line('line 2');
dbe_output.put_line('line 3');
linenum := 100;
dbe_output.get_lines(lines, linenum);
dbe_output.put_line('num: ' || linenum);
FOR i IN 1 .. linenum LOOP
dbe_output.put_line(lines[i]);
END LOOP;
END;
/
-- 预期结果为：
num: 3
line 1
line 2
line 3
ANONYMOUS BLOCK EXECUTE
当服务端的字符编码类型server_encoding不为UTF8时，如果数据中存在字符编码属于合法的UTF8编码，DBE_OUTPUT.PUT_LINE函数和DBE_OUTPUT.PUT函数在处理该字符编码时会将其按照UTF8编码逻辑进行处理，将其先转换成server_encoding的编码格式后再进行后续操作，这样可能会导致函数返回值不符合预期或发生报错。当开启GUC参数enable_convert_illegal_char后（enable_convert_illegal_char值为on），DBE_OUTPUT.PUT_LINE函数和DBE_OUTPUT.PUT函数在处理此类编码的表现与参数关闭时保持一致，特殊字符不会以占位符形式输出，因此不建议用户对含有特殊字符的数据使用DBE_OUTPUT.PUT_LINE函数和DBE_OUTPUT.PUT函数。
