TO_SINGLE_BYTE

📖 Описание

Функция Oracle/PLSQL TO_SINGLE_BYTE заменяет многобайтовые символы их однобайтовыми эквивалентами, если такие эквиваленты существуют. Символы без соответствующей замены сохраняются.


🧩 Синтаксис

TO_SINGLE_BYTE(char)

⚙️ Параметры и аргументы

char — строка CHAR, VARCHAR2, NCHAR или NVARCHAR2; результат сохраняет тип и кодировку аргумента. Функция полезна в кодировках, содержащих однобайтовые и многобайтовые варианты символов; она не гарантирует, что вся строка станет однобайтовой.


💻 Примеры

Уже однобайтовые символы остаются без изменений:

SELECT TO_SINGLE_BYTE('Workshop 2026') FROM dual;
-- Результат: Workshop 2026

В базе AL32UTF8 полноширинные B7 преобразуются в B7. UNISTR задаёт исходные символы, а CAST переводит строку в кодировку базы:

WITH labels (text_value) AS (
  SELECT CAST(UNISTR('\FF22\FF17') AS VARCHAR2(20)) FROM dual
)
SELECT TO_SINGLE_BYTE(text_value) AS short_label,
       LENGTHB(text_value) AS bytes_before,
       LENGTHB(TO_SINGLE_BYTE(text_value)) AS bytes_after
FROM labels;
SHORT_LABEL BYTES_BEFORE BYTES_AFTER
B7 6 2

Размер в байтах вычисляет LENGTHB; преобразование типа выполняет CAST.

См. документацию Oracle 19: TO_SINGLE_BYTE.

См. документацию Oracle 19: UNISTR.