OString.php

Go to the documentation of this file.

<?php
/* vim: set expandtab tabstop=4 shiftwidth=4: */
//  
//  Copyright (c) 2003 Laurent Bedubourg
//  
//  This library is free software; you can redistribute it and/or
//  modify it under the terms of the GNU Lesser General Public
//  License as published by the Free Software Foundation; either
//  version 2.1 of the License, or (at your option) any later version.
//  
//  This library is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
//  Lesser General Public License for more details.
//  
//  You should have received a copy of the GNU Lesser General Public
//  License along with this library; if not, write to the Free Software
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//  
//  Authors: Laurent Bedubourg <laurent.bedubourg@free.fr>
//  


require_once PT_IP . "/Types.php";
require_once PT_IP . "/Types/Errors.php";

if (!defined('endl')) { 
    if (isset($GLOBALS['REQUEST_URI'])) { 
        define('endl', "<br/>\n"); 
    } else {
        define('endl', "\n");
    }
}

class OString 
{
    var $_str;

    function OString($str="")
    {
        return $this->__construct($str);
    }
    
    function __construct($str="")
    {
        if (is_object($str)) {
            if (!method_exists($str, "toString")) {
                $err = new TypeError('String constructor requires string or '
                                     . ' object implementing toString() method.',
                                     PEAR_ERROR_DIE);
                // return EX::raise($err);
                return PEAR::raiseError($err); 
            }
            $this->_str = $str->toString();
        } else {
            $this->_str = $str;
        }
    }

    function append()
    {
        $args = func_get_args();
        foreach ($args as $arg) {
            if (is_object($arg)) {
                $this->_str .= $arg->toString();
            } else {
                $this->_str .= $arg;
            }
        }
    }
    
    function charAt($i)
    {
        return $this->_str[$i];
    }
    
    function indexOf($needle, $pos=0)
    {
        if (is_object($needle)) { $needle = $needle->toString(); }
        return strpos($this->_str, $needle, $pos);
    }
    
    function lastIndexOf($needle)
    {
        if (is_object($needle)) { $needle = $needle->toString(); }
        return strrpos($this->_str, $needle);
    }
    
    function matches($regex)
    {
        if (is_object($regex)) { $regex = $regex->toString(); }
        return preg_match($regex, $this->_str);
    }

    function contains($str)
    {
        if (is_object($str)){ $str = $str->toString(); }
        return (strpos($this->_str, $str) !== false);
    }
    
    function startsWith($str)
    {
        if (is_object($str)){ $str = $str->toString(); }
        return preg_match('|^'. preg_quote($str) . '|', $this->_str);
    }
    
    function endsWith($str)
    {
        if (is_object($str)){ $str = $str->toString(); }
        return preg_match('|'. preg_quote($str) . '$|', $this->_str);
    }
    
    function replace($old, $new)
    {
        if (is_object($old)){ $old = $old->toString(); }
        if (is_object($new)){ $new = $new->toString(); }
        return str_replace($old, $new, $this->_str);
    }
    
    function split($sep)
    {
        if (is_object($sep)){ $sep = $sep->toString(); }
        return split($sep, $this->_str);
    }
    
    function substr($start, $end=false)
    {
        if ($end === false){ return substr($this->_str, $start); }
        return substr($this->_str, $start, ($end-$start));
    }

    function extract($start, $length)
    {
        return substr($this->_str, $start, $length);
    }
    
    function toLowerCase()
    {
        return strtolower($this->_str);
    }
    
    function toUpperCase()
    {
        return strtoupper($this->_str);
    }
    
    function trim()
    {
        return trim($this->_str);
    }
    
    function equals($o)
    {
        if (is_object($o)) {
            return $this->_str == $str->toString();
        } else { 
            return $this->_str == $o;
        }
    }
    
    function length()
    {
        return strlen($this->_str);
    }
    
    function toString()
    {
        return $this->_str;
    }

    function &getNewIterator()
    {
        return new StringIterator($this);
    }
}

class StringBuffer extends OString
{
    function appendln()
    {
        $args = func_get_args();
        foreach ($args as $arg) {
            if (is_object($arg)) {
                $this->_str .= $arg->toString();
            } else {
                $this->_str .= $arg;
            }
        }        
        $this->_str .= endl;
    }
}

class StringIterator
{
    var $_str;
    var $_index = -1;
    var $_end = false;
    var $_value;
    
    function StringIterator(&$str)
    {
        $this->__construct($str);
    }

    function __construct(&$str)
    {
        if (is_object($str)) {
            $this->_string = new OString($str->toString());
        } else if (is_string($str)) {
            $this->_string = new OString($str);
        }
        $this->reset();
    }

    function reset()
    {
        $this->_end = false;
        $this->_index = 0;
        if ($this->_string->length() == 0) {
            $this->_end = true;
        } else {
            $this->_value = $this->_string->charAt(0);
        }
    }
    
    function next()
    {
        if ($this->_end || ++$this->_index >= $this->_string->length()) {
            $this->_end = true;
            return null;
        }
        
        $this->_value = $this->_string->charAt($this->_index);
        return $this->_value;
    }
    
    function isValid()
    {
        return !$this->_end;
    }
    
    function index()
    {
        return $this->_index;
    }
    
    function value()
    {
        return $this->_value;
    }
}

?>

---