9.5. Функции и операторы для работы с бинарными строками

9.5. Функции и операторы для работы с бинарными строками
Назад	Наверх	Глава 9. Функции и операторы	Начало	Далее

---

9.5. Функции и операторы для работы с бинарными строками #

Этот раздел описывает функции и операторы для изучения и манипулирования двоичными строками, то есть значениями типа bytea. Многие из них эквивалентны по назначению и синтаксису функциям работы со строками, описанным в предыдущем разделе.

SQL определяет некоторые строковые функции, которые используют ключевые слова, а не запятые, для разделения аргументов. Подробности приведены в разделе Таблица 9.11. Tantor BE также предоставляет версии этих функций, которые используют обычный синтаксис вызова функций (см. раздел Таблица 9.12).

Таблица 9.11. SQL Функции и операторы для работы с бинарными строками

Функция/Оператор Описание Пример(ы)
bytea || bytea → bytea Сцепляет две двоичные строки. '\x123456'::bytea || '\x789a00bcde'::bytea → \x123456789a00bcde
bit_length ( bytea ) → integer Возвращает количество битов в двоичной строке (8 раз функция octet_length). bit_length('\x123456'::bytea) → 24
btrim ( байты bytea, удаленныебайты bytea ) → bytea Удаляет самую длинную строку, содержащую только байты, указанные в bytesremoved, из начала и конца bytes. btrim('\x1234567890'::bytea, '\x9012'::bytea) → \x345678
ltrim ( bytes bytea, bytesremoved bytea ) → bytea Удаляет самую длинную строку, содержащую только байты, указанные в bytesremoved, из начала bytes. ltrim('\x1234567890'::bytea, '\x9012'::bytea) → \x34567890
octet_length ( bytea ) → integer Возвращает количество байтов в двоичной строке. octet_length('\x123456'::bytea) → 3
overlay ( bytes bytea PLACING newsubstring bytea FROM start integer [ FOR count integer ] ) → bytea Заменяет подстроку bytes, начиная с start-го байта и распространяющуюся на count байт, на newsubstring. Если count не указан, по умолчанию используется длина newsubstring. overlay('\x1234567890'::bytea placing '\002\003'::bytea from 2 for 3) → \x12020390
position ( substring bytea IN bytes bytea ) → integer Возвращает первый индекс начала указанной подстроки substring внутри bytes, или ноль, если она отсутствует. position('\x5678'::bytea in '\x1234567890'::bytea) → 3
rtrim ( bytes bytea, bytesremoved bytea ) → bytea Удаляет самую длинную строку, содержащую только байты, указанные в bytesremoved, из конца bytes. rtrim('\x1234567890'::bytea, '\x9012'::bytea) → \x12345678
substring ( bytes bytea [ FROM start integer ] [ FOR count integer ] ) → bytea Извлекает подстроку из bytes, начиная с start-го байта, если он указан, и заканчивая после count байтов, если он указан. Укажите хотя бы один из параметров start и count. substring('\x1234567890'::bytea from 3 for 2) → \x5678
trim ( [ LEADING | TRAILING | BOTH ] bytesremoved bytea FROM bytes bytea ) → bytea Удаляет самую длинную строку, содержащую только байты, указанные в bytesremoved, с начала, конца или обоих концов (BOTH по умолчанию) bytes. trim('\x9012'::bytea from '\x1234567890'::bytea) → \x345678
trim ( [ LEADING | TRAILING | BOTH ] [ FROM ] bytes bytea, bytesremoved bytea ) → bytea Это нестандартный синтаксис для функции trim(). trim(both from '\x1234567890'::bytea, '\x9012'::bytea) → \x345678

Дополнительные функции для манипуляции с бинарными строками доступны и перечислены в Таблица 9.12. Некоторые из них используются внутренне для реализации стандартных строковых функций SQL, перечисленных в Таблица 9.11.

Таблица 9.12. Другие функции для работы с двоичными строками

Функция Описание Пример(ы)
bit_count ( bytes bytea ) → bigint Возвращает количество установленных битов в двоичной строке (также известное как “popcount”). bit_count('\x1234567890'::bytea) → 15
get_bit ( bytes bytea, n bigint ) → integer Извлекает n-й бит из двоичной строки. get_bit('\x1234567890'::bytea, 30) → 1
get_byte ( bytes bytea, n integer ) → integer Извлекает n-й байт из двоичной строки. get_byte('\x1234567890'::bytea, 4) → 144
length ( bytea ) → integer Возвращает количество байтов в двоичной строке. length('\x1234567890'::bytea) → 5
length ( байты bytea, encoding name ) → integer Возвращает количество символов в двоичной строке, предполагая, что это текст в заданной кодировке encoding. length('jose'::bytea, 'UTF8') → 4
md5 ( bytea ) → text Вычисляет MD5-hash двоичной строки, результат записывается в шестнадцатеричном формате. md5('Th\000omas'::bytea) → 8ab2d3c9689aaf18​b4958c334c82d8b1
set_bit ( bytes bytea, n bigint, newvalue integer ) → bytea Устанавливает n-й бит в двоичной строке в значение newvalue. set_bit('\x1234567890'::bytea, 30, 0) → \x1234563890
set_byte ( bytes bytea, n integer, newvalue integer ) → bytea Устанавливает n-й байт в двоичной строке в значение newvalue. set_byte('\x1234567890'::bytea, 4, 64) → \x1234567840
sha224 ( bytea ) → bytea Вычисляет SHA-224 хеш двоичной строки. sha224('abc'::bytea) → \x23097d223405d8228642a477bda2​55b32aadbce4bda0b3f7e36c9da7
sha256 ( bytea ) → bytea Вычисляет SHA-256 хеш hash бинарной строки. sha256('abc'::bytea) → \xba7816bf8f01cfea414140de5dae2223​b00361a396177a9cb410ff61f20015ad
sha384 ( bytea ) → bytea Вычисляет SHA-384 хеш двоичной строки. sha384('abc'::bytea) → \xcb00753f45a35e8bb5a03d699ac65007​272c32ab0eded1631a8b605a43ff5bed​8086072ba1e7cc2358baeca134c825a7
sha512 ( bytea ) → bytea Вычисляет SHA-512 хеш hash двоичной строки. sha512('abc'::bytea) → \xddaf35a193617abacc417349ae204131​12e6fa4e89a97ea20a9eeee64b55d39a​2192992a274fc1a836ba3c23a3feebbd​454d4423643ce80e2a9ac94fa54ca49f
substr ( bytes bytea, start integer [, count integer ] ) → bytea Извлекает подстроку из bytes, начиная с start-го байта и продолжающуюся count байтов, если это указано. (То же самое, что и substring(байты from start for count)). substr('\x1234567890'::bytea, 3, 2) → \x5678

Функции get_byte и set_byte нумеруют первый байт двоичной строки как байт 0. Функции get_bit и set_bit нумеруют биты справа в каждом байте; например, бит 0 является наименее значимым битом первого байта, а бит 15 - наиболее значимым битом второго байта.

Для исторических причин функция md5 возвращает шестнадцатеричное значение типа text, в то время как функции SHA-2 возвращают тип bytea. Используйте функции encode и decode для преобразования между ними. Например, напишите encode(sha256('abc'), 'hex'), чтобы получить шестнадцатеричное текстовое представление, или decode(md5('abc'), 'hex'), чтобы получить значение типа bytea.

Функции для преобразования строк между различными наборами символов (кодировками) и для представления произвольных двоичных данных в текстовой форме показаны в Таблица 9.13. Для этих функций аргумент или результат типа text выражается в кодировке по умолчанию базы данных, в то время как аргументы или результаты типа bytea находятся в кодировке, указанной другим аргументом.

Таблица 9.13. Функции преобразования текста/бинарной строки

Функция Описание Пример(ы)
convert ( bytes bytea, src_encoding name, dest_encoding name ) → bytea Преобразует двоичную строку, представляющую текст в кодировке src_encoding, в двоичную строку в кодировке dest_encoding (см. Раздел 22.3.4 для доступных преобразований). convert('text_in_utf8', 'UTF8', 'LATIN1') → \x746578745f696e5f75746638
convert_from ( bytes bytea, src_encoding name ) → text Преобразует двоичную строку, представляющую текст в кодировке src_encoding, в text в кодировке базы данных (см. Раздел 22.3.4 для доступных преобразований). convert_from('text_in_utf8', 'UTF8') → text_in_utf8
convert_to ( string text, dest_encoding name ) → bytea Преобразует строку text (в кодировке базы данных) в бинарную строку, закодированную в кодировке dest_encoding (см. Раздел 22.3.4 для доступных преобразований). convert_to('some_text', 'UTF8') → \x736f6d655f74657874
encode ( байты bytea, формат text ) → text Преобразует двоичные данные в текстовое представление; поддерживаемые значения format: base64, escape, hex. encode('123\000\001', 'base64') → MTIzAAE=
decode ( string text, формат text ) → bytea Декодирует двоичные данные из текстового представления; поддерживаемые значения формата такие же, как и для encode. decode('MTIzAAE=', 'base64') → \x3132330001

Функции encode и decode поддерживают следующие текстовые форматы:

base64 #

Формат base64 соответствует RFC 2045 Раздел 6.8. Согласно RFC, закодированные строки разбиваются на 76 символов. Однако вместо маркера конца строки MIME CRLF используется только символ новой строки. Функция decode игнорирует символы возврата каретки, новой строки, пробела и табуляции. В противном случае возникает ошибка, когда decode получает недопустимые данные base64 — включая случаи, когда завершающая подкладка некорректна.

escape #

Формат escape преобразует нулевые байты и байты с установленным старшим битом в восьмеричные последовательности экранирования (\nnn), и удваивает обратные косые черты. Другие значения байтов представлены буквально. Функция decode вызовет ошибку, если за обратной косой чертой не следует либо вторая обратная косая черта, либо три восьмеричные цифры; она принимает другие значения байтов без изменений.

hex #

Формат hex представляет каждые 4 бита данных в виде одной шестнадцатеричной цифры, от 0 до f, записывая старший разряд каждого байта первым. Функция encode выводит шестнадцатеричные цифры от a до f в нижнем регистре. Поскольку наименьшая единица данных составляет 8 бит, всегда возвращается четное количество символов при вызове функции encode. Функция decode принимает символы a-f в верхнем или нижнем регистре. Возникает ошибка, когда функции decode передаются недопустимые шестнадцатеричные данные, включая случай с нечетным количеством символов.

См. также агрегатную функцию string_agg в Раздел 9.21 и функции для работы с большими объектами в Раздел 32.4.

---

Назад	Наверх	Далее
9.4. Функции и операторы строк	Начало	9.6. Функции и операторы для битовых строк