CONVERT Function

This function converts RAW r from character set from_charset to character set to_charset and returns the resulting RAW.

Both from_charset and to_charset must be supported character sets defined to the Oracle server.

Syntax

UTL_RAW.CONVERT (
   r            IN RAW,
   to_charset   IN VARCHAR2,
   from_charset IN VARCHAR2) 
  RETURN RAW;

Pragmas

pragma restrict_references(convert, WNDS, RNDS, WNPS, RNPS);  

Parameters

Table 80-33 CONVERT Function Parameters

Parameter	Description
r	RAW byte-string to be converted.
to_charset	Name of NLS character set to which r is converted.
from_charset	Name of NLS character set in which r is supplied.

Returns

Table 80-34 CONVERT Function Returns

Return	Description
RAW	Byte string r converted according to the specified character sets.

Errors

Table 80-35 CONVERT Function Errors

Error	Description
VALUE_ERROR	Either: - r missing, NULL, and/or 0 length - from_charset or to_charset missing, NULL, and/or 0 length - from_charset or to_charset names invalid or unsupported