crm.fsf.org/20131203/files/sites/all/modules-old/civicrm/packages/PHP/Token/Stream/CachingFactory.php

   1 <?php
   2 /**
   3  * php-token-stream
   4  *
   5  * Copyright (c) 2009-2012, Sebastian Bergmann <sb@sebastian-bergmann.de>.
   6  * All rights reserved.
   7  *
   8  * Redistribution and use in source and binary forms, with or without
   9  * modification, are permitted provided that the following conditions
  10  * are met:
  11  *
  12  *   * Redistributions of source code must retain the above copyright
  13  *     notice, this list of conditions and the following disclaimer.
  14  *
  15  *   * Redistributions in binary form must reproduce the above copyright
  16  *     notice, this list of conditions and the following disclaimer in
  17  *     the documentation and/or other materials provided with the
  18  *     distribution.
  19  *
  20  *   * Neither the name of Sebastian Bergmann nor the names of his
  21  *     contributors may be used to endorse or promote products derived
  22  *     from this software without specific prior written permission.
  23  *
  24  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  25  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  26  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  27  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  28  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  29  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  30  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  31  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  32  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  34  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  35  * POSSIBILITY OF SUCH DAMAGE.
  36  *
  37  * @package   PHP_TokenStream
  38  * @author    Sebastian Bergmann <sb@sebastian-bergmann.de>
  39  * @copyright 2009-2012 Sebastian Bergmann <sb@sebastian-bergmann.de>
  40  * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
  41  * @since     File available since Release 1.0.0
  42  */
  43
  44 /**
  45  * A caching factory for token stream objects.
  46  *
  47  * @author    Sebastian Bergmann <sb@sebastian-bergmann.de>
  48  * @copyright 2009-2012 Sebastian Bergmann <sb@sebastian-bergmann.de>
  49  * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
  50  * @version   Release: 1.1.3
  51  * @link      http://github.com/sebastianbergmann/php-token-stream/tree
  52  * @since     Class available since Release 1.0.0
  53  */
  54 class PHP_Token_Stream_CachingFactory
  55 {
  56     /**
  57      * @var array
  58      */
  59     protected static $cache = array();
  60
  61     /**
  62      * @param  string $filename
  63      * @return PHP_Token_Stream
  64      */
  65     public static function get($filename)
  66     {
  67         if (!isset(self::$cache[$filename])) {
  68             self::$cache[$filename] = new PHP_Token_Stream($filename);
  69         }
  70
  71         return self::$cache[$filename];
  72     }
  73
  74     /**
  75      * @param string $filename
  76      */
  77     public static function clear($filename = NULL)
  78     {
  79         if (is_string($filename)) {
  80             unset(self::$cache[$filename]);
  81         } else {
  82             self::$cache = array();
  83         }
  84     }
  85 }