[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  namespace Psr\Link;
   4  
   5  /**
   6   * An evolvable link provider value object.
   7   */
   8  interface EvolvableLinkProviderInterface extends LinkProviderInterface
   9  {
  10      /**
  11       * Returns an instance with the specified link included.
  12       *
  13       * If the specified link is already present, this method MUST return normally
  14       * without errors. The link is present if $link is === identical to a link
  15       * object already in the collection.
  16       *
  17       * @param LinkInterface $link
  18       *   A link object that should be included in this collection.
  19       * @return static
  20       */
  21      public function withLink(LinkInterface $link);
  22  
  23      /**
  24       * Returns an instance with the specifed link removed.
  25       *
  26       * If the specified link is not present, this method MUST return normally
  27       * without errors. The link is present if $link is === identical to a link
  28       * object already in the collection.
  29       *
  30       * @param LinkInterface $link
  31       *   The link to remove.
  32       * @return static
  33       */
  34      public function withoutLink(LinkInterface $link);
  35  }