* * // Basic assignments * $query->addAssignments([ * '"Object"."Title"' => 'Bob', * '"Object"."Description"' => 'Bob was here' * ]) * * // Parameterised assignments * $query->addAssignments([ * '"Object"."Title"' => ['?' => 'Bob'], * '"Object"."Description"' => ['?' => null] * ]) * * // Complex parameters * $query->addAssignments([ * '"Object"."Score"' => ['MAX(?,?)' => [1, 3]] * ]); * * // Assignment of literal SQL for a field. The empty array is * // important to denote the zero-number paramater list * $query->addAssignments([ * '"Object"."Score"' => ['NOW()' => []] * ]); * * * * @param array $assignments The list of fields to assign * @return $this Self reference */ public function addAssignments(array $assignments); /** * Sets the list of assignments to the given list * * For multi-row objects this applies this to the current row. * * @see SQLWriteExpression::addAssignments() for syntax examples * * @param array $assignments * @return $this Self reference */ public function setAssignments(array $assignments); /** * Retrieves the list of assignments in parameterised format * * For multi-row objects returns assignments for the current row. * * @return array List of assigments. The key of this array will be the * column to assign, and the value a parameterised array in the format * ['SQL' => [parameters]]; */ public function getAssignments(); /** * Set the value for a single field * * For multi-row objects this applies this to the current row. * * E.g. *


     *
     * // Literal assignment
     * $query->assign('"Object"."Description"', 'lorum ipsum'));
     *
     * // Single parameter
     * $query->assign('"Object"."Title"', ['?' => 'Bob']);
     *
     * // Complex parameters
     * $query->assign('"Object"."Score"', ['MAX(?,?)' => [1, 3]]);
     *

* * @param string $field The field name to update * @param mixed $value The value to assign to this field. This could be an * array containing a parameterised SQL query of any number of parameters, * or a single literal value. * @return $this Self reference */ public function assign($field, $value); /** * Assigns a value to a field using the literal SQL expression, rather than * a value to be escaped * * For multi-row objects this applies this to the current row. * * @param string $field The field name to update * @param string $sql The SQL to use for this update. E.g. "NOW()" * @return $this Self reference */ public function assignSQL($field, $sql); }