class.ilStr.php

Go to the documentation of this file.

<?php

/* Copyright (c) 1998-2014 ILIAS open source, Extended GPL, see docs/LICENSE */


class ilStr
{
        static public function subStr($a_str, $a_start, $a_length = NULL)
        {
                if (function_exists("mb_substr"))
                {
                        // bug in PHP < 5.4.12: null is not supported as length (if encoding given)
                        // https://github.com/php/php-src/pull/133                      
                        if ($a_length === null)
                        {
                                $a_length = mb_strlen($a_str, "UTF-8");
                        }
                        
                        return mb_substr($a_str, $a_start, $a_length, "UTF-8");
                }
                else
                {
                        return substr($a_str, $a_start, $a_length);
                }
        }

        static function strPos($a_haystack, $a_needle, $a_offset = NULL)
        {
                if (function_exists("mb_strpos"))
                {
                        return mb_strpos($a_haystack, $a_needle, $a_offset, "UTF-8");
                }
                else
                {
                        return strpos($a_haystack, $a_needle, $a_offset);
                }
        }

        static function strrPos($a_haystack, $a_needle, $a_offset = NULL)
        {
                if (function_exists("mb_strpos"))
                {
                        return mb_strrpos($a_haystack, $a_needle, $a_offset, "UTF-8");
                }
                else
                {
                        return strrpos($a_haystack, $a_needle, $a_offset);
                }
        }

        static function strIPos($a_haystack, $a_needle, $a_offset = NULL)
        {
                if (function_exists("mb_stripos"))
                {
                        return mb_stripos($a_haystack, $a_needle, $a_offset, "UTF-8");
                }
                else
                {
                        return stripos($a_haystack, $a_needle, $a_offset);
                }
        }

        /*function strrPos($a_haystack, $a_needle, $a_offset = NULL)
        {
                if (function_exists("mb_strrpos"))
                {
                        // only for php version 5.2.0 and above
                        if( version_compare(PHP_VERSION, '5.2.0', '>=') )
                        {
                                return mb_strrpos($a_haystack, $a_needle, $a_offset, "UTF-8");
                        }
                        else
                        {
                                @todo: We need an implementation for php versions < 5.2.0
                                return mb_strrpos($a_haystack, $a_needle, "UTF-8");
                        }
                }
                else
                {
                        return strrpos($a_haystack, $a_needle, $a_offset);
                }               
        }*/

        static public function strLen($a_string)
        {
                if (function_exists("mb_strlen"))
                {
                        return mb_strlen($a_string, "UTF-8");
                }
                else
                {
                        return strlen($a_string);
                }               
        }

        static public function strToLower($a_string)
        {
                if (function_exists("mb_strtolower"))
                {
                        return mb_strtolower($a_string, "UTF-8");
                }
                else
                {
                        return strtolower($a_string);
                }               
        }

        static function strToUpper($a_string)
        {
                $a_string = (string) $a_string;
                if (function_exists("mb_strtoupper"))
                {
                        return mb_strtoupper($a_string, "UTF-8");
                }
                else
                {
                        return strtoupper($a_string);
                }               
        }
        
        static function strCmp($a, $b)
        {
                global $ilCollator;

                if (is_object($ilCollator))
                {
                        return ($ilCollator->compare(ilStr::strToUpper($a), ilStr::strToUpper($b)) > 0);
                }
                else
                {
                        return (strcoll(ilStr::strToUpper($a), ilStr::strToUpper($b)) > 0);
                }
        }
        
        static public function shortenText($a_string,$a_start_pos,$a_num_bytes,$a_encoding = 'UTF-8')
        {
                if (function_exists("mb_strcut"))
                {
                        return mb_strcut($a_string, $a_start_pos, $a_num_bytes, $a_encoding);
                }
                return substr($a_string, $a_start_pos, $a_num_bytes);
        }

        static function isUtf8($a_str)
        {
                if (function_exists("mb_detect_encoding"))
                {
                        if (mb_detect_encoding($a_str, "UTF-8", true) == "UTF-8")
                        {
                                return true;
                        }
                }
                else
                {
                        // copied from http://www.php.net/manual/en/function.mb-detect-encoding.php
                        $c=0; $b=0;
                        $bits=0;
                        $len=strlen($a_str);
                        for($i=0; $i<$len; $i++){
                                $c=ord($a_str[$i]);
                                if($c > 128){
                                        if(($c >= 254)) return false;
                                        elseif($c >= 252) $bits=6;
                                        elseif($c >= 248) $bits=5;
                                        elseif($c >= 240) $bits=4;
                                        elseif($c >= 224) $bits=3;
                                        elseif($c >= 192) $bits=2;
                                        else return false;
                                        if(($i+$bits) > $len) return false;
                                        while($bits > 1){
                                                $i++;
                                                $b=ord($a_str[$i]);
                                                if($b < 128 || $b > 191) return false;
                                                $bits--;
                                        }
                                }
                        }
                        return true;
                }
                return false;
        }


        static public function strPosAll($a_haystack, $a_needle)
        {
                $positions = array();
                $cpos = 0;
                while(is_int($pos = strpos($a_haystack, $a_needle, $cpos)))
                {
                        $positions[] = $pos;
                        $cpos = $pos+1;
                }
                return $positions;
        }

        static function replaceFirsOccurence($a_old, $a_new, $a_str)
        {
                if (is_int(strpos($a_str, $a_old)))
                {
                        $a_str = substr_replace ($a_str, $a_new, strpos($a_str, $a_old), strlen($a_old));
                }
                return $a_str;
        }

        public static function convertUpperCamelCaseToUnderscoreCase($value)
        {
                return strtolower(preg_replace(
                        array('#(?<=(?:[A-Z]))([A-Z]+)([A-Z][A-z])#', '#(?<=(?:[a-z0-9]))([A-Z])#'),
                        array('\1_\2', '_\1'),
                        $value
                ));
        }

        static function getBytesForString($a_str)
        {
                $bytes = array();
                for($i = 0; $i < strlen($a_str); $i++)
                {
                        $bytes[] = ord($a_str[$i]);
                }
                return $bytes;
        }
        
        static function normalizeUtf8String($a_str)
        {
                include_once("./include/Unicode/UtfNormal.php");
                return UtfNormal::toNFC($a_str);
        }
        

}
?>