UTL_RAW包用于操作或检索原始数据类型的长度。
前提条件
管理员必须提前为每个用户或用户组授予执行特权。
函数和存储过程
函数/存储过程 | 类型 | 返回类型 | 说明 |
---|---|---|---|
CAST_TO_RAW(c IN VARCHAR2) | 函数 | RAW | 将VARCHAR2字符串转换为RAW值。 |
CAST_TO_VARCHAR2(r IN RAW) | 函数 | VARCHAR2 | 将RAW值转换为VARCHAR2字符串。 |
CONCAT(r1 IN RAW, r2 IN RAW, r3 IN RAW,…) | 函数 | RAW | 将多个RAW值连接成一个RAW值。 |
CONVERT(r IN RAW, to_charset IN VARCHAR2, from_charset IN VARCHAR2) | 函数 | RAW | 将编码数据从一种编码转换为另一种编码,并将结果作为RAW值返回。 |
LENGTH(r IN RAW) | 函数 | NUMBER | 返回RAW值的长度。 |
SUBSTR(r IN RAW, pos IN INTEGER, len IN INTEGER) | 函数 | RAW | 返回RAW值的一部分。 |
CAST_TO_RAW
CAST_TO_RAW函数将VARCHAR2字符串转换为RAW值:
CAST_TO_RAW(c VARCHAR2)
- 如果传递非NULL值,则此函数返回RAW值。
- 如果传递NULL值,则此函数返回NULL。
参数
参数 | 说明 |
---|---|
c | 需要转换的字符串,此处将转换为RAW的VARCHAR2值。 |
示例
以下示例使用CAST_TO_RAW函数将VARCHAR2字符串转换为RAW值:
DECLARE
v VARCHAR2;
r RAW;
BEGIN
v := 'Accounts';
dbms_output.put_line(v);
r := UTL_RAW.CAST_TO_RAW(v);
dbms_output.put_line(r);
END;
结果集包含原始字符串的内容以及转换后的RAW值:
Accounts
\x4163636f756e7473
CAST_TO_VARCHAR2
CAST_TO_VARCHAR2函数将RAW数据转换为VARCHAR2数据:
CAST_TO_VARCHAR2(r RAW)
- 如果传递非NULL值,则此函数返回VARCHAR2值。
- 如果传递NULL值,则此函数返回NULL。
参数
参数 | 说明 |
---|---|
r | 将转换为VARCHAR2值的RAW值。 |
示例
以下示例使用CAST_TO_VARCHAR2函数将RAW值转换为VARCHAR2字符串:
DECLARE
r RAW;
v VARCHAR2;
BEGIN
r := '\x4163636f756e7473';
dbms_output.put_line(r);
v := UTL_RAW.CAST_TO_VARCHAR2(r);
dbms_output.put_line(v);
END;
结果集包含原始字符串的内容以及转换后的RAW值:
\x4163636f756e7473
Accounts
CONCAT
CONCAT函数将多个RAW值连接成一个RAW值:
CONCAT(r1 RAW, r2 RAW, r3 RAW,…)
此函数返回RAW值。与Oracle实施不同,PolarDB PostgreSQL版(兼容Oracle)实施是一种可变参数函数,并且不会限制可连接起来的值的数量。
参数
参数 | 说明 |
---|---|
r1, r2, r3,… | CONCAT将连接的RAW值。 |
示例
以下示例使用CONCAT函数将多个RAW值连接成一个RAW值,然后,CAST_TO_VARCHAR2函数会将结果(连接的值)转换为VARCHAR2格式:
SELECT UTL_RAW.CAST_TO_VARCHAR2(UTL_RAW.CONCAT('\x61', '\x62', '\x63')) FROM DUAL;
显示结果如下:concat
--------
abc
(1 row)
CONVERT
CONVERT函数将字符串从一种编码转换为另一种编码,并将结果作为RAW值返回:
CONVERT(r RAW, to_charset VARCHAR2, from_charset VARCHAR2)
此函数返回RAW值。参数
参数 | 说明 |
---|---|
r | 将转换的RAW值。 |
to_charset | r将转换后的编码的名称。 |
from_charset | r将执行转换的源编码的名称。 |
示例
以下示例使用UTL_RAW.CAST_TO_RAW函数将VARCHAR2字符串(Accounts)转换为原始值,然后将该值从UTF8转换为LATIN7,再将其从LATIN7转换为UTF8:
DECLARE
r RAW;
v VARCHAR2;
BEGIN
v:= 'Accounts';
dbms_output.put_line(v);
r:= UTL_RAW.CAST_TO_RAW(v);
dbms_output.put_line(r);
r:= UTL_RAW.CONVERT(r, 'UTF8', 'LATIN7');
dbms_output.put_line(r);
r:= UTL_RAW.CONVERT(r, 'LATIN7', 'UTF8');
dbms_output.put_line(r);
END;
此示例返回VARCHAR2值、RAW值和转换后的值:
Accounts
\x4163636f756e7473
\x4163636f756e7473
\x4163636f756e7473
LENGTH
LENGTH(r RAW)
参数
参数 | 说明 |
---|---|
r | LENGTH将计算的RAW值。 |
示例
以下示例使用LENGTH函数返回RAW值的长度:
SELECT UTL_RAW.LENGTH(UTL_RAW.CAST_TO_RAW('Accounts')) FROM DUAL;
显示结果如下:length
--------
8
(1 row)
以下示例使用LENGTH函数返回包含多字节字符的RAW值的长度:
SELECT UTL_RAW.LENGTH(UTL_RAW.CAST_TO_RAW('独孤求败'));
显示结果如下: length
--------
12
(1 row)
SUBSTR
SUBSTR函数返回RAW值的子字符串:
SUBSTR (r RAW, pos INTEGER, len INTEGER)
参数
参数 | 说明 |
---|---|
r | 表示将从中返回子字符串的RAW值。 |
pos | 表示返回子字符串的第一个字节的RAW值中的位置。
|
len | 表示将返回的最大字节数。 |
示例
以下示例使用SUBSTR函数从RAW值的第3个字符开始截取子字符串:
SELECT UTL_RAW.SUBSTR(UTL_RAW.CAST_TO_RAW('Accounts'), 3, 5) FROM DUAL;
显示结果如下:
substr
--------
count
(1 row)
以下示例使用SUBSTR函数从RAW值结尾的第5个字符开始截取子字符串:
SELECT UTL_RAW.SUBSTR(UTL_RAW.CAST_TO_RAW('Accounts'), -5 , 3) FROM DUAL;
显示结果如下: substr
--------
oun
(1 row)