 <chapter id="xtypes">
  <!--<title>Extending <acronym>SQL</acronym>: Types</title>-->
  <title><acronym>SQL</acronym>の拡張――データ型</title>
<indexterm><primary>SQL</primary><secondary sortas="かくちょう">拡張</secondary><tertiary sortas="でーたがた">データ型</tertiary></indexterm><indexterm><primary sortas="でーたがた">データ型</primary><secondary sortas="かくちょう">拡張</secondary></indexterm>
  <para>
   <!--As previously mentioned, there are two kinds  of  types
   in  <productname>Postgres</productname>: base types (defined in a programming language) 
   and composite types.
   Examples in this section up to interfacing indices  can
   be  found in <filename>complex.sql</filename> and <filename>complex.c</filename>.  Composite examples 
   are in <filename>funcs.sql</filename>.-->

   先に述べられているように、<productname>Postgres</productname>には基本データ型（プログラミング言語で定義されています）と複合データ型という2種類のデータ型があります。この章から<xref linkend="xindex">までで使用している例は、<filename>complex.sql</filename>と<filename>complex.c</filename>にあります。複合データ型の例は<filename>funcs.sql</filename>にあります。
  </para>

  <sect1 id="xtypes-userdefined">
   <!--<title>User-Defined Types</title>-->
   <title>ユーザー定義データ型</title>
<indexterm><primary sortas="でーたがた">データ型</primary><secondary sortas="ゆーざーていぎ">ユーザー定義</secondary></indexterm><indexterm><primary sortas="ゆーざーていぎでーたがた">ユーザー定義でーた型</primary></indexterm>
   <sect2>
    <!--<title>Functions Needed for a User-Defined Type</title>-->
    <title>ユーザー定義データ型に必要な関数</title>

    <para>
     <!--A  user-defined  type must always have input and output
     functions.  These  functions  determine  how  the  type
     appears in strings (for input by the user and output to
     the user) and how the type is organized in memory.  The
     input  function takes a null-delimited character string
     as its input and returns the internal (in memory)  
     representation of the type.  The output function takes the
     internal representation of the type and returns a null
     delimited character string.
     Suppose  we  want to define a complex type which represents 
     complex numbers. Naturally, we choose  to  represent a 
     complex in memory as the following <acronym>C</acronym> structure:-->

     ユーザー定義データ型では、必ず入力関数と出力関数が必要です。これらの関数は、型がユーザーによる入力とユーザーへの出力のための文字列中にどのような形式で表示されるかと、その型がメモリ中でどう構成されるかを決定します。入力関数はその入力としてNULL終端文字列を取り、その型の（メモリ中の）内部表現を返します。出力関数はその型の内部表現を取り、NULL終端文字列を返します。たとえば、複素数を表現する複素数型を定義したい場合の例を見てみましょう。
</para>

<programlisting>
typedef struct Complex {
    double      x;
    double      y;
} Complex;
</programlisting>

<para>
     <!--and  a  string of the form (x,y) as the external string
     representation.
     These functions are usually not hard  to  write,  especially  
     the output function.  However, there are a number of points 
     to remember:-->

     このように、<acronym>C</acronym>構造体のように、メモリ中の複素数表現と、外部文字列表現として(x,y)という形式の文字列を使用する場合が自然でしょう。これらの関数、特に出力関数を記述するのは困難ではありません。しかし、いくつかの注意点があります。
</para>

     <itemizedlist>
      <listitem>
        <para>  
        <!--When defining your external (string) representation,  
	remember that you must eventually write a
	complete and robust parser for that  representation 
	as your input function!-->

        外部（文字列）表現を定義するときには、その表現のための完全で堅牢なパーサーを入力関数として書かなければいけません。
</para>

<programlisting>
Complex *
complex_in(char *str)
{
    double x, y;
    Complex *result;
    if (sscanf(str, " ( %lf , %lf )", &amp;x, &amp;y) != 2) {
        elog(ERROR, "complex_in: error in parsing %s", str);
        return NULL;
    }
    result = (Complex *)palloc(sizeof(Complex));
    result-&gt;x = x;
    result-&gt;y = y;
    return (result);
}
</programlisting>

<para>
	<!--The output function can simply be:-->
        出力関数は単に以下のようになるでしょう。
</para>

<programlisting>
char *
complex_out(Complex *complex)
{
    char *result;
    if (complex == NULL)
        return(NULL);
    result = (char *) palloc(60);
    sprintf(result, "(%g,%g)", complex-&gt;x, complex-&gt;y);
    return(result);
}
</programlisting>

      </listitem>
      <listitem>
       <para>
	<!--You  should  try  to  make  the input and output
	functions inverses of each  other.   If  you  do
	not, you will have severe problems when you need
	to dump your data into a file and then  read  it
	back  in  (say,  into someone else's database on
	another computer).  This is a particularly  common  
	problem  when  floating-point  numbers  are
	involved.-->

        入出力関数は、各々の逆関数になるようにするべきです。そうしないと、データをファイルにダンプし、たとえばそれを他のコンピュータ上にある別の誰かのデータベースなどに戻そうとする際に、深刻な問題が発生するでしょう。これは、浮動小数が関係する際によく発生する問題です。
       </para>
      </listitem>
     </itemizedlist>
    <para>
     <!--To define the <acronym>complex</acronym> type, we need to create  the  two
     user-defined   functions   complex_in  and  complex_out
     before creating the type:-->

     <acronym>複素数（complex）</acronym>型を定義するとき、その型を生成する前に2つのユーザー定義関数complex_inとcomplex_outを生成する必要があります。<indexterm><primary sortas="でーたがた">データ型</primary><secondary sortas="ふくそすう">複素数</secondary></indexterm><indexterm><primary sortas="ふくそすう">複素数</primary></indexterm>
</para>

<programlisting>
CREATE FUNCTION complex_in(opaque)
    RETURNS complex
    AS 'PGROOT/tutorial/obj/complex.so'
    LANGUAGE 'c';

CREATE FUNCTION complex_out(opaque)
    RETURNS opaque
    AS 'PGROOT/tutorial/obj/complex.so'
    LANGUAGE 'c';

CREATE TYPE complex (
    internallength = 16,
    input = complex_in,
    output = complex_out
);
</programlisting>

    <para>
     <!--As discussed earlier, <productname>Postgres</productname> fully supports arrays of
     base  types.  Additionally, <productname>Postgres</productname> supports arrays of
     user-defined types as well.  When you  define  a  type,
     <productname>Postgres</productname>  automatically  provides support for arrays of
     that type.  For historical reasons, the array type  has
     the  same name as the user-defined type with the 
     underscore character _ prepended.
     Composite types do not need  any  function  defined  on
     them,  since  the  system already understands what they
     look like inside.-->

     前に述べたように、<productname>Postgres</productname>は基本型の配列をフルにサポートしています。これに加え、<productname>Postgres</productname>ではユーザー定義型の配列もサポートしています。型を定義すると、<productname>Postgres</productname>は自動的にその型の配列のサポートを提供します。歴史的な理由により、配列型はユーザー型の名前の前にアンダースコア（「_」）が付いた名前になります。複合型の場合は、すでにシステムはそれらが内部的にどのようになっているかを把握しているので、関数を定義する必要はありません。<indexterm><primary sortas="はいれつ">配列</primary></indexterm><indexterm><primary sortas="でーたがた">データ型</primary><secondary sortas="はいれつ">配列</secondary></indexterm>
    </para>
   </sect2>

   <sect2>
    <!--<title>Large Objects</title>-->
    <title>ラージオブジェクト</title>
<indexterm><primary sortas="でーたがた">データ型</primary><secondary sortas="らーじおぶじぇくと">ラージオブジェクト</secondary></indexterm><indexterm><primary sortas="らーじおぶじぇくと">ラージオブジェクト</primary></indexterm><indexterm><primary sortas="らーじおぶじぇくと">ラージオブジェクト</primary><secondary sortas="かくちょう">拡張</secondary></indexterm>
    <para>
     <!--If the values of your datatype might exceed a few hundred bytes in
     size (in internal form), you should be careful to mark them TOASTable.
     To do this, the internal representation must follow the standard
     layout for variable-length data: the first four bytes must be an int32
     containing the total length in bytes of the datum (including itself).
     Then, all your functions that accept values of the type must be careful
     to call pg_detoast_datum() on the supplied values - after checking
     that the value is not NULL, if your function is not strict.  Finally,
     select the appropriate storage option when giving the CREATE TYPE
     command.-->

     ユーザー定義データ型の内部形式の大きさが数百バイトを越えるのであれば、TOAST化を可能とするには注意が必要です。TOAST化のためには、内部表現が可変長データの標準レイアウトに従っていなければいけません。先頭の4バイトはint32型で、それ自身を含めたデータの合計バイト数を入れます。また、その型の値を受け付ける関数はすべて、与えられた値についてpg_detoast_datum()を呼び出すのに注意が必要です。その関数が厳密でない場合は、値がNULLでないことをあらかじめ検査しなければいけません。最後に、CREATE TYPEコマンドを実行する際に、適当な保存オプションを選択してください。

    </para>
   </sect2>
  </sect1>
 </chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode:sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"./reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->
