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_charsetr将转换后的编码的名称。
from_charsetr将执行转换的源编码的名称。

示例

以下示例使用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函数返回RAW值的长度:
LENGTH(r RAW)

参数

参数说明
rLENGTH将计算的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值中的位置。
  • 如果pos为0或1,则子字符串从RAW值的第一个字节开始截取子字符串。
  • 如果pos大于1,则子字符串从pos指定的第一个字节开始截取子字符串。例如,如果pos为3,则子字符串从值的第三个字节开始截取子字符串。
  • 如果pos为负数,则子字符串从源值末尾算起的pos字节开始截取子字符串。例如,如果pos为-3,则子字符串从值末尾算起的第三个字节开始截取子字符串。
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)