/**
* Adds an object to the instance pool.
*
* Propel keeps cached copies of objects in an instance pool when they are retrieved
* from the database. In some cases -- especially when you override doSelect*()
* methods in your stub classes -- you may need to explicitly add objects
* to the cache in order to ensure that the same objects are always returned by doSelect*()
* and retrieveByPK*() calls.
*
* @param CustomListElement $obj A CustomListElement object.
* @param string $key (optional) key to use for instance map (for performance boost if key was already calculated externally).
*/
public static function addInstanceToPool($obj, $key = null)
{
if (Propel::isInstancePoolingEnabled()) {
if ($key === null) {
$key = (string) $obj->getIdElement();
}
// if key === null
CustomListElementPeer::$instances[$key] = $obj;
}
}
/**
* Filter the query by a related CustomListElement object
*
* @param CustomListElement|PropelObjectCollection $customListElement the related object to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return CustomListsQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByCustomListElement($customListElement, $comparison = null)
{
if ($customListElement instanceof CustomListElement) {
return $this->addUsingAlias(CustomListsPeer::ID_CUSTOM_LIST, $customListElement->getCustomList(), $comparison);
} elseif ($customListElement instanceof PropelObjectCollection) {
return $this->useCustomListElementQuery()->filterByPrimaryKeys($customListElement->getPrimaryKeys())->endUse();
} else {
throw new PropelException('filterByCustomListElement() only accepts arguments of type CustomListElement or PropelCollection');
}
}
/**
* @param CustomListElement $customListElement The customListElement object to add.
*/
protected function doAddCustomListElement($customListElement)
{
$this->collCustomListElements[] = $customListElement;
$customListElement->setCustomLists($this);
}
/**
* Exclude object from result
*
* @param CustomListElement $customListElement Object to remove from the list of results
*
* @return CustomListElementQuery The current query, for fluid interface
*/
public function prune($customListElement = null)
{
if ($customListElement) {
$this->addUsingAlias(CustomListElementPeer::ID_ELEMENT, $customListElement->getIdElement(), Criteria::NOT_EQUAL);
}
return $this;
}
