PEAR Manual
Prev |  | Next

# DB_common::provides()

DB_common::provides() -- Checks if the DBMS supports a particular feature

## Synopsis

``boolean provides` (string $feature)`

## Description

Checks if a feature is available for the chosen database type.

## Parameter

string `$feature`

  the feature to check

  Table 33-1. Possible values are:

  `$feature` value | Meaning
  --- | ---
  `prepare` | The database does a pre-check of the SQL statment
  `pconnect` | The database supports persistent connections
  `transactions` | The database supports transactions
  `limit` | The database supports LIMITed SELECT statments

## Return value

boolean - `TRUE` if the feature is supported

## Note

This function can not be called statically.

Warning
The provided information are only hints. Check the documentation of your database system for the real supported features. I.e. MySQL supports transactions, but not for every table type.

## Example

Example 33-1. Using provides()
    <?php
    // Once you have a valid DB object named $db...
    if ($db->provides('pconnect')) {
        echo "Persistent connections are allowed.\n";
    }
    ?>

Prev | Home | Next
DB_common::prepare() | Up | DB_common::query()