Curry
PHP Framework

core

db

html

utility

SqlInsert::values

public SqlInsert values ( array または string $fields, mixed $value = null )
INSERT文で値を設定するするフィールドと値を指定します。
指定方法は2つあります。
一つはレコードの各フィールドの値を、フィールド名と値の組み合わせの連想配列で指定する方法。この場合、複数フィールドを一度に指定できます。
もう一つは第一引数にフィールド名、第二引数に値を指定する方法です。この場合、一度に一つのフィールドしか指定できませんが、複数回、メソッドを実行することで複数指定は可能です。

値にnullを設定したフィールドにはテーブルのフィールドに対してもnullをセットします。
連想配列のキーには、INSERT対象のテーブルに存在しない列を含めないように注意してください。この場合、SQLエラーとなり、PDOExceptionが発生します。

パラメーター

名前 型 内容
$fields array または string フィールド名をキーとした、フィールド名と値の組み合わせの連想配列。
または、フィールド名を文字列で指定。後者の場合、第二引数で値の指定が必要です。
$value mixed 第一引数に対して文字列でフィールド名を指定した場合にそのフィールドに設定する値を指定します。
第一引数が配列の場合に第二引数を指定すると例外が発生します。
逆に第一引数が文字列の場合に第二引数を省略すると例外が発生します。

返り値

自分自身のインスタンスを返します。