/**
* Dispenses a new bean (a RedBean_OODBBean Bean Object)
* of the specified type. Always
* use this function to get an empty bean object. Never
* instantiate a RedBean_OODBBean yourself because it needs
* to be configured before you can use it with RedBean. This
* function applies the appropriate initialization /
* configuration for you.
*
* @param string $type type of bean you want to dispense
* @param string $number number of beans you would like to get
*
* @return RedBean_OODBBean
*/
public function dispense($type, $number = 1)
{
$beans = array();
for ($i = 0; $i < $number; $i++) {
$bean = new RedBean_OODBBean();
$bean->initializeForDispense($type, $this->beanhelper);
if (!$this->isFrozen) {
$this->check($bean);
}
$this->signal('dispense', $bean);
$beans[] = $bean;
}
return count($beans) === 1 ? array_pop($beans) : $beans;
}