他のバージョンの文書 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

9.5. バイナリ文字列関数と演算子

本節ではbytea型の値を調べたり操作するための関数と演算子について説明します。

SQLでは、引数の区切りにカンマではなくキーワードを使う文字列関数を、いくつか定義しています。 詳細は表9.11「SQLバイナリ文字列関数と演算子」を参照してください。 またPostgreSQLは、これらの関数に対して通常の関数呼び出し構文を使用するバージョンを提供します(表9.9「その他の文字列関数」を参照してください)。

注記

このページで示されるサンプル結果は、サーバパラメータであるbytea_outputescapeに設定されていることを想定しています(この設定はPostgreSQLの伝統的な形式です)。

表9.11 SQLバイナリ文字列関数と演算子

関数戻り値型説明結果
string || string bytea 文字列結合 E'\\\\Post'::bytea || E'\\047gres\\000'::bytea\\Post'gres\000
octet_length(string) intバイナリ文字列中のバイト数octet_length(E'jo\\000se'::bytea)5
overlay(string placing string from int [for int]) bytea 部分文字列の置換 overlay(E'Th\\000omas'::bytea placing E'\\002\\003'::bytea from 2 for 3)T\\002\\003mas
position(substring in string) int指定した部分文字列の位置position(E'\\000om'::bytea in E'Th\\000omas'::bytea)3
substring(string [from int] [for int]) bytea 部分文字列の抽出 substring(E'Th\\000omas'::bytea from 2 for 3)h\000o
trim([both] bytes from string) bytea文字列stringの先頭および末尾からbytesに含まれるバイトのみを含む最長の文字列を削除します。 trim(E'\\000\\001'::bytea from E'\\000Tom\\001'::bytea)Tom

この他、表9.12「その他のバイナリ文字列関数」に列挙するバイナリ列操作関数が使えます。 そのいくつかは、表9.11「SQLバイナリ文字列関数と演算子」で説明した標準SQLの文字列関数を実装するために内部的に使用されています。

表9.12 その他のバイナリ文字列関数

関数戻り値型説明結果
btrim(string bytea, bytes bytea) byteabytesに含まれるバイトのみを有する最長の文字列をstringの先頭と末尾から削除します。 btrim(E'\\000trim\\001'::bytea, E'\\000\\001'::bytea)trim
decode(string text, format text) byteastringで表現されているテキストデータをバイナリデータに復号します。 formatのオプションはencodeと同じです。 decode(E'123\\000456', 'escape')123\000456
encode(data bytea, format text) textバイナリデータをテキスト表現形式に符号化します。 サポートされている形式は、base64hexescapeです。 escapeは0のバイトと最上位ビットがセットされているバイトを8進数のシーケンス(\nnn)に変換し 、バックスラッシュを二重化します。 encode(E'123\\000456'::bytea, 'escape')123\000456
get_bit(string, offset) int 文字列から1ビット抽出します。 get_bit(E'Th\\000omas'::bytea, 45)1
get_byte(string, offset) int 文字列から1バイト抽出します。 get_byte(E'Th\\000omas'::bytea, 4)109
length(string) int バイナリ文字列の長さ length(E'jo\\000se'::bytea)5
md5(string) text stringのMD5のハッシュを計算し、結果を16進数で返します。 md5(E'Th\\000omas'::bytea)8ab2d3c9689aaf18 b4958c334c82d8b1
set_bit(string, offset, newvalue) bytea 文字列内のビットを設定します。 set_bit(E'Th\\000omas'::bytea, 45, 0)Th\000omAs
set_byte(string, offset, newvalue) bytea 文字列内の1バイトを設定します。 set_byte(E'Th\\000omas'::bytea, 4, 64)Th\000o@as

get_byteset_byteはバイナリ列の先頭バイトを0バイトとして数えます。 get_bitset_bitは各バイト内を右からビットを数えます。例えばビット0は先頭バイトの最下位ビットとなり、ビット15は第二バイトの最上位ビットとなります。

9.20. 集約関数におけるstring_agg集約関数や33.4. サーバ側の関数のラージオブジェクト関数も参照してください。