home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / Servidores / xampp-win32-1.6.7-installer.exe / php / PEAR / phing / util / regexp / PregEngine.php next >
Encoding:
PHP Script  |  2006-12-28  |  3.7 KB  |  105 lines
  1. <?php
  2. /* 
  3.  *  $Id: PregEngine.php 131 2006-12-28 11:27:09Z mrook $
  4.  *
  5.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  6.  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  7.  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  8.  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  9.  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  10.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  11.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  12.  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  13.  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  14.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  15.  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  16.  *
  17.  * This software consists of voluntary contributions made by many individuals
  18.  * and is licensed under the LGPL. For more information please see
  19.  * <http://phing.info>. 
  20.  */
  21.  
  22. require_once 'phing/util/regexp/RegexpEngine.php';
  23.  
  24. /**
  25.  * PREG Regexp Engine.
  26.  * Implements a regexp engine using PHP's preg_match(), preg_match_all(), and preg_replace() functions.
  27.  * 
  28.  * @author hans lellelid, hans@velum.net
  29.  * @package phing.util.regex
  30.  */
  31. class PregEngine implements RegexpEngine {
  32.  
  33.     /**
  34.      * @var boolean
  35.      */
  36.     private $ignoreCase = false;
  37.         
  38.     /**
  39.      * Sets whether or not regex operation is case sensitive.
  40.      * @param boolean $bit
  41.      * @return void
  42.      */
  43.     function setIgnoreCase($bit) {
  44.         $this->ignoreCase = (boolean) $bit;
  45.     }
  46.  
  47.     /**
  48.      * Gets whether or not regex operation is case sensitive.
  49.      * @return boolean
  50.      */
  51.     function getIgnoreCase() {
  52.         return $this->ignoreCase;
  53.     }
  54.         
  55.     /**
  56.      * The pattern needs to be converted into PREG style -- which includes adding expression delims & any flags, etc.
  57.      * @param string $pattern
  58.      * @return string prepared pattern.
  59.      */
  60.     private function preparePattern($pattern)
  61.     {
  62.         return '/'.$pattern.'/'.($this->ignoreCase ? 'i' : '');
  63.     }
  64.     
  65.     /**
  66.      * Matches pattern against source string and sets the matches array.
  67.      * @param string $pattern The regex pattern to match.
  68.      * @param string $source The source string.
  69.      * @param array $matches The array in which to store matches.
  70.      * @return boolean Success of matching operation.
  71.      */
  72.     function match($pattern, $source, &$matches) { 
  73.         return preg_match($this->preparePattern($pattern), $source, $matches);
  74.     }
  75.  
  76.     /**
  77.      * Matches all patterns in source string and sets the matches array.
  78.      * @param string $pattern The regex pattern to match.
  79.      * @param string $source The source string.
  80.      * @param array $matches The array in which to store matches.
  81.      * @return boolean Success of matching operation.
  82.      */        
  83.     function matchAll($pattern, $source, &$matches) {
  84.         return preg_match_all($this->preparePattern($pattern), $source, $matches);
  85.     }
  86.  
  87.     /**
  88.      * Replaces $pattern with $replace in $source string.
  89.      * References to \1 group matches will be replaced with more preg-friendly
  90.      * $1.
  91.      * @param string $pattern The regex pattern to match.
  92.      * @param string $replace The string with which to replace matches.
  93.      * @param string $source The source string.
  94.      * @return string The replaced source string.
  95.      */        
  96.     function replace($pattern, $replace, $source) {
  97.         // convert \1 -> $1, because we want to use the more generic \1 in the XML
  98.         // but PREG prefers $1 syntax.
  99.         $replace = preg_replace('/\\\(\d+)/', '\$$1', $replace);
  100.         return preg_replace($this->preparePattern($pattern), $replace, $source);
  101.     }
  102.  
  103. }
  104.  
  105. ?>