/**
* 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 PrincipalI18n $obj A PrincipalI18n 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 = serialize(array((string) $obj->getId(), (string) $obj->getLocale()));
}
// if key === null
PrincipalI18nPeer::$instances[$key] = $obj;
}
}
/**
* Exclude object from result
*
* @param PrincipalI18n $principalI18n Object to remove from the list of results
*
* @return PrincipalI18nQuery The current query, for fluid interface
*/
public function prune($principalI18n = null)
{
if ($principalI18n) {
$this->addCond('pruneCond0', $this->getAliasedColName(PrincipalI18nPeer::ID), $principalI18n->getId(), Criteria::NOT_EQUAL);
$this->addCond('pruneCond1', $this->getAliasedColName(PrincipalI18nPeer::LOCALE), $principalI18n->getLocale(), Criteria::NOT_EQUAL);
$this->combine(array('pruneCond0', 'pruneCond1'), Criteria::LOGICAL_OR);
}
return $this;
}
/**
* Method called to associate a PrincipalI18n object to this object
* through the PrincipalI18n foreign key attribute.
*
* @param PrincipalI18n $l PrincipalI18n
* @return Principal The current object (for fluent API support)
*/
public function addPrincipalI18n(PrincipalI18n $l)
{
if ($l && ($locale = $l->getLocale())) {
$this->setLocale($locale);
$this->currentTranslations[$locale] = $l;
}
if ($this->collPrincipalI18ns === null) {
$this->initPrincipalI18ns();
$this->collPrincipalI18nsPartial = true;
}
if (!in_array($l, $this->collPrincipalI18ns->getArrayCopy(), true)) {
// only add it if the **same** object is not already associated
$this->doAddPrincipalI18n($l);
if ($this->principalI18nsScheduledForDeletion and $this->principalI18nsScheduledForDeletion->contains($l)) {
$this->principalI18nsScheduledForDeletion->remove($this->principalI18nsScheduledForDeletion->search($l));
}
}
return $this;
}
