/**
  * 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      Songs $obj A Songs 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
         SongsPeer::$instances[$key] = $obj;
     }
 }
 /**
  * Exclude object from result
  *
  * @param   Songs $songs Object to remove from the list of results
  *
  * @return SongsQuery The current query, for fluid interface
  */
 public function prune($songs = null)
 {
     if ($songs) {
         $this->addUsingAlias(SongsPeer::ID, $songs->getId(), Criteria::NOT_EQUAL);
     }
     return $this;
 }
 /**
  * Filter the query by a related Songs object
  *
  * @param   Songs|PropelObjectCollection $songs  the related object to use as filter
  * @param     string $comparison Operator to use for the column comparison, defaults to Criteria::EQUAL
  *
  * @return                 AlbumQuery The current query, for fluid interface
  * @throws PropelException - if the provided filter is invalid.
  */
 public function filterBySongs($songs, $comparison = null)
 {
     if ($songs instanceof Songs) {
         return $this->addUsingAlias(AlbumPeer::ID, $songs->getAlbumId(), $comparison);
     } elseif ($songs instanceof PropelObjectCollection) {
         return $this->useSongsQuery()->filterByPrimaryKeys($songs->getPrimaryKeys())->endUse();
     } else {
         throw new PropelException('filterBySongs() only accepts arguments of type Songs or PropelCollection');
     }
 }