/** * 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; }