Oracle / PLSQL: TO_MULTI_BYTE Function

This Oracle tutorial explains how to use the Oracle/PLSQL TO_MULTI_BYTE function with syntax and examples.

Description

The Oracle/PLSQL TO_MULTI_BYTE function returns a character value with all of the single-byte characters converted to multibyte characters. To use this function, your database character set contains both single-byte and multibyte characters.

Syntax

The syntax for the TO_MULTI_BYTE function in Oracle/PLSQL is:

TO_MULTI_BYTE( char )

Parameters or Arguments

char

A char, varchar2, nchar, or nvarchar2 value converted to multibyte characters. This function will return its result in the same character set as char.

Returns

The TO_MULTI_BYTE function returns a multibyte character value that will be in the same character set as the char parameter.

Applies To

The TO_MULTI_BYTE function can be used in the following versions of Oracle/PLSQL:

• Oracle 12c, Oracle 11g, Oracle 10g, Oracle 9i, Oracle 8i

Example

Let's look at some Oracle TO_MULTI_BYTE function examples and explore how to use the TO_MULTI_BYTE function in Oracle/PLSQL.

For example:

select TO_MULTI_BYTE('aodb is the nic')
from dual;

The SQL statement above would return a multibyte character value.