他のバージョンの文書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

44.11. pg_cast

pg_castカタログには、データ型変換パスが格納されます。 ここには、組み込みのパスとCREATE CASTで定義されたパスが存在します。

pg_castは、システムがどのように動作するか分かっているような、あらゆる型変換を表しているわけではないということに注意してください。 いくつかの一般的なルールから推測ができないような型変換についてのみ表しています。 例えば、ドメインとその基本の型は明示的にpg_cast内で表されていません。 ほかの重要な例外は"I/O変換キャスト"です。これらのキャストは、text型やほかの文字列型から変換したりされたりするのにデータ型自身のI/O関数を用いていますが、これらのキャストは明示的にpg_cast内において表されていません。

表 44-11. pg_castの列

名前参照先説明
castsourceoidpg_type.oidソースデータ型のOID
casttargetoidpg_type.oid対象データ型のOID
castfuncoidpg_proc.oid このキャストを実行するために使用する関数のOID。データ型をバイナリに強制変換できる場合はゼロが格納されます(つまり、キャストを実行するためにランタイム操作は必要ありません)。
castcontextchar  キャストがどの構文で起動されるかを示します。eは、明示のキャストとしてのみ起動されることを意味します(CAST::構文を使用します)。aは、対象となる列を明示的に特定するだけでなく暗黙的にも特定することを意味します。iは他の場合と同様に演算式内で暗黙的であることを意味します。

pg_cast内に挙げられているキャスト関数は、第1番目の引数の型として、キャスト元の型をいつも取らなければいけません。また、キャスト関数は、結果の型としてキャスト先の型を返します。キャスト関数は3つまで引数を持つことができます。もし存在するなら、2番目の引数はinteger型でなくてはなりません。この引数は、キャスト先の型に関連付けられた型修飾子を受け取ります。2番目の引数がない場合は、-1です。3番目の引数は、もし存在する場合は、boolean型でなくてはなりません。この引数は、もしキャストが明示的なキャストであればtrueを受け取り、そうでない場合はfalseを受け取ります。

もし関連のある関数が1つ以上の引数を持つ場合は、キャストの型が元と先で同じであるpg_castエントリを作成することが妥当です。このようなエントリは、"length coercion functions"を表現します。"length coercion functions"は型の値を特定の型の修飾子の値に適するように修正します。

pg_castエントリが異なるキャスト元とキャスト先の型を持っていて、かつ関数が1つ以上の引数を持つ時は、1つの型から別の型への変換を意味していて、1つの手順で長さの修正を適用します。このようなエントリが利用できない時は、型修飾子を使用した型の修正は2つの手順が必要です。1つはデータ型の間での変換で、2つ目は修飾子を適用することです。