(4.1.0 - 4.2.3 only)
この関数は、 実験的 なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用して下さい。
この関数は、関係にタプルを追加します。 tuple データは、属性/値の組の配列であり、 指定した relation に挿入されます。実行に成功 する、 tuple 配列には新規に生成されたタプル の完全なデータが含まれ、そこにはシーケンスのような暗黙の内に設定 される全てのドメインが含まれます。
この関数は成功時に(すなわちDBPLUS_ERR_NOERR)ゼロ、失敗時にdb++エ ラーコードを返します。db++エラーコードに関するより詳細な情報につ いては、 dbplus_errcode() または本章の導入部を参 照下さい。