pg_insert
Insert array into table
&reftitle.description;
mixedpg_insert
resourceconnection
stringtable_name
arrayassoc_array
intoptionsPGSQL_DML_EXEC
pg_insert inserts the values of assoc_array
into the table specified by table_name.
If options is
specified, pg_convert is applied
to assoc_array with the specified options.
&reftitle.parameters;
connection
PostgreSQL database connection resource.
table_name
Name of the table into which to insert rows. The table table_name must at least
have as many columns as assoc_array has elements.
assoc_array
An array whose keys are field names in the table table_name,
and whose values are the values of those fields that are to be inserted.
options
Any number of PGSQL_CONV_OPTS,
PGSQL_DML_NO_CONV,
PGSQL_DML_ESCAPE,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC or
PGSQL_DML_STRING combined. If PGSQL_DML_STRING is part of the
options then query string is returned. When PGSQL_DML_NO_CONV
or PGSQL_DML_ESCAPE is set, it does not call pg_convert internally.
&reftitle.returnvalues;
Returns the connection resource on success, &return.falseforfailure;. Returns string if PGSQL_DML_STRING is passed
via options.
&reftitle.examples;
<function>pg_insert</function> example
]]>
&reftitle.changelog;
&Version;
&Description;
5.6.0
Unless PGSQL_DML_STRING is passed, the function
now returns the connection resource instead of &true; on success.
5.6.0
No longer experimental. Added PGSQL_DML_ESCAPE constant,
&true;/&false; and &null; data type support.
5.5.3/5.4.19
Direct SQL injection to table_name and Indirect SQL
injection to identifiers are fixed.
&reftitle.seealso;
pg_convert