/**
* 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 you may need to explicitly add objects
* to the cache in order to ensure that the same objects are always returned by find*()
* and findPk*() calls.
*
* @param \App\Propel\PromotionTypeI18n $obj A \App\Propel\PromotionTypeI18n 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 (null === $key) {
$key = serialize([null === $obj->getPromotionTypeId() || is_scalar($obj->getPromotionTypeId()) || is_callable([$obj->getPromotionTypeId(), '__toString']) ? (string) $obj->getPromotionTypeId() : $obj->getPromotionTypeId(), null === $obj->getLocale() || is_scalar($obj->getLocale()) || is_callable([$obj->getLocale(), '__toString']) ? (string) $obj->getLocale() : $obj->getLocale()]);
}
// if key === null
self::$instances[$key] = $obj;
}
}
/**
* Returns the current translation for a given locale
*
* @param string $locale Locale to use for the translation, e.g. 'fr_FR'
* @param ConnectionInterface $con an optional connection object
*
* @return ChildPromotionTypeI18n */
public function getTranslation($locale = 'en_US', ConnectionInterface $con = null)
{
if (!isset($this->currentTranslations[$locale])) {
if (null !== $this->collPromotionTypeI18ns) {
foreach ($this->collPromotionTypeI18ns as $translation) {
if ($translation->getLocale() == $locale) {
$this->currentTranslations[$locale] = $translation;
return $translation;
}
}
}
if ($this->isNew()) {
$translation = new ChildPromotionTypeI18n();
$translation->setLocale($locale);
} else {
$translation = ChildPromotionTypeI18nQuery::create()->filterByPrimaryKey(array($this->getPrimaryKey(), $locale))->findOneOrCreate($con);
$this->currentTranslations[$locale] = $translation;
}
$this->addPromotionTypeI18n($translation);
}
return $this->currentTranslations[$locale];
}
/**
* Exclude object from result
*
* @param ChildPromotionTypeI18n $promotionTypeI18n Object to remove from the list of results
*
* @return $this|ChildPromotionTypeI18nQuery The current query, for fluid interface
*/
public function prune($promotionTypeI18n = null)
{
if ($promotionTypeI18n) {
$this->addCond('pruneCond0', $this->getAliasedColName(PromotionTypeI18nTableMap::COL_PROMOTION_TYPE_ID), $promotionTypeI18n->getPromotionTypeId(), Criteria::NOT_EQUAL);
$this->addCond('pruneCond1', $this->getAliasedColName(PromotionTypeI18nTableMap::COL_LOCALE), $promotionTypeI18n->getLocale(), Criteria::NOT_EQUAL);
$this->combine(array('pruneCond0', 'pruneCond1'), Criteria::LOGICAL_OR);
}
return $this;
}
/**
* Filter the query by a related \App\Propel\PromotionTypeI18n object
*
* @param \App\Propel\PromotionTypeI18n|ObjectCollection $promotionTypeI18n the related object to use as filter
* @param string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
*
* @return ChildPromotionTypeQuery The current query, for fluid interface
*/
public function filterByPromotionTypeI18n($promotionTypeI18n, $comparison = null)
{
if ($promotionTypeI18n instanceof \App\Propel\PromotionTypeI18n) {
return $this->addUsingAlias(PromotionTypeTableMap::COL_PROMOTION_TYPE_ID, $promotionTypeI18n->getPromotionTypeId(), $comparison);
} elseif ($promotionTypeI18n instanceof ObjectCollection) {
return $this->usePromotionTypeI18nQuery()->filterByPrimaryKeys($promotionTypeI18n->getPrimaryKeys())->endUse();
} else {
throw new PropelException('filterByPromotionTypeI18n() only accepts arguments of type \\App\\Propel\\PromotionTypeI18n or Collection');
}
}