Postgres Pro Standard : Документация: 9.5: 9.5. Функции и операторы двоичных строк : Компания Postgres Professional

9.5. Функции и операторы двоичных строк
Пред.	Наверх	Глава 9. Функции и операторы	Начало	След.

9.5. Функции и операторы двоичных строк

В этом разделе описываются функции и операторы для работы с данными типа bytea.

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

Примечание

В примерах, приведённых на этой странице, подразумевается, что параметр сервера bytea_output равен escape (выбран традиционный формат Postgres Pro).

Таблица 9.9. SQL-функции и операторы для работы с двоичными строками

Функция	Тип результата	Описание	Пример	Результат
`string \|\| string`	`bytea`	Конкатенация строк	`'\\Post'::bytea \|\| '\047gres\000'::bytea`	`\\Post'gres\000`
`octet_length(string)`	`int`	Число байт в двоичной строке	`octet_length('jo\000se'::bytea)`	`5`
`overlay(string placing string from int [for int])`	`bytea`	Заменяет подстроку	`overlay('Th\000omas'::bytea placing '\002\003'::bytea from 2 for 3)`	`T\\002\\003mas`
`position(substring in string)`	`int`	Положение указанной подстроки	`position('\000om'::bytea in 'Th\000omas'::bytea)`	`3`
`substring(string [from int] [for int])`	`bytea`	Извлекает подстроку	`substring('Th\000omas'::bytea from 2 for 3)`	`h\000o`
`trim([both] bytes from string)`	`bytea`	Удаляет наибольшую строку, содержащую только байты, заданные в параметре `bytes`, с начала и с конца строки `string`	`trim('\000\001'::bytea from '\000Tom\001'::bytea)`	`Tom`

В PostgreSQL есть и другие функции для работы с двоичными строками, перечисленные в Таблице 9.10. Некоторые из них используются в качестве внутренней реализации стандартных функций SQL, приведённых в Таблице 9.9.

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

Функция	Тип результата	Описание	Пример	Результат
`btrim(string bytea, bytes bytea)`	`bytea`	Удаляет наибольшую строку, содержащую только байты, заданные в параметре `bytes`, с начала и с конца строки `string`	`btrim('\000trim\001'::bytea, '\000\001'::bytea)`	`trim`
`decode(string text, format text)`	`bytea`	Получает двоичные данные из текстового представления в `string`. Значения параметра `format` те же, что и для функции `encode`.	`decode('123\000456', 'escape')`	`123\000456`
`encode(data bytea, format text)`	`text`	Переводит двоичные данные в текстовое представление в одном из форматов: `base64`, `hex`, `escape`. Формат `escape` преобразует нулевые байты и байты с 1 в старшем бите в восьмеричные последовательности `\nnn` и дублирует обратную косую черту.	`encode('123\000456'::bytea, 'escape')`	`123\000456`
`get_bit(string, offset)`	`int`	Извлекает бит из строки	`get_bit('Th\000omas'::bytea, 45)`	`1`
`get_byte(string, offset)`	`int`	Извлекает байт из строки	`get_byte('Th\000omas'::bytea, 4)`	`109`
`length(string)`	`int`	Длина двоичной строки	`length('jo\000se'::bytea)`	`5`
`md5(string)`	`text`	Вычисляет MD5-хеш строки `string` и возвращает результат в 16-ричном виде	`md5('Th\000omas'::bytea)`	`8ab2d3c9689aaf18 b4958c334c82d8b1`
`set_bit(string, offset, newvalue)`	`bytea`	Устанавливает значение бита в строке	`set_bit('Th\000omas'::bytea, 45, 0)`	`Th\000omAs`
`set_byte(string, offset, newvalue)`	`bytea`	Устанавливает значение байта в строке	`set_byte('Th\000omas'::bytea, 4, 64)`	`Th\000o@as`

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

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

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

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.

Вход в личный кабинет

Восстановление пароля

Подтверждение аккаунта

Изменение пароля

9.5. Функции и операторы двоичных строк

Примечание

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.