PEAR Manual
Prev |  | Next

# ->find()

->find() -- find results

## Synopsis

``int $DB_DataObject->find` ([boolean $autoFetch])`

## Description

The find method builds and executes the current Query, based on the object variables and any WhereAdd() conditions , If the AutoFetch is `TRUE`, then it will also call the fetch method automatically.

## Parameter

- `boolean $autoFetch` - fetch first result

## Return value

`int` - number of rows found, only if the database backend supports the numRows() method. Otherwise 1 (or in versions after 1.7.13, true will returned)

## Note

This function can not be called statically.

## Example

Example 33-1. Simple find() of data based on Object Vars
    $person = new DataObjects_Person;
    $person->hair = 'red';
    $person->has_glasses = 1;
    $number_of_rows = $person->find();

Example 33-2. Resulting SQL
    SELECT * FROM person WHERE hair='red' and has_glasses = 1

Prev | Home | Next
{Child Class}::staticGet() | Up | ->fetch()