PHP Manual
Prev |  | Next

# pg_select

(PHP 4 >= 4.3.0, PHP 5)

pg_select -- Select records

## Description

mixed pg_select ( resource connection, string table_name, array assoc_array [, int options] )

pg_select() selects records specified by `assoc_array` which has `field=>value`. For a successful query, it returns an array containing all records and fields that match the condition specified by `assoc_array`.

If `options` is specified, pg_convert() is applied to `assoc_array` with the specified flags.

Warning
This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

## Parameters

`connection`

  PostgreSQL database connection resource.

`table_name`

  Name of the table from which to select rows.

`assoc_array`

  An array whose keys are field names in the table `table_name`, and whose values are the conditions that a row must meet to be retrieved.

`options`

  Any number of `PGSQL_CONV_FORCE_NULL`, `PGSQL_DML_NO_CONV`, `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.

## Return Values

Returns `TRUE` on success or `FALSE` on failure. Returns string if `PGSQL_DML_STRING` is passed via `options`.

## Examples

Example 1. pg_select() example

`<?php $db = pg_connect('dbname=foo'); // This is safe, since $_POST is converted automatically $rec = pg_select($db, 'post_log', $_POST); if ($rec) { echo "Records selected\n"; var_dump($rec); } else { echo "User must have sent wrong inputs\n"; } ?>`

## See Also

pg_convert()

Prev | Home | Next
pg_result_status | Up | pg_send_execute