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.