/**
* Resets all references to other model objects or collections of model objects.
*
* This method is a user-space workaround for PHP's inability to garbage collect
* objects with circular references (even in PHP 5.3). This is currently necessary
* when using Propel in certain daemon or large-volume/high-memory operations.
*
* @param boolean $deep Whether to also clear the references on all referrer objects.
*/
public function clearAllReferences($deep = false)
{
if ($deep && !$this->alreadyInClearAllReferencesDeep) {
$this->alreadyInClearAllReferencesDeep = true;
if ($this->aCustomLists instanceof Persistent) {
$this->aCustomLists->clearAllReferences($deep);
}
$this->alreadyInClearAllReferencesDeep = false;
}
// if ($deep)
$this->aCustomLists = null;
}
/**
* Exclude object from result
*
* @param CustomLists $customLists Object to remove from the list of results
*
* @return CustomListsQuery The current query, for fluid interface
*/
public function prune($customLists = null)
{
if ($customLists) {
$this->addUsingAlias(CustomListsPeer::ID_CUSTOM_LIST, $customLists->getIdCustomList(), Criteria::NOT_EQUAL);
}
return $this;
}
/**
* @param CustomLists $customLists The customLists object to add.
*/
protected function doAddCustomLists(CustomLists $customLists)
{
// set the back reference to this object directly as using provided method either results
// in endless loop or in multiple relations
if (!$customLists->getCyclicalEventss()->contains($this)) {
$cyclicalEventHasList = new CyclicalEventHasList();
$cyclicalEventHasList->setCustomLists($customLists);
$this->addCyclicalEventHasList($cyclicalEventHasList);
$foreignCollection = $customLists->getCyclicalEventss();
$foreignCollection[] = $this;
}
}
/**
* 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 CustomLists $obj A CustomLists 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->getIdCustomList();
}
// if key === null
CustomListsPeer::$instances[$key] = $obj;
}
}
/**
* Filter the query by a related CustomLists object
*
* @param CustomLists|PropelObjectCollection $customLists The related object(s) to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return EventHasListQuery The current query, for fluid interface
* @throws PropelException - if the provided filter is invalid.
*/
public function filterByCustomLists($customLists, $comparison = null)
{
if ($customLists instanceof CustomLists) {
return $this->addUsingAlias(EventHasListPeer::ID_LIST, $customLists->getIdCustomList(), $comparison);
} elseif ($customLists instanceof PropelObjectCollection) {
if (null === $comparison) {
$comparison = Criteria::IN;
}
return $this->addUsingAlias(EventHasListPeer::ID_LIST, $customLists->toKeyValue('PrimaryKey', 'IdCustomList'), $comparison);
} else {
throw new PropelException('filterByCustomLists() only accepts arguments of type CustomLists or PropelCollection');
}
}