/**
  * 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 Role $obj A Role 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->getId();
         }
         // if key === null
         RolePeer::$instances[$key] = $obj;
     }
 }
 /**
  * Filter the query by a related Role object
  *
  * @param   Role|PropelObjectCollection $role The related object(s) to use as filter
  * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
  *
  * @return                 UserRoleQuery The current query, for fluid interface
  * @throws PropelException - if the provided filter is invalid.
  */
 public function filterByRole($role, $comparison = null)
 {
     if ($role instanceof Role) {
         return $this->addUsingAlias(UserRolePeer::ROLE_ID, $role->getId(), $comparison);
     } elseif ($role instanceof PropelObjectCollection) {
         if (null === $comparison) {
             $comparison = Criteria::IN;
         }
         return $this->addUsingAlias(UserRolePeer::ROLE_ID, $role->toKeyValue('PrimaryKey', 'Id'), $comparison);
     } else {
         throw new PropelException('filterByRole() only accepts arguments of type Role or PropelCollection');
     }
 }
 /**
  * Declares an association between this object and a Role object.
  *
  * @param                  Role $v
  * @return UserRole The current object (for fluent API support)
  * @throws PropelException
  */
 public function setRole(Role $v = null)
 {
     if ($v === null) {
         $this->setRoleId(NULL);
     } else {
         $this->setRoleId($v->getId());
     }
     $this->aRole = $v;
     // Add binding for other direction of this n:n relationship.
     // If this object has already been added to the Role object, it will not be re-added.
     if ($v !== null) {
         $v->addUserRole($this);
     }
     return $this;
 }
 /**
  * Exclude object from result
  *
  * @param   Role $role Object to remove from the list of results
  *
  * @return RoleQuery The current query, for fluid interface
  */
 public function prune($role = null)
 {
     if ($role) {
         $this->addUsingAlias(RolePeer::ID, $role->getId(), Criteria::NOT_EQUAL);
     }
     return $this;
 }