source: sourcecode/application/libraries/PHPExcel/Calculation/TextData.php @ 1

Last change on this file since 1 was 1, checked in by dungnv, 11 years ago
File size: 17.4 KB
Line 
1<?php
2/**
3 * PHPExcel
4 *
5 * Copyright (c) 2006 - 2014 PHPExcel
6 *
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 *
21 * @category    PHPExcel
22 * @package             PHPExcel_Calculation
23 * @copyright   Copyright (c) 2006 - 2014 PHPExcel (http://www.codeplex.com/PHPExcel)
24 * @license             http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt   LGPL
25 * @version             1.8.0, 2014-03-02
26 */
27
28
29/** PHPExcel root directory */
30if (!defined('PHPEXCEL_ROOT')) {
31        /**
32         * @ignore
33         */
34        define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
35        require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
36}
37
38
39/**
40 * PHPExcel_Calculation_TextData
41 *
42 * @category    PHPExcel
43 * @package             PHPExcel_Calculation
44 * @copyright   Copyright (c) 2006 - 2014 PHPExcel (http://www.codeplex.com/PHPExcel)
45 */
46class PHPExcel_Calculation_TextData {
47
48        private static $_invalidChars = Null;
49
50        private static function _uniord($c) {
51                if (ord($c{0}) >=0 && ord($c{0}) <= 127)
52                        return ord($c{0});
53                if (ord($c{0}) >= 192 && ord($c{0}) <= 223)
54                        return (ord($c{0})-192)*64 + (ord($c{1})-128);
55                if (ord($c{0}) >= 224 && ord($c{0}) <= 239)
56                        return (ord($c{0})-224)*4096 + (ord($c{1})-128)*64 + (ord($c{2})-128);
57                if (ord($c{0}) >= 240 && ord($c{0}) <= 247)
58                        return (ord($c{0})-240)*262144 + (ord($c{1})-128)*4096 + (ord($c{2})-128)*64 + (ord($c{3})-128);
59                if (ord($c{0}) >= 248 && ord($c{0}) <= 251)
60                        return (ord($c{0})-248)*16777216 + (ord($c{1})-128)*262144 + (ord($c{2})-128)*4096 + (ord($c{3})-128)*64 + (ord($c{4})-128);
61                if (ord($c{0}) >= 252 && ord($c{0}) <= 253)
62                        return (ord($c{0})-252)*1073741824 + (ord($c{1})-128)*16777216 + (ord($c{2})-128)*262144 + (ord($c{3})-128)*4096 + (ord($c{4})-128)*64 + (ord($c{5})-128);
63                if (ord($c{0}) >= 254 && ord($c{0}) <= 255) //error
64                        return PHPExcel_Calculation_Functions::VALUE();
65                return 0;
66        }       //      function _uniord()
67
68        /**
69         * CHARACTER
70         *
71         * @param       string  $character      Value
72         * @return      int
73         */
74        public static function CHARACTER($character) {
75                $character      = PHPExcel_Calculation_Functions::flattenSingleValue($character);
76
77                if ((!is_numeric($character)) || ($character < 0)) {
78                        return PHPExcel_Calculation_Functions::VALUE();
79                }
80
81                if (function_exists('mb_convert_encoding')) {
82                        return mb_convert_encoding('&#'.intval($character).';', 'UTF-8', 'HTML-ENTITIES');
83                } else {
84                        return chr(intval($character));
85                }
86        }
87
88
89        /**
90         * TRIMNONPRINTABLE
91         *
92         * @param       mixed   $stringValue    Value to check
93         * @return      string
94         */
95        public static function TRIMNONPRINTABLE($stringValue = '') {
96                $stringValue    = PHPExcel_Calculation_Functions::flattenSingleValue($stringValue);
97
98                if (is_bool($stringValue)) {
99                        return ($stringValue) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
100                }
101
102                if (self::$_invalidChars == Null) {
103                        self::$_invalidChars = range(chr(0),chr(31));
104                }
105
106                if (is_string($stringValue) || is_numeric($stringValue)) {
107                        return str_replace(self::$_invalidChars,'',trim($stringValue,"\x00..\x1F"));
108                }
109                return NULL;
110        }       //      function TRIMNONPRINTABLE()
111
112
113        /**
114         * TRIMSPACES
115         *
116         * @param       mixed   $stringValue    Value to check
117         * @return      string
118         */
119        public static function TRIMSPACES($stringValue = '') {
120                $stringValue    = PHPExcel_Calculation_Functions::flattenSingleValue($stringValue);
121
122                if (is_bool($stringValue)) {
123                        return ($stringValue) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
124                }
125
126                if (is_string($stringValue) || is_numeric($stringValue)) {
127                        return trim(preg_replace('/ +/',' ',trim($stringValue,' ')));
128                }
129                return NULL;
130        }       //      function TRIMSPACES()
131
132
133        /**
134         * ASCIICODE
135         *
136         * @param       string  $characters             Value
137         * @return      int
138         */
139        public static function ASCIICODE($characters) {
140                if (($characters === NULL) || ($characters === ''))
141                        return PHPExcel_Calculation_Functions::VALUE();
142                $characters     = PHPExcel_Calculation_Functions::flattenSingleValue($characters);
143                if (is_bool($characters)) {
144                        if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
145                                $characters = (int) $characters;
146                        } else {
147                                $characters = ($characters) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
148                        }
149                }
150
151                $character = $characters;
152                if ((function_exists('mb_strlen')) && (function_exists('mb_substr'))) {
153                        if (mb_strlen($characters, 'UTF-8') > 1) { $character = mb_substr($characters, 0, 1, 'UTF-8'); }
154                        return self::_uniord($character);
155                } else {
156                        if (strlen($characters) > 0) { $character = substr($characters, 0, 1); }
157                        return ord($character);
158                }
159        }       //      function ASCIICODE()
160
161
162        /**
163         * CONCATENATE
164         *
165         * @return      string
166         */
167        public static function CONCATENATE() {
168                // Return value
169                $returnValue = '';
170
171                // Loop through arguments
172                $aArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
173                foreach ($aArgs as $arg) {
174                        if (is_bool($arg)) {
175                                if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
176                                        $arg = (int) $arg;
177                                } else {
178                                        $arg = ($arg) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
179                                }
180                        }
181                        $returnValue .= $arg;
182                }
183
184                // Return
185                return $returnValue;
186        }       //      function CONCATENATE()
187
188
189        /**
190         * DOLLAR
191         *
192         * This function converts a number to text using currency format, with the decimals rounded to the specified place.
193         * The format used is $#,##0.00_);($#,##0.00)..
194         *
195         * @param       float   $value                  The value to format
196         * @param       int             $decimals               The number of digits to display to the right of the decimal point.
197         *                                                                      If decimals is negative, number is rounded to the left of the decimal point.
198         *                                                                      If you omit decimals, it is assumed to be 2
199         * @return      string
200         */
201        public static function DOLLAR($value = 0, $decimals = 2) {
202                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
203                $decimals       = is_null($decimals) ? 0 : PHPExcel_Calculation_Functions::flattenSingleValue($decimals);
204
205                // Validate parameters
206                if (!is_numeric($value) || !is_numeric($decimals)) {
207                        return PHPExcel_Calculation_Functions::NaN();
208                }
209                $decimals = floor($decimals);
210
211                $mask = '$#,##0';
212                if ($decimals > 0) {
213                        $mask .= '.' . str_repeat('0',$decimals);
214                } else {
215                        $round = pow(10,abs($decimals));
216                        if ($value < 0) { $round = 0-$round; }
217                        $value = PHPExcel_Calculation_MathTrig::MROUND($value, $round);
218                }
219
220                return PHPExcel_Style_NumberFormat::toFormattedString($value, $mask);
221
222        }       //      function DOLLAR()
223
224
225        /**
226         * SEARCHSENSITIVE
227         *
228         * @param       string  $needle         The string to look for
229         * @param       string  $haystack       The string in which to look
230         * @param       int             $offset         Offset within $haystack
231         * @return      string
232         */
233        public static function SEARCHSENSITIVE($needle,$haystack,$offset=1) {
234                $needle         = PHPExcel_Calculation_Functions::flattenSingleValue($needle);
235                $haystack       = PHPExcel_Calculation_Functions::flattenSingleValue($haystack);
236                $offset         = PHPExcel_Calculation_Functions::flattenSingleValue($offset);
237
238                if (!is_bool($needle)) {
239                        if (is_bool($haystack)) {
240                                $haystack = ($haystack) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
241                        }
242
243                        if (($offset > 0) && (PHPExcel_Shared_String::CountCharacters($haystack) > $offset)) {
244                                if (PHPExcel_Shared_String::CountCharacters($needle) == 0) {
245                                        return $offset;
246                                }
247                                if (function_exists('mb_strpos')) {
248                                        $pos = mb_strpos($haystack, $needle, --$offset, 'UTF-8');
249                                } else {
250                                        $pos = strpos($haystack, $needle, --$offset);
251                                }
252                                if ($pos !== false) {
253                                        return ++$pos;
254                                }
255                        }
256                }
257                return PHPExcel_Calculation_Functions::VALUE();
258        }       //      function SEARCHSENSITIVE()
259
260
261        /**
262         * SEARCHINSENSITIVE
263         *
264         * @param       string  $needle         The string to look for
265         * @param       string  $haystack       The string in which to look
266         * @param       int             $offset         Offset within $haystack
267         * @return      string
268         */
269        public static function SEARCHINSENSITIVE($needle,$haystack,$offset=1) {
270                $needle         = PHPExcel_Calculation_Functions::flattenSingleValue($needle);
271                $haystack       = PHPExcel_Calculation_Functions::flattenSingleValue($haystack);
272                $offset         = PHPExcel_Calculation_Functions::flattenSingleValue($offset);
273
274                if (!is_bool($needle)) {
275                        if (is_bool($haystack)) {
276                                $haystack = ($haystack) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
277                        }
278
279                        if (($offset > 0) && (PHPExcel_Shared_String::CountCharacters($haystack) > $offset)) {
280                                if (PHPExcel_Shared_String::CountCharacters($needle) == 0) {
281                                        return $offset;
282                                }
283                                if (function_exists('mb_stripos')) {
284                                        $pos = mb_stripos($haystack, $needle, --$offset,'UTF-8');
285                                } else {
286                                        $pos = stripos($haystack, $needle, --$offset);
287                                }
288                                if ($pos !== false) {
289                                        return ++$pos;
290                                }
291                        }
292                }
293                return PHPExcel_Calculation_Functions::VALUE();
294        }       //      function SEARCHINSENSITIVE()
295
296
297        /**
298         * FIXEDFORMAT
299         *
300         * @param       mixed           $value  Value to check
301         * @param       integer         $decimals
302         * @param       boolean         $no_commas
303         * @return      boolean
304         */
305        public static function FIXEDFORMAT($value, $decimals = 2, $no_commas = FALSE) {
306                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
307                $decimals       = PHPExcel_Calculation_Functions::flattenSingleValue($decimals);
308                $no_commas      = PHPExcel_Calculation_Functions::flattenSingleValue($no_commas);
309
310                // Validate parameters
311                if (!is_numeric($value) || !is_numeric($decimals)) {
312                        return PHPExcel_Calculation_Functions::NaN();
313                }
314                $decimals = floor($decimals);
315
316                $valueResult = round($value,$decimals);
317                if ($decimals < 0) { $decimals = 0; }
318                if (!$no_commas) {
319                        $valueResult = number_format($valueResult,$decimals);
320                }
321
322                return (string) $valueResult;
323        }       //      function FIXEDFORMAT()
324
325
326        /**
327         * LEFT
328         *
329         * @param       string  $value  Value
330         * @param       int             $chars  Number of characters
331         * @return      string
332         */
333        public static function LEFT($value = '', $chars = 1) {
334                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
335                $chars          = PHPExcel_Calculation_Functions::flattenSingleValue($chars);
336
337                if ($chars < 0) {
338                        return PHPExcel_Calculation_Functions::VALUE();
339                }
340
341                if (is_bool($value)) {
342                        $value = ($value) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
343                }
344
345                if (function_exists('mb_substr')) {
346                        return mb_substr($value, 0, $chars, 'UTF-8');
347                } else {
348                        return substr($value, 0, $chars);
349                }
350        }       //      function LEFT()
351
352
353        /**
354         * MID
355         *
356         * @param       string  $value  Value
357         * @param       int             $start  Start character
358         * @param       int             $chars  Number of characters
359         * @return      string
360         */
361        public static function MID($value = '', $start = 1, $chars = null) {
362                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
363                $start          = PHPExcel_Calculation_Functions::flattenSingleValue($start);
364                $chars          = PHPExcel_Calculation_Functions::flattenSingleValue($chars);
365
366                if (($start < 1) || ($chars < 0)) {
367                        return PHPExcel_Calculation_Functions::VALUE();
368                }
369
370                if (is_bool($value)) {
371                        $value = ($value) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
372                }
373
374                if (function_exists('mb_substr')) {
375                        return mb_substr($value, --$start, $chars, 'UTF-8');
376                } else {
377                        return substr($value, --$start, $chars);
378                }
379        }       //      function MID()
380
381
382        /**
383         * RIGHT
384         *
385         * @param       string  $value  Value
386         * @param       int             $chars  Number of characters
387         * @return      string
388         */
389        public static function RIGHT($value = '', $chars = 1) {
390                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
391                $chars          = PHPExcel_Calculation_Functions::flattenSingleValue($chars);
392
393                if ($chars < 0) {
394                        return PHPExcel_Calculation_Functions::VALUE();
395                }
396
397                if (is_bool($value)) {
398                        $value = ($value) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
399                }
400
401                if ((function_exists('mb_substr')) && (function_exists('mb_strlen'))) {
402                        return mb_substr($value, mb_strlen($value, 'UTF-8') - $chars, $chars, 'UTF-8');
403                } else {
404                        return substr($value, strlen($value) - $chars);
405                }
406        }       //      function RIGHT()
407
408
409        /**
410         * STRINGLENGTH
411         *
412         * @param       string  $value  Value
413         * @return      string
414         */
415        public static function STRINGLENGTH($value = '') {
416                $value          = PHPExcel_Calculation_Functions::flattenSingleValue($value);
417
418                if (is_bool($value)) {
419                        $value = ($value) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
420                }
421
422                if (function_exists('mb_strlen')) {
423                        return mb_strlen($value, 'UTF-8');
424                } else {
425                        return strlen($value);
426                }
427        }       //      function STRINGLENGTH()
428
429
430        /**
431         * LOWERCASE
432         *
433         * Converts a string value to upper case.
434         *
435         * @param       string          $mixedCaseString
436         * @return      string
437         */
438        public static function LOWERCASE($mixedCaseString) {
439                $mixedCaseString        = PHPExcel_Calculation_Functions::flattenSingleValue($mixedCaseString);
440
441                if (is_bool($mixedCaseString)) {
442                        $mixedCaseString = ($mixedCaseString) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
443                }
444
445                return PHPExcel_Shared_String::StrToLower($mixedCaseString);
446        }       //      function LOWERCASE()
447
448
449        /**
450         * UPPERCASE
451         *
452         * Converts a string value to upper case.
453         *
454         * @param       string          $mixedCaseString
455         * @return      string
456         */
457        public static function UPPERCASE($mixedCaseString) {
458                $mixedCaseString        = PHPExcel_Calculation_Functions::flattenSingleValue($mixedCaseString);
459
460                if (is_bool($mixedCaseString)) {
461                        $mixedCaseString = ($mixedCaseString) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
462                }
463
464                return PHPExcel_Shared_String::StrToUpper($mixedCaseString);
465        }       //      function UPPERCASE()
466
467
468        /**
469         * PROPERCASE
470         *
471         * Converts a string value to upper case.
472         *
473         * @param       string          $mixedCaseString
474         * @return      string
475         */
476        public static function PROPERCASE($mixedCaseString) {
477                $mixedCaseString        = PHPExcel_Calculation_Functions::flattenSingleValue($mixedCaseString);
478
479                if (is_bool($mixedCaseString)) {
480                        $mixedCaseString = ($mixedCaseString) ? PHPExcel_Calculation::getTRUE() : PHPExcel_Calculation::getFALSE();
481                }
482
483                return PHPExcel_Shared_String::StrToTitle($mixedCaseString);
484        }       //      function PROPERCASE()
485
486
487        /**
488         * REPLACE
489         *
490         * @param       string  $oldText        String to modify
491         * @param       int             $start          Start character
492         * @param       int             $chars          Number of characters
493         * @param       string  $newText        String to replace in defined position
494         * @return      string
495         */
496        public static function REPLACE($oldText = '', $start = 1, $chars = null, $newText) {
497                $oldText        = PHPExcel_Calculation_Functions::flattenSingleValue($oldText);
498                $start          = PHPExcel_Calculation_Functions::flattenSingleValue($start);
499                $chars          = PHPExcel_Calculation_Functions::flattenSingleValue($chars);
500                $newText        = PHPExcel_Calculation_Functions::flattenSingleValue($newText);
501
502                $left = self::LEFT($oldText,$start-1);
503                $right = self::RIGHT($oldText,self::STRINGLENGTH($oldText)-($start+$chars)+1);
504
505                return $left.$newText.$right;
506        }       //      function REPLACE()
507
508
509        /**
510         * SUBSTITUTE
511         *
512         * @param       string  $text           Value
513         * @param       string  $fromText       From Value
514         * @param       string  $toText         To Value
515         * @param       integer $instance       Instance Number
516         * @return      string
517         */
518        public static function SUBSTITUTE($text = '', $fromText = '', $toText = '', $instance = 0) {
519                $text           = PHPExcel_Calculation_Functions::flattenSingleValue($text);
520                $fromText       = PHPExcel_Calculation_Functions::flattenSingleValue($fromText);
521                $toText         = PHPExcel_Calculation_Functions::flattenSingleValue($toText);
522                $instance       = floor(PHPExcel_Calculation_Functions::flattenSingleValue($instance));
523
524                if ($instance == 0) {
525                        if(function_exists('mb_str_replace')) {
526                                return mb_str_replace($fromText,$toText,$text);
527                        } else {
528                                return str_replace($fromText,$toText,$text);
529                        }
530                } else {
531                        $pos = -1;
532                        while($instance > 0) {
533                                if (function_exists('mb_strpos')) {
534                                        $pos = mb_strpos($text, $fromText, $pos+1, 'UTF-8');
535                                } else {
536                                        $pos = strpos($text, $fromText, $pos+1);
537                                }
538                                if ($pos === false) {
539                                        break;
540                                }
541                                --$instance;
542                        }
543                        if ($pos !== false) {
544                                if (function_exists('mb_strlen')) {
545                                        return self::REPLACE($text,++$pos,mb_strlen($fromText, 'UTF-8'),$toText);
546                                } else {
547                                        return self::REPLACE($text,++$pos,strlen($fromText),$toText);
548                                }
549                        }
550                }
551
552                return $text;
553        }       //      function SUBSTITUTE()
554
555
556        /**
557         * RETURNSTRING
558         *
559         * @param       mixed   $testValue      Value to check
560         * @return      boolean
561         */
562        public static function RETURNSTRING($testValue = '') {
563                $testValue      = PHPExcel_Calculation_Functions::flattenSingleValue($testValue);
564
565                if (is_string($testValue)) {
566                        return $testValue;
567                }
568                return Null;
569        }       //      function RETURNSTRING()
570
571
572        /**
573         * TEXTFORMAT
574         *
575         * @param       mixed   $value  Value to check
576         * @param       string  $format Format mask to use
577         * @return      boolean
578         */
579        public static function TEXTFORMAT($value,$format) {
580                $value  = PHPExcel_Calculation_Functions::flattenSingleValue($value);
581                $format = PHPExcel_Calculation_Functions::flattenSingleValue($format);
582
583                if ((is_string($value)) && (!is_numeric($value)) && PHPExcel_Shared_Date::isDateTimeFormatCode($format)) {
584                        $value = PHPExcel_Calculation_DateTime::DATEVALUE($value);
585                }
586
587                return (string) PHPExcel_Style_NumberFormat::toFormattedString($value,$format);
588        }       //      function TEXTFORMAT()
589
590}       //      class PHPExcel_Calculation_TextData
Note: See TracBrowser for help on using the repository browser.