wpDataTables Lite - Version 2.1.5

Version Description

  • Improvement: Replaced PHPExcel library with PhpSpreadsheet library.
  • BugFix: Fixed issue with deprecated errors.
  • Notice: From this version required PHP version is 5.6 or newer!
  • Other small bug fixes and stability improvements.
Download this release

Release Info

Developer wpDataTables
Plugin Icon 128x128 wpDataTables Lite
Version 2.1.5
Comparing to
See all releases

Code changes from version 2.1.4 to 2.1.5

Files changed (163) hide show
  1. config/config.inc.php +1 -1
  2. controllers/wdt_functions.php +2 -2
  3. lib/analog/analog/.gitignore +2 -0
  4. lib/analog/analog/.travis.yml +13 -0
  5. lib/analog/analog/LICENSE +21 -0
  6. lib/analog/analog/README.md +133 -0
  7. lib/analog/analog/composer.json +27 -0
  8. lib/analog/analog/examples/SplClassLoader.php +155 -0
  9. lib/analog/analog/examples/amon.php +16 -0
  10. lib/analog/analog/examples/apprise.php +11 -0
  11. lib/analog/analog/examples/buffer.php +18 -0
  12. lib/analog/analog/examples/chromelogger.php +19 -0
  13. lib/analog/analog/examples/default.php +11 -0
  14. lib/analog/analog/examples/file.php +15 -0
  15. lib/analog/analog/examples/firephp.php +16 -0
  16. lib/analog/analog/examples/gelf.php +16 -0
  17. lib/analog/analog/examples/ignore.php +9 -0
  18. lib/analog/analog/examples/levelbuffer.php +24 -0
  19. lib/analog/analog/examples/mail.php +13 -0
  20. lib/analog/analog/examples/mongo.php +21 -0
  21. lib/analog/analog/examples/multi.php +27 -0
  22. lib/analog/analog/examples/pdo.php +29 -0
  23. lib/analog/analog/examples/post.php +14 -0
  24. lib/analog/analog/examples/psr-0.php +19 -0
  25. lib/analog/analog/examples/server.php +13 -0
  26. lib/analog/analog/examples/slackbot.php +9 -0
  27. lib/analog/analog/examples/stderr.php +9 -0
  28. lib/analog/analog/examples/syslog.php +9 -0
  29. lib/analog/analog/examples/threshold.php +24 -0
  30. lib/analog/analog/examples/variable.php +14 -0
  31. lib/analog/analog/lib/Analog.php +22 -0
  32. lib/analog/analog/lib/Analog/Analog.php +265 -0
  33. lib/analog/analog/lib/Analog/Handler/Amon.php +43 -0
  34. lib/analog/analog/lib/Analog/Handler/Apprise.php +40 -0
  35. lib/analog/analog/lib/Analog/Handler/Buffer.php +59 -0
  36. lib/analog/analog/lib/Analog/Handler/Buffer/Destructor.php +12 -0
  37. lib/analog/analog/lib/Analog/Handler/ChromeLogger.php +44 -0
  38. lib/analog/analog/lib/Analog/Handler/File.php +37 -0
  39. lib/analog/analog/lib/Analog/Handler/FirePHP.php +77 -0
  40. lib/analog/analog/lib/Analog/Handler/GELF.php +48 -0
  41. lib/analog/analog/lib/Analog/Handler/Ignore.php +20 -0
  42. lib/analog/analog/lib/Analog/Handler/LevelBuffer.php +63 -0
  43. lib/analog/analog/lib/Analog/Handler/LevelName.php +50 -0
  44. lib/analog/analog/lib/Analog/Handler/Mail.php +28 -0
  45. lib/analog/analog/lib/Analog/Handler/Mongo.php +57 -0
  46. lib/analog/analog/lib/Analog/Handler/Multi.php +55 -0
  47. lib/analog/analog/lib/Analog/Handler/Null.php +23 -0
  48. lib/analog/analog/lib/Analog/Handler/PDO.php +89 -0
  49. lib/analog/analog/lib/Analog/Handler/Post.php +46 -0
  50. lib/analog/analog/lib/Analog/Handler/Slackbot.php +47 -0
  51. lib/analog/analog/lib/Analog/Handler/Stderr.php +24 -0
  52. lib/analog/analog/lib/Analog/Handler/Syslog.php +67 -0
  53. lib/analog/analog/lib/Analog/Handler/Threshold.php +45 -0
  54. lib/analog/analog/lib/Analog/Handler/Variable.php +26 -0
  55. lib/analog/analog/lib/Analog/Handler/WPMail.php +49 -0
  56. lib/analog/analog/lib/Analog/Logger.php +220 -0
  57. lib/analog/analog/lib/ChromePhp.php +423 -0
  58. lib/analog/analog/phpunit.xml.dist +19 -0
  59. lib/analog/analog/tests/AnalogTest.php +176 -0
  60. lib/analog/analog/tests/PHPUnit_Framework_TestCase.php +5 -0
  61. lib/analog/analog/tests/PsrLogCompatTest.php +37 -0
  62. lib/analog/analog/tests/bootstrap.php +8 -0
  63. lib/autoload.php +7 -0
  64. lib/bin/cleanup +140 -0
  65. lib/composer/ClassLoader.php +445 -0
  66. lib/composer/LICENSE +21 -0
  67. lib/composer/autoload_classmap.php +9 -0
  68. lib/composer/autoload_files.php +51 -0
  69. lib/composer/autoload_namespaces.php +11 -0
  70. lib/composer/autoload_psr4.php +14 -0
  71. lib/composer/autoload_real.php +70 -0
  72. lib/composer/autoload_static.php +120 -0
  73. lib/composer/installed.json +487 -0
  74. lib/jlawrence/eos/README.md +168 -0
  75. lib/jlawrence/eos/composer.json +22 -0
  76. lib/jlawrence/eos/src/AdvancedFunctions.php +86 -0
  77. lib/jlawrence/eos/src/Graph.php +281 -0
  78. lib/jlawrence/eos/src/Math.php +47 -0
  79. lib/jlawrence/eos/src/Matrix.php +656 -0
  80. lib/jlawrence/eos/src/Parser.php +593 -0
  81. lib/jlawrence/eos/src/Stack.php +115 -0
  82. lib/jlawrence/eos/src/Trig.php +75 -0
  83. lib/markbaker/complex/README.md +156 -0
  84. lib/markbaker/complex/classes/Autoloader.php +53 -0
  85. lib/markbaker/complex/classes/Bootstrap.php +38 -0
  86. lib/markbaker/complex/classes/src/Complex.php +387 -0
  87. lib/markbaker/complex/classes/src/Exception.php +13 -0
  88. lib/markbaker/complex/classes/src/functions/abs.php +29 -0
  89. lib/markbaker/complex/classes/src/functions/acos.php +38 -0
  90. lib/markbaker/complex/classes/src/functions/acosh.php +34 -0
  91. lib/markbaker/complex/classes/src/functions/acot.php +25 -0
  92. lib/markbaker/complex/classes/src/functions/acoth.php +25 -0
  93. lib/markbaker/complex/classes/src/functions/acsc.php +29 -0
  94. lib/markbaker/complex/classes/src/functions/acsch.php +29 -0
  95. lib/markbaker/complex/classes/src/functions/argument.php +28 -0
  96. lib/markbaker/complex/classes/src/functions/asec.php +29 -0
  97. lib/markbaker/complex/classes/src/functions/asech.php +29 -0
  98. lib/markbaker/complex/classes/src/functions/asin.php +37 -0
  99. lib/markbaker/complex/classes/src/functions/asinh.php +33 -0
  100. lib/markbaker/complex/classes/src/functions/atan.php +45 -0
  101. lib/markbaker/complex/classes/src/functions/atanh.php +38 -0
  102. lib/markbaker/complex/classes/src/functions/conjugate.php +28 -0
  103. lib/markbaker/complex/classes/src/functions/cos.php +34 -0
  104. lib/markbaker/complex/classes/src/functions/cosh.php +32 -0
  105. lib/markbaker/complex/classes/src/functions/cot.php +29 -0
  106. lib/markbaker/complex/classes/src/functions/coth.php +24 -0
  107. lib/markbaker/complex/classes/src/functions/csc.php +29 -0
  108. lib/markbaker/complex/classes/src/functions/csch.php +29 -0
  109. lib/markbaker/complex/classes/src/functions/exp.php +34 -0
  110. lib/markbaker/complex/classes/src/functions/inverse.php +29 -0
  111. lib/markbaker/complex/classes/src/functions/ln.php +33 -0
  112. lib/markbaker/complex/classes/src/functions/log10.php +32 -0
  113. lib/markbaker/complex/classes/src/functions/log2.php +32 -0
  114. lib/markbaker/complex/classes/src/functions/negative.php +31 -0
  115. lib/markbaker/complex/classes/src/functions/pow.php +40 -0
  116. lib/markbaker/complex/classes/src/functions/rho.php +28 -0
  117. lib/markbaker/complex/classes/src/functions/sec.php +25 -0
  118. lib/markbaker/complex/classes/src/functions/sech.php +25 -0
  119. lib/markbaker/complex/classes/src/functions/sin.php +32 -0
  120. lib/markbaker/complex/classes/src/functions/sinh.php +32 -0
  121. lib/markbaker/complex/classes/src/functions/sqrt.php +29 -0
  122. lib/markbaker/complex/classes/src/functions/tan.php +40 -0
  123. lib/markbaker/complex/classes/src/functions/tanh.php +35 -0
  124. lib/markbaker/complex/classes/src/functions/theta.php +38 -0
  125. lib/markbaker/complex/classes/src/operations/add.php +46 -0
  126. lib/markbaker/complex/classes/src/operations/divideby.php +56 -0
  127. lib/markbaker/complex/classes/src/operations/divideinto.php +56 -0
  128. lib/markbaker/complex/classes/src/operations/multiply.php +48 -0
  129. lib/markbaker/complex/classes/src/operations/subtract.php +46 -0
  130. lib/markbaker/complex/composer.json +91 -0
  131. lib/markbaker/complex/examples/complexTest.php +154 -0
  132. lib/markbaker/complex/examples/testFunctions.php +52 -0
  133. lib/markbaker/complex/examples/testOperations.php +34 -0
  134. lib/markbaker/complex/license.md +25 -0
  135. lib/phpExcel/PHPExcel.php +0 -1153
  136. lib/phpExcel/PHPExcel/Autoloader.php +0 -81
  137. lib/phpExcel/PHPExcel/CachedObjectStorage/APC.php +0 -290
  138. lib/phpExcel/PHPExcel/CachedObjectStorage/CacheBase.php +0 -368
  139. lib/phpExcel/PHPExcel/CachedObjectStorage/DiscISAM.php +0 -208
  140. lib/phpExcel/PHPExcel/CachedObjectStorage/ICache.php +0 -103
  141. lib/phpExcel/PHPExcel/CachedObjectStorage/Igbinary.php +0 -149
  142. lib/phpExcel/PHPExcel/CachedObjectStorage/Memcache.php +0 -308
  143. lib/phpExcel/PHPExcel/CachedObjectStorage/Memory.php +0 -118
  144. lib/phpExcel/PHPExcel/CachedObjectStorage/MemoryGZip.php +0 -133
  145. lib/phpExcel/PHPExcel/CachedObjectStorage/MemorySerialized.php +0 -129
  146. lib/phpExcel/PHPExcel/CachedObjectStorage/PHPTemp.php +0 -200
  147. lib/phpExcel/PHPExcel/CachedObjectStorage/SQLite.php +0 -307
  148. lib/phpExcel/PHPExcel/CachedObjectStorage/SQLite3.php +0 -346
  149. lib/phpExcel/PHPExcel/CachedObjectStorage/Wincache.php +0 -289
  150. lib/phpExcel/PHPExcel/CachedObjectStorageFactory.php +0 -231
  151. lib/phpExcel/PHPExcel/CalcEngine/CyclicReferenceStack.php +0 -94
  152. lib/phpExcel/PHPExcel/CalcEngine/Logger.php +0 -151
  153. lib/phpExcel/PHPExcel/Calculation.php +0 -4391
  154. lib/phpExcel/PHPExcel/Calculation/Database.php +0 -676
  155. lib/phpExcel/PHPExcel/Calculation/DateTime.php +0 -1553
  156. lib/phpExcel/PHPExcel/Calculation/Engineering.php +0 -2650
  157. lib/phpExcel/PHPExcel/Calculation/Exception.php +0 -46
  158. lib/phpExcel/PHPExcel/Calculation/ExceptionHandler.php +0 -45
  159. lib/phpExcel/PHPExcel/Calculation/Financial.php +0 -2359
  160. lib/phpExcel/PHPExcel/Calculation/FormulaParser.php +0 -622
  161. lib/phpExcel/PHPExcel/Calculation/FormulaToken.php +0 -176
  162. lib/phpExcel/PHPExcel/Calculation/Function.php +0 -148
  163. lib/phpExcel/PHPExcel/Calculation/Functions.php +0 -736
config/config.inc.php CHANGED
@@ -9,7 +9,7 @@ defined('ABSPATH') or die("Cannot access pages directly.");
9
 
10
  // Current version
11
 
12
- define('WDT_CURRENT_VERSION', '2.1.4');
13
 
14
  /**
15
  * Regular Expressions
9
 
10
  // Current version
11
 
12
+ define('WDT_CURRENT_VERSION', '2.1.5');
13
 
14
  /**
15
  * Regular Expressions
controllers/wdt_functions.php CHANGED
@@ -345,10 +345,10 @@ function wdtActivation($networkWide) {
345
  global $wpdb;
346
 
347
  // Check PHP version
348
- if (!defined('PHP_VERSION_ID') || PHP_VERSION_ID < 50400) {
349
  deactivate_plugins(WDT_BASENAME);
350
  wp_die(
351
- '<p>The <strong>wpDataTables Lite</strong> plugin requires PHP version 5.4 or greater.</p>',
352
  'Plugin Activation Error',
353
  ['response' => 200, 'back_link' => TRUE]
354
  );
345
  global $wpdb;
346
 
347
  // Check PHP version
348
+ if (!defined('PHP_VERSION_ID') || PHP_VERSION_ID < 50600) {
349
  deactivate_plugins(WDT_BASENAME);
350
  wp_die(
351
+ '<p>The <strong>wpDataTables Lite</strong> plugin requires PHP version 5.6 or greater.</p>',
352
  'Plugin Activation Error',
353
  ['response' => 200, 'back_link' => TRUE]
354
  );
lib/analog/analog/.gitignore ADDED
@@ -0,0 +1,2 @@
 
 
1
+ vendor/*
2
+ /composer.lock
lib/analog/analog/.travis.yml ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ language: php
2
+ php:
3
+ - 5.4
4
+ - 5.5
5
+ - 5.6
6
+ - 7.0
7
+ - 7.1
8
+ - 7.2
9
+ - 7.3
10
+
11
+ before_script: composer install --no-interaction --prefer-source
12
+ script:
13
+ - vendor/bin/phpunit --coverage-text --verbose
lib/analog/analog/LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ The MIT License
2
+
3
+ Copyright (c) 2012 Johnny Broadway
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
lib/analog/analog/README.md ADDED
@@ -0,0 +1,133 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # Analog - PHP micro logging package [![Build Status](https://travis-ci.org/jbroadway/analog.png)](https://travis-ci.org/jbroadway/analog)
2
+
3
+ * Copyright: (c) 2012-Present Johnny Broadway
4
+ * License: [MIT](http://www.opensource.org/licenses/mit-license.php)
5
+
6
+ <!-- a href='http://www.pledgie.com/campaigns/16595'><img alt='Click here to lend your support to: Analog and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/16595.png?skin_name=chrome' border='0' /></a -->
7
+
8
+ A PHP logging package based on the idea of using closures
9
+ for configurability and extensibility. It functions as a static class, but you can
10
+ completely control the writing of log messages through a closure function
11
+ (aka [anonymous functions](http://ca3.php.net/manual/en/functions.anonymous.php)),
12
+ or use the `Analog\Logger` wrapper that implements the
13
+ [PSR-3 specification](https://www.php-fig.org/psr/psr-3/).
14
+
15
+ ## Installation
16
+
17
+ Install the latest version with:
18
+
19
+ ```bash
20
+ $ composer require jbroadway/analog
21
+ ```
22
+
23
+ ## Usage
24
+
25
+ ### Basic Usage
26
+
27
+ ```php
28
+ <?php
29
+
30
+ use Analog\Analog;
31
+ use Analog\Handler\FirePHP;
32
+
33
+ Analog::handler (FirePHP::init ());
34
+
35
+ Analog::log ('Take me to your browser');
36
+ ```
37
+
38
+ ### Usage with [PSR-3](https://www.php-fig.org/psr/psr-3/)
39
+
40
+ ```php
41
+ <?php
42
+
43
+ use Analog\Logger;
44
+ use Analog\Handler\Variable;
45
+
46
+ $logger = new Logger;
47
+
48
+ $log = '';
49
+
50
+ $logger->handler (Variable::init ($log));
51
+
52
+ $logger->alert ('Things are really happening right now!');
53
+
54
+ var_dump ($log);
55
+ ```
56
+
57
+ ### Usage with a custom handler
58
+
59
+ ```php
60
+ <?php
61
+
62
+ use Analog\Analog;
63
+
64
+ // Default logging to /tmp/analog.txt
65
+ Analog::log ('Log this error');
66
+
67
+ // Log to a MongoDB log collection
68
+ Analog::handler (function ($info) {
69
+ static $conn = null;
70
+ if (! $conn) {
71
+ $conn = new Mongo ('localhost:27017');
72
+ }
73
+ $conn->mydb->log->insert ($info);
74
+ });
75
+
76
+ // Log an alert
77
+ Analog::log ('The sky is falling!', Analog::ALERT);
78
+
79
+ // Log some debug info
80
+ Analog::log ('Debugging info', Analog::DEBUG);
81
+ ```
82
+
83
+ For more examples, see the [examples](https://github.com/jbroadway/analog/tree/master/examples) folder.
84
+
85
+ ## Logging Options
86
+
87
+ By default, this class will write to a file named `sys_get_temp_dir() . '/analog.txt'`
88
+ using the format `"machine - date - level - message\n"`, making it usable with no
89
+ customization necessary.
90
+
91
+ Analog also comes with over a dozen pre-written handlers in the Analog/Handlers folder,
92
+ with examples for each in the examples folder. These include:
93
+
94
+ * Amon - Send logs to the [Amon](http://amon.cx/) server monitoring tool
95
+ * Apprise - Send notifications through the [apprise](https://github.com/caronc/apprise) command line tool
96
+ * Buffer - Buffer messages to send all at once (works with File, Mail, Stderr, and Variable handlers)
97
+ * ChromeLogger - Sends messages to [Chrome Logger](http://craig.is/writing/chrome-logger) browser plugin
98
+ * File - Append messages to a file
99
+ * FirePHP - Send messages to [FirePHP](http://www.firephp.org/) browser plugin
100
+ * GELF - Send message to the [Graylog2](http://www.graylog2.org/) log management server
101
+ * Ignore - Do nothing
102
+ * LevelBuffer - Buffer messages and send only if sufficient error level reached
103
+ * LevelName - Convert log level numbers to names in log output
104
+ * Mail - Send email notices
105
+ * Mongo - Save to MongoDB collection
106
+ * Multi - Send different log levels to different handlers
107
+ * PDO - Send messages to any PDO database connection (MySQL, SQLite, PostgreSQL, etc.)
108
+ * Post - Send messages over HTTP POST to another machine
109
+ * Slackbot - Post messages to Slack via Slackbot
110
+ * Stderr - Send messages to STDERR
111
+ * Syslog - Send messages to syslog
112
+ * Threshold - Only writes log messages above a certain threshold
113
+ * Variable - Buffer messages to a variable reference.
114
+
115
+ So while it's a micro class, it's highly extensible and very capable out of the box too.
116
+
117
+ ## Rationale
118
+
119
+ I wrote this because I wanted something very small and simple like
120
+ [KLogger](https://github.com/katzgrau/KLogger), and preferably not torn out
121
+ of a wider framework if possible. After searching, I wasn't happy with the
122
+ single-purpose libraries I found. With KLogger for example, I didn't want an
123
+ object instance but rather a static class, and I wanted more flexibility in
124
+ the back-end.
125
+
126
+ I also found some that had the flexibility also had more complexity, for example
127
+ [Monolog](https://github.com/Seldaek/monolog) is dozens of source files (not incl. tests).
128
+ With closures, this seemed to be a good balance of small without sacrificing
129
+ flexibility.
130
+
131
+ > What about Analog, the logfile analyzer? Well, since it hasn't been updated
132
+ > since 2004, I think it's safe to call a single-file PHP logging class the
133
+ > same thing without it being considered stepping on toes :)
lib/analog/analog/composer.json ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "analog/analog",
3
+ "type": "library",
4
+ "description": "PHP logging class that can be extended via closures. Includes several pre-built handlers including file, mail, syslog, HTTP post, and MongoDB.",
5
+ "keywords": ["log", "logging", "logger", "syslog", "error", "debug", "debugging", "alerts"],
6
+ "homepage": "https://github.com/jbroadway/analog",
7
+ "license": "MIT",
8
+ "authors": [
9
+ {
10
+ "name": "Johnny Broadway",
11
+ "email": "johnny@johnnybroadway.com",
12
+ "homepage": "http://www.johnnybroadway.com/"
13
+ }
14
+ ],
15
+ "require": {
16
+ "psr/log": "1.*",
17
+ "php": ">=5.3.2"
18
+ },
19
+ "require-dev": {
20
+ "phpunit/phpunit": "^4.8.36 || ^5.7 || ^6.5"
21
+ },
22
+ "autoload": {
23
+ "psr-0": {
24
+ "Analog": "lib/"
25
+ }
26
+ }
27
+ }
lib/analog/analog/examples/SplClassLoader.php ADDED
@@ -0,0 +1,155 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /*
4
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
5
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
6
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
7
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
8
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
9
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
10
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
11
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
12
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
13
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
14
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
15
+ *
16
+ * This software consists of voluntary contributions made by many individuals
17
+ * and is licensed under the MIT license. For more information, see
18
+ * <http://www.doctrine-project.org>.
19
+ */
20
+
21
+ /**
22
+ * SplClassLoader implementation that implements the technical interoperability
23
+ * standards for PHP 5.3 namespaces and class names.
24
+ *
25
+ * http://groups.google.com/group/php-standards/web/psr-0-final-proposal?pli=1
26
+ *
27
+ * // Example which loads classes for the Doctrine Common package in the
28
+ * // Doctrine\Common namespace.
29
+ * $classLoader = new SplClassLoader('Doctrine\Common', '/path/to/doctrine');
30
+ * $classLoader->register();
31
+ *
32
+ * @license http://www.opensource.org/licenses/mit-license.html MIT License
33
+ * @author Jonathan H. Wage <jonwage@gmail.com>
34
+ * @author Roman S. Borschel <roman@code-factory.org>
35
+ * @author Matthew Weier O'Phinney <matthew@zend.com>
36
+ * @author Kris Wallsmith <kris.wallsmith@gmail.com>
37
+ * @author Fabien Potencier <fabien.potencier@symfony-project.org>
38
+ */
39
+ class SplClassLoader
40
+ {
41
+ private $_fileExtension = '.php';
42
+ private $_namespace;
43
+ private $_includePath;
44
+ private $_namespaceSeparator = '\\';
45
+
46
+ /**
47
+ * Creates a new <tt>SplClassLoader</tt> that loads classes of the
48
+ * specified namespace.
49
+ *
50
+ * @param string $ns The namespace to use.
51
+ */
52
+ public function __construct($ns = null, $includePath = null)
53
+ {
54
+ $this->_namespace = $ns;
55
+ $this->_includePath = $includePath;
56
+ }
57
+
58
+ /**
59
+ * Sets the namespace separator used by classes in the namespace of this class loader.
60
+ *
61
+ * @param string $sep The separator to use.
62
+ */
63
+ public function setNamespaceSeparator($sep)
64
+ {
65
+ $this->_namespaceSeparator = $sep;
66
+ }
67
+
68
+ /**
69
+ * Gets the namespace seperator used by classes in the namespace of this class loader.
70
+ *
71
+ * @return void
72
+ */
73
+ public function getNamespaceSeparator()
74
+ {
75
+ return $this->_namespaceSeparator;
76
+ }
77
+
78
+ /**
79
+ * Sets the base include path for all class files in the namespace of this class loader.
80
+ *
81
+ * @param string $includePath
82
+ */
83
+ public function setIncludePath($includePath)
84
+ {
85
+ $this->_includePath = $includePath;
86
+ }
87
+
88
+ /**
89
+ * Gets the base include path for all class files in the namespace of this class loader.
90
+ *
91
+ * @return string $includePath
92
+ */
93
+ public function getIncludePath()
94
+ {
95
+ return $this->_includePath;
96
+ }
97
+
98
+ /**
99
+ * Sets the file extension of class files in the namespace of this class loader.
100
+ *
101
+ * @param string $fileExtension
102
+ */
103
+ public function setFileExtension($fileExtension)
104
+ {
105
+ $this->_fileExtension = $fileExtension;
106
+ }
107
+
108
+ /**
109
+ * Gets the file extension of class files in the namespace of this class loader.
110
+ *
111
+ * @return string $fileExtension
112
+ */
113
+ public function getFileExtension()
114
+ {
115
+ return $this->_fileExtension;
116
+ }
117
+
118
+ /**
119
+ * Installs this class loader on the SPL autoload stack.
120
+ */
121
+ public function register()
122
+ {
123
+ spl_autoload_register(array($this, 'loadClass'));
124
+ }
125
+
126
+ /**
127
+ * Uninstalls this class loader from the SPL autoloader stack.
128
+ */
129
+ public function unregister()
130
+ {
131
+ spl_autoload_unregister(array($this, 'loadClass'));
132
+ }
133
+
134
+ /**
135
+ * Loads the given class or interface.
136
+ *
137
+ * @param string $className The name of the class to load.
138
+ * @return void
139
+ */
140
+ public function loadClass($className)
141
+ {
142
+ if (null === $this->_namespace || $this->_namespace.$this->_namespaceSeparator === substr($className, 0, strlen($this->_namespace.$this->_namespaceSeparator))) {
143
+ $fileName = '';
144
+ $namespace = '';
145
+ if (false !== ($lastNsPos = strripos($className, $this->_namespaceSeparator))) {
146
+ $namespace = substr($className, 0, $lastNsPos);
147
+ $className = substr($className, $lastNsPos + 1);
148
+ $fileName = str_replace($this->_namespaceSeparator, DIRECTORY_SEPARATOR, $namespace) . DIRECTORY_SEPARATOR;
149
+ }
150
+ $fileName .= str_replace('_', DIRECTORY_SEPARATOR, $className) . $this->_fileExtension;
151
+
152
+ require ($this->_includePath !== null ? $this->_includePath . DIRECTORY_SEPARATOR : '') . $fileName;
153
+ }
154
+ }
155
+ }
lib/analog/analog/examples/amon.php ADDED
@@ -0,0 +1,16 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // 1. Install the Amon PHP lib from http://amon.cx/guide/clients/php/
4
+ require 'amon.php';
5
+
6
+ require '../lib/Analog.php';
7
+
8
+ Analog::handler (Analog\Handler\Amon::init (
9
+ 'http://127.0.0.1',
10
+ 2464
11
+ ));
12
+
13
+ Analog::log ('Error message');
14
+ Analog::log ('Debug info', Analog::DEBUG);
15
+
16
+ ?>
lib/analog/analog/examples/apprise.php ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $command = '/usr/local/bin/apprise';
6
+ $service = 'slack://tokenA/tokenB/tokenC/#slack-channel';
7
+ Analog::handler (Analog\Handler\Apprise::init ($command, $service));
8
+
9
+ Analog::log ('Output to apprise command');
10
+
11
+ ?>
lib/analog/analog/examples/buffer.php ADDED
@@ -0,0 +1,18 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Buffer::init (
6
+ Analog\Handler\Mail::init (
7
+ 'you@example.com',
8
+ 'Log messages',
9
+ 'noreply@example.com'
10
+ )
11
+ ));
12
+
13
+ // will all be sent as one email instead of three
14
+ Analog::log ('Message one');
15
+ Analog::log ('Message two');
16
+ Analog::log ('Message three');
17
+
18
+ ?>
lib/analog/analog/examples/chromelogger.php ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\ChromeLogger::init ());
6
+
7
+ // debug-level message
8
+ Analog::debug ($_SERVER);
9
+
10
+ // an info message
11
+ Analog::info ('An error message');
12
+
13
+ // a warning message
14
+ Analog::warning ('Turn back before it\'s too late');
15
+
16
+ // an error with no file/line #'s
17
+ Analog::log ('Another error message');
18
+
19
+ ?>
lib/analog/analog/examples/default.php ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::log ('foo');
6
+ Analog::log ('bar');
7
+
8
+ echo file_get_contents (Analog::handler ());
9
+ unlink (Analog::handler ());
10
+
11
+ ?>
lib/analog/analog/examples/file.php ADDED
@@ -0,0 +1,15 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $log_file = 'log.txt';
6
+
7
+ Analog::handler (Analog\Handler\File::init ($log_file));
8
+
9
+ Analog::log ('foo');
10
+ Analog::log ('bar');
11
+
12
+ echo file_get_contents ($log_file);
13
+ unlink ($log_file);
14
+
15
+ ?>
lib/analog/analog/examples/firephp.php ADDED
@@ -0,0 +1,16 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\FirePHP::init ());
6
+
7
+ // debug-level message
8
+ Analog::log (array ('A debug message', __FILE__, __LINE__), Analog::DEBUG);
9
+
10
+ // an info message
11
+ Analog::log (array ('An error message', __FILE__, __LINE__), Analog::INFO);
12
+
13
+ // an error with no file/line #'s
14
+ Analog::log ('Another error message');
15
+
16
+ ?>
lib/analog/analog/examples/gelf.php ADDED
@@ -0,0 +1,16 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // 1. Install the GELF classes from https://github.com/Graylog2/gelf-php
4
+ require 'GELFMessage.php';
5
+ require 'GELFMessagePublisher.php';
6
+
7
+ require '../lib/Analog.php';
8
+
9
+ Analog::handler (Analog\Handler\GELF::init (
10
+ 'localhost'
11
+ ));
12
+
13
+ Analog::log ('Error message');
14
+ Analog::log (array ('Debug info', __FILE__, __LINE__), Analog::DEBUG);
15
+
16
+ ?>
lib/analog/analog/examples/ignore.php ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Ignore::init ());
6
+
7
+ Analog::log ('Hellooooooo');
8
+
9
+ ?>
lib/analog/analog/examples/levelbuffer.php ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $log = '';
6
+
7
+ Analog::handler (Analog\Handler\LevelBuffer::init (
8
+ Analog\Handler\Variable::init ($log),
9
+ Analog::CRITICAL
10
+ ));
11
+
12
+ // none of these will trigger sending the log
13
+ Analog::log ('Debugging...', Analog::DEBUG);
14
+ Analog::log ('Minor warning...', Analog::WARNING);
15
+ Analog::log ('An error...', Analog::ERROR);
16
+
17
+ echo "Log is still empty:\n" . $log . "\n";
18
+
19
+ // but this will, and will include all the others in the log
20
+ Analog::log ('Oh noes!', Analog::URGENT);
21
+
22
+ echo "Log now has everything:\n" . $log;
23
+
24
+ ?>
lib/analog/analog/examples/mail.php ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Mail::init (
6
+ 'you@example.com',
7
+ 'Log message',
8
+ 'noreply@example.com'
9
+ ));
10
+
11
+ Analog::log ('Error message');
12
+
13
+ ?>
lib/analog/analog/examples/mongo.php ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Mongo::init (
6
+ 'localhost:27017',
7
+ 'testing',
8
+ 'log'
9
+ ));
10
+
11
+ Analog::log ('Error message');
12
+ Analog::log ('Debug info', Analog::DEBUG);
13
+
14
+ $m = new MongoClient ('mongodb://localhost:27017');
15
+ $cur = $m->testing->log->find ();
16
+ foreach ($cur as $doc) {
17
+ print_r ($doc);
18
+ }
19
+ $m->testing->log->remove ();
20
+
21
+ ?>
lib/analog/analog/examples/multi.php ADDED
@@ -0,0 +1,27 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $errors = "Errors:\n";
6
+ $warnings = "Warnings:\n";
7
+ $debug = "Debug:\n";
8
+
9
+ Analog::handler (Analog\Handler\Multi::init (array (
10
+ Analog::ERROR => Analog\Handler\Variable::init ($errors),
11
+ Analog::WARNING => Analog\Handler\Variable::init ($warnings),
12
+ Analog::DEBUG => Analog\Handler\Variable::init ($debug)
13
+ )));
14
+
15
+ Analog::log ('First error');
16
+ Analog::log ('Emergency!', Analog::URGENT);
17
+ Analog::log ('A warning...', Analog::WARNING);
18
+ Analog::log ('Some info', Analog::INFO);
19
+ Analog::log ('Debugging output', Analog::DEBUG);
20
+
21
+ echo $errors;
22
+ echo "-----\n";
23
+ echo $warnings;
24
+ echo "-----\n";
25
+ echo $debug;
26
+
27
+ ?>
lib/analog/analog/examples/pdo.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $pdo = new PDO ('sqlite:example.sqlite', '', '', [
6
+ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
7
+ PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_OBJ
8
+ ]);
9
+
10
+ $table = 'logs';
11
+
12
+ // Helper method for creating the database table
13
+ Analog\Handler\PDO::createTable ($pdo, $table);
14
+
15
+ // Initialize Analog with your PDO connection and table
16
+ Analog::handler (Analog\Handler\PDO::init ($pdo, $table));
17
+
18
+ // Log some messages
19
+ Analog::log ('Error message');
20
+ Analog::log ('Debug info', Analog::DEBUG);
21
+
22
+ // Fetch all to show it worked
23
+ foreach ($pdo->query ('select * from `' . $table . '`') as $row) {
24
+ print_r ($row);
25
+ }
26
+
27
+ // Cleanup
28
+ $pdo = null;
29
+ unlink ('example.sqlite');
lib/analog/analog/examples/post.php ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $log = '';
6
+
7
+ Analog::handler (Analog\Handler\Post::init ('http://localhost:8080/'));
8
+
9
+ Analog::log ('foo');
10
+ Analog::log ('bar');
11
+
12
+ echo $log;
13
+
14
+ ?>
lib/analog/analog/examples/psr-0.php ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require 'SplClassLoader.php';
4
+
5
+ $loader = new SplClassLoader ('Analog', '../lib');
6
+ $loader->register ();
7
+
8
+ use \Analog\Analog;
9
+
10
+ $log = '';
11
+
12
+ Analog::handler (\Analog\Handler\Variable::init ($log));
13
+
14
+ Analog::log ('Test one');
15
+ Analog::log ('Test two');
16
+
17
+ echo $log;
18
+
19
+ ?>
lib/analog/analog/examples/server.php ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ * This works with test_post.php to verify sent data.
5
+ * Run me via:
6
+ *
7
+ * php -S localhost:8080 server.php
8
+ *
9
+ * Note: Requires PHP 5.4+
10
+ */
11
+ file_put_contents ('php://stdout', 'Logged: ' . join (' - ', $_POST) . "\n");
12
+
13
+ ?>
lib/analog/analog/examples/slackbot.php ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Slackbot::init ('teamname', 'token', 'channel'));
6
+
7
+ Analog::log ('Error message', Analog::WARNING);
8
+
9
+ ?>
lib/analog/analog/examples/stderr.php ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Stderr::init ());
6
+
7
+ Analog::log ('Output to php://stderr');
8
+
9
+ ?>
lib/analog/analog/examples/syslog.php ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ Analog::handler (Analog\Handler\Syslog::init ('analog', 'user'));
6
+
7
+ Analog::log ('Error message', Analog::WARNING);
8
+
9
+ ?>
lib/analog/analog/examples/threshold.php ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $log = '';
6
+
7
+ Analog::handler (Analog\Handler\Threshold::init (
8
+ Analog\Handler\Variable::init ($log),
9
+ Analog::ERROR
10
+ ));
11
+
12
+ // these will be ignored
13
+ Analog::log ('Debugging...', Analog::DEBUG);
14
+ Analog::log ('Minor warning...', Analog::WARNING);
15
+
16
+ echo "Log is still empty:\n" . $log . "\n";
17
+
18
+ // but these will be logged
19
+ Analog::log ('An error...', Analog::ERROR);
20
+ Analog::log ('Oh noes!', Analog::URGENT);
21
+
22
+ echo "Log now has everything:\n" . $log;
23
+
24
+ ?>
lib/analog/analog/examples/variable.php ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require '../lib/Analog.php';
4
+
5
+ $log = '';
6
+
7
+ Analog::handler (Analog\Handler\Variable::init ($log));
8
+
9
+ Analog::log ('foo');
10
+ Analog::log ('bar');
11
+
12
+ echo $log;
13
+
14
+ ?>
lib/analog/analog/lib/Analog.php ADDED
@@ -0,0 +1,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ * Register a very simple autoloader for the pre-built handlers
5
+ * based on the current working directory.
6
+ */
7
+ spl_autoload_register (function ($class) {
8
+ $file = str_replace ('\\', DIRECTORY_SEPARATOR, ltrim ($class, '\\')) . '.php';
9
+ if (file_exists (__DIR__ . DIRECTORY_SEPARATOR . $file)) {
10
+ require_once $file;
11
+ return true;
12
+ }
13
+ return false;
14
+ });
15
+
16
+ /**
17
+ * We simply alias extend the main class so that Analog is
18
+ * available as a global class. This saves us adding
19
+ * `use \Analog\Analog` at the top of every file,
20
+ * or worse, typeing `\Analog\Analog::log()` everywhere.
21
+ */
22
+ class_alias ('\Analog\Analog', 'Analog');
lib/analog/analog/lib/Analog/Analog.php ADDED
@@ -0,0 +1,265 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog;
4
+
5
+ /**
6
+ * Analog - PHP 5.3+ logging class
7
+ *
8
+ * Copyright (c) 2012 Johnny Broadway
9
+ *
10
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
11
+ * of this software and associated documentation files (the "Software"), to deal
12
+ * in the Software without restriction, including without limitation the rights
13
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14
+ * copies of the Software, and to permit persons to whom the Software is furnished
15
+ * to do so, subject to the following conditions:
16
+ *
17
+ * The above copyright notice and this permission notice shall be included in all
18
+ * copies or substantial portions of the Software.
19
+ *
20
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
23
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
26
+ * THE SOFTWARE.
27
+ */
28
+
29
+ /**
30
+ * A short and simple logging class for based on the idea of using closures for
31
+ * configurability and extensibility. Functions as a static class, but you can
32
+ * completely control the formatting and writing of log messages through closures.
33
+ *
34
+ * By default, this class will write to a file named /tmp/log.txt using a format
35
+ * "machine - date - level - message\n".
36
+ *
37
+ * I wrote this because I wanted something simple and small like KLogger, and
38
+ * preferably not torn out of a wider framework if possible. After searching,
39
+ * I wasn't happy with the single-purpose libraries I found. With KLogger for
40
+ * example, I didn't want an object instance but rather a static class, and I
41
+ * wanted more flexibility in the back-end.
42
+ *
43
+ * I also found that the ones that had really flexible back-ends supported a lot
44
+ * that I could never personally foresee needing, and could be easier to extend
45
+ * with new back-ends that may be needed over time. Closures seem a natural fit for
46
+ * this kind of thing.
47
+ *
48
+ * What about Analog, the logfile analyzer? Well, since it hasn't been updated
49
+ * since 2004, I think it's safe to call a single-file PHP logging class the
50
+ * same thing without it being considered stepping on toes :)
51
+ *
52
+ * Usage:
53
+ *
54
+ * <?php
55
+ *
56
+ * require_once ('Analog.php');
57
+ *
58
+ * // Default logging to /tmp/analog.txt
59
+ * Analog::log ('Log this error');
60
+ *
61
+ * // Log to a MongoDB log collection
62
+ * Analog::handler (function ($info) {
63
+ * static $conn = null;
64
+ * if (! $conn) {
65
+ * $conn = new Mongo ('localhost:27017');
66
+ * }
67
+ * $conn->mydb->log->insert ($info);
68
+ * });
69
+ *
70
+ * // Log an alert
71
+ * Analog::log ('The sky is falling!', Analog::ALERT);
72
+ *
73
+ * // Log some debug info
74
+ * Analog::log ('Debugging info', Analog::DEBUG);
75
+ *
76
+ * ?>
77
+ *
78
+ * @package Analog
79
+ * @author Johnny Broadway
80
+ */
81
+ class Analog {
82
+ /**
83
+ * List of severity levels.
84
+ */
85
+ const URGENT = 0; // It's an emergency
86
+ const ALERT = 1; // Immediate action required
87
+ const CRITICAL = 2; // Critical conditions
88
+ const ERROR = 3; // An error occurred
89
+ const WARNING = 4; // Something unexpected happening
90
+ const NOTICE = 5; // Something worth noting
91
+ const INFO = 6; // Information, not an error
92
+ const DEBUG = 7; // Debugging messages
93
+
94
+ /**
95
+ * The default format for log messages (machine, date, level, message)
96
+ * written to a file. To change the order of items in the string,
97
+ * use `%1$s` references.
98
+ */
99
+ public static $format = "%s - %s - %d - %s\n";
100
+
101
+ /**
102
+ * The default date/time format for log messages written to a file.
103
+ * Feeds into the `$format` property.
104
+ */
105
+ public static $date_format = 'Y-m-d H:i:s';
106
+
107
+ /**
108
+ * Timezone for date/time values.
109
+ */
110
+ public static $timezone = 'GMT';
111
+
112
+ /**
113
+ * Default log level.
114
+ */
115
+ public static $default_level = 3;
116
+
117
+ /**
118
+ * The method of saving the log output. See Analog::handler()
119
+ * for details on setting this.
120
+ */
121
+ private static $handler = null;
122
+
123
+ /**
124
+ * The name of the current machine, defaults to $_SERVER['SERVER_ADDR']
125
+ * on first call to format_message(), or 'localhost' if $_SERVER['SERVER_ADDR']
126
+ * is not set (e.g., during CLI use).
127
+ */
128
+ public static $machine = null;
129
+
130
+ /**
131
+ * Handler getter/setter. If no handler is provided, it will set it to
132
+ * sys_get_temp_dir() . '/analog.txt' as a default. Usage:
133
+ *
134
+ * Analog::handler ('my_log.txt');
135
+ *
136
+ * Using a closure:
137
+ *
138
+ * Analog::handler (function ($msg) {
139
+ * return error_log ($msg);
140
+ * });
141
+ */
142
+ public static function handler ($handler = false) {
143
+ if ($handler) {
144
+ self::$handler = $handler;
145
+ } elseif (! self::$handler) {
146
+ self::$handler = realpath (sys_get_temp_dir ()) . DIRECTORY_SEPARATOR . 'analog.txt';
147
+ }
148
+ return self::$handler;
149
+ }
150
+
151
+ /**
152
+ * Get the log info as an associative array.
153
+ */
154
+ private static function get_struct ($message, $level) {
155
+ if (self::$machine === null) {
156
+ self::$machine = (isset ($_SERVER['SERVER_ADDR'])) ? $_SERVER['SERVER_ADDR'] : 'localhost';
157
+ }
158
+
159
+ $dt = new \DateTime ('now', new \DateTimeZone (self::$timezone));
160
+
161
+ return array (
162
+ 'machine' => self::$machine,
163
+ 'date' => $dt->format (self::$date_format),
164
+ 'level' => $level,
165
+ 'message' => $message
166
+ );
167
+ }
168
+
169
+ /**
170
+ * Write a raw message to the log using a function or the default
171
+ * file logging.
172
+ */
173
+ private static function write ($struct) {
174
+ $handler = self::handler ();
175
+
176
+ if (! $handler instanceof \Closure) {
177
+ $handler = \Analog\Handler\File::init ($handler);
178
+ }
179
+ return $handler ($struct);
180
+ }
181
+
182
+ /**
183
+ * This is the main function you will call to log messages.
184
+ * Defaults to severity level Analog::ERROR, which can be
185
+ * changed via the `$default_level` property.
186
+ * Usage:
187
+ *
188
+ * Analog::log ('Debug info', Analog::DEBUG);
189
+ */
190
+ public static function log ($message, $level = null) {
191
+ $level = ($level !== null) ? $level : self::$default_level;
192
+ return self::write (self::get_struct ($message, $level));
193
+ }
194
+
195
+ /**
196
+ * Shortcut method for Analog::log($info, Analog::URGENT)
197
+ * Usage:
198
+ *
199
+ * Analog::urgent ('Debug info');
200
+ */
201
+ public static function urgent ($message) {
202
+ return self::write (self::get_struct ($message, self::URGENT));
203
+ }
204
+
205
+ /**
206
+ * Shortcut method for Analog::log($info, Analog::ALERT)
207
+ * Usage:
208
+ *
209
+ * Analog::alert ('Debug info');
210
+ */
211
+ public static function alert ($message) {
212
+ return self::write (self::get_struct ($message, self::ALERT));
213
+ }
214
+
215
+ /**
216
+ * Shortcut method for Analog::log($info, Analog::ERROR)
217
+ * Usage:
218
+ *
219
+ * Analog::error ('Debug info');
220
+ */
221
+ public static function error ($message) {
222
+ return self::write (self::get_struct ($message, self::ERROR));
223
+ }
224
+
225
+ /**
226
+ * Shortcut method for Analog::log($info, Analog::WARNING)
227
+ * Usage:
228
+ *
229
+ * Analog::warning ('Debug info');
230
+ */
231
+ public static function warning ($message) {
232
+ return self::write (self::get_struct ($message, self::WARNING));
233
+ }
234
+
235
+ /**
236
+ * Shortcut method for Analog::log($info, Analog::NOTICE)
237
+ * Usage:
238
+ *
239
+ * Analog::notice ('Debug info');
240
+ */
241
+ public static function notice ($message) {
242
+ return self::write (self::get_struct ($message, self::NOTICE));
243
+ }
244
+
245
+ /**
246
+ * Shortcut method for Analog::log($info, Analog::INFO)
247
+ * Usage:
248
+ *
249
+ * Analog::info ('Debug info');
250
+ */
251
+ public static function info ($message) {
252
+ return self::write (self::get_struct ($message, self::INFO));
253
+ }
254
+
255
+ /**
256
+ * Shortcut method for Analog::log($info, Analog::DEBUG)
257
+ * Usage:
258
+ *
259
+ * Analog::debug ('Debug info');
260
+ */
261
+ public static function debug ($message) {
262
+ return self::write (self::get_struct ($message, self::DEBUG));
263
+ }
264
+
265
+ }
lib/analog/analog/lib/Analog/Handler/Amon.php ADDED
@@ -0,0 +1,43 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to an Amon monitoring server (http://amon.cx/).
7
+ *
8
+ * Usage:
9
+ *
10
+ * // First include the Amon classes
11
+ * require 'amon.php';
12
+ *
13
+ * // Initialize the Analog Amon handler
14
+ * Analog::handler (Analog\Handler\Amon::init (
15
+ * 'http://127.0.0.1', // server address
16
+ * 2464, // port number
17
+ * 'abc123def456' // application key
18
+ * ));
19
+ */
20
+ class Amon {
21
+ public static function init ($host = 'http://127.0.0.1', $port = 2464, $key = false) {
22
+ \Amon::config (array (
23
+ 'host' => $host,
24
+ 'port' => $port,
25
+ 'application_key' => $key
26
+ ));
27
+
28
+ $tags = array (
29
+ 0 => 'urgent',
30
+ 1 => 'alert',
31
+ 2 => 'critical',
32
+ 3 => 'error',
33
+ 4 => 'warning',
34
+ 5 => 'notice',
35
+ 6 => 'info',
36
+ 7 => 'debug'
37
+ );
38
+
39
+ return function ($info) use ($tags) {
40
+ \Amon::log ($info, array ($tags[$info['level']]));
41
+ };
42
+ }
43
+ }
lib/analog/analog/lib/Analog/Handler/Apprise.php ADDED
@@ -0,0 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the output to the apprise command line tool (https://github.com/caronc/apprise).
7
+ *
8
+ * Usage:
9
+ *
10
+ * $command = '/usr/local/bin/apprise';
11
+ * $service = 'slack://tokenA/tokenB/tokenC/#slack-channel';
12
+ * Analog::handler (Analog\Handler\Apprise::init ($command, $service));
13
+ *
14
+ * Analog::log ('Log me');
15
+ *
16
+ * Notes:
17
+ *
18
+ * - $service may also be an array of services.
19
+ * - Uses Analog::$format for the appending format.
20
+ */
21
+ class Apprise {
22
+ public static function init ($command, $service) {
23
+ return function ($info) use ($command, $service) {
24
+ if (is_array ($service)) {
25
+ $service = array_map ('escapeshellarg', $service);
26
+ $service = join (' ', $service);
27
+ } else {
28
+ $service = escapeshellarg ($service);
29
+ }
30
+
31
+ exec (
32
+ sprintf ('%s -b %s %s',
33
+ $command,
34
+ escapeshellarg (vsprintf (\Analog\Analog::$format, $info)),
35
+ $service
36
+ )
37
+ );
38
+ };
39
+ }
40
+ }
lib/analog/analog/lib/Analog/Handler/Buffer.php ADDED
@@ -0,0 +1,59 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Buffers messages to be sent as a batch to another handler at the end
7
+ * of the request. Currently only works with the Mail handler.
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler (Analog\Handler\Buffer::init (
12
+ * Analog\Handler\Mail::init ($to, $subject, $from)
13
+ * ));
14
+ *
15
+ * // will all be buffered into one email
16
+ * Analog::log ('Message one', Analog::DEBUG);
17
+ * Analog::log ('Message two', Analog::WARNING);
18
+ * Analog::log ('Message three', Analog::ERROR);
19
+ *
20
+ * Note: Uses Analog::$format to format the messages as they're appended
21
+ * to the buffer.
22
+ */
23
+ class Buffer {
24
+ /**
25
+ * This builds a log string of all messages logged.
26
+ */
27
+ public static $buffer = '';
28
+
29
+ /**
30
+ * This contains the handler to send to on close.
31
+ */
32
+ private static $handler;
33
+
34
+ /**
35
+ * A copy of our destructor object that will call close() on our behalf,
36
+ * since static classes can't have their own __destruct() methods.
37
+ */
38
+ private static $destructor;
39
+
40
+ /**
41
+ * Accepts another handler function to be used on close().
42
+ */
43
+ public static function init ($handler) {
44
+ self::$handler = $handler;
45
+ self::$destructor = new \Analog\Handler\Buffer\Destructor ();
46
+
47
+ return function ($info) {
48
+ Buffer::$buffer .= vsprintf (\Analog\Analog::$format, $info);
49
+ };
50
+ }
51
+
52
+ /**
53
+ * Passes the buffered log to the final $handler.
54
+ */
55
+ public static function close () {
56
+ $handler = self::$handler;
57
+ return $handler (self::$buffer, true);
58
+ }
59
+ }
lib/analog/analog/lib/Analog/Handler/Buffer/Destructor.php ADDED
@@ -0,0 +1,12 @@
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler\Buffer;
4
+
5
+ /**
6
+ * A destructor object to call close() for us at the end of the request.
7
+ */
8
+ class Destructor {
9
+ public function __destruct () {
10
+ \Analog\Handler\Buffer::close ();
11
+ }
12
+ }
lib/analog/analog/lib/Analog/Handler/ChromeLogger.php ADDED
@@ -0,0 +1,44 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ require_once __DIR__ . '/../../ChromePhp.php';
6
+
7
+ /**
8
+ * Log to the [Chrome Logger](http://craig.is/writing/chrome-logger).
9
+ * Based on the [ChromePhp library](https://github.com/ccampbell/chromephp).
10
+ *
11
+ * Usage:
12
+ *
13
+ * Analog::handler (Analog\Handler\ChromeLogger::init ());
14
+ *
15
+ * // send a debug message
16
+ * Analog::debug ($an_object);
17
+ *
18
+ * // send an ordinary message
19
+ * Analog::info ('An error message');
20
+ */
21
+ class ChromeLogger {
22
+ public static function init () {
23
+ return function ($info) {
24
+ switch ($info['level']) {
25
+ case \Analog\Analog::DEBUG:
26
+ \ChromePhp::log ($info['message']);
27
+ break;
28
+ case \Analog\Analog::INFO:
29
+ case \Analog\Analog::NOTICE:
30
+ \ChromePhp::info ($info['message']);
31
+ break;
32
+ case \Analog\Analog::WARNING:
33
+ \ChromePhp::warn ($info['message']);
34
+ break;
35
+ case \Analog\Analog::ERROR:
36
+ case \Analog\Analog::CRITICAL:
37
+ case \Analog\Analog::ALERT:
38
+ case \Analog\Analog::URGENT:
39
+ \ChromePhp::error ($info['message']);
40
+ break;
41
+ }
42
+ };
43
+ }
44
+ }
lib/analog/analog/lib/Analog/Handler/File.php ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Append to the specified log file. Does the same thing as the default
7
+ * handling.
8
+ *
9
+ * Usage:
10
+ *
11
+ * $log_file = 'log.txt';
12
+ * Analog::handler (Analog\Handler\File::init ($log_file));
13
+ *
14
+ * Analog::log ('Log me');
15
+ *
16
+ * Note: Uses Analog::$format for the appending format.
17
+ */
18
+ class File {
19
+ public static function init ($file) {
20
+ return function ($info, $buffered = false) use ($file) {
21
+ $f = fopen ($file, 'a+');
22
+ if (! $f) {
23
+ throw new \LogicException ('Could not open file for writing');
24
+ }
25
+
26
+ if (! flock ($f, LOCK_EX)) {
27
+ throw new \RuntimeException ('Could not lock file');
28
+ }
29
+
30
+ fwrite ($f, ($buffered)
31
+ ? $info
32
+ : vsprintf (\Analog\Analog::$format, $info));
33
+ flock ($f, LOCK_UN);
34
+ fclose ($f);
35
+ };
36
+ }
37
+ }
lib/analog/analog/lib/Analog/Handler/FirePHP.php ADDED
@@ -0,0 +1,77 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Log via FirePHP using the Wildfire protocol (http://www.firephp.org/).
7
+ * Based loosely on the Monolog FirePHP handler.
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler (Analog\Handler\FirePHP::init ());
12
+ *
13
+ * // send a debug message with file and line number
14
+ * Analog::log (array ('Log me', __FILE__, __LINE__), Analog::DEBUG);
15
+ *
16
+ * // send an ordinary message
17
+ * Analog::log ('An error message');
18
+ */
19
+ class FirePHP {
20
+ /**
21
+ * Translation list for log levels.
22
+ */
23
+ private static $log_levels = array (
24
+ \Analog\Analog::DEBUG => 'LOG',
25
+ \Analog\Analog::INFO => 'INFO',
26
+ \Analog\Analog::NOTICE => 'INFO',
27
+ \Analog\Analog::WARNING => 'WARN',
28
+ \Analog\Analog::ERROR => 'ERROR',
29
+ \Analog\Analog::CRITICAL => 'ERROR',
30
+ \Analog\Analog::ALERT => 'ERROR',
31
+ \Analog\Analog::URGENT => 'ERROR'
32
+ );
33
+
34
+ /**
35
+ * Message index increases by 1 each time a message is sent.
36
+ */
37
+ private static $message_index = 1;
38
+
39
+ /**
40
+ * Formats a log header to be sent.
41
+ */
42
+ public static function format_header ($info) {
43
+ if (is_array ($info['message'])) {
44
+ $extra = array (
45
+ 'Type' => self::$log_levels[$info['level']],
46
+ 'File' => $info['message'][1],
47
+ 'Line' => $info['message'][2]
48
+ );
49
+ $info['message'] = $info['message'][0];
50
+ } else {
51
+ $extra = array ('Type' => self::$log_levels[$info['level']]);
52
+ }
53
+
54
+ $json = json_encode (array ($extra, $info['message']));
55
+
56
+ return sprintf ('X-Wf-1-1-1-%d: %s|%s|', self::$message_index++, strlen ($json), $json);
57
+ }
58
+
59
+ /**
60
+ * Sends the initial headers if FirePHP is available then returns a
61
+ * closure that handles sending log messages.
62
+ */
63
+ public static function init () {
64
+ if (! isset ($_SERVER['HTTP_USER_AGENT'])
65
+ || preg_match ('{\bFirePHP/\d+\.\d+\b}', $_SERVER['HTTP_USER_AGENT'])
66
+ || isset ($_SERVER['HTTP_X_FIREPHP_VERSION'])) {
67
+
68
+ header ('X-Wf-Protocol-1: http://meta.wildfirehq.org/Protocol/JsonStream/0.2');
69
+ header ('X-Wf-1-Plugin-1: http://meta.firephp.org/Wildfire/Plugin/FirePHP/Library-FirePHPCore/0.3');
70
+ header ('X-Wf-1-Structure-1: http://meta.firephp.org/Wildfire/Structure/FirePHP/FirebugConsole/0.1');
71
+ }
72
+
73
+ return function ($info) {
74
+ header (FirePHP::format_header ($info));
75
+ };
76
+ }
77
+ }
lib/analog/analog/lib/Analog/Handler/GELF.php ADDED
@@ -0,0 +1,48 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to a Graylog2 server (http://graylog2.org/).
7
+ *
8
+ * Usage:
9
+ *
10
+ * // First include the GELF classes from
11
+ * // https://github.com/Graylog2/gelf-php
12
+ * require 'GELFMessage.php';
13
+ * require 'GELFMessagePublisher.php';
14
+ *
15
+ * // Initialize the Analog GELF handler
16
+ * Analog::handler (Analog\Handler\GELF::init (
17
+ * '172.16.22.30'
18
+ * ));
19
+ *
20
+ * // Send a message with file and line number
21
+ * Analog::log (array ('Log me', __FILE__, __LINE__), Analog::DEBUG);
22
+ *
23
+ * // Send an ordinary message
24
+ * Analog::log ('An error message');
25
+ */
26
+ class GELF {
27
+ public static function init ($host = '127.0.0.1', $port = \GELFMessagePublisher::GRAYLOG2_DEFAULT_PORT) {
28
+ $publisher = new \GELFMessagePublisher ($host, $port);
29
+
30
+ return function ($info) use ($publisher) {
31
+ $message = new \GELFMessage ();
32
+ $message->setHost ($info['machine']);
33
+ $message->setLevel ($info['level']);
34
+
35
+ if (is_array ($info['message'])) {
36
+ $message->setShortMessage ($info['message'][0]);
37
+ $message->setFullMessage ($info['message'][0]);
38
+ $message->setFile ($info['message'][1]);
39
+ $message->setLine ($info['message'][2]);
40
+ } else {
41
+ $message->setShortMessage ($info['message']);
42
+ $message->setFullMessage ($info['message']);
43
+ }
44
+
45
+ $publisher->publish ($message);
46
+ };
47
+ }
48
+ }
lib/analog/analog/lib/Analog/Handler/Ignore.php ADDED
@@ -0,0 +1,20 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Ignores anything sent to it so you can disable logging.
7
+ *
8
+ * Usage:
9
+ *
10
+ * Analog::handler (Analog\Handler\Ignore::init ());
11
+ *
12
+ * Analog::log ('Log me');
13
+ */
14
+ class Ignore {
15
+ public static function init () {
16
+ return function ($info) {
17
+ // do nothing
18
+ };
19
+ }
20
+ }
lib/analog/analog/lib/Analog/Handler/LevelBuffer.php ADDED
@@ -0,0 +1,63 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Buffers messages to be sent as a batch to another handler only when a
7
+ * message of a certain level threshold has been received. This means for
8
+ * example that you can trigger a handler only if an error has occurred.
9
+ * Currently only works with the Mail handler.
10
+ *
11
+ * Inspired by the Monolog FingersCrossedHandler.
12
+ *
13
+ * Usage:
14
+ *
15
+ * Analog::handler (Analog\Handler\LevelBuffer::init (
16
+ * Analog\Handler\Mail::init ($to, $subject, $from),
17
+ * Analog::ERROR
18
+ * ));
19
+ *
20
+ * // will all be buffered until something ERROR or above is logged
21
+ * Analog::log ('Message one', Analog::DEBUG);
22
+ * Analog::log ('Message two', Analog::WARNING);
23
+ * Analog::log ('Message three', Analog::URGENT);
24
+ *
25
+ * Note: Uses Analog::$format to format the messages as they're appended
26
+ * to the buffer.
27
+ */
28
+ class LevelBuffer {
29
+ /**
30
+ * This builds a log string of all messages logged.
31
+ */
32
+ public static $buffer = '';
33
+
34
+ /**
35
+ * This contains the handler to send to on close.
36
+ */
37
+ private static $handler;
38
+
39
+ /**
40
+ * Accepts another handler function to be used on close().
41
+ * $until_level defaults to CRITICAL.
42
+ */
43
+ public static function init ($handler, $until_level = 2) {
44
+ self::$handler = $handler;
45
+
46
+ return function ($info) use ($until_level) {
47
+ LevelBuffer::$buffer .= vsprintf (\Analog\Analog::$format, $info);
48
+ if ($info['level'] <= $until_level) {
49
+ // flush and reset the buffer
50
+ LevelBuffer::flush ();
51
+ LevelBuffer::$buffer = '';
52
+ }
53
+ };
54
+ }
55
+
56
+ /**
57
+ * Passes the buffered log to the final $handler.
58
+ */
59
+ public static function flush () {
60
+ $handler = self::$handler;
61
+ return $handler (self::$buffer, true);
62
+ }
63
+ }
lib/analog/analog/lib/Analog/Handler/LevelName.php ADDED
@@ -0,0 +1,50 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Translates log level codes to their names
7
+ *
8
+ *
9
+ * Usage:
10
+ *
11
+ * // The log level (3rd value) must be formatted as a string
12
+ * Analog::$format = "%s - %s - %s - %s\n";
13
+ *
14
+ * Analog::handler (Analog\Handler\LevelName::init (
15
+ * Analog\Handler\File::init ($file)
16
+ * ));
17
+ */
18
+ class LevelName {
19
+ /**
20
+ * Translation list for log levels.
21
+ */
22
+ private static $log_levels = array (
23
+ \Analog\Analog::DEBUG => 'DEBUG',
24
+ \Analog\Analog::INFO => 'INFO',
25
+ \Analog\Analog::NOTICE => 'NOTICE',
26
+ \Analog\Analog::WARNING => 'WARNING',
27
+ \Analog\Analog::ERROR => 'ERROR',
28
+ \Analog\Analog::CRITICAL => 'CRITICAL',
29
+ \Analog\Analog::ALERT => 'ALERT',
30
+ \Analog\Analog::URGENT => 'URGENT'
31
+ );
32
+
33
+ /**
34
+ * This contains the handler to send to
35
+ */
36
+ public static $handler;
37
+
38
+ public static function init ($handler) {
39
+ self::$handler = $handler;
40
+
41
+ return function ($info) {
42
+ if (isset(self::$log_levels[$info['level']])) {
43
+ $info['level'] = self::$log_levels[$info['level']];
44
+ }
45
+ $handler = LevelName::$handler;
46
+ $handler ($info);
47
+ };
48
+ }
49
+
50
+ }
lib/analog/analog/lib/Analog/Handler/Mail.php ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to the specified email address.
7
+ *
8
+ * Usage:
9
+ *
10
+ * Analog::handler (Analog\Handler\Mail::init (
11
+ * 'you@example.com', // to
12
+ * 'Subject line', // subject
13
+ * 'no-reply@example.com' // from
14
+ * ));
15
+ */
16
+ class Mail {
17
+ public static function init ($to, $subject, $from) {
18
+ return function ($info, $buffered = false) use ($to, $subject, $from) {
19
+ if($info=="") return; // do not send empty mail.
20
+ $headers = sprintf ("From: %s\r\nContent-type: text/plain; charset=utf-8\r\n", $from);
21
+ $body = ($buffered)
22
+ ? "Logged:\n" . $info
23
+ : vsprintf ("Machine: %s\nDate: %s\nLevel: %d\nMessage: %s", $info);
24
+
25
+ mail ($to, $subject, wordwrap ($body, 70), $headers);
26
+ };
27
+ }
28
+ }
lib/analog/analog/lib/Analog/Handler/Mongo.php ADDED
@@ -0,0 +1,57 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to the specified collection in a
7
+ * MongoDB database.
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler (Analog\Handler\Mongo::init (
12
+ * 'localhost:27017', // connection string
13
+ * 'mydb', // database name
14
+ * 'log' // collection name
15
+ * ));
16
+ *
17
+ * Alternately, if you have an existing Mongo connection,
18
+ * you can simply initialize it with that:
19
+ *
20
+ * $conn = new MongoClient ('localhost:27017'); // mongo driver
21
+ * $conn = new MongoDB\Driver\Manager('localhost:27017'); // mongodb driver
22
+ * Analog::handler (Analog\Handler\Mongo::init (
23
+ * $conn, // Mongo object
24
+ * 'mydb', // database name
25
+ * 'log' // collection name
26
+ * ));
27
+ */
28
+ class Mongo {
29
+ public static function init ($server, $database, $collection) {
30
+ if ($server instanceof \MongoDB\Driver\Manager) {
31
+ $driver = 'mongodb';
32
+ $manager = $server;
33
+ } elseif ($server instanceof \MongoClient) {
34
+ $db = $server->{$database};
35
+ } else {
36
+ if (class_exists('\MongoDB\Driver\Manager')) {
37
+ $driver = 'mongodb';
38
+ $manager = new \MongoDB\Driver\Manager("mongodb://$server");
39
+ } else {
40
+ $conn = new \MongoClient ("mongodb://$server");
41
+ $db = $conn->{$database};
42
+ }
43
+ }
44
+ if ($driver == 'mongodb') {
45
+ return function ($info) use ($manager, $database, $collection) {
46
+ $bulk = new \MongoDB\Driver\BulkWrite;
47
+ $bulk->insert($info);
48
+ $dbAndColl = $database.'.'.$collection;
49
+ $manager->executeBulkWrite($dbAndColl, $bulk);
50
+ };
51
+ } else {
52
+ return function ($info) use ($db, $collection) {
53
+ $db->{$collection}->insert ($info);
54
+ };
55
+ }
56
+ }
57
+ }
lib/analog/analog/lib/Analog/Handler/Multi.php ADDED
@@ -0,0 +1,55 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Sends messages to one or more of the other handlers based on its
7
+ * log level.
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler( Analog\Handler\Multi::init( array(
12
+ * // anything error or worse goes to this
13
+ * Analog::ERROR => array(
14
+ * Analog\Handler\Mail::init( $to, $subject, $from ),
15
+ * Analog\Handler\Stderr::init()
16
+ * ),
17
+ *
18
+ * // Warnings are sent here
19
+ * Analog::WARNING => Analog\Handler\File::init( 'logs/warnings.log' ),
20
+ *
21
+ * // Debug and info messages sent here
22
+ * Analog::DEBUG => Analog\Handler\Ignore::init() // do nothing
23
+ * ) ) );
24
+ *
25
+ * // will be ignored
26
+ * Analog::log ('Ignore me', Analog::DEBUG);
27
+ *
28
+ * // will be written to logs/warnings.log
29
+ * Analog::log ('Log me', Analog::WARNING);
30
+ *
31
+ * // will trigger an email notice
32
+ * Analog::log ('Uh oh...', Analog::ERROR);
33
+ */
34
+ class Multi {
35
+ public static function init ($handlers) {
36
+ return function ($info) use ($handlers) {
37
+ $level = is_numeric ($info['level']) ? $info['level'] : 3;
38
+ while ($level <= 7) {
39
+ if ( isset ( $handlers[ $level ] ) ) {
40
+
41
+ if ( ! is_array( $handlers[ $level ] ) ) {
42
+ $handlers[ $level ] = array( $handlers[ $level ] );
43
+ }
44
+
45
+ foreach ( $handlers[ $level ] as $handler ) {
46
+ $handler( $info );
47
+ }
48
+
49
+ return;
50
+ }
51
+ $level++;
52
+ }
53
+ };
54
+ }
55
+ }
lib/analog/analog/lib/Analog/Handler/Null.php ADDED
@@ -0,0 +1,23 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Note: Deprecated because Null is a reserved word in PHP7.
7
+ * Please use Analog\Handler\Ignore instead.
8
+ *
9
+ * Ignores anything sent to it so you can disable logging.
10
+ *
11
+ * Usage:
12
+ *
13
+ * Analog::handler (Analog\Handler\Null::init ());
14
+ *
15
+ * Analog::log ('Log me');
16
+ */
17
+ #class Null {
18
+ # public static function init () {
19
+ # return function ($info) {
20
+ # // do nothing
21
+ # };
22
+ # }
23
+ #}
lib/analog/analog/lib/Analog/Handler/PDO.php ADDED
@@ -0,0 +1,89 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to the specified table in a database.
7
+ *
8
+ * Usage:
9
+ *
10
+ * Analog::handler (Analog\Handler\PDO::init (
11
+ * $pdo, // PDO connection object
12
+ * 'logs' // database table name
13
+ * ));
14
+ *
15
+ * Alternately, you can pass the connection info as an array and it
16
+ * will initialize a new PDO connection for logging:
17
+ *
18
+ * $conn = [
19
+ * 'mysql:host=localhost;dbname=example',
20
+ * 'username',
21
+ * 'password'
22
+ * ];
23
+ *
24
+ * Analog::handler (Analog\Handler\PDO::init (
25
+ * $conn, // connection info
26
+ * 'logs' // database table name
27
+ * ));
28
+ *
29
+ * A convenience method exists for creating the database table:
30
+ *
31
+ * Analog\Handler\PDO::createTable ($pdo, 'logs');
32
+ *
33
+ * The schema it creates looks like this:
34
+ *
35
+ * CREATE TABLE `logs` (
36
+ * `machine` varchar(48),
37
+ * `date` datetime,
38
+ * `level` int,
39
+ * `message` text,
40
+ * index (`machine`)
41
+ * index (`date`),
42
+ * index (`level`)
43
+ * );
44
+ *
45
+ * Note: The table name property should *never* come from an insecure
46
+ * source, as it is not escaped for SQL injection prevention. The other
47
+ * fields are properly protected, however.
48
+ */
49
+ class PDO {
50
+ public static function init ($pdo, $table) {
51
+ if (is_array ($pdo)) {
52
+ $pdo = new \PDO ($pdo[0], $pdo[1], $pdo[2], [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
53
+ }
54
+
55
+ $stmt = $pdo->prepare (
56
+ 'insert into `' . $table . '` (`machine`, `date`, `level`, `message`) values (:machine, :date, :level, :message)'
57
+ );
58
+
59
+ return function ($info) use ($stmt, $table) {
60
+ $stmt->execute ($info);
61
+ };
62
+ }
63
+
64
+ public static function createTable ($pdo, $table) {
65
+ if (is_array ($pdo)) {
66
+ $pdo = new \PDO ($pdo[0], $pdo[1], $pdo[2]);
67
+ }
68
+
69
+ $pdo->beginTransaction ();
70
+
71
+ $pdo->prepare (
72
+ 'create table `' . $table . '` (`machine` varchar(48), `date` datetime, `level` int, `message` text)'
73
+ )->execute ();
74
+
75
+ $pdo->prepare (
76
+ 'create index `' . $table . '_message` on `' . $table . '` (`machine`)'
77
+ )->execute ();
78
+
79
+ $pdo->prepare (
80
+ 'create index `' . $table . '_date` on `' . $table . '` (`date`)'
81
+ )->execute ();
82
+
83
+ $pdo->prepare (
84
+ 'create index `' . $table . '_level` on `' . $table . '` (`level`)'
85
+ )->execute ();
86
+
87
+ $pdo->commit ();
88
+ }
89
+ }
lib/analog/analog/lib/Analog/Handler/Post.php ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Post the log info to the specified address.
7
+ *
8
+ * Usage:
9
+ *
10
+ * $address = 'http://my-log-server/log-me';
11
+ * Analog::handler (Analog\Handler\Post::init ($address));
12
+ *
13
+ * The server will receive an HTTP POST request with four
14
+ * parameters:
15
+ *
16
+ * - machine
17
+ * - date
18
+ * - level
19
+ * - message
20
+ *
21
+ * Note: Requires cURL.
22
+ */
23
+ class Post {
24
+ public static function init ($address) {
25
+ return function ($info) use ($address) {
26
+ if (! extension_loaded ('curl')) {
27
+ throw new \LogicException ('CURL extension not loaded.');
28
+ }
29
+
30
+ $ch = curl_init ();
31
+ curl_setopt ($ch, CURLOPT_URL, $address);
32
+ curl_setopt ($ch, CURLOPT_MAXREDIRS, 3);
33
+ curl_setopt ($ch, CURLOPT_FOLLOWLOCATION, 0);
34
+ curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
35
+ curl_setopt ($ch, CURLOPT_VERBOSE, 0);
36
+ curl_setopt ($ch, CURLOPT_HEADER, 0);
37
+ curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, 10);
38
+ curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER, 0);
39
+ curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, 0);
40
+ curl_setopt ($ch, CURLOPT_POST, 1);
41
+ curl_setopt ($ch, CURLOPT_POSTFIELDS, $info);
42
+ curl_exec ($ch);
43
+ curl_close ($ch);
44
+ };
45
+ }
46
+ }
lib/analog/analog/lib/Analog/Handler/Slackbot.php ADDED
@@ -0,0 +1,47 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Post the log info to the specified Slack channel through Slack's Slackbot.
7
+ *
8
+ * Usage:
9
+ *
10
+ * $team = 'team-subdomain';
11
+ * $token = 'slackbot token';
12
+ * $channel = 'slack-channel';
13
+ * Analog::handler (Analog\Handler\Slackbot::init ($team, $token, $channel));
14
+ *
15
+ * Note: Requires cURL.
16
+ */
17
+ class Slackbot {
18
+ public static function init ($team, $token, $channel) {
19
+ return function ($info) use ($team, $token, $channel) {
20
+ if (! extension_loaded ('curl')) {
21
+ throw new \LogicException ('CURL extension not loaded.');
22
+ }
23
+
24
+ $url = sprintf (
25
+ 'https://%s.slack.com/services/hooks/slackbot?token=%s&channel=%s',
26
+ $team,
27
+ $token,
28
+ $channel
29
+ );
30
+
31
+ $msg = sprintf (
32
+ '%s (%d): %s',
33
+ $info['machine'],
34
+ $info['level'],
35
+ $info['message']
36
+ );
37
+
38
+ $ch = curl_init ();
39
+ curl_setopt ($ch, CURLOPT_URL, $url);
40
+ curl_setopt ($ch, CURLOPT_POST, 1);
41
+ curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
42
+ curl_setopt ($ch, CURLOPT_POSTFIELDS, $msg);
43
+ curl_exec ($ch);
44
+ curl_close ($ch);
45
+ };
46
+ }
47
+ }
lib/analog/analog/lib/Analog/Handler/Stderr.php ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the output to STDERR.
7
+ *
8
+ * Usage:
9
+ *
10
+ * Analog::handler (Analog\Handler\Stderr::init ());
11
+ *
12
+ * Analog::log ('Log me');
13
+ *
14
+ * Note: Uses Analog::$format for the appending format.
15
+ */
16
+ class Stderr {
17
+ public static function init () {
18
+ return function ($info, $buffered = false) {
19
+ file_put_contents ('php://stderr', ($buffered)
20
+ ? $info
21
+ : vsprintf (\Analog\Analog::$format, $info));
22
+ };
23
+ }
24
+ }
lib/analog/analog/lib/Analog/Handler/Syslog.php ADDED
@@ -0,0 +1,67 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to the syslog service. This was borrowed largely
7
+ * from the Monolog syslog handler.
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler (Analog\Handler\Syslog::init ('ident', 'facility'));
12
+ */
13
+ class Syslog {
14
+ public static $levels = array (
15
+ \Analog\Analog::DEBUG => LOG_DEBUG,
16
+ \Analog\Analog::INFO => LOG_INFO,
17
+ \Analog\Analog::NOTICE => LOG_NOTICE,
18
+ \Analog\Analog::WARNING => LOG_WARNING,
19
+ \Analog\Analog::ERROR => LOG_ERR,
20
+ \Analog\Analog::CRITICAL => LOG_CRIT,
21
+ \Analog\Analog::ALERT => LOG_ALERT,
22
+ \Analog\Analog::URGENT => LOG_EMERG
23
+ );
24
+
25
+ public static $facilities = array (
26
+ 'auth' => LOG_AUTH,
27
+ 'authpriv' => LOG_AUTHPRIV,
28
+ 'cron' => LOG_CRON,
29
+ 'daemon' => LOG_DAEMON,
30
+ 'kern' => LOG_KERN,
31
+ 'lpr' => LOG_LPR,
32
+ 'mail' => LOG_MAIL,
33
+ 'news' => LOG_NEWS,
34
+ 'syslog' => LOG_SYSLOG,
35
+ 'user' => LOG_USER,
36
+ 'uucp' => LOG_UUCP
37
+ );
38
+
39
+ public static function init ($ident, $facility) {
40
+ if (! defined ('PHP_WINDOWS_VERSION_BUILD')) {
41
+ self::$facilities['local0'] = LOG_LOCAL0;
42
+ self::$facilities['local1'] = LOG_LOCAL1;
43
+ self::$facilities['local2'] = LOG_LOCAL2;
44
+ self::$facilities['local3'] = LOG_LOCAL3;
45
+ self::$facilities['local4'] = LOG_LOCAL4;
46
+ self::$facilities['local5'] = LOG_LOCAL5;
47
+ self::$facilities['local6'] = LOG_LOCAL6;
48
+ self::$facilities['local7'] = LOG_LOCAL7;
49
+ }
50
+
51
+ if (array_key_exists (strtolower ($facility), self::$facilities)) {
52
+ $facility = self::$facilities[strtolower ($facility)];
53
+ } elseif (! in_array ($facility, array_values (self::$facilities), true)) {
54
+ throw new \UnexpectedValueException ('Unknown facility value "' . $facility . '"');
55
+ }
56
+
57
+ return function ($info) use ($ident, $facility) {
58
+ if (! openlog ($ident, LOG_PID, $facility)) {
59
+ throw new \LogicException ('Can\'t open syslog for ident "' . $ident . '" and facility "' . $facility . '"');
60
+ }
61
+
62
+ syslog (Syslog::$levels[$info['level']], vsprintf ('%1$s: %4$s', $info));
63
+
64
+ closelog ();
65
+ };
66
+ }
67
+ }
lib/analog/analog/lib/Analog/Handler/Threshold.php ADDED
@@ -0,0 +1,45 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Only writes log messages above a certain threshold
7
+ *
8
+ *
9
+ * Usage:
10
+ *
11
+ * Analog::handler (Analog\Handler\Threshold::init (
12
+ * Analog\Handler\File::init ($file),
13
+ * Analog::ERROR
14
+ * ));
15
+ *
16
+ * // Only message three will be logged
17
+ * Analog::log ('Message one', Analog::DEBUG);
18
+ * Analog::log ('Message two', Analog::WARNING);
19
+ * Analog::log ('Message three', Analog::URGENT);
20
+ *
21
+ * Note: Uses Analog::$format to format the messages as they're appended
22
+ * to the buffer.
23
+ */
24
+ class Threshold {
25
+ /**
26
+ * This contains the handler to send to on close.
27
+ */
28
+ public static $handler;
29
+
30
+ /**
31
+ * Accepts another handler function to be used on close().
32
+ * $until_level defaults to ERROR.
33
+ */
34
+ public static function init ($handler, $until_level = 3) {
35
+ self::$handler = $handler;
36
+
37
+ return function ($info) use ($until_level) {
38
+ if ($info['level'] <= $until_level) {
39
+ $handler = Threshold::$handler;
40
+ $handler ($info);
41
+ }
42
+ };
43
+ }
44
+
45
+ }
lib/analog/analog/lib/Analog/Handler/Variable.php ADDED
@@ -0,0 +1,26 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Append the log info to a variable passed in as a reference.
7
+ *
8
+ * Usage:
9
+ *
10
+ * $my_log = '';
11
+ * Analog::handler (Analog\Handler\Variable::init ($my_log));
12
+ *
13
+ * Analog::log ('Log me');
14
+ * echo $my_log;
15
+ *
16
+ * Note: Uses Analog::$format for the appending format.
17
+ */
18
+ class Variable {
19
+ public static function init (&$log) {
20
+ return function ($info, $buffered = false) use (&$log) {
21
+ $log .= ($buffered)
22
+ ? $info
23
+ : vsprintf (\Analog\Analog::$format, $info);
24
+ };
25
+ }
26
+ }
lib/analog/analog/lib/Analog/Handler/WPMail.php ADDED
@@ -0,0 +1,49 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog\Handler;
4
+
5
+ /**
6
+ * Send the log message to the specified email address using WordPress wp_mail.
7
+ *
8
+ * You can also specify a template in your theme to style how the email looks like.
9
+ *
10
+ * Usage:
11
+ *
12
+ * Analog::handler (Analog\Handler\WPMail::init (
13
+ * 'you@example.com', // to
14
+ * 'Subject line', // subject
15
+ * 'no-reply@example.com', // from
16
+ * 'log-email-template.php' // email template in theme
17
+ * ));
18
+ */
19
+ class WPMail {
20
+ public static function init ($to, $subject, $from, $template='') {
21
+ return function ($info, $buffered = false) use ($to, $subject, $from, $template) {
22
+ $body = ($buffered)
23
+ ? "Logged:\n" . $info
24
+ : vsprintf ("Machine: %s\nDate: %s\nLevel: %d\nMessage: %s", $info);
25
+
26
+
27
+ $log_template = locate_template( $template );
28
+
29
+ if ( ! empty( $log_template ) ) {
30
+ ob_start();
31
+ include_once $log_template;
32
+ $body = ob_get_clean();
33
+ } else {
34
+ $body = wordwrap( $body, 70 );
35
+ }
36
+
37
+ add_filter( 'wp_mail_content_type', array( __CLASS__, 'set_email_content_type' ) );
38
+
39
+ wp_mail( $to, $subject, $body );
40
+
41
+ remove_filter( 'wp_mail_content_type', array( __CLASS__, 'set_email_content_type' ) );
42
+
43
+ };
44
+ }
45
+
46
+ public static function set_email_content_type() {
47
+ return 'text/html';
48
+ }
49
+ }
lib/analog/analog/lib/Analog/Logger.php ADDED
@@ -0,0 +1,220 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Analog;
4
+
5
+ use Psr\Log\LoggerInterface;
6
+ use Psr\Log\LogLevel;
7
+ use Psr\Log\InvalidArgumentException;
8
+
9
+ /**
10
+ * Analog - PHP 5.3+ logging class
11
+ *
12
+ * Copyright (c) 2012 Johnny Broadway
13
+ *
14
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
15
+ * of this software and associated documentation files (the "Software"), to deal
16
+ * in the Software without restriction, including without limitation the rights
17
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
18
+ * copies of the Software, and to permit persons to whom the Software is furnished
19
+ * to do so, subject to the following conditions:
20
+ *
21
+ * The above copyright notice and this permission notice shall be included in all
22
+ * copies or substantial portions of the Software.
23
+ *
24
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
25
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
27
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
28
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
29
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
30
+ * THE SOFTWARE.
31
+ */
32
+
33
+ /**
34
+ * Implements the PSR-3 standard as a wrapper to Analog. For more information,
35
+ * see:
36
+ *
37
+ * https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-3-logger-interface.md
38
+ *
39
+ * Usage:
40
+ *
41
+ * <?php
42
+ *
43
+ * require_once ('vendor/autoload.php');
44
+ *
45
+ * $log = new Analog\Logger ();
46
+ *
47
+ * $log->notice ('Things are really happening right now.');
48
+ *
49
+ * ?>
50
+ *
51
+ * @package Analog
52
+ * @author Johnny Broadway
53
+ */
54
+ class Logger implements LoggerInterface {
55
+ /**
56
+ * Converts from PSR-3 log levels to Analog log levels.
57
+ */
58
+ public function convert_log_level ($level, $reverse = false) {
59
+ if ($reverse) {
60
+ switch ($level) {
61
+ case Analog::URGENT:
62
+ return LogLevel::EMERGENCY;
63
+ case Analog::ALERT:
64
+ return LogLevel::ALERT;
65
+ case Analog::CRITICAL:
66
+ return LogLevel::CRITICAL;
67
+ case Analog::ERROR:
68
+ return LogLevel::ERROR;
69
+ case Analog::WARNING:
70
+ return LogLevel::WARNING;
71
+ case Analog::NOTICE:
72
+ return LogLevel::NOTICE;
73
+ case Analog::INFO:
74
+ return LogLevel::INFO;
75
+ case Analog::DEBUG:
76
+ return LogLevel::DEBUG;
77
+ }
78
+ throw new InvalidArgumentException ('Level "' . $level . '" is not defined.');
79
+ } else {
80
+ switch ($level) {
81
+ case LogLevel::EMERGENCY:
82
+ return Analog::URGENT;
83
+ case LogLevel::ALERT:
84
+ return Analog::ALERT;
85
+ case LogLevel::CRITICAL:
86
+ return Analog::CRITICAL;
87
+ case LogLevel::ERROR:
88
+ return Analog::ERROR;
89
+ case LogLevel::WARNING:
90
+ return Analog::WARNING;
91
+ case LogLevel::NOTICE:
92
+ return Analog::NOTICE;
93
+ case LogLevel::INFO:
94
+ return Analog::INFO;
95
+ case LogLevel::DEBUG:
96
+ return Analog::DEBUG;
97
+ }
98
+ throw new InvalidArgumentException ('Level "' . $level . '" is not defined.');
99
+ }
100
+ }
101
+
102
+ /**
103
+ * Interpolates context values into the message placeholders.
104
+ */
105
+ private function interpolate ($message, array $context = array ()) {
106
+ if (is_array ($message)) {
107
+ return $message;
108
+ }
109
+
110
+ // build a replacement array with braces around the context keys
111
+ $replace = array ();
112
+ foreach ($context as $key => $val) {
113
+ if (is_object ($val) && get_class ($val) === 'DateTime') {
114
+ $val = $val->format ('Y-m-d H:i:s');
115
+ } elseif (is_object ($val)) {
116
+ $val = json_encode ($val);
117
+ } elseif (is_array ($val)) {
118
+ $val = json_encode ($val);
119
+ } elseif (is_resource ($val)) {
120
+ $val = (string) $val;
121
+ }
122
+ $replace['{' . $key . '}'] = $val;
123
+ }
124
+
125
+ // interpolate replacement values into the the message and return
126
+ return strtr ($message, $replace);
127
+ }
128
+
129
+ /**
130
+ * Sets the Analog log handler.
131
+ */
132
+ public function handler ($handler) {
133
+ Analog::handler ($handler);
134
+ }
135
+
136
+ /**
137
+ * Sets the log message format.
138
+ */
139
+ public function format ($format) {
140
+ Analog::$format = $format;
141
+ }
142
+
143
+ /**
144
+ * System is unusable.
145
+ */
146
+ public function emergency ($message, array $context = array ()) {
147
+ $this->_log (Analog::URGENT, $message, $context);
148
+ }
149
+
150
+ /**
151
+ * Action must be taken immediately.
152
+ */
153
+ public function alert ($message, array $context = array ()) {
154
+ $this->_log (Analog::ALERT, $message, $context);
155
+ }
156
+
157
+ /**
158
+ * Critical conditions.
159
+ */
160
+ public function critical ($message, array $context = array ()) {
161
+ $this->_log (Analog::CRITICAL, $message, $context);
162
+ }
163
+
164
+ /**
165
+ * Runtime errors that do not require immediate action but should typically
166
+ * be logged and monitored.
167
+ */
168
+ public function error ($message, array $context = array ()) {
169
+ $this->_log (Analog::ERROR, $message, $context);
170
+ }
171
+
172
+ /**
173
+ * Exceptional occurrences that are not errors.
174
+ */
175
+ public function warning ($message, array $context = array ()) {
176
+ $this->_log (Analog::WARNING, $message, $context);
177
+ }
178
+
179
+ /**
180
+ * Normal but significant events.
181
+ */
182
+ public function notice ($message, array $context = array ()) {
183
+ $this->_log (Analog::NOTICE, $message, $context);
184
+ }
185
+
186
+ /**
187
+ * Interesting events.
188
+ */
189
+ public function info ($message, array $context = array ()) {
190
+ $this->_log (Analog::INFO, $message, $context);
191
+ }
192
+
193
+ /**
194
+ * Detailed debug information.
195
+ */
196
+ public function debug ($message, array $context = array ()) {
197
+ $this->_log (Analog::DEBUG, $message, $context);
198
+ }
199
+
200
+ /**
201
+ * Logs with an arbitrary level.
202
+ */
203
+ public function log ($level, $message, array $context = array ()) {
204
+ $this->_log (
205
+ $this->convert_log_level ($level),
206
+ $message,
207
+ $context
208
+ );
209
+ }
210
+
211
+ /**
212
+ * Perform the logging to Analog after the log level has been converted.
213
+ */
214
+ private function _log ($level, $message, $context) {
215
+ Analog::log (
216
+ $this->interpolate ($message, $context),
217
+ $level
218
+ );
219
+ }
220
+ }
lib/analog/analog/lib/ChromePhp.php ADDED
@@ -0,0 +1,423 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Copyright 2010-2013 Craig Campbell
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+
18
+ /**
19
+ * Server Side Chrome PHP debugger class
20
+ *
21
+ * @package ChromePhp
22
+ * @author Craig Campbell <iamcraigcampbell@gmail.com>
23
+ */
24
+ class ChromePhp
25
+ {
26
+ /**
27
+ * @var string
28
+ */
29
+ const VERSION = '4.0.0';
30
+
31
+ /**
32
+ * @var string
33
+ */
34
+ const HEADER_NAME = 'X-ChromeLogger-Data';
35
+
36
+ /**
37
+ * @var string
38
+ */
39
+ const BACKTRACE_LEVEL = 'backtrace_level';
40
+
41
+ /**
42
+ * @var string
43
+ */
44
+ const LOG = 'log';
45
+
46
+ /**
47
+ * @var string
48
+ */
49
+ const WARN = 'warn';
50
+
51
+ /**
52
+ * @var string
53
+ */
54
+ const ERROR = 'error';
55
+
56
+ /**
57
+ * @var string
58
+ */
59
+ const GROUP = 'group';
60
+
61
+ /**
62
+ * @var string
63
+ */
64
+ const INFO = 'info';
65
+
66
+ /**
67
+ * @var string
68
+ */
69
+ const GROUP_END = 'groupEnd';
70
+
71
+ /**
72
+ * @var string
73
+ */
74
+ const GROUP_COLLAPSED = 'groupCollapsed';
75
+
76
+ /**
77
+ * @var string
78
+ */
79
+ protected $_php_version;
80
+
81
+ /**
82
+ * @var int
83
+ */
84
+ protected $_timestamp;
85
+
86
+ /**
87
+ * @var array
88
+ */
89
+ protected $_json = array(
90
+ 'version' => self::VERSION,
91
+ 'columns' => array('log', 'backtrace', 'type'),
92
+ 'rows' => array()
93
+ );
94
+
95
+ /**
96
+ * @var array
97
+ */
98
+ protected $_backtraces = array();
99
+
100
+ /**
101
+ * @var bool
102
+ */
103
+ protected $_error_triggered = false;
104
+
105
+ /**
106
+ * @var array
107
+ */
108
+ protected $_settings = array(
109
+ self::BACKTRACE_LEVEL => 1
110
+ );
111
+
112
+ /**
113
+ * @var ChromePhp
114
+ */
115
+ protected static $_instance;
116
+
117
+ /**
118
+ * Prevent recursion when working with objects referring to each other
119
+ *
120
+ * @var array
121
+ */
122
+ protected $_processed = array();
123
+
124
+ /**
125
+ * constructor
126
+ */
127
+ private function __construct()
128
+ {
129
+ $this->_php_version = phpversion();
130
+ $this->_timestamp = $this->_php_version >= 5.1 ? $_SERVER['REQUEST_TIME'] : time();
131
+ $this->_json['request_uri'] = $_SERVER['REQUEST_URI'];
132
+ }
133
+
134
+ /**
135
+ * gets instance of this class
136
+ *
137
+ * @return ChromePhp
138
+ */
139
+ public static function getInstance()
140
+ {
141
+ if (self::$_instance === null) {
142
+ self::$_instance = new self();
143
+ }
144
+ return self::$_instance;
145
+ }
146
+
147
+ /**
148
+ * logs a variable to the console
149
+ *
150
+ * @param mixed $data,... unlimited OPTIONAL number of additional logs [...]
151
+ * @return void
152
+ */
153
+ public static function log()
154
+ {
155
+ return self::_log('', func_get_args());
156
+ }
157
+
158
+ /**
159
+ * logs a warning to the console
160
+ *
161
+ * @param mixed $data,... unlimited OPTIONAL number of additional logs [...]
162
+ * @return void
163
+ */
164
+ public static function warn()
165
+ {
166
+ return self::_log(self::WARN, func_get_args());
167
+ }
168
+
169
+ /**
170
+ * logs an error to the console
171
+ *
172
+ * @param mixed $data,... unlimited OPTIONAL number of additional logs [...]
173
+ * @return void
174
+ */
175
+ public static function error()
176
+ {
177
+ return self::_log(self::ERROR, func_get_args());
178
+ }
179
+
180
+ /**
181
+ * sends a group log
182
+ *
183
+ * @param string value
184
+ */
185
+ public static function group()
186
+ {
187
+ return self::_log(self::GROUP, func_get_args());
188
+ }
189
+
190
+ /**
191
+ * sends an info log
192
+ *
193
+ * @param mixed $data,... unlimited OPTIONAL number of additional logs [...]
194
+ * @return void
195
+ */
196
+ public static function info()
197
+ {
198
+ return self::_log(self::INFO, func_get_args());
199
+ }
200
+
201
+ /**
202
+ * sends a collapsed group log
203
+ *
204
+ * @param string value
205
+ */
206
+ public static function groupCollapsed()
207
+ {
208
+ return self::_log(self::GROUP_COLLAPSED, func_get_args());
209
+ }
210
+
211
+ /**
212
+ * ends a group log
213
+ *
214
+ * @param string value
215
+ */
216
+ public static function groupEnd()
217
+ {
218
+ return self::_log(self::GROUP_END, func_get_args());
219
+ }
220
+
221
+ /**
222
+ * internal logging call
223
+ *
224
+ * @param string $type
225
+ * @return void
226
+ */
227
+ protected static function _log($type, array $args)
228
+ {
229
+ // nothing passed in, don't do anything
230
+ if (count($args) == 0 && $type != self::GROUP_END) {
231
+ return;
232
+ }
233
+
234
+ $logger = self::getInstance();
235
+
236
+ $logger->_processed = array();
237
+
238
+ $logs = array();
239
+ foreach ($args as $arg) {
240
+ $logs[] = $logger->_convert($arg);
241
+ }
242
+
243
+ $backtrace = debug_backtrace(false);
244
+ $level = $logger->getSetting(self::BACKTRACE_LEVEL);
245
+
246
+ $backtrace_message = 'unknown';
247
+ if (isset($backtrace[$level]['file']) && isset($backtrace[$level]['line'])) {
248
+ $backtrace_message = $backtrace[$level]['file'] . ' : ' . $backtrace[$level]['line'];
249
+ }
250
+
251
+ $logger->_addRow($logs, $backtrace_message, $type);
252
+ }
253
+
254
+ /**
255
+ * converts an object to a better format for logging
256
+ *
257
+ * @param Object
258
+ * @return array
259
+ */
260
+ protected function _convert($object)
261
+ {
262
+ // if this isn't an object then just return it
263
+ if (!is_object($object)) {
264
+ return $object;
265
+ }
266
+
267
+ //Mark this object as processed so we don't convert it twice and it
268
+ //Also avoid recursion when objects refer to each other
269
+ $this->_processed[] = $object;
270
+
271
+ $object_as_array = array();
272
+
273
+ // first add the class name
274
+ $object_as_array['___class_name'] = get_class($object);
275
+
276
+ // loop through object vars
277
+ $object_vars = get_object_vars($object);
278
+ foreach ($object_vars as $key => $value) {
279
+
280
+ // same instance as parent object
281
+ if ($value === $object || in_array($value, $this->_processed, true)) {
282
+ $value = 'recursion - parent object [' . get_class($value) . ']';
283
+ }
284
+ $object_as_array[$key] = $this->_convert($value);
285
+ }
286
+
287
+ $reflection = new ReflectionClass($object);
288
+
289
+ // loop through the properties and add those
290
+ foreach ($reflection->getProperties() as $property) {
291
+
292
+ // if one of these properties was already added above then ignore it
293
+ if (array_key_exists($property->getName(), $object_vars)) {
294
+ continue;
295
+ }
296
+ $type = $this->_getPropertyKey($property);
297
+
298
+ if ($this->_php_version >= 5.3) {
299
+ $property->setAccessible(true);
300
+ }
301
+
302
+ try {
303
+ $value = $property->getValue($object);
304
+ } catch (ReflectionException $e) {
305
+ $value = 'only PHP 5.3 can access private/protected properties';
306
+ }
307
+
308
+ // same instance as parent object
309
+ if ($value === $object || in_array($value, $this->_processed, true)) {
310
+ $value = 'recursion - parent object [' . get_class($value) . ']';
311
+ }
312
+
313
+ $object_as_array[$type] = $this->_convert($value);
314
+ }
315
+ return $object_as_array;
316
+ }
317
+
318
+ /**
319
+ * takes a reflection property and returns a nicely formatted key of the property name
320
+ *
321
+ * @param ReflectionProperty
322
+ * @return string
323
+ */
324
+ protected function _getPropertyKey(ReflectionProperty $property)
325
+ {
326
+ $static = $property->isStatic() ? ' static' : '';
327
+ if ($property->isPublic()) {
328
+ return 'public' . $static . ' ' . $property->getName();
329
+ }
330
+
331
+ if ($property->isProtected()) {
332
+ return 'protected' . $static . ' ' . $property->getName();
333
+ }
334
+
335
+ if ($property->isPrivate()) {
336
+ return 'private' . $static . ' ' . $property->getName();
337
+ }
338
+ }
339
+
340
+ /**
341
+ * adds a value to the data array
342
+ *
343
+ * @var mixed
344
+ * @return void
345
+ */
346
+ protected function _addRow(array $logs, $backtrace, $type)
347
+ {
348
+ // if this is logged on the same line for example in a loop, set it to null to save space
349
+ if (in_array($backtrace, $this->_backtraces)) {
350
+ $backtrace = null;
351
+ }
352
+
353
+ // for group, groupEnd, and groupCollapsed
354
+ // take out the backtrace since it is not useful
355
+ if ($type == self::GROUP || $type == self::GROUP_END || $type == self::GROUP_COLLAPSED) {
356
+ $backtrace = null;
357
+ }
358
+
359
+ if ($backtrace !== null) {
360
+ $this->_backtraces[] = $backtrace;
361
+ }
362
+
363
+ $row = array($logs, $backtrace, $type);
364
+
365
+ $this->_json['rows'][] = $row;
366
+ $this->_writeHeader($this->_json);
367
+ }
368
+
369
+ protected function _writeHeader($data)
370
+ {
371
+ header(self::HEADER_NAME . ': ' . $this->_encode($data));
372
+ }
373
+
374
+ /**
375
+ * encodes the data to be sent along with the request
376
+ *
377
+ * @param array $data
378
+ * @return string
379
+ */
380
+ protected function _encode($data)
381
+ {
382
+ return base64_encode(utf8_encode(json_encode($data)));
383
+ }
384
+
385
+ /**
386
+ * adds a setting
387
+ *
388
+ * @param string key
389
+ * @param mixed value
390
+ * @return void
391
+ */
392
+ public function addSetting($key, $value)
393
+ {
394
+ $this->_settings[$key] = $value;
395
+ }
396
+
397
+ /**
398
+ * add ability to set multiple settings in one call
399
+ *
400
+ * @param array $settings
401
+ * @return void
402
+ */
403
+ public function addSettings(array $settings)
404
+ {
405
+ foreach ($settings as $key => $value) {
406
+ $this->addSetting($key, $value);
407
+ }
408
+ }
409
+
410
+ /**
411
+ * gets a setting
412
+ *
413
+ * @param string key
414
+ * @return mixed
415
+ */
416
+ public function getSetting($key)
417
+ {
418
+ if (!isset($this->_settings[$key])) {
419
+ return null;
420
+ }
421
+ return $this->_settings[$key];
422
+ }
423
+ }
lib/analog/analog/phpunit.xml.dist ADDED
@@ -0,0 +1,19 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+
3
+ <phpunit backupGlobals="false"
4
+ backupStaticAttributes="false"
5
+ bootstrap="./tests/bootstrap.php"
6
+ colors="true"
7
+ convertErrorsToExceptions="true"
8
+ convertNoticesToExceptions="true"
9
+ convertWarningsToExceptions="true"
10
+ processIsolation="false"
11
+ stopOnFailure="false"
12
+ syntaxCheck="false"
13
+ >
14
+ <testsuites>
15
+ <testsuite name="Analog Test Suite">
16
+ <directory suffix="Test.php" phpVersion="5.3.2" phpVersionOperator=">=">./tests</directory>
17
+ </testsuite>
18
+ </testsuites>
19
+ </phpunit>
lib/analog/analog/tests/AnalogTest.php ADDED
@@ -0,0 +1,176 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ require_once ('lib/Analog.php');
4
+
5
+ use PHPUnit\Framework\TestCase;
6
+
7
+ class AnalogTest extends TestCase {
8
+ public static $log = '';
9
+
10
+ /**
11
+ * @covers Analog::handler
12
+ * @covers Analog::log
13
+ * @covers Analog\Handler\File::init
14
+ */
15
+ function test_default () {
16
+ @unlink (Analog::handler ());
17
+
18
+ // Check it wrote correctly to temp file
19
+ Analog::log ('Foo');
20
+ $this->assertStringMatchesFormat (
21
+ "localhost - %d-%d-%d %d:%d:%d - 3 - Foo\n",
22
+ file_get_contents (Analog::handler ())
23
+ );
24
+ unlink (Analog::handler ());
25
+ }
26
+
27
+ /**
28
+ * @depends test_default
29
+ */
30
+ function test_format () {
31
+ // Test changing the format string and write again
32
+ Analog::$format = "%s, %s, %d, %s\n";
33
+ Analog::log ('Foo');
34
+ $this->assertStringMatchesFormat (
35
+ "localhost, %d-%d-%d %d:%d:%d, 3, Foo\n",
36
+ file_get_contents (Analog::handler ())
37
+ );
38
+ unlink (Analog::handler ());
39
+ }
40
+
41
+ /**
42
+ * @depends test_format
43
+ */
44
+ function test_tz_and_dates () {
45
+ // Test changing the date_format
46
+ Analog::$date_format = 'r'; // RFC2822 format
47
+ Analog::log ('Foo');
48
+ $this->assertStringMatchesFormat (
49
+ "localhost, %s, %d %s %d %d:%d:%d +0000, 3, Foo\n",
50
+ file_get_contents (Analog::handler ())
51
+ );
52
+ unlink (Analog::handler ());
53
+
54
+ // Test changing the timezone
55
+ Analog::$timezone = 'CST';
56
+ Analog::log ('Foo');
57
+
58
+ $dt = new \DateTime ('now', new \DateTimeZone (Analog::$timezone));
59
+ $zone_offset = $dt->format ('O');
60
+
61
+ $this->assertStringMatchesFormat (
62
+ "localhost, %s, %d %s %d %d:%d:%d $zone_offset, 3, Foo\n",
63
+ file_get_contents (Analog::handler ())
64
+ );
65
+ unlink (Analog::handler ());
66
+
67
+ Analog::$date_format = 'Y-m-d H:i:s';
68
+ Analog::$timezone = 'GMT';
69
+ }
70
+
71
+ /**
72
+ * @depends test_tz_and_dates
73
+ */
74
+ function test_handler () {
75
+ // Test logging using a closure
76
+ Analog::handler (function ($msg) {
77
+ AnalogTest::$log .= vsprintf (Analog::$format, $msg);
78
+ });
79
+
80
+ Analog::log ('Testing');
81
+ $this->assertStringMatchesFormat (
82
+ "localhost, %d-%d-%d %d:%d:%d, 3, Testing\n",
83
+ self::$log
84
+ );
85
+
86
+ self::$log = '';
87
+ }
88
+
89
+ /**
90
+ * @depends test_handler
91
+ */
92
+ function test_level () {
93
+ // Test default_level change
94
+ Analog::$default_level = 1;
95
+ Analog::log ('Testing');
96
+ $this->assertStringMatchesFormat (
97
+ "localhost, %d-%d-%d %d:%d:%d, 1, Testing\n",
98
+ self::$log
99
+ );
100
+
101
+ Analog::$default_level = 3;
102
+ }
103
+
104
+ /*
105
+ * @depends test_level
106
+ * @covers Analog::urgent
107
+ * @covers Analog::alert
108
+ * @covers Analog::critical
109
+ * @covers Analog::error
110
+ * @covers Analog::warning
111
+ * @covers Analog::notice
112
+ * @covers Analog::info
113
+ * @covers Analog::debug
114
+ */
115
+ function test_aliases () {
116
+ self::$log = '';
117
+
118
+ Analog::urgent ('Testing');
119
+ $this->assertStringMatchesFormat (
120
+ "localhost, %d-%d-%d %d:%d:%d, 0, Testing\n",
121
+ self::$log
122
+ );
123
+
124
+ self::$log = '';
125
+
126
+ Analog::alert ('Testing');
127
+ $this->assertStringMatchesFormat (
128
+ "localhost, %d-%d-%d %d:%d:%d, 1, Testing\n",
129
+ self::$log
130
+ );
131
+
132
+ self::$log = '';
133
+
134
+ Analog::error ('Testing');
135
+ $this->assertStringMatchesFormat (
136
+ "localhost, %d-%d-%d %d:%d:%d, 3, Testing\n",
137
+ self::$log
138
+ );
139
+
140
+ self::$log = '';
141
+
142
+ Analog::warning ('Testing');
143
+ $this->assertStringMatchesFormat (
144
+ "localhost, %d-%d-%d %d:%d:%d, 4, Testing\n",
145
+ self::$log
146
+ );
147
+
148
+ self::$log = '';
149
+
150
+ Analog::notice ('Testing');
151
+ $this->assertStringMatchesFormat (
152
+ "localhost, %d-%d-%d %d:%d:%d, 5, Testing\n",
153
+ self::$log
154
+ );
155
+
156
+ self::$log = '';
157
+
158
+ Analog::info ('Testing');
159
+ $this->assertStringMatchesFormat (
160
+ "localhost, %d-%d-%d %d:%d:%d, 6, Testing\n",
161
+ self::$log
162
+ );
163
+
164
+ self::$log = '';
165
+
166
+ Analog::debug ('Testing');
167
+ $this->assertStringMatchesFormat (
168
+ "localhost, %d-%d-%d %d:%d:%d, 7, Testing\n",
169
+ self::$log
170
+ );
171
+
172
+ self::$log = '';
173
+ }
174
+ }
175
+
176
+ ?>
lib/analog/analog/tests/PHPUnit_Framework_TestCase.php ADDED
@@ -0,0 +1,5 @@
 
 
 
 
 
1
+ <?php
2
+
3
+ use PHPUnit\Framework\TestCase;
4
+
5
+ class PHPUnit_Framework_TestCase extends TestCase {}
lib/analog/analog/tests/PsrLogCompatTest.php ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ date_default_timezone_set ('GMT');
4
+
5
+ require_once ('lib/Analog.php');
6
+
7
+ use Analog\Logger;
8
+ use Analog\Handler\Variable;
9
+ use Psr\Log\Test\LoggerInterfaceTest;
10
+
11
+ if (! class_exists ('PHPUnit_Framework_TestCase')) {
12
+ require_once ('tests/PHPUnit_Framework_TestCase.php');
13
+ }
14
+
15
+ class PsrLogCompatTest extends LoggerInterfaceTest {
16
+ private $log = '';
17
+
18
+ public function getLogger () {
19
+ $logger = new Logger ();
20
+ $logger->handler (Variable::init ($this->log));
21
+ $logger->format ("%3\$d %4\$s\n");
22
+ return $logger;
23
+ }
24
+
25
+ public function getLogs () {
26
+ $logger = $this->getLogger ();
27
+
28
+ $logs = explode ("\n", trim ($this->log));
29
+
30
+ foreach ($logs as $key => $line) {
31
+ list ($level, $msg) = explode (' ', $line, 2);
32
+ $logs[$key] = $logger->convert_log_level ((int) $level, true) . ' ' . $msg;
33
+ }
34
+
35
+ return $logs;
36
+ }
37
+ }
lib/analog/analog/tests/bootstrap.php ADDED
@@ -0,0 +1,8 @@
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ $filename = __DIR__ .'/../vendor/autoload.php';
4
+ if (!file_exists($filename)) {
5
+ throw new Exception("You need to execute `composer install` before running the tests. (vendors are required for test execution)");
6
+ }
7
+
8
+ require_once $filename;
lib/autoload.php ADDED
@@ -0,0 +1,7 @@
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload.php @generated by Composer
4
+
5
+ require_once __DIR__ . '/composer/autoload_real.php';
6
+
7
+ return ComposerAutoloaderInit7d0a298bb30f5ff6bc20a6405b7fdab0::getLoader();
lib/bin/cleanup ADDED
@@ -0,0 +1,140 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ #!/usr/bin/env php
2
+ <?php
3
+ $options = getopt("i:e:h", ['include:', 'exclude:', 'help']);
4
+
5
+ if (isset($options['include'])) {
6
+ $options['i'] = $options['include'];
7
+ }
8
+
9
+ if (isset($options['exclude'])) {
10
+ $options['e'] = $options['exclude'];
11
+ }
12
+
13
+ if (isset($options['h']) || isset($options['help'])) {
14
+ echo "Cleaning composer vendor directory" . PHP_EOL . PHP_EOL;
15
+
16
+ echo "\e[0;33mUsage:\e[0m" . PHP_EOL;
17
+ echo " command [options] [arguments]" . PHP_EOL . PHP_EOL;
18
+
19
+ echo "\e[0;33mOptions:\e[0m" . PHP_EOL;
20
+ echo " \e[0;32m-h, --help \e[0m Display this help message" . PHP_EOL;
21
+ echo " \e[0;32m-i, --include \e[0m Add patterns for common files, comma separated" . PHP_EOL;
22
+ echo " \e[0;32m-e, --exclude \e[0m Remove patterns for common files, comma separated" . PHP_EOL . PHP_EOL;
23
+
24
+ echo "\e[0;33mExample:\e[0m" . PHP_EOL;
25
+ echo " ./vendor/bin/cleanup --include *.zip,*.rar --exclude doc,docs,test" . PHP_EOL;
26
+ return;
27
+ }
28
+
29
+ // Default patterns for common files
30
+ $patterns = [
31
+ '.git',
32
+ '.github',
33
+ 'test',
34
+ 'tests',
35
+ 'travis',
36
+ 'demo',
37
+ 'example',
38
+ 'examples',
39
+ 'doc',
40
+ 'docs',
41
+ 'license',
42
+ 'changelog*',
43
+ 'changes*',
44
+ 'faq*',
45
+ 'contributing*',
46
+ 'history*',
47
+ 'upgrading*',
48
+ 'upgrade*',
49
+ 'package*',
50
+ 'readme*',
51
+ '{,.}*.yml',
52
+ '*.md',
53
+ '*.xml',
54
+ '*.txt',
55
+ '*.dist',
56
+ '.php_cs*',
57
+ '.scrutinizer',
58
+ '.gitignore',
59
+ '.gitattributes',
60
+ '.editorconfig',
61
+ 'dockerfile',
62
+ 'composer.lock',
63
+ ];
64
+
65
+ if (isset($options['i'])) {
66
+ $patterns = array_merge($patterns, explode(',', $options['i']));
67
+ }
68
+
69
+ if (isset($options['e'])) {
70
+ $patterns = array_diff($patterns, explode(',', $options['e']));
71
+ }
72
+ /**
73
+ * Recursively traverses the directory tree
74
+ *
75
+ * @param string $dir
76
+ * @return array
77
+ */
78
+ function expandTree($dir)
79
+ {
80
+ $directories = [];
81
+ $files = array_diff(scandir($dir), ['.', '..']);
82
+ foreach($files as $file) {
83
+ $directory = $dir . '/' . $file;
84
+ if(is_dir($directory)) {
85
+ $directories[] = $directory;
86
+ $directories = array_merge($directories, expandTree($directory));
87
+ }
88
+ }
89
+
90
+ return $directories;
91
+ }
92
+
93
+ /**
94
+ * Recursively deletes the directory
95
+ *
96
+ * @param string $dir
97
+ * @return bool
98
+ */
99
+ function delTree($dir)
100
+ {
101
+ $files = array_diff(scandir($dir), ['.', '..']);
102
+ foreach ($files as $file) {
103
+ (is_dir($dir . '/' . $file)) ? delTree($dir . '/' . $file) : unlink($dir . '/' . $file);
104
+ }
105
+
106
+ return rmdir($dir);
107
+ }
108
+
109
+ /**
110
+ * Prepare word
111
+ *
112
+ * @param string $matches
113
+ * @return string
114
+ */
115
+ function prepareWord($matches)
116
+ {
117
+ return '[' . strtolower($matches[1]) . strtoupper($matches[1]) . ']';
118
+ }
119
+
120
+ $directories = expandTree(dirname(__DIR__, 2));
121
+
122
+ foreach ($directories as $directory) {
123
+ foreach ($patterns as $pattern) {
124
+
125
+ $casePattern = preg_replace_callback('/([a-z])/i', 'prepareWord', $pattern);
126
+
127
+ foreach (glob($directory . '/' . $casePattern, GLOB_BRACE) as $file) {
128
+
129
+ echo 'delete: ' . $file . PHP_EOL;
130
+
131
+ if (is_dir($file)) {
132
+ delTree($file);
133
+ } else {
134
+ unlink($file);
135
+ }
136
+ }
137
+ }
138
+ }
139
+
140
+ echo 'success' . PHP_EOL;
lib/composer/ClassLoader.php ADDED
@@ -0,0 +1,445 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /*
4
+ * This file is part of Composer.
5
+ *
6
+ * (c) Nils Adermann <naderman@naderman.de>
7
+ * Jordi Boggiano <j.boggiano@seld.be>
8
+ *
9
+ * For the full copyright and license information, please view the LICENSE
10
+ * file that was distributed with this source code.
11
+ */
12
+
13
+ namespace Composer\Autoload;
14
+
15
+ /**
16
+ * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
17
+ *
18
+ * $loader = new \Composer\Autoload\ClassLoader();
19
+ *
20
+ * // register classes with namespaces
21
+ * $loader->add('Symfony\Component', __DIR__.'/component');
22
+ * $loader->add('Symfony', __DIR__.'/framework');
23
+ *
24
+ * // activate the autoloader
25
+ * $loader->register();
26
+ *
27
+ * // to enable searching the include path (eg. for PEAR packages)
28
+ * $loader->setUseIncludePath(true);
29
+ *
30
+ * In this example, if you try to use a class in the Symfony\Component
31
+ * namespace or one of its children (Symfony\Component\Console for instance),
32
+ * the autoloader will first look for the class under the component/
33
+ * directory, and it will then fallback to the framework/ directory if not
34
+ * found before giving up.
35
+ *
36
+ * This class is loosely based on the Symfony UniversalClassLoader.
37
+ *
38
+ * @author Fabien Potencier <fabien@symfony.com>
39
+ * @author Jordi Boggiano <j.boggiano@seld.be>
40
+ * @see http://www.php-fig.org/psr/psr-0/
41
+ * @see http://www.php-fig.org/psr/psr-4/
42
+ */
43
+ class ClassLoader
44
+ {
45
+ // PSR-4
46
+ private $prefixLengthsPsr4 = array();
47
+ private $prefixDirsPsr4 = array();
48
+ private $fallbackDirsPsr4 = array();
49
+
50
+ // PSR-0
51
+ private $prefixesPsr0 = array();
52
+ private $fallbackDirsPsr0 = array();
53
+
54
+ private $useIncludePath = false;
55
+ private $classMap = array();
56
+ private $classMapAuthoritative = false;
57
+ private $missingClasses = array();
58
+ private $apcuPrefix;
59
+
60
+ public function getPrefixes()
61
+ {
62
+ if (!empty($this->prefixesPsr0)) {
63
+ return call_user_func_array('array_merge', $this->prefixesPsr0);
64
+ }
65
+
66
+ return array();
67
+ }
68
+
69
+ public function getPrefixesPsr4()
70
+ {
71
+ return $this->prefixDirsPsr4;
72
+ }
73
+
74
+ public function getFallbackDirs()
75
+ {
76
+ return $this->fallbackDirsPsr0;
77
+ }
78
+
79
+ public function getFallbackDirsPsr4()
80
+ {
81
+ return $this->fallbackDirsPsr4;
82
+ }
83
+
84
+ public function getClassMap()
85
+ {
86
+ return $this->classMap;
87
+ }
88
+
89
+ /**
90
+ * @param array $classMap Class to filename map
91
+ */
92
+ public function addClassMap(array $classMap)
93
+ {
94
+ if ($this->classMap) {
95
+ $this->classMap = array_merge($this->classMap, $classMap);
96
+ } else {
97
+ $this->classMap = $classMap;
98
+ }
99
+ }
100
+
101
+ /**
102
+ * Registers a set of PSR-0 directories for a given prefix, either
103
+ * appending or prepending to the ones previously set for this prefix.
104
+ *
105
+ * @param string $prefix The prefix
106
+ * @param array|string $paths The PSR-0 root directories
107
+ * @param bool $prepend Whether to prepend the directories
108
+ */
109
+ public function add($prefix, $paths, $prepend = false)
110
+ {
111
+ if (!$prefix) {
112
+ if ($prepend) {
113
+ $this->fallbackDirsPsr0 = array_merge(
114
+ (array) $paths,
115
+ $this->fallbackDirsPsr0
116
+ );
117
+ } else {
118
+ $this->fallbackDirsPsr0 = array_merge(
119
+ $this->fallbackDirsPsr0,
120
+ (array) $paths
121
+ );
122
+ }
123
+
124
+ return;
125
+ }
126
+
127
+ $first = $prefix[0];
128
+ if (!isset($this->prefixesPsr0[$first][$prefix])) {
129
+ $this->prefixesPsr0[$first][$prefix] = (array) $paths;
130
+
131
+ return;
132
+ }
133
+ if ($prepend) {
134
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
135
+ (array) $paths,
136
+ $this->prefixesPsr0[$first][$prefix]
137
+ );
138
+ } else {
139
+ $this->prefixesPsr0[$first][$prefix] = array_merge(
140
+ $this->prefixesPsr0[$first][$prefix],
141
+ (array) $paths
142
+ );
143
+ }
144
+ }
145
+
146
+ /**
147
+ * Registers a set of PSR-4 directories for a given namespace, either
148
+ * appending or prepending to the ones previously set for this namespace.
149
+ *
150
+ * @param string $prefix The prefix/namespace, with trailing '\\'
151
+ * @param array|string $paths The PSR-4 base directories
152
+ * @param bool $prepend Whether to prepend the directories
153
+ *
154
+ * @throws \InvalidArgumentException
155
+ */
156
+ public function addPsr4($prefix, $paths, $prepend = false)
157
+ {
158
+ if (!$prefix) {
159
+ // Register directories for the root namespace.
160
+ if ($prepend) {
161
+ $this->fallbackDirsPsr4 = array_merge(
162
+ (array) $paths,
163
+ $this->fallbackDirsPsr4
164
+ );
165
+ } else {
166
+ $this->fallbackDirsPsr4 = array_merge(
167
+ $this->fallbackDirsPsr4,
168
+ (array) $paths
169
+ );
170
+ }
171
+ } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
172
+ // Register directories for a new namespace.
173
+ $length = strlen($prefix);
174
+ if ('\\' !== $prefix[$length - 1]) {
175
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
176
+ }
177
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
178
+ $this->prefixDirsPsr4[$prefix] = (array) $paths;
179
+ } elseif ($prepend) {
180
+ // Prepend directories for an already registered namespace.
181
+ $this->prefixDirsPsr4[$prefix] = array_merge(
182
+ (array) $paths,
183
+ $this->prefixDirsPsr4[$prefix]
184
+ );
185
+ } else {
186
+ // Append directories for an already registered namespace.
187
+ $this->prefixDirsPsr4[$prefix] = array_merge(
188
+ $this->prefixDirsPsr4[$prefix],
189
+ (array) $paths
190
+ );
191
+ }
192
+ }
193
+
194
+ /**
195
+ * Registers a set of PSR-0 directories for a given prefix,
196
+ * replacing any others previously set for this prefix.
197
+ *
198
+ * @param string $prefix The prefix
199
+ * @param array|string $paths The PSR-0 base directories
200
+ */
201
+ public function set($prefix, $paths)
202
+ {
203
+ if (!$prefix) {
204
+ $this->fallbackDirsPsr0 = (array) $paths;
205
+ } else {
206
+ $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
207
+ }
208
+ }
209
+
210
+ /**
211
+ * Registers a set of PSR-4 directories for a given namespace,
212
+ * replacing any others previously set for this namespace.
213
+ *
214
+ * @param string $prefix The prefix/namespace, with trailing '\\'
215
+ * @param array|string $paths The PSR-4 base directories
216
+ *
217
+ * @throws \InvalidArgumentException
218
+ */
219
+ public function setPsr4($prefix, $paths)
220
+ {
221
+ if (!$prefix) {
222
+ $this->fallbackDirsPsr4 = (array) $paths;
223
+ } else {
224
+ $length = strlen($prefix);
225
+ if ('\\' !== $prefix[$length - 1]) {
226
+ throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
227
+ }
228
+ $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
229
+ $this->prefixDirsPsr4[$prefix] = (array) $paths;
230
+ }
231
+ }
232
+
233
+ /**
234
+ * Turns on searching the include path for class files.
235
+ *
236
+ * @param bool $useIncludePath
237
+ */
238
+ public function setUseIncludePath($useIncludePath)
239
+ {
240
+ $this->useIncludePath = $useIncludePath;
241
+ }
242
+
243
+ /**
244
+ * Can be used to check if the autoloader uses the include path to check
245
+ * for classes.
246
+ *
247
+ * @return bool
248
+ */
249
+ public function getUseIncludePath()
250
+ {
251
+ return $this->useIncludePath;
252
+ }
253
+
254
+ /**
255
+ * Turns off searching the prefix and fallback directories for classes
256
+ * that have not been registered with the class map.
257
+ *
258
+ * @param bool $classMapAuthoritative
259
+ */
260
+ public function setClassMapAuthoritative($classMapAuthoritative)
261
+ {
262
+ $this->classMapAuthoritative = $classMapAuthoritative;
263
+ }
264
+
265
+ /**
266
+ * Should class lookup fail if not found in the current class map?
267
+ *
268
+ * @return bool
269
+ */
270
+ public function isClassMapAuthoritative()
271
+ {
272
+ return $this->classMapAuthoritative;
273
+ }
274
+
275
+ /**
276
+ * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
277
+ *
278
+ * @param string|null $apcuPrefix
279
+ */
280
+ public function setApcuPrefix($apcuPrefix)
281
+ {
282
+ $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
283
+ }
284
+
285
+ /**
286
+ * The APCu prefix in use, or null if APCu caching is not enabled.
287
+ *
288
+ * @return string|null
289
+ */
290
+ public function getApcuPrefix()
291
+ {
292
+ return $this->apcuPrefix;
293
+ }
294
+
295
+ /**
296
+ * Registers this instance as an autoloader.
297
+ *
298
+ * @param bool $prepend Whether to prepend the autoloader or not
299
+ */
300
+ public function register($prepend = false)
301
+ {
302
+ spl_autoload_register(array($this, 'loadClass'), true, $prepend);
303
+ }
304
+
305
+ /**
306
+ * Unregisters this instance as an autoloader.
307
+ */
308
+ public function unregister()
309
+ {
310
+ spl_autoload_unregister(array($this, 'loadClass'));
311
+ }
312
+
313
+ /**
314
+ * Loads the given class or interface.
315
+ *
316
+ * @param string $class The name of the class
317
+ * @return bool|null True if loaded, null otherwise
318
+ */
319
+ public function loadClass($class)
320
+ {
321
+ if ($file = $this->findFile($class)) {
322
+ includeFile($file);
323
+
324
+ return true;
325
+ }
326
+ }
327
+
328
+ /**
329
+ * Finds the path to the file where the class is defined.
330
+ *
331
+ * @param string $class The name of the class
332
+ *
333
+ * @return string|false The path if found, false otherwise
334
+ */
335
+ public function findFile($class)
336
+ {
337
+ // class map lookup
338
+ if (isset($this->classMap[$class])) {
339
+ return $this->classMap[$class];
340
+ }
341
+ if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
342
+ return false;
343
+ }
344
+ if (null !== $this->apcuPrefix) {
345
+ $file = apcu_fetch($this->apcuPrefix.$class, $hit);
346
+ if ($hit) {
347
+ return $file;
348
+ }
349
+ }
350
+
351
+ $file = $this->findFileWithExtension($class, '.php');
352
+
353
+ // Search for Hack files if we are running on HHVM
354
+ if (false === $file && defined('HHVM_VERSION')) {
355
+ $file = $this->findFileWithExtension($class, '.hh');
356
+ }
357
+
358
+ if (null !== $this->apcuPrefix) {
359
+ apcu_add($this->apcuPrefix.$class, $file);
360
+ }
361
+
362
+ if (false === $file) {
363
+ // Remember that this class does not exist.
364
+ $this->missingClasses[$class] = true;
365
+ }
366
+
367
+ return $file;
368
+ }
369
+
370
+ private function findFileWithExtension($class, $ext)
371
+ {
372
+ // PSR-4 lookup
373
+ $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
374
+
375
+ $first = $class[0];
376
+ if (isset($this->prefixLengthsPsr4[$first])) {
377
+ $subPath = $class;
378
+ while (false !== $lastPos = strrpos($subPath, '\\')) {
379
+ $subPath = substr($subPath, 0, $lastPos);
380
+ $search = $subPath . '\\';
381
+ if (isset($this->prefixDirsPsr4[$search])) {
382
+ $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
383
+ foreach ($this->prefixDirsPsr4[$search] as $dir) {
384
+ if (file_exists($file = $dir . $pathEnd)) {
385
+ return $file;
386
+ }
387
+ }
388
+ }
389
+ }
390
+ }
391
+
392
+ // PSR-4 fallback dirs
393
+ foreach ($this->fallbackDirsPsr4 as $dir) {
394
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
395
+ return $file;
396
+ }
397
+ }
398
+
399
+ // PSR-0 lookup
400
+ if (false !== $pos = strrpos($class, '\\')) {
401
+ // namespaced class name
402
+ $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
403
+ . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
404
+ } else {
405
+ // PEAR-like class name
406
+ $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
407
+ }
408
+
409
+ if (isset($this->prefixesPsr0[$first])) {
410
+ foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
411
+ if (0 === strpos($class, $prefix)) {
412
+ foreach ($dirs as $dir) {
413
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
414
+ return $file;
415
+ }
416
+ }
417
+ }
418
+ }
419
+ }
420
+
421
+ // PSR-0 fallback dirs
422
+ foreach ($this->fallbackDirsPsr0 as $dir) {
423
+ if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
424
+ return $file;
425
+ }
426
+ }
427
+
428
+ // PSR-0 include paths.
429
+ if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
430
+ return $file;
431
+ }
432
+
433
+ return false;
434
+ }
435
+ }
436
+
437
+ /**
438
+ * Scope isolated include.
439
+ *
440
+ * Prevents access to $this/self from included files.
441
+ */
442
+ function includeFile($file)
443
+ {
444
+ include $file;
445
+ }
lib/composer/LICENSE ADDED
@@ -0,0 +1,21 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+
2
+ Copyright (c) Nils Adermann, Jordi Boggiano
3
+
4
+ Permission is hereby granted, free of charge, to any person obtaining a copy
5
+ of this software and associated documentation files (the "Software"), to deal
6
+ in the Software without restriction, including without limitation the rights
7
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8
+ copies of the Software, and to permit persons to whom the Software is furnished
9
+ to do so, subject to the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be included in all
12
+ copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20
+ THE SOFTWARE.
21
+
lib/composer/autoload_classmap.php ADDED
@@ -0,0 +1,9 @@
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_classmap.php @generated by Composer
4
+
5
+ $vendorDir = dirname(dirname(__FILE__));
6
+ $baseDir = dirname($vendorDir);
7
+
8
+ return array(
9
+ );
lib/composer/autoload_files.php ADDED
@@ -0,0 +1,51 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_files.php @generated by Composer
4
+
5
+ $vendorDir = dirname(dirname(__FILE__));
6
+ $baseDir = dirname($vendorDir);
7
+
8
+ return array(
9
+ 'abede361264e2ae69ec1eee813a101af' => $vendorDir . '/markbaker/complex/classes/src/functions/abs.php',
10
+ '21a5860fbef5be28db5ddfbc3cca67c4' => $vendorDir . '/markbaker/complex/classes/src/functions/acos.php',
11
+ '1546e3f9d127f2a9bb2d1b6c31c26ef1' => $vendorDir . '/markbaker/complex/classes/src/functions/acosh.php',
12
+ 'd2516f7f4fba5ea5905f494b4a8262e0' => $vendorDir . '/markbaker/complex/classes/src/functions/acot.php',
13
+ '4511163d560956219b96882c0980b65e' => $vendorDir . '/markbaker/complex/classes/src/functions/acoth.php',
14
+ 'c361f5616dc2a8da4fa3e137077cd4ea' => $vendorDir . '/markbaker/complex/classes/src/functions/acsc.php',
15
+ '02d68920fc98da71991ce569c91df0f6' => $vendorDir . '/markbaker/complex/classes/src/functions/acsch.php',
16
+ '88e19525eae308b4a6aa3419364875d3' => $vendorDir . '/markbaker/complex/classes/src/functions/argument.php',
17
+ '60e8e2d0827b58bfc904f13957e51849' => $vendorDir . '/markbaker/complex/classes/src/functions/asec.php',
18
+ '13d2f040713999eab66c359b4d79871d' => $vendorDir . '/markbaker/complex/classes/src/functions/asech.php',
19
+ '838ab38beb32c68a79d3cd2c007d5a04' => $vendorDir . '/markbaker/complex/classes/src/functions/asin.php',
20
+ 'bb28eccd0f8f008333a1b3c163d604ac' => $vendorDir . '/markbaker/complex/classes/src/functions/asinh.php',
21
+ '9e483de83558c98f7d3feaa402c78cb3' => $vendorDir . '/markbaker/complex/classes/src/functions/atan.php',
22
+ '36b74b5b765ded91ee58c8ee3c0e85e3' => $vendorDir . '/markbaker/complex/classes/src/functions/atanh.php',
23
+ '05c15ee9510da7fd6bf6136f436500c0' => $vendorDir . '/markbaker/complex/classes/src/functions/conjugate.php',
24
+ 'd3208dfbce2505e370788f9f22f6785f' => $vendorDir . '/markbaker/complex/classes/src/functions/cos.php',
25
+ '141cf1fb3a3046f8b64534b0ebab33ca' => $vendorDir . '/markbaker/complex/classes/src/functions/cosh.php',
26
+ 'be660df75fd0dbe7fa7c03b7434b3294' => $vendorDir . '/markbaker/complex/classes/src/functions/cot.php',
27
+ '01e31ea298a51bc9e91517e3ce6b9e76' => $vendorDir . '/markbaker/complex/classes/src/functions/coth.php',
28
+ '803ddd97f7b1da68982a7b087c3476f6' => $vendorDir . '/markbaker/complex/classes/src/functions/csc.php',
29
+ '3001cdfd101ec3c32da34ee43c2e149b' => $vendorDir . '/markbaker/complex/classes/src/functions/csch.php',
30
+ '77b2d7629ef2a93fabb8c56754a91051' => $vendorDir . '/markbaker/complex/classes/src/functions/exp.php',
31
+ '4a4471296dec796c21d4f4b6552396a9' => $vendorDir . '/markbaker/complex/classes/src/functions/inverse.php',
32
+ 'c3e9897e1744b88deb56fcdc39d34d85' => $vendorDir . '/markbaker/complex/classes/src/functions/ln.php',
33
+ 'a83cacf2de942cff288de15a83afd26d' => $vendorDir . '/markbaker/complex/classes/src/functions/log2.php',
34
+ '6a861dacc9ee2f3061241d4c7772fa21' => $vendorDir . '/markbaker/complex/classes/src/functions/log10.php',
35
+ '4d2522d968c8ba78d6c13548a1b4200e' => $vendorDir . '/markbaker/complex/classes/src/functions/negative.php',
36
+ 'fd587ca933fc0447fa5ab4843bdd97f7' => $vendorDir . '/markbaker/complex/classes/src/functions/pow.php',
37
+ '383ef01c62028fc78cd4388082fce3c2' => $vendorDir . '/markbaker/complex/classes/src/functions/rho.php',
38
+ '150fbd1b95029dc47292da97ecab9375' => $vendorDir . '/markbaker/complex/classes/src/functions/sec.php',
39
+ '549abd9bae174286d660bdaa07407c68' => $vendorDir . '/markbaker/complex/classes/src/functions/sech.php',
40
+ '6bfbf5eaea6b17a0ed85cb21ba80370c' => $vendorDir . '/markbaker/complex/classes/src/functions/sin.php',
41
+ '22efe13f1a497b8e199540ae2d9dc59c' => $vendorDir . '/markbaker/complex/classes/src/functions/sinh.php',
42
+ 'e90135ab8e787795a509ed7147de207d' => $vendorDir . '/markbaker/complex/classes/src/functions/sqrt.php',
43
+ 'bb0a7923ffc6a90919cd64ec54ff06bc' => $vendorDir . '/markbaker/complex/classes/src/functions/tan.php',
44
+ '2d302f32ce0fd4e433dd91c5bb404a28' => $vendorDir . '/markbaker/complex/classes/src/functions/tanh.php',
45
+ '24dd4658a952171a4ee79218c4f9fd06' => $vendorDir . '/markbaker/complex/classes/src/functions/theta.php',
46
+ 'e49b7876281d6f5bc39536dde96d1f4a' => $vendorDir . '/markbaker/complex/classes/src/operations/add.php',
47
+ '47596e02b43cd6da7700134fd08f88cf' => $vendorDir . '/markbaker/complex/classes/src/operations/subtract.php',
48
+ '883af48563631547925fa4c3b48ead07' => $vendorDir . '/markbaker/complex/classes/src/operations/multiply.php',
49
+ 'f190e3308e6ca23234a2875edc985c03' => $vendorDir . '/markbaker/complex/classes/src/operations/divideby.php',
50
+ 'ac9e33ce6841aa5bf5d16d465a2f03a7' => $vendorDir . '/markbaker/complex/classes/src/operations/divideinto.php',
51
+ );
lib/composer/autoload_namespaces.php ADDED
@@ -0,0 +1,11 @@
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_namespaces.php @generated by Composer
4
+
5
+ $vendorDir = dirname(dirname(__FILE__));
6
+ $baseDir = dirname($vendorDir);
7
+
8
+ return array(
9
+ 'PHPSQLParser\\' => array($vendorDir . '/greenlion/php-sql-parser/src'),
10
+ 'Analog' => array($vendorDir . '/analog/analog/lib'),
11
+ );
lib/composer/autoload_psr4.php ADDED
@@ -0,0 +1,14 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_psr4.php @generated by Composer
4
+
5
+ $vendorDir = dirname(dirname(__FILE__));
6
+ $baseDir = dirname($vendorDir);
7
+
8
+ return array(
9
+ 'jlawrence\\eos\\' => array($vendorDir . '/jlawrence/eos/src'),
10
+ 'Psr\\SimpleCache\\' => array($vendorDir . '/psr/simple-cache/src'),
11
+ 'Psr\\Log\\' => array($vendorDir . '/psr/log/Psr/Log'),
12
+ 'PhpOffice\\PhpSpreadsheet\\' => array($vendorDir . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet'),
13
+ 'Complex\\' => array($vendorDir . '/markbaker/complex/classes/src'),
14
+ );
lib/composer/autoload_real.php ADDED
@@ -0,0 +1,70 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_real.php @generated by Composer
4
+
5
+ class ComposerAutoloaderInit7d0a298bb30f5ff6bc20a6405b7fdab0
6
+ {
7
+ private static $loader;
8
+
9
+ public static function loadClassLoader($class)
10
+ {
11
+ if ('Composer\Autoload\ClassLoader' === $class) {
12
+ require __DIR__ . '/ClassLoader.php';
13
+ }
14
+ }
15
+
16
+ public static function getLoader()
17
+ {
18
+ if (null !== self::$loader) {
19
+ return self::$loader;
20
+ }
21
+
22
+ spl_autoload_register(array('ComposerAutoloaderInit7d0a298bb30f5ff6bc20a6405b7fdab0', 'loadClassLoader'), true, true);
23
+ self::$loader = $loader = new \Composer\Autoload\ClassLoader();
24
+ spl_autoload_unregister(array('ComposerAutoloaderInit7d0a298bb30f5ff6bc20a6405b7fdab0', 'loadClassLoader'));
25
+
26
+ $useStaticLoader = PHP_VERSION_ID >= 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded());
27
+ if ($useStaticLoader) {
28
+ require_once __DIR__ . '/autoload_static.php';
29
+
30
+ call_user_func(\Composer\Autoload\ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0::getInitializer($loader));
31
+ } else {
32
+ $map = require __DIR__ . '/autoload_namespaces.php';
33
+ foreach ($map as $namespace => $path) {
34
+ $loader->set($namespace, $path);
35
+ }
36
+
37
+ $map = require __DIR__ . '/autoload_psr4.php';
38
+ foreach ($map as $namespace => $path) {
39
+ $loader->setPsr4($namespace, $path);
40
+ }
41
+
42
+ $classMap = require __DIR__ . '/autoload_classmap.php';
43
+ if ($classMap) {
44
+ $loader->addClassMap($classMap);
45
+ }
46
+ }
47
+
48
+ $loader->register(true);
49
+
50
+ if ($useStaticLoader) {
51
+ $includeFiles = Composer\Autoload\ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0::$files;
52
+ } else {
53
+ $includeFiles = require __DIR__ . '/autoload_files.php';
54
+ }
55
+ foreach ($includeFiles as $fileIdentifier => $file) {
56
+ composerRequire7d0a298bb30f5ff6bc20a6405b7fdab0($fileIdentifier, $file);
57
+ }
58
+
59
+ return $loader;
60
+ }
61
+ }
62
+
63
+ function composerRequire7d0a298bb30f5ff6bc20a6405b7fdab0($fileIdentifier, $file)
64
+ {
65
+ if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
66
+ require $file;
67
+
68
+ $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
69
+ }
70
+ }
lib/composer/autoload_static.php ADDED
@@ -0,0 +1,120 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ // autoload_static.php @generated by Composer
4
+
5
+ namespace Composer\Autoload;
6
+
7
+ class ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0
8
+ {
9
+ public static $files = array (
10
+ 'abede361264e2ae69ec1eee813a101af' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/abs.php',
11
+ '21a5860fbef5be28db5ddfbc3cca67c4' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acos.php',
12
+ '1546e3f9d127f2a9bb2d1b6c31c26ef1' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acosh.php',
13
+ 'd2516f7f4fba5ea5905f494b4a8262e0' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acot.php',
14
+ '4511163d560956219b96882c0980b65e' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acoth.php',
15
+ 'c361f5616dc2a8da4fa3e137077cd4ea' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acsc.php',
16
+ '02d68920fc98da71991ce569c91df0f6' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/acsch.php',
17
+ '88e19525eae308b4a6aa3419364875d3' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/argument.php',
18
+ '60e8e2d0827b58bfc904f13957e51849' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/asec.php',
19
+ '13d2f040713999eab66c359b4d79871d' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/asech.php',
20
+ '838ab38beb32c68a79d3cd2c007d5a04' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/asin.php',
21
+ 'bb28eccd0f8f008333a1b3c163d604ac' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/asinh.php',
22
+ '9e483de83558c98f7d3feaa402c78cb3' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/atan.php',
23
+ '36b74b5b765ded91ee58c8ee3c0e85e3' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/atanh.php',
24
+ '05c15ee9510da7fd6bf6136f436500c0' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/conjugate.php',
25
+ 'd3208dfbce2505e370788f9f22f6785f' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/cos.php',
26
+ '141cf1fb3a3046f8b64534b0ebab33ca' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/cosh.php',
27
+ 'be660df75fd0dbe7fa7c03b7434b3294' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/cot.php',
28
+ '01e31ea298a51bc9e91517e3ce6b9e76' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/coth.php',
29
+ '803ddd97f7b1da68982a7b087c3476f6' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/csc.php',
30
+ '3001cdfd101ec3c32da34ee43c2e149b' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/csch.php',
31
+ '77b2d7629ef2a93fabb8c56754a91051' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/exp.php',
32
+ '4a4471296dec796c21d4f4b6552396a9' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/inverse.php',
33
+ 'c3e9897e1744b88deb56fcdc39d34d85' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/ln.php',
34
+ 'a83cacf2de942cff288de15a83afd26d' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/log2.php',
35
+ '6a861dacc9ee2f3061241d4c7772fa21' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/log10.php',
36
+ '4d2522d968c8ba78d6c13548a1b4200e' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/negative.php',
37
+ 'fd587ca933fc0447fa5ab4843bdd97f7' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/pow.php',
38
+ '383ef01c62028fc78cd4388082fce3c2' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/rho.php',
39
+ '150fbd1b95029dc47292da97ecab9375' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/sec.php',
40
+ '549abd9bae174286d660bdaa07407c68' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/sech.php',
41
+ '6bfbf5eaea6b17a0ed85cb21ba80370c' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/sin.php',
42
+ '22efe13f1a497b8e199540ae2d9dc59c' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/sinh.php',
43
+ 'e90135ab8e787795a509ed7147de207d' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/sqrt.php',
44
+ 'bb0a7923ffc6a90919cd64ec54ff06bc' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/tan.php',
45
+ '2d302f32ce0fd4e433dd91c5bb404a28' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/tanh.php',
46
+ '24dd4658a952171a4ee79218c4f9fd06' => __DIR__ . '/..' . '/markbaker/complex/classes/src/functions/theta.php',
47
+ 'e49b7876281d6f5bc39536dde96d1f4a' => __DIR__ . '/..' . '/markbaker/complex/classes/src/operations/add.php',
48
+ '47596e02b43cd6da7700134fd08f88cf' => __DIR__ . '/..' . '/markbaker/complex/classes/src/operations/subtract.php',
49
+ '883af48563631547925fa4c3b48ead07' => __DIR__ . '/..' . '/markbaker/complex/classes/src/operations/multiply.php',
50
+ 'f190e3308e6ca23234a2875edc985c03' => __DIR__ . '/..' . '/markbaker/complex/classes/src/operations/divideby.php',
51
+ 'ac9e33ce6841aa5bf5d16d465a2f03a7' => __DIR__ . '/..' . '/markbaker/complex/classes/src/operations/divideinto.php',
52
+ );
53
+
54
+ public static $prefixLengthsPsr4 = array (
55
+ 'j' =>
56
+ array (
57
+ 'jlawrence\\eos\\' => 14,
58
+ ),
59
+ 'P' =>
60
+ array (
61
+ 'Psr\\SimpleCache\\' => 16,
62
+ 'Psr\\Log\\' => 8,
63
+ 'PhpOffice\\PhpSpreadsheet\\' => 25,
64
+ ),
65
+ 'C' =>
66
+ array (
67
+ 'Complex\\' => 8,
68
+ ),
69
+ );
70
+
71
+ public static $prefixDirsPsr4 = array (
72
+ 'jlawrence\\eos\\' =>
73
+ array (
74
+ 0 => __DIR__ . '/..' . '/jlawrence/eos/src',
75
+ ),
76
+ 'Psr\\SimpleCache\\' =>
77
+ array (
78
+ 0 => __DIR__ . '/..' . '/psr/simple-cache/src',
79
+ ),
80
+ 'Psr\\Log\\' =>
81
+ array (
82
+ 0 => __DIR__ . '/..' . '/psr/log/Psr/Log',
83
+ ),
84
+ 'PhpOffice\\PhpSpreadsheet\\' =>
85
+ array (
86
+ 0 => __DIR__ . '/..' . '/phpoffice/phpspreadsheet/src/PhpSpreadsheet',
87
+ ),
88
+ 'Complex\\' =>
89
+ array (
90
+ 0 => __DIR__ . '/..' . '/markbaker/complex/classes/src',
91
+ ),
92
+ );
93
+
94
+ public static $prefixesPsr0 = array (
95
+ 'P' =>
96
+ array (
97
+ 'PHPSQLParser\\' =>
98
+ array (
99
+ 0 => __DIR__ . '/..' . '/greenlion/php-sql-parser/src',
100
+ ),
101
+ ),
102
+ 'A' =>
103
+ array (
104
+ 'Analog' =>
105
+ array (
106
+ 0 => __DIR__ . '/..' . '/analog/analog/lib',
107
+ ),
108
+ ),
109
+ );
110
+
111
+ public static function getInitializer(ClassLoader $loader)
112
+ {
113
+ return \Closure::bind(function () use ($loader) {
114
+ $loader->prefixLengthsPsr4 = ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0::$prefixLengthsPsr4;
115
+ $loader->prefixDirsPsr4 = ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0::$prefixDirsPsr4;
116
+ $loader->prefixesPsr0 = ComposerStaticInit7d0a298bb30f5ff6bc20a6405b7fdab0::$prefixesPsr0;
117
+
118
+ }, null, ClassLoader::class);
119
+ }
120
+ }
lib/composer/installed.json ADDED
@@ -0,0 +1,487 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ [
2
+ {
3
+ "name": "analog/analog",
4
+ "version": "1.0.13-stable",
5
+ "version_normalized": "1.0.13.0",
6
+ "source": {
7
+ "type": "git",
8
+ "url": "https://github.com/jbroadway/analog.git",
9
+ "reference": "718ac1dad4577a15cadadab01b79d1923f5a9c6d"
10
+ },
11
+ "dist": {
12
+ "type": "zip",
13
+ "url": "https://api.github.com/repos/jbroadway/analog/zipball/718ac1dad4577a15cadadab01b79d1923f5a9c6d",
14
+ "reference": "718ac1dad4577a15cadadab01b79d1923f5a9c6d",
15
+ "shasum": ""
16
+ },
17
+ "require": {
18
+ "php": ">=5.3.2",
19
+ "psr/log": "1.*"
20
+ },
21
+ "require-dev": {
22
+ "phpunit/phpunit": "^4.8.36 || ^5.7 || ^6.5"
23
+ },
24
+ "time": "2019-06-27T16:18:03+00:00",
25
+ "type": "library",
26
+ "installation-source": "dist",
27
+ "autoload": {
28
+ "psr-0": {
29
+ "Analog": "lib/"
30
+ }
31
+ },
32
+ "notification-url": "https://packagist.org/downloads/",
33
+ "license": [
34
+ "MIT"
35
+ ],
36
+ "authors": [
37
+ {
38
+ "name": "Johnny Broadway",
39
+ "email": "johnny@johnnybroadway.com",
40
+ "homepage": "http://www.johnnybroadway.com/"
41
+ }
42
+ ],
43
+ "description": "PHP logging class that can be extended via closures. Includes several pre-built handlers including file, mail, syslog, HTTP post, and MongoDB.",
44
+ "homepage": "https://github.com/jbroadway/analog",
45
+ "keywords": [
46
+ "alerts",
47
+ "debug",
48
+ "debugging",
49
+ "error",
50
+ "log",
51
+ "logger",
52
+ "logging",
53
+ "syslog"
54
+ ]
55
+ },
56
+ {
57
+ "name": "greenlion/php-sql-parser",
58
+ "version": "v4.1.2",
59
+ "version_normalized": "4.1.2.0",
60
+ "source": {
61
+ "type": "git",
62
+ "url": "https://github.com/greenlion/PHP-SQL-Parser.git",
63
+ "reference": "b4e8522ebca3e5c8bbd4e2c25edaef155a96db20"
64
+ },
65
+ "dist": {
66
+ "type": "zip",
67
+ "url": "https://api.github.com/repos/greenlion/PHP-SQL-Parser/zipball/b4e8522ebca3e5c8bbd4e2c25edaef155a96db20",
68
+ "reference": "b4e8522ebca3e5c8bbd4e2c25edaef155a96db20",
69
+ "shasum": ""
70
+ },
71
+ "require": {
72
+ "analog/analog": "^1.0.6",
73
+ "php": ">=5.3.2"
74
+ },
75
+ "require-dev": {
76
+ "phpunit/phpunit": "^4.0.14",
77
+ "squizlabs/php_codesniffer": "^1.5.1"
78
+ },
79
+ "time": "2017-05-16T21:20:45+00:00",
80
+ "type": "library",
81
+ "installation-source": "dist",
82
+ "autoload": {
83
+ "psr-0": {
84
+ "PHPSQLParser\\": "src/"
85
+ }
86
+ },
87
+ "notification-url": "https://packagist.org/downloads/",
88
+ "license": [
89
+ "BSD-3-Clause"
90
+ ],
91
+ "authors": [
92
+ {
93
+ "name": "André Rothe",
94
+ "email": "phosco@gmx.de",
95
+ "homepage": "https://www.phosco.info",
96
+ "role": "Committer"
97
+ },
98
+ {
99
+ "name": "Justin Swanhart",
100
+ "email": "greenlion@gmail.com",
101
+ "homepage": "http://code.google.com/u/greenlion@gmail.com/",
102
+ "role": "Owner"
103
+ }
104
+ ],
105
+ "description": "A pure PHP SQL (non validating) parser w/ focus on MySQL dialect of SQL",
106
+ "homepage": "https://github.com/greenlion/PHP-SQL-Parser",
107
+ "keywords": [
108
+ "creator",
109
+ "mysql",
110
+ "parser",
111
+ "sql"
112
+ ]
113
+ },
114
+ {
115
+ "name": "jlawrence/eos",
116
+ "version": "v3.2.2",
117
+ "version_normalized": "3.2.2.0",
118
+ "source": {
119
+ "type": "git",
120
+ "url": "https://github.com/jlawrence11/eos.git",
121
+ "reference": "25e3d0f2316cb4636000f452a8e7dcc83725a32a"
122
+ },
123
+ "dist": {
124
+ "type": "zip",
125
+ "url": "https://api.github.com/repos/jlawrence11/eos/zipball/25e3d0f2316cb4636000f452a8e7dcc83725a32a",
126
+ "reference": "25e3d0f2316cb4636000f452a8e7dcc83725a32a",
127
+ "shasum": ""
128
+ },
129
+ "require-dev": {
130
+ "codeclimate/php-test-reporter": "dev-master",
131
+ "phpunit/phpunit": "4.*"
132
+ },
133
+ "time": "2016-03-02T22:35:41+00:00",
134
+ "type": "library",
135
+ "installation-source": "dist",
136
+ "autoload": {
137
+ "psr-4": {
138
+ "jlawrence\\eos\\": "src/"
139
+ }
140
+ },
141
+ "notification-url": "https://packagist.org/downloads/",
142
+ "license": [
143
+ "LGPL-2.1+"
144
+ ],
145
+ "authors": [
146
+ {
147
+ "name": "Jon Lawrence",
148
+ "email": "jon@jon-lawrence.com"
149
+ }
150
+ ],
151
+ "description": "Parse and solve math equations without using 'eval()'.",
152
+ "keywords": [
153
+ "eos",
154
+ "equations",
155
+ "math",
156
+ "solve"
157
+ ]
158
+ },
159
+ {
160
+ "name": "markbaker/complex",
161
+ "version": "1.4.7",
162
+ "version_normalized": "1.4.7.0",
163
+ "source": {
164
+ "type": "git",
165
+ "url": "https://github.com/MarkBaker/PHPComplex.git",
166
+ "reference": "1ea674a8308baf547cbcbd30c5fcd6d301b7c000"
167
+ },
168
+ "dist": {
169
+ "type": "zip",
170
+ "url": "https://api.github.com/repos/MarkBaker/PHPComplex/zipball/1ea674a8308baf547cbcbd30c5fcd6d301b7c000",
171
+ "reference": "1ea674a8308baf547cbcbd30c5fcd6d301b7c000",
172
+ "shasum": ""
173
+ },
174
+ "require": {
175
+ "php": "^5.6.0|^7.0.0"
176
+ },
177
+ "require-dev": {
178
+ "dealerdirect/phpcodesniffer-composer-installer": "^0.4.3",
179
+ "phpcompatibility/php-compatibility": "^8.0",
180
+ "phpdocumentor/phpdocumentor": "2.*",
181
+ "phploc/phploc": "2.*",
182
+ "phpmd/phpmd": "2.*",
183
+ "phpunit/phpunit": "^4.8.35|^5.4.0",
184
+ "sebastian/phpcpd": "2.*",
185
+ "squizlabs/php_codesniffer": "^3.3.0"
186
+ },
187
+ "time": "2018-10-13T23:28:42+00:00",
188
+ "type": "library",
189
+ "installation-source": "dist",
190
+ "autoload": {
191
+ "psr-4": {
192
+ "Complex\\": "classes/src/"
193
+ },
194
+ "files": [
195
+ "classes/src/functions/abs.php",
196
+ "classes/src/functions/acos.php",
197
+ "classes/src/functions/acosh.php",
198
+ "classes/src/functions/acot.php",
199
+ "classes/src/functions/acoth.php",
200
+ "classes/src/functions/acsc.php",
201
+ "classes/src/functions/acsch.php",
202
+ "classes/src/functions/argument.php",
203
+ "classes/src/functions/asec.php",
204
+ "classes/src/functions/asech.php",
205
+ "classes/src/functions/asin.php",
206
+ "classes/src/functions/asinh.php",
207
+ "classes/src/functions/atan.php",
208
+ "classes/src/functions/atanh.php",
209
+ "classes/src/functions/conjugate.php",
210
+ "classes/src/functions/cos.php",
211
+ "classes/src/functions/cosh.php",
212
+ "classes/src/functions/cot.php",
213
+ "classes/src/functions/coth.php",
214
+ "classes/src/functions/csc.php",
215
+ "classes/src/functions/csch.php",
216
+ "classes/src/functions/exp.php",
217
+ "classes/src/functions/inverse.php",
218
+ "classes/src/functions/ln.php",
219
+ "classes/src/functions/log2.php",
220
+ "classes/src/functions/log10.php",
221
+ "classes/src/functions/negative.php",
222
+ "classes/src/functions/pow.php",
223
+ "classes/src/functions/rho.php",
224
+ "classes/src/functions/sec.php",
225
+ "classes/src/functions/sech.php",
226
+ "classes/src/functions/sin.php",
227
+ "classes/src/functions/sinh.php",
228
+ "classes/src/functions/sqrt.php",
229
+ "classes/src/functions/tan.php",
230
+ "classes/src/functions/tanh.php",
231
+ "classes/src/functions/theta.php",
232
+ "classes/src/operations/add.php",
233
+ "classes/src/operations/subtract.php",
234
+ "classes/src/operations/multiply.php",
235
+ "classes/src/operations/divideby.php",
236
+ "classes/src/operations/divideinto.php"
237
+ ]
238
+ },
239
+ "notification-url": "https://packagist.org/downloads/",
240
+ "license": [
241
+ "MIT"
242
+ ],
243
+ "authors": [
244
+ {
245
+ "name": "Mark Baker",
246
+ "email": "mark@lange.demon.co.uk"
247
+ }
248
+ ],
249
+ "description": "PHP Class for working with complex numbers",
250
+ "homepage": "https://github.com/MarkBaker/PHPComplex",
251
+ "keywords": [
252
+ "complex",
253
+ "mathematics"
254
+ ]
255
+ },
256
+ {
257
+ "name": "phpoffice/phpspreadsheet",
258
+ "version": "1.4.0",
259
+ "version_normalized": "1.4.0.0",
260
+ "source": {
261
+ "type": "git",
262
+ "url": "https://github.com/PHPOffice/PhpSpreadsheet.git",
263
+ "reference": "125f462a718956f37d81305ca0df4f17cef0f3b9"
264
+ },
265
+ "dist": {
266
+ "type": "zip",
267
+ "url": "https://api.github.com/repos/PHPOffice/PhpSpreadsheet/zipball/125f462a718956f37d81305ca0df4f17cef0f3b9",
268
+ "reference": "125f462a718956f37d81305ca0df4f17cef0f3b9",
269
+ "shasum": ""
270
+ },
271
+ "require": {
272
+ "ext-ctype": "*",
273
+ "ext-dom": "*",
274
+ "ext-gd": "*",
275
+ "ext-iconv": "*",
276
+ "ext-libxml": "*",
277
+ "ext-mbstring": "*",
278
+ "ext-simplexml": "*",
279
+ "ext-xml": "*",
280
+ "ext-xmlreader": "*",
281
+ "ext-xmlwriter": "*",
282
+ "ext-zip": "*",
283
+ "ext-zlib": "*",
284
+ "markbaker/complex": "^1.4.1",
285
+ "php": "^5.6|^7.0",
286
+ "psr/simple-cache": "^1.0"
287
+ },
288
+ "require-dev": {
289
+ "dompdf/dompdf": "^0.8.0",
290
+ "friendsofphp/php-cs-fixer": "@stable",
291
+ "jpgraph/jpgraph": "^4.0",
292
+ "mpdf/mpdf": "^7.0.0",
293
+ "phpunit/phpunit": "^5.7",
294
+ "squizlabs/php_codesniffer": "^3.3",
295
+ "tecnickcom/tcpdf": "^6.2"
296
+ },
297
+ "suggest": {
298
+ "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
299
+ "jpgraph/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers",
300
+ "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
301
+ "tecnick.com/tcpdf": "Option for rendering PDF with PDF Writer"
302
+ },
303
+ "time": "2018-08-06T02:58:06+00:00",
304
+ "type": "library",
305
+ "installation-source": "dist",
306
+ "autoload": {
307
+ "psr-4": {
308
+ "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
309
+ }
310
+ },
311
+ "notification-url": "https://packagist.org/downloads/",
312
+ "license": [
313
+ "LGPL-2.1-or-later"
314
+ ],
315
+ "authors": [
316
+ {
317
+ "name": "Maarten Balliauw",
318
+ "homepage": "http://blog.maartenballiauw.be"
319
+ },
320
+ {
321
+ "name": "Erik Tilt"
322
+ },
323
+ {
324
+ "name": "Franck Lefevre",
325
+ "homepage": "http://rootslabs.net"
326
+ },
327
+ {
328
+ "name": "Mark Baker",
329
+ "homepage": "http://markbakeruk.net"
330
+ }
331
+ ],
332
+ "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
333
+ "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
334
+ "keywords": [
335
+ "OpenXML",
336
+ "excel",
337
+ "gnumeric",
338
+ "ods",
339
+ "php",
340
+ "spreadsheet",
341
+ "xls",
342
+ "xlsx"
343
+ ]
344
+ },
345
+ {
346
+ "name": "psr/log",
347
+ "version": "1.1.0",
348
+ "version_normalized": "1.1.0.0",
349
+ "source": {
350
+ "type": "git",
351
+ "url": "https://github.com/php-fig/log.git",
352
+ "reference": "6c001f1daafa3a3ac1d8ff69ee4db8e799a654dd"
353
+ },
354
+ "dist": {
355
+ "type": "zip",
356
+ "url": "https://api.github.com/repos/php-fig/log/zipball/6c001f1daafa3a3ac1d8ff69ee4db8e799a654dd",
357
+ "reference": "6c001f1daafa3a3ac1d8ff69ee4db8e799a654dd",
358
+ "shasum": ""
359
+ },
360
+ "require": {
361
+ "php": ">=5.3.0"
362
+ },
363
+ "time": "2018-11-20T15:27:04+00:00",
364
+ "type": "library",
365
+ "extra": {
366
+ "branch-alias": {
367
+ "dev-master": "1.0.x-dev"
368
+ }
369
+ },
370
+ "installation-source": "dist",
371
+ "autoload": {
372
+ "psr-4": {
373
+ "Psr\\Log\\": "Psr/Log/"
374
+ }
375
+ },
376
+ "notification-url": "https://packagist.org/downloads/",
377
+ "license": [
378
+ "MIT"
379
+ ],
380
+ "authors": [
381
+ {
382
+ "name": "PHP-FIG",
383
+ "homepage": "http://www.php-fig.org/"
384
+ }
385
+ ],
386
+ "description": "Common interface for logging libraries",
387
+ "homepage": "https://github.com/php-fig/log",
388
+ "keywords": [
389
+ "log",
390
+ "psr",
391
+ "psr-3"
392
+ ]
393
+ },
394
+ {
395
+ "name": "psr/simple-cache",
396
+ "version": "1.0.1",
397
+ "version_normalized": "1.0.1.0",
398
+ "source": {
399
+ "type": "git",
400
+ "url": "https://github.com/php-fig/simple-cache.git",
401
+ "reference": "408d5eafb83c57f6365a3ca330ff23aa4a5fa39b"
402
+ },
403
+ "dist": {
404
+ "type": "zip",
405
+ "url": "https://api.github.com/repos/php-fig/simple-cache/zipball/408d5eafb83c57f6365a3ca330ff23aa4a5fa39b",
406
+ "reference": "408d5eafb83c57f6365a3ca330ff23aa4a5fa39b",
407
+ "shasum": ""
408
+ },
409
+ "require": {
410
+ "php": ">=5.3.0"
411
+ },
412
+ "time": "2017-10-23T01:57:42+00:00",
413
+ "type": "library",
414
+ "extra": {
415
+ "branch-alias": {
416
+ "dev-master": "1.0.x-dev"
417
+ }
418
+ },
419
+ "installation-source": "dist",
420
+ "autoload": {
421
+ "psr-4": {
422
+ "Psr\\SimpleCache\\": "src/"
423
+ }
424
+ },
425
+ "notification-url": "https://packagist.org/downloads/",
426
+ "license": [
427
+ "MIT"
428
+ ],
429
+ "authors": [
430
+ {
431
+ "name": "PHP-FIG",
432
+ "homepage": "http://www.php-fig.org/"
433
+ }
434
+ ],
435
+ "description": "Common interfaces for simple caching",
436
+ "keywords": [
437
+ "cache",
438
+ "caching",
439
+ "psr",
440
+ "psr-16",
441
+ "simple-cache"
442
+ ]
443
+ },
444
+ {
445
+ "name": "visavi/cleanup",
446
+ "version": "v1.4",
447
+ "version_normalized": "1.4.0.0",
448
+ "source": {
449
+ "type": "git",
450
+ "url": "https://github.com/visavi/cleanup.git",
451
+ "reference": "ce015983634a8c4c96a525caf13ca787ff06718a"
452
+ },
453
+ "dist": {
454
+ "type": "zip",
455
+ "url": "https://api.github.com/repos/visavi/cleanup/zipball/ce015983634a8c4c96a525caf13ca787ff06718a",
456
+ "reference": "ce015983634a8c4c96a525caf13ca787ff06718a",
457
+ "shasum": ""
458
+ },
459
+ "require": {
460
+ "php": ">=5.4.0"
461
+ },
462
+ "time": "2018-05-21T15:16:26+00:00",
463
+ "bin": [
464
+ "cleanup"
465
+ ],
466
+ "type": "library",
467
+ "installation-source": "dist",
468
+ "notification-url": "https://packagist.org/downloads/",
469
+ "license": [
470
+ "MIT"
471
+ ],
472
+ "authors": [
473
+ {
474
+ "name": "Alexander Grigorev",
475
+ "email": "admin@visavi.net",
476
+ "homepage": "http://visavi.net"
477
+ }
478
+ ],
479
+ "description": "Cleaning vendor directory",
480
+ "homepage": "http://visavi.net",
481
+ "keywords": [
482
+ "clean",
483
+ "composer",
484
+ "vendor"
485
+ ]
486
+ }
487
+ ]
lib/jlawrence/eos/README.md ADDED
@@ -0,0 +1,168 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ # EOS
2
+
3
+ [![Build Status](https://travis-ci.org/jlawrence11/eos.svg?branch=master)](https://travis-ci.org/jlawrence11/eos)
4
+ [![Latest Stable Version](https://poser.pugx.org/jlawrence/eos/v/stable.svg)](https://packagist.org/packages/jlawrence/eos)
5
+ [![Latest Unstable Version](https://poser.pugx.org/jlawrence/eos/v/unstable.svg)](https://packagist.org/packages/jlawrence/eos)
6
+ [![Total Downloads](https://poser.pugx.org/jlawrence/eos/downloads.svg)](https://packagist.org/packages/jlawrence/eos)
7
+ [![License](https://poser.pugx.org/jlawrence/eos/license.svg)](https://packagist.org/packages/jlawrence/eos)
8
+ [![Code Climate](https://codeclimate.com/github/jlawrence11/eos/badges/gpa.svg)](https://codeclimate.com/github/jlawrence11/eos)
9
+ [![Test Coverage](https://codeclimate.com/github/jlawrence11/eos/badges/coverage.svg)](https://codeclimate.com/github/jlawrence11/eos)
10
+
11
+ ## Installation
12
+
13
+ Install EOS with [Composer](https://getcomposer.org/)
14
+
15
+ Add the dependency:
16
+
17
+ ```json
18
+ "require": {
19
+ "jlawrence/eos": "3.*"
20
+ }
21
+ ```
22
+
23
+ Run `composer update` and you're done.
24
+
25
+ ## Equation Operating System
26
+
27
+ ### jlawrence\eos\
28
+
29
+ This class makes it incredibly easy to use and parse/solve equations in
30
+ your own applications. __NOTE__ ALL of the functions within
31
+ these classes are static. It is also important to note that these
32
+ classes throw exceptions if running in to errors, please read the beginning
33
+ of the `Math.php` file for the defines of the exceptions thrown. Exceptions
34
+ includes a descriptive message of the error encountered and within `Parser` will
35
+ also typically include the full equation used.
36
+
37
+ #### Parser
38
+
39
+ This class has one important function, `Parser::solve()` which does all the legwork,
40
+ so we'll start there and end with examples.
41
+
42
+ use jlawrence\eos\Parser;
43
+
44
+ ##### solve($infix, $variables)
45
+
46
+ To use this function:
47
+
48
+ $value = Parser::solve($eq, $vars);
49
+
50
+ ###### _$infix_
51
+
52
+ Is simply a standard equation with variable support.
53
+
54
+ Example Equations:
55
+
56
+ 2(4x)
57
+ 5+((1+2)*4)+3
58
+ 5+4(1+2)+3
59
+ 10*sin(x)
60
+ 10*cos(x)
61
+
62
+ The parser has good implied multiplication.
63
+
64
+ ###### _$variables_
65
+
66
+ The variables are fairly simple to understand. If it contains a scalar (ie
67
+ a non-array value) _every_ variable within the equation will be replaced with
68
+ that number. If it contains an array, there will be a by-variable replacement -
69
+ note that the array MUST be in the format of `'variable' => value`
70
+ Such as:
71
+
72
+ array(
73
+ 'x' => 2,
74
+ 'y' => 3
75
+ );
76
+
77
+ Given the equation:
78
+
79
+ 5x^y
80
+
81
+ If this is called by:
82
+
83
+ Parser::solveIF('5x^y', 2);
84
+
85
+ It will equal '20', as every variable is replaced by 2. However, if called like:
86
+
87
+ Parser::solveIF('5x^y', array(
88
+ 'x' => 2,
89
+ 'y' => 3));
90
+
91
+ You will get the result of '40' as it would equate to `5*2^3`, as expected.
92
+
93
+ #### jlawrence\eos\Graph
94
+
95
+ To use:
96
+
97
+ use jlawrence\eos\Graph;
98
+
99
+ This is the fun class that can create graphs.
100
+ The image will default to 640x480, to initialize a different size use:
101
+
102
+ Graph::init($width, $height);
103
+
104
+ The `$width` and `$height` are the values used for the image size.
105
+
106
+ ##### graph($eq, $xLow, $xHigh, [$xStep, $xyGrid, $yGuess, ...])
107
+
108
+ This method will generate the graph for the equation (`$eq`) with a min and max
109
+ `x` range that it will parse through. All Variables explained:
110
+
111
+ * `$eq`
112
+ The Standard Equation to use. _Must_ have a variable in it. (ie `x`)
113
+ * `$xLow`
114
+ The starting point for the calculations - the left side of the graph.
115
+ * `$xHigh`
116
+ The last point calculated for the variable - the right side of the graph.
117
+ * `$xStep`
118
+ Stepping point for the variable. Set to null/false to use the smart xStep feature within the graph class.
119
+ * `$xyGrid = false`
120
+ Show `x/y` gridlines on the graph. Defaults to false. Each grid line is set at an integer, with a max of 30 lines, so it will calculate the stepping for it. When the grid is show, the lines are labeled along the top and left side of the image.
121
+ * `$yGuess = true`
122
+ Guess the Lower and Upper `y-bounds` (The bottom and top of the image
123
+ respectively.) This will set the the bounds to the lowest `y` value
124
+ encountered for the `$yLow`, and the largest `y` value for `$yHigh`.
125
+ * `$yLow = null`
126
+ Lower bound for `y`. Will be reset if a lower value for `y` is found if `$yGuess` is true.
127
+ * `$yHigh = null`
128
+ Upper bound for `y`. Will be reset if a larger `y` value is found if `$yGuess` is true.
129
+
130
+ If you don't want the axis' labeled with their numbers, you can turn off the default behavior with:
131
+
132
+ Graph::$labelAxis = false;
133
+
134
+ TODO:
135
+
136
+ * Allow user-defined colors for all aspects of the graph.
137
+
138
+ To set up a graph with a `21x21` window (ie `-10 to 10`) for the equation
139
+ `sin(x)` and output as PNG, would use as:
140
+
141
+ Graph::graph('sin(x)', -10, 10, 0.01, true, false, -10, 10);
142
+ Graph::outPNG();
143
+
144
+ It would look like:
145
+ ![Sin(x)](http://s6.postimg.org/nm7tcj8lt/eos3.png)
146
+
147
+ ## Development
148
+
149
+ ### Testing
150
+
151
+ Run the unit tests by first installing phpunit with (from the repository root)
152
+
153
+ ```
154
+ composer update
155
+ ```
156
+
157
+ Then run the tests with
158
+
159
+ ```
160
+ phpunit
161
+ ```
162
+ ---
163
+
164
+ When creating classes for adding functions to the package, make sure to call
165
+ `Parser::solveIF()` instead of `Parser::solve()` so that the class retains
166
+ the full original equation used by the user.
167
+
168
+ ---
lib/jlawrence/eos/composer.json ADDED
@@ -0,0 +1,22 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "jlawrence/eos",
3
+ "description": "Parse and solve math equations without using 'eval()'.",
4
+ "license": "LGPL-2.1+",
5
+ "keywords": ["EOS","equations","math","solve"],
6
+ "authors": [
7
+ {
8
+ "name": "Jon Lawrence",
9
+ "email": "jon@jon-lawrence.com"
10
+ }
11
+ ],
12
+ "require": {},
13
+ "require-dev": {
14
+ "phpunit/phpunit": "4.*",
15
+ "codeclimate/php-test-reporter": "dev-master"
16
+ },
17
+ "autoload": {
18
+ "psr-4": {
19
+ "jlawrence\\eos\\": "src/"
20
+ }
21
+ }
22
+ }
lib/jlawrence/eos/src/AdvancedFunctions.php ADDED
@@ -0,0 +1,86 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Created by: Jon Lawrence on 2015-07-13 8:42 AM
4
+ */
5
+
6
+ namespace jlawrence\eos;
7
+
8
+
9
+ class AdvancedFunctions
10
+ {
11
+
12
+ /**
13
+ * Create a list for the parser of 'expressiveFunction' => 'class::function'
14
+ *
15
+ * @return array
16
+ */
17
+ public static function map()
18
+ {
19
+ $ret = array(
20
+ 'sum' => __NAMESPACE__ .'\AdvancedFunctions::sum',
21
+ 'log' => __NAMESPACE__ .'\AdvancedFunctions::log'
22
+ );
23
+
24
+ return $ret;
25
+ }
26
+
27
+ /**
28
+ * Summation function
29
+ *
30
+ * Will take an equation and run it through a summation algorithm. All parts
31
+ * of the input can be in equation form, so the start and stops can have
32
+ * equations to determine what they should be using the globally inputted
33
+ * variables from the user.
34
+ *
35
+ * @param string $input String in the form of "equation, start, stop"
36
+ * @param array $vars Array of variables used for solving the current equation.
37
+ * @return float The summation of the equation
38
+ */
39
+ public static function sum($input, $vars)
40
+ {
41
+ //remove whitespace
42
+ $input = preg_replace("/\s/", "", $input);
43
+ //split in to parts
44
+ list($eq, $start, $stop) = explode(",", $input);
45
+ $ret = 0;
46
+ //make sure there's a variable, or return equation as-is
47
+ if((Parser::solveIF($eq,0)) == preg_replace("/[\(\)]/", "", $eq)) {
48
+ return $eq;
49
+ }
50
+ $start = Parser::solveIF($start, $vars);
51
+ $stop = Parser::solveIF($stop, $vars);
52
+ for($i=$start; $i <= $stop; $i++) {
53
+ $ret += Parser::solveIF($eq, $i);
54
+ }
55
+
56
+ return $ret;
57
+ }
58
+
59
+ /**
60
+ * Log function for all non-natural logs. Defaults to base 10
61
+ *
62
+ * @param $input
63
+ * @param array $vars Variable replacement
64
+ * @return float
65
+ * @throws \Exception
66
+ */
67
+ public static function log($input, $vars)
68
+ {
69
+ $base = 10;
70
+ if(stripos($input, ",")) {
71
+ list($eq, $base) = explode(",", $input);
72
+ } else {
73
+ $eq = $input;
74
+ }
75
+ //Make sure no functions or operators are hidden inside
76
+ $sc = Parser::solveIF($eq, $vars);
77
+ if(10 != $base) {
78
+ $base = Parser::solveIF($base, $vars);
79
+ }
80
+ $ans = log($sc, $base);
81
+ if(is_nan($ans) || is_infinite($ans)) {
82
+ throw new \Exception("Result of 'log({$eq}, {$base}) = {$ans}' is either infinite or a non-number in ". Parser::$inFix, Math::E_NAN);
83
+ }
84
+ return $ans;
85
+ }
86
+ }
lib/jlawrence/eos/src/Graph.php ADDED
@@ -0,0 +1,281 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace jlawrence\eos;
4
+
5
+ // fun class that requires the GD libraries to give visual output to the user
6
+
7
+ /**
8
+ * Equation Graph
9
+ *
10
+ * Fun class that requires the GD libraries to give visual output of an
11
+ * equation to the user. Extends the Parser class.
12
+ *
13
+ * @author Jon Lawrence <jlawrence11@gmail.com>
14
+ * @copyright Copyright ©2005-2013 Jon Lawrence
15
+ * @license http://opensource.org/licenses/LGPL-2.1 LGPL 2.1 License
16
+ * @package Math
17
+ * @subpackage EOS
18
+ * @version 3.x
19
+ */
20
+ class Graph
21
+ {
22
+ private static $width = 640;
23
+ private static $height = 480;
24
+
25
+ /**
26
+ * @var resource
27
+ */
28
+ private static $image;
29
+
30
+ public static $labelAxis = true;
31
+ public static $backgroundColor = array(255, 255, 255);
32
+ public static $gridColor = array(150, 150, 150);
33
+ public static $axisColor = array(0, 0, 0);
34
+ public static $lineColor = array(0, 0, 0);
35
+
36
+ /**
37
+ * Initializer
38
+ *
39
+ * Sets up the Graph class with an image width and height defaults to
40
+ * 640x480
41
+ *
42
+ * @param int $width Image width
43
+ * @param int $height Image height
44
+ */
45
+ public static function init($width = 640, $height = 480)
46
+ {
47
+ // default width and height equal to that of a poor monitor (in early 2000s)
48
+ self::$width = $width;
49
+ self::$height = $height;
50
+
51
+ // initialize main class
52
+ Parser::init();
53
+ //can't really mess this up, return true
54
+ return true;
55
+ }
56
+
57
+
58
+ /**
59
+ * Create GD Graph Image
60
+ *
61
+ * Creates a GD image based on the equation given with the parameters that are set
62
+ *
63
+ * @param string $eq Equation to use. Needs variable in equation to create graph, all variables are interpreted as 'x'
64
+ * @param integer $xLow Lower x-bound for graph
65
+ * @param integer $xHigh Upper x-bound for graph
66
+ * @param float $xStep Stepping points while solving, the lower, the better precision. Slow if lower than .01
67
+ * @param bool $xyGrid Draw grid-lines?
68
+ * @param bool $yGuess Guess the upper/lower yBounds?
69
+ * @param int $yLow Lower y-bound
70
+ * @param int $yHigh Upper y-bound
71
+ * @return null
72
+ */
73
+ public static function graph($eq, $xLow, $xHigh, $xStep = null, $xyGrid = false, $yGuess = true, $yLow = null, $yHigh = null)
74
+ {
75
+ //create our image and allocate the two colors
76
+ $img = ImageCreate(self::$width, self::$height);
77
+ //The following noinspection needed because the first color allocated is the background, but not used for anything else.
78
+ /** @noinspection PhpUnusedLocalVariableInspection */
79
+ $bgColor = ImageColorAllocate($img, self::$backgroundColor[0], self::$backgroundColor[1], self::$backgroundColor[2]);
80
+ $aColor = ImageColorAllocate($img, self::$axisColor[0], self::$axisColor[1], self::$axisColor[2]);
81
+ $lColor = ImageColorAllocate($img, self::$lineColor[0], self::$lineColor[1], self::$lineColor[2]);
82
+ $gColor = ImageColorAllocate($img, self::$gridColor[0], self::$gridColor[1], self::$gridColor[2]);
83
+ //$black = ImageColorAllocate($img, 0, 0, 0);
84
+ //$grey = ImageColorAllocate($img, 150, 150, 150);
85
+ //$darkGrey = ImageColorAllocate($img, 50, 50, 50);
86
+ if ($xLow > $xHigh)
87
+ list($xLow, $xHigh) = array($xHigh, $xLow); //swap function
88
+ //Smart xStep calc
89
+ if ($xStep == false) {
90
+ $xStep = ($xHigh - $xLow) / self::$width;
91
+ }
92
+ $xStep = abs($xStep);
93
+ $hand = null;
94
+ $xVars = array();
95
+ //If yGuess is true, make sure yLow and yHigh are not set
96
+ if ($yGuess) {
97
+ $yLow = null;
98
+ $yHigh = null;
99
+ }
100
+ //We want to limit the number of lines/ticks/etc so graph remains readable, set max now
101
+ $xMaxLines = 30;
102
+ $yMaxLines = 30;
103
+ //DEVELOPER, UNCOMMENT NEXT LINE IF WANTING TO PREVENT SLOW GRAPHS
104
+ //$xStep = ($xStep < .01) ? $xStep : 0.01;
105
+
106
+ $xScale = self::$width / ($xHigh - $xLow);
107
+ $counter = 0;
108
+ // @codeCoverageIgnoreStart
109
+ if (Math::$DEBUG) {
110
+ $hand = fopen("Graph.txt", "w");
111
+ fwrite($hand, "$eq\n");
112
+ }
113
+ // @codeCoverageIgnoreEnd
114
+ for ($i = $xLow; $i <= $xHigh; $i += $xStep) {
115
+ $tester = sprintf("%10.3f", $i);
116
+ if ($tester == "-0.000") $i = 0;
117
+ $y = Parser::solve($eq, $i);
118
+ //eval('$y='. str_replace('&x', $i, $eq).";"); /* used to debug my Parser class results */
119
+ // @codeCoverageIgnoreStart
120
+ if (Math::$DEBUG) {
121
+ $tmp1 = sprintf("y(%5.3f) = %10.3f\n", $i, $y);
122
+ fwrite($hand, $tmp1);
123
+ }
124
+ // @codeCoverageIgnoreEnd
125
+
126
+ // If developer asked us to find the upper and lower bounds for y...
127
+ if ($yGuess == true) {
128
+ $yLow = ($yLow === null || ($y < $yLow)) ? $y : $yLow;
129
+ $yHigh = ($yHigh === null || $y > $yHigh) ? $y : $yHigh;
130
+ }
131
+ $xVars[$counter] = $y;
132
+ $counter++;
133
+ }
134
+
135
+
136
+ //Now that we have all the variables stored...find the yScale
137
+ $yScale = self::$height / (($yHigh) - ($yLow));
138
+ // @codeCoverageIgnoreStart
139
+ //Calculate the stepping points for lines now
140
+ if ($yHigh - $yLow > $yMaxLines) {
141
+ $yJump = ceil(($yHigh - $yLow) / $yMaxLines);
142
+ } else {
143
+ $yJump = 1;
144
+ }
145
+ if ($xHigh - $xLow > $xMaxLines) {
146
+ $xJump = ceil(($xHigh - $xLow) / $xMaxLines);
147
+ } else {
148
+ $xJump = 1;
149
+ }
150
+ // @codeCoverageIgnoreEnd
151
+
152
+ // add 0.01 to each side so that if y is from 1 to 5, the lines at 1 and 5 are seen
153
+ $yLow -= 0.01;
154
+ $yHigh += 0.01;
155
+
156
+ // @codeCoverageIgnoreStart
157
+ if (Math::$DEBUG) {
158
+ fwrite($hand, $yLow . " -- " . $yHigh . "\n");
159
+ }
160
+ // @codeCoverageIgnoreEnd
161
+
162
+ // if developer wanted a grid on the graph, add it now
163
+ if ($xyGrid == true) {
164
+ // @codeCoverageIgnoreStart
165
+ if (Math::$DEBUG) {
166
+ fwrite($hand, "Drawing Grid\n");
167
+ }
168
+ // @codeCoverageIgnoreEnd
169
+ for ($i = ceil($yLow); $i <= floor($yHigh); $i += $yJump) {
170
+ $i0 = abs($yHigh - $i);
171
+ ImageLine($img, 0, $i0 * $yScale, self::$width, $i0 * $yScale, $gColor);
172
+ imagestring($img, 1, 2, $i0 * $yScale + 2, $i, $gColor);
173
+ }
174
+ for ($i = ceil($xLow); $i <= floor($xHigh); $i += $xJump) {
175
+ $i0 = abs($xLow - $i);
176
+ ImageLine($img, $i0 * $xScale, 0, $i0 * $xScale, self::$height, $gColor);
177
+ imagestring($img, 1, $i0 * $xScale + 2, 2, $i, $gColor);
178
+ }
179
+ }
180
+
181
+ //Now that we have the scales, let's see if we can draw an x/y-axis
182
+ if ($xLow <= 0 && $xHigh >= 0) {
183
+ //the y-axis is within our range - draw it.
184
+ $x0 = abs($xLow) * $xScale;
185
+ ImageLine($img, $x0, 0, $x0, self::$height, $aColor);
186
+ for ($i = ceil($yLow); $i <= floor($yHigh); $i += $yJump) {
187
+ $i0 = abs($yHigh - $i);
188
+ ImageLine($img, $x0 - 3, $i0 * $yScale, $x0 + 3, $i0 * $yScale, $aColor);
189
+ //If we want the axis labeled... (call in the allies?)
190
+ if (self::$labelAxis) {
191
+ imagestring($img, 1, $x0 + 2, $i0 * $yScale + 1, $i, $aColor);
192
+ }
193
+ }
194
+ }
195
+ if ($yLow <= 0 && $yHigh >= 0) {
196
+ //the x-axis is within our range - draw it.
197
+ $y0 = abs($yHigh) * $yScale;
198
+ ImageLine($img, 0, $y0, self::$width, $y0, $aColor);
199
+ //Create ticks for y
200
+ for ($i = ceil($xLow); $i <= floor($xHigh); $i += $xJump) {
201
+ $i0 = abs($xLow - $i);
202
+ ImageLine($img, $i0 * $xScale, $y0 - 3, $i0 * $xScale, $y0 + 3, $aColor);
203
+ //If we want the axis labeled....
204
+ if (self::$labelAxis) {
205
+ imagestring($img, 1, $i0 * $xScale + 2, $y0 + 1, $i, $aColor);
206
+ }
207
+ }
208
+ }
209
+ $counter = 1;
210
+
211
+ //now graph it all ;]
212
+ for ($i = $xLow + $xStep; $i <= $xHigh; $i += $xStep) {
213
+ $x1 = (abs($xLow - ($i - $xStep))) * $xScale;
214
+ $y1 = (($xVars[$counter - 1] < $yLow) || ($xVars[$counter - 1] > $yHigh)) ? -1 : (abs($yHigh - $xVars[$counter - 1])) * $yScale;
215
+ $x2 = (abs($xLow - $i)) * $xScale;
216
+ $y2 = (($xVars[$counter] < $yLow) || ($xVars[$counter] > $yHigh)) ? -1 : (abs($yHigh - $xVars[$counter])) * $yScale;
217
+
218
+ // if any of the y values were found to be off of the y-bounds, don't graph those connecting lines
219
+ if ($y1 != -1 && $y2 != -1)
220
+ ImageLine($img, $x1, $y1, $x2, $y2, $lColor);
221
+ $counter++;
222
+ }
223
+ // @codeCoverageIgnoreStart
224
+ if (Math::$DEBUG) {
225
+ fclose($hand);
226
+ }
227
+ // @codeCoverageIgnoreEnd
228
+ self::$image = $img;
229
+ }
230
+
231
+ /**
232
+ * Sends JPG to browser
233
+ *
234
+ * Sends a JPG image with proper header to output
235
+ *
236
+ * @codeCoverageIgnore
237
+ */
238
+ public static function outJPG()
239
+ {
240
+ header("Content-type: image/jpeg");
241
+ ImageJpeg(self::$image);
242
+ }
243
+
244
+ /**
245
+ * Sends PNG to browser
246
+ *
247
+ * Sends a PNG image with proper header to output
248
+ *
249
+ * @codeCoverageIgnore
250
+ */
251
+ public static function outPNG()
252
+ {
253
+ header("Content-type: image/png");
254
+ ImagePng(self::$image);
255
+ }
256
+
257
+ /**
258
+ * Output GD Image
259
+ *
260
+ * Will give the developer the GD resource for the graph that
261
+ * can be used to store the graph to the FS or other media
262
+ *
263
+ * @return Resource GD Image Resource
264
+ */
265
+ public static function getImage()
266
+ {
267
+ return self::$image;
268
+ }
269
+
270
+ /**
271
+ * Output GD Image
272
+ *
273
+ * Alias for eqGraph::getImage()
274
+ *
275
+ * @return Resource GD Image resource
276
+ */
277
+ public static function outGD()
278
+ {
279
+ return self::getImage();
280
+ }
281
+ }
lib/jlawrence/eos/src/Math.php ADDED
@@ -0,0 +1,47 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Created by: Jon Lawrence on 2015-07-02 2:49 PM
4
+ */
5
+
6
+ namespace jlawrence\eos;
7
+
8
+ /**
9
+ * Class Math
10
+ * @package jlawrence\eos
11
+ *
12
+ * Will be a holder for constants, variables, and other things commonly needed by the
13
+ * rest of the package.
14
+ */
15
+ class Math
16
+ {
17
+ /**
18
+ * No matching open/close pair in equation
19
+ */
20
+ const E_NO_SET = 5500;
21
+
22
+ /**
23
+ * Division by zero
24
+ */
25
+ const E_DIV_ZERO = 5501;
26
+
27
+ /**
28
+ * No equation present
29
+ */
30
+ const E_NO_EQ = 5502;
31
+
32
+ /**
33
+ * No variable replacements available
34
+ */
35
+ const E_NO_VAR = 5503;
36
+
37
+ /**
38
+ * Not A Number (NAN)
39
+ */
40
+ const E_NAN = 5504;
41
+
42
+ /**
43
+ * @var bool Use debug features
44
+ */
45
+ public static $DEBUG = false;
46
+
47
+ }
lib/jlawrence/eos/src/Matrix.php ADDED
@@ -0,0 +1,656 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * matrix.class.php
4
+ *
5
+ * Will set up the defines for error checking as well as provide
6
+ * the Matrix class for include. As this is made to be modular,
7
+ * only the class (and possibly helper classes) along with their
8
+ * defines will be found in this file.
9
+ * @package Math
10
+ * @subpackage Matrix
11
+ */
12
+
13
+ namespace jlawrence\eos;
14
+
15
+ /**
16
+ * Matrix Class
17
+ *
18
+ * This class will allow you to create and use Matrices
19
+ * as well as providing common Matrix operations. It
20
+ * uses PHP5 for OOP and Error Throwing and is commented
21
+ * for the PHPDoc Parser for documentation creation.
22
+ *
23
+ * @version $Id: matrix.class.php 10 2012-08-06 23:41:36Z jlawrence11 $
24
+ * @author Jon Lawrence <JLawrence11@gmail.com>
25
+ * @license http://opensource.org/licenses/LGPL-2.1 LGPL 2.1 License
26
+ * @copyright Copyright �2012, Jon Lawrence
27
+ * @package Math
28
+ * @subpackage Matrix
29
+ */
30
+ class Matrix {
31
+
32
+ /**
33
+ * Invalid String input type
34
+ */
35
+ const E_INVALID_INPUT = 5001;
36
+
37
+ /**
38
+ * Matrix needed to be a square matrix for the operation
39
+ */
40
+ const E_NOT_SQUARE = 5002;
41
+
42
+ /**
43
+ * Matrix was undefined
44
+ */
45
+ const E_NO_MATRIX = 5003;
46
+
47
+ /**
48
+ * Matrix had varying column lengths
49
+ */
50
+ const E_INVALID_MATRIX = 5004;
51
+
52
+ /**
53
+ * Matrix operation required rows/cols to be even, they were not
54
+ */
55
+ const E_NOT_EQUAL = 5005;
56
+
57
+ /**
58
+ * Determinate was '0' while preforming another operation
59
+ */
60
+ const E_NO_INVERSE = 5006;
61
+
62
+ private $matrix;
63
+
64
+ /**
65
+ * Construct method
66
+ *
67
+ * For format of input string, see the see tag below
68
+ *
69
+ * @see Matrix::_assign()
70
+ * @param string $mText Matrix text input
71
+ */
72
+ public function __construct($mText="")
73
+ {
74
+ if ($mText) $this->_assign($mText);
75
+ }
76
+
77
+ /**
78
+ * Create a matrix based on string input similar to the TI Calculators
79
+ * input string "[1,2,3;4,5,6;7,8,9]" is the equivalent of the matrix:
80
+ * <pre>
81
+ * | 1 2 3 |
82
+ * | 4 5 6 |
83
+ * | 7 8 9 |
84
+ * </pre>
85
+ *
86
+ * @param String $mText The matrix in string format to assign to the current object
87
+ * @return Boolean True if is passes verification after being converted
88
+ * @throws \Exception If the input text is not in a valid format
89
+ */
90
+ public function _assign($mText)
91
+ {
92
+ if(trim($mText)=="")
93
+ return false;
94
+
95
+ $mText = preg_replace("/\s/", "", $mText);
96
+ if(!preg_match("/^\[(([\-]*[0-9\. ]+[,]{0,1})+[;]{0,1})*\]$/", $mText)) {
97
+ throw new \Exception("'{$mText}' is not a valid input", Matrix::E_INVALID_INPUT);
98
+ }
99
+ $mText = preg_replace("/(\[|\])/", "", $mText);
100
+
101
+ $rows = explode(";", $mText);
102
+ $i=0;$j=0;
103
+ foreach($rows as $row)
104
+ {
105
+ $cols = explode(",", $row);
106
+ foreach($cols as $value)
107
+ {
108
+ $this->matrix[$i][$j] = $value;
109
+ $j++;
110
+ }
111
+ $i++;
112
+ $j = 0;
113
+ }
114
+
115
+ return $this->_verify();
116
+ }
117
+
118
+ /**
119
+ * Private function that will verify all the columns have the same
120
+ * number of items, ensuring it is a valid matrix
121
+ *
122
+ * @access private
123
+ * @param array|bool $mArray
124
+ * @return bool True if it passes, false if not a valid matrix
125
+ */
126
+ private function _verify($mArray = false)
127
+ {
128
+ if(!$mArray) $mArray = $this->matrix;
129
+ $nSet = false;
130
+
131
+ if(is_array($mArray))
132
+ {
133
+ foreach($mArray as $row)
134
+ {
135
+ $cols = count($row);
136
+ if($nSet===false) {
137
+ $nSet = $cols;
138
+ }
139
+ if($cols != $nSet) {
140
+ return false;
141
+ }
142
+ }
143
+ } else {
144
+ return false;
145
+ }
146
+
147
+ return true;
148
+ }
149
+
150
+ /**
151
+ * Is it a valid matrix?
152
+ *
153
+ * Public function to tell the class user whether or not the passed
154
+ * array is valid, if no array is passed, it will tell the user whether
155
+ * the matrix of the current instance is valid. Valid is denoted by all
156
+ * rows have the same number of columns.
157
+ *
158
+ * @param array|bool $mArray Array to be used, if not assigned will default to $this->matrix
159
+ * @return bool True/False depending on if array is a valid matrix
160
+ */
161
+ public function isValid($mArray = false)
162
+ {
163
+ if(!$mArray) $mArray = $this->matrix;
164
+ return $this->_verify($mArray);
165
+ }
166
+
167
+ /**
168
+ * Is it a square Matrix?
169
+ *
170
+ * Will determine whether or not the matrix is valid, and if it
171
+ * is, will determine if the matrix is a square matrix (n by n).
172
+ *
173
+ * @param array|bool $mArray Matrix array, if not assigned will use $this->matrix
174
+ * @return bool True/False depending on whether or not the matrix is square
175
+ */
176
+ public function isSquare($mArray = false)
177
+ {
178
+ if(!$mArray) $mArray = $this->matrix;
179
+ if(!$this->_verify($mArray)) {
180
+ return false;
181
+ }
182
+ $rows = count($mArray);
183
+ $cols = count($mArray[0]);
184
+ return ($rows == $cols);
185
+ }
186
+
187
+ /**
188
+ * Get 'n' from a square (n by n) Matrix
189
+ *
190
+ * Will check to see if a matrix is square, if so, will return 'n', which
191
+ * is the number of rows==columns in the matrix
192
+ *
193
+ * @param array|bool $mArray Matrix array, uses $this->matrix if not assigned
194
+ * @return int The 'n' of a square matrix, or false if not square
195
+ * @throws \Exception If not a square matrix, throws an exception
196
+ */
197
+ public function _getN($mArray = false)
198
+ {
199
+ if(!$mArray) $mArray = $this->matrix;
200
+
201
+ if($this->isSquare($mArray)) {
202
+ return count($mArray);
203
+ } else {
204
+ $m = $this->toString($mArray);
205
+ throw new \Exception("'{$m}' is not a square matrix", Matrix::E_NOT_SQUARE);
206
+ }
207
+ }
208
+
209
+ /**
210
+ * Create an Identity Matrix
211
+ *
212
+ * Creates an Identity Matrix of size 'n'.
213
+ *
214
+ * @link http://en.wikipedia.org/wiki/Identity_matrix
215
+ * @param int $n The rows/cols of identity matrix
216
+ * @param bool $useInternal If true will set $this->matrix
217
+ * @return Matrix|bool Return an identity matrix if $useInternal is false, otherwise 'true'
218
+ */
219
+ public function createIdentity($n, $useInternal = true)
220
+ {
221
+ $mArray = array();
222
+ for($rows=0;$rows<$n;$rows++) {
223
+ for($cols=0;$cols<$n;$cols++) {
224
+ if($rows==$cols) {
225
+ $mArray[$rows][$cols] = 1;
226
+ } else {
227
+ $mArray[$rows][$cols] = 0;
228
+ }
229
+ }
230
+ }
231
+ if($useInternal == true) {
232
+ $this->matrix = $mArray;
233
+ return true;
234
+ } else {
235
+ $nMatrix = new Matrix($this->toString($mArray));
236
+ return $nMatrix;
237
+ }
238
+
239
+ }
240
+
241
+ /**
242
+ * Convert current Matrix to string format
243
+ *
244
+ * Convert an array to the string format used by this class.
245
+ *
246
+ * @see Matrix::_assign()
247
+ * @param array|bool $mArray if not assigned will use this instance's matrix.
248
+ * @throws \Exception If matrix is not an array
249
+ * @return string The array broken down in to string format
250
+ */
251
+ public function toString($mArray = false)
252
+ {
253
+ if(!$mArray) $mArray = $this->matrix;
254
+ $rows=array();
255
+ if(is_array($mArray))
256
+ {
257
+ foreach($mArray as $cols){
258
+ $rows[] = implode(",", $cols);
259
+ }
260
+ $retString = sprintf("[%s]", implode($rows, ";"));
261
+ return $retString;
262
+ } else {
263
+ throw new \Exception("No matrix to convert", Matrix::E_NO_MATRIX);
264
+ }
265
+ }
266
+
267
+ /**
268
+ * Overload PHP's class __toString() method
269
+ *
270
+ * PHP magic method for "echoing" this object without a specific method called
271
+ * Will use {@link Matrix::toString()} with no parameters for it's return.
272
+ *
273
+ * @return string Returns the $matrix value in string format
274
+ */
275
+ public function __toString()
276
+ {
277
+ return $this->toString();
278
+ }
279
+
280
+ /**
281
+ * Get Matrix Array
282
+ *
283
+ * Will return the matrix array of the current instance.
284
+ *
285
+ * @return array The matrix array of the current instance
286
+ */
287
+ public function getArray()
288
+ {
289
+ return $this->matrix;
290
+ }
291
+
292
+ /**
293
+ * Formatted Matrix output for use in console
294
+ *
295
+ * Will output the matrix in 'pretty' format, if used with 'echo' and
296
+ * HTML, surround it by the '<<pre>>' and '<</pre>>' tags to display properly
297
+ *
298
+ * @param int $width The width of printing space to use
299
+ * @param array|bool $mArray Matrix array, defaults to $this->matrix
300
+ * @return string "Pretty-Printed" matrix in ASCII format
301
+ */
302
+ public function prettyPrint($width=80, $mArray=false)
303
+ {
304
+ if(!$mArray) $mArray = $this->matrix;
305
+ if(!$this->_verify($mArray)) return false;
306
+
307
+ $out = "";
308
+ $aCount = count($mArray[0]);
309
+ $space = floor(($width-4)/$aCount);
310
+ $space_2 = floor($space/2);
311
+
312
+ foreach($mArray as $row)
313
+ {
314
+ $out .= sprintf("| %{$space_2}.2f", $row[0]);
315
+ for($i=1;$i<$aCount;$i++)
316
+ {
317
+ $out .= sprintf("%{$space}.2f", $row[$i]);
318
+ }
319
+ $out .= sprintf("%{$space_2}s |\n", " ");
320
+ }
321
+
322
+ return $out;
323
+ }
324
+
325
+ /**
326
+ * Adds two matrices together
327
+ *
328
+ * Will add the inputted Matrix to the current instance, and return
329
+ * the result as Matrix class.
330
+ *
331
+ * @link http://en.wikipedia.org/wiki/Matrix_addition
332
+ * @param Matrix $nMatrix Matrix class to be added to current instance
333
+ * @return Matrix The result of the addition
334
+ * @throws \Exception $msg of exception explains problem
335
+ */
336
+ public function addMatrix(Matrix $nMatrix)
337
+ {
338
+ if(!$this->_verify() || !$nMatrix->_verify())
339
+ throw new \Exception("Matrices have varying column sizes", Matrix::E_INVALID_MATRIX);
340
+
341
+ $matrix1 = $this->getArray();
342
+ $matrix2 = $nMatrix->getArray();
343
+ if((count($matrix1)!=count($matrix2)) || (count($matrix1[0])!=count($matrix2[0])))
344
+ {
345
+ $m1 = $this->toString($matrix1);
346
+ $m2 = $this->toString($matrix2);
347
+ throw new \Exception("The rows and/or columns '{$m1}' and '{$m2}' are not the same", Matrix::E_NOT_EQUAL);
348
+ }
349
+
350
+ $rArray = array();
351
+ for($row=0;$row<count($matrix1);$row++) {
352
+ for($col=0;$col<count($matrix1[0]);$col++) {
353
+ $rArray[$row][$col] = $matrix1[$row][$col] + $matrix2[$row][$col];
354
+ }
355
+ }
356
+ $rMatrix = new Matrix($this->toString($rArray));
357
+ return $rMatrix;
358
+ }
359
+
360
+ /**
361
+ * Subtract Matrices
362
+ *
363
+ * Will subtract the inputted Matrix from the current instance, and return
364
+ * the result as Matrix class.
365
+ *
366
+ * @link http://en.wikipedia.org/wiki/Matrix_subtraction
367
+ * @param Matrix $nMatrix Matrix class to be subtracted from current instance
368
+ * @return Matrix The result of the subtraction
369
+ * @throws \Exception $msg of exception explains problem
370
+ */
371
+ public function subMatrix(Matrix $nMatrix)
372
+ {
373
+ if(!$this->_verify() || !$nMatrix->_verify())
374
+ throw new \Exception("Matrices have varying column sizes", Matrix::E_INVALID_MATRIX);
375
+
376
+ $matrix1 = $this->getArray();
377
+ $matrix2 = $nMatrix->getArray();
378
+ if((count($matrix1)!=count($matrix2)) || (count($matrix1[0])!=count($matrix2[0])))
379
+ {
380
+ $m1 = $this->toString($matrix1);
381
+ $m2 = $this->toString($matrix2);
382
+ throw new \Exception("The rows and/or columns '{$m1}' and '{$m2}' are not the same", Matrix::E_NOT_EQUAL);
383
+ }
384
+
385
+ $rArray = array();
386
+ for($row=0;$row<count($matrix1);$row++) {
387
+ for($col=0;$col<count($matrix1[0]);$col++) {
388
+ $rArray[$row][$col] = $matrix1[$row][$col] - $matrix2[$row][$col];
389
+ }
390
+ }
391
+ $rMatrix = new Matrix($this->toString($rArray));
392
+ return $rMatrix;
393
+ }
394
+
395
+ /**
396
+ * Multiply current matrix by a scalar value
397
+ *
398
+ * Multiplies a matrix by a scalar value (int/float/etc) (constant, ie '2')
399
+ *
400
+ * @link http://en.wikipedia.org/wiki/Scalar_multiplication
401
+ * @param float $k The value to multiply the matrix by
402
+ * @return Matrix Returns a new Matrix instance with the result
403
+ * @throws \Exception if the instance matrix is not valid
404
+ */
405
+ public function mpScalar($k)
406
+ {
407
+ //we'll verify a true matrix to ... help the user
408
+ if(!$this->_verify())
409
+ throw new \Exception("Matrix '{$this}' has varying column sizes", Matrix::E_INVALID_MATRIX);
410
+
411
+ $cArray = $this->getArray();
412
+ $rArray = array();
413
+ $rows = count($cArray);
414
+ $cols = count($cArray[0]);
415
+ for($i=0;$i<$rows;$i++) {
416
+ for($j=0;$j<$cols;$j++) {
417
+ $rArray[$i][$j] = $cArray[$i][$j] * $k;
418
+ }
419
+ }
420
+ $rMatrix = new Matrix($this->toString($rArray));
421
+ return $rMatrix;
422
+ }
423
+
424
+ /**
425
+ * Get the Matrix Determinant
426
+ *
427
+ * Finds the determinant of the square matrix, user should not use
428
+ * the parameter, as that is meant to allow recursive calling
429
+ * of this function from within itself.
430
+ *
431
+ * @link http://en.wikipedia.org/wiki/Matrix_determinant
432
+ * @param array|bool $mArray The array to find a determinate of
433
+ * @return float The Determinate of the square matrix
434
+ * @throws \Exception If matrix is 1,1 or is not square
435
+ */
436
+ public function getDeterminant($mArray = false)
437
+ {
438
+ if(!$mArray) $mArray = $this->matrix;
439
+ //print_r($mArray);
440
+ if(!$this->isSquare($mArray))
441
+ throw new \Exception("'{$this}' is not a square matrix", Matrix::E_NOT_SQUARE);
442
+
443
+ $n = $this->_getN($mArray);
444
+ if($n < 1){
445
+ // @codeCoverageIgnoreStart
446
+ // Should never get this far
447
+ throw new \Exception("No Matrix", Matrix::E_NO_MATRIX);
448
+ // @codeCoverageIgnoreEnd
449
+ } elseif ($n == 1) {
450
+ $det = $mArray[0][0];
451
+ } elseif ($n == 2) {
452
+ $det = $mArray[0][0]*$mArray[1][1] - $mArray[1][0]*$mArray[0][1];
453
+ } else {
454
+ $det = 0;
455
+ $nArray = array();
456
+ for($j1=0;$j1<$n;$j1++) {
457
+ for($i=1;$i<$n;$i++) {
458
+ $j2 = 0;
459
+ for($j=0;$j<$n;$j++) {
460
+ if($j==$j1) {
461
+ continue;
462
+ }
463
+ $nArray[$i-1][$j2] = $mArray[$i][$j];
464
+ $j2++;
465
+ }
466
+ }
467
+ $det += pow(-1,2+$j1)*$mArray[0][$j1]*$this->getDeterminant($nArray);
468
+ }
469
+ }
470
+ return $det;
471
+ }
472
+
473
+ /**
474
+ * coFactor Matrix
475
+ *
476
+ * Will return a Matrix of coFactors for the matrix provided, or an array
477
+ * of the matrix as is the default.
478
+ *
479
+ * @link http://en.wikipedia.org/wiki/Matrix_cofactors
480
+ * @param array|bool $cArray A matrix in array format (or $this->matrix by default)
481
+ * @param bool $asArray When set to true, will return an array, when false a Matrix Object
482
+ * @return Matrix|array A matrix of coFactors for the array provided (or current matrix)
483
+ * @throws \Exception if the matrix is not square
484
+ */
485
+ public function coFactor($cArray=false,$asArray=true)
486
+ {
487
+ if(!$cArray) $cArray = $this->matrix;
488
+ if(!$this->isSquare($cArray))
489
+ throw new \Exception("'{$this}' is not a square matrix", Matrix::E_NOT_SQUARE);
490
+
491
+ $n = $this->_getN($cArray);
492
+ $minor = array();
493
+ $rArray = array();
494
+
495
+ for($j=0;$j<$n;$j++){
496
+ for($i=0;$i<$n;$i++) {
497
+ //Form the adjugate
498
+ $i1 = 0;
499
+ for($ii=0;$ii<$n;$ii++) {
500
+ if($ii==$i) {
501
+ continue;
502
+ }
503
+ $j1=0;
504
+ for($jj=0;$jj<$n;$jj++) {
505
+ if($jj==$j) {
506
+ continue;
507
+ }
508
+ $minor[$i1][$j1] = $cArray[$ii][$jj];
509
+ $j1++;
510
+ }
511
+ $i1++;
512
+ }
513
+ $det = $this->getDeterminant($minor);
514
+ $rArray[$i][$j] = pow(-1,$i+$j+2)*$det;
515
+ }
516
+ }
517
+ if($asArray==false){
518
+ $rMatrix = new Matrix($this->toString($rArray));
519
+ return $rMatrix;
520
+ } else {
521
+ return $rArray;
522
+ }
523
+
524
+ }
525
+
526
+ /**
527
+ * Will transpose the current matrix or array provided
528
+ *
529
+ * Transposes the current matrix, or the array provided
530
+ *
531
+ * @link http://en.wikipedia.org/wiki/Matrix_transpose
532
+ * @param array|bool $cArray the array to transpose (defaults to $this->matrix)
533
+ * @param bool $asArray whether to return an array or Matrix object
534
+ * @return array|Matrix Defaults to returning an array of the transposed matrix
535
+ * @throws \Exception if the matrix is not square
536
+ */
537
+ public function transpose($cArray=false,$asArray=true)
538
+ {
539
+ if(!$cArray) $cArray = $this->matrix;
540
+ if(!$this->isSquare($cArray))
541
+ throw new \Exception("'{$this}' is not a square matrix", Matrix::E_NOT_SQUARE);
542
+
543
+ $n = $this->_getN();
544
+ $nArray = array();
545
+ for($i=0;$i<$n;$i++) {
546
+ for($j=0;$j<$n;$j++) {
547
+ $nArray[$j][$i] = $cArray[$i][$j];
548
+ }
549
+ }
550
+ if($asArray==true) {
551
+ return $nArray;
552
+ } else {
553
+ $nMatrix = new Matrix($this->toString($nArray));
554
+ return $nMatrix;
555
+ }
556
+ }
557
+
558
+ /**
559
+ * Adjugate Matrix
560
+ *
561
+ * Will return the Adjugate matrix of the array provided
562
+ * or the current matrix instance if not provided.
563
+ *
564
+ * @link http://en.wikipedia.org/wiki/Adjugate_matrix
565
+ * @param array|bool $cArray Defaults to $this->matrix if not provided
566
+ * @param bool $asArray Whether to return an array or Matrix object
567
+ * @return array|Matrix Defaults to return the array of the Adjugate matrix
568
+ */
569
+ public function adjugate($cArray=false,$asArray=true)
570
+ {
571
+ if(!$cArray) $cArray = $this->matrix;
572
+ $rArray = $this->transpose($this->coFactor($cArray));
573
+ if($asArray==true)
574
+ return $rArray;
575
+
576
+ $rMatrix = new Matrix($this->toString($rArray));
577
+ return $rMatrix;
578
+ }
579
+
580
+ /**
581
+ * Inverse of current matrix
582
+ *
583
+ * Will give the inverse of the array provided or the current matrix
584
+ * Matrix returned denoted by A^-1
585
+ *
586
+ * @link http://en.wikipedia.org/wiki/Inverse_matrix
587
+ * @param array|bool $cArray Array to invert (defaults to $this->matrix)
588
+ * @return Matrix By default returns a new instance of Matrix
589
+ * @throws \Exception for any number of reasons that would make the inverse not available
590
+ */
591
+ public function inverse($cArray = false)
592
+ {
593
+ if(!$cArray) $cArray = $this->matrix;
594
+
595
+ $det = $this->getDeterminant($cArray);
596
+ if($det == 0)
597
+ throw new \Exception("Determinant of {$this} is 0, No Inverse found", Matrix::E_NO_INVERSE);
598
+
599
+
600
+ $scalar = 1/$det;
601
+ $adj = $this->adjugate($cArray, false);
602
+ $iMatrix = $adj->mpScalar($scalar);
603
+ return $iMatrix;
604
+ }
605
+
606
+ /**
607
+ * Multiply Matrices
608
+ *
609
+ * This function will multiply the current matrix with the matrix provided.
610
+ * If current Matrix is denoted by 'A' and the inputted is denoted by 'B',
611
+ * When written, this will return AB.
612
+ *
613
+ * @link http://en.wikipedia.org/wiki/Matrix_multiplication
614
+ * @param Matrix $bMatrix The matrix to multiply with the current
615
+ * @return Matrix The result of multiplication.
616
+ * @throws \Exception $msg explains why operation failed
617
+ */
618
+ public function mpMatrix(Matrix $bMatrix)
619
+ {
620
+ if(!$this->_verify() || !$bMatrix->_verify()) {
621
+ // @codeCoverageIgnoreStart
622
+ // Should never get this far
623
+ $eM1 = $this->toString();
624
+ $eM2 = $bMatrix->toString();
625
+ throw new \Exception("Either '{$eM1}' and/or '{$eM2}' is not a valid Matrix", Matrix::E_INVALID_MATRIX);
626
+ // @codeCoverageIgnoreEnd
627
+ }
628
+ $aArray = $this->matrix;
629
+ $bArray = $bMatrix->getArray();
630
+
631
+ //The number of columns in A must match the number of rows in B
632
+ if(count($aArray[0]) != count($bArray)) {
633
+ $mA = $this->toString();
634
+ $mB = $bMatrix->toString();
635
+ throw new \Exception("Columns in '{$mA}' don't match Rows of '{$mB}'", Matrix::E_NOT_EQUAL);
636
+ }
637
+
638
+ $rArray = array();
639
+
640
+ //Loop through rows of Matrix A
641
+ for($i=0;$i<count($aArray);$i++) {
642
+ //Loop through the columns of Matrix B
643
+ for($j=0;$j<count($bArray[0]);$j++) {
644
+ $value = 0;
645
+ //loop through the rows of Matrix B
646
+ for($k=0;$k<count($bArray);$k++) {
647
+ $value += $aArray[$i][$k] * $bArray[$k][$j];
648
+ }
649
+ $rArray[$i][$j] = $value;
650
+ }
651
+ }
652
+ $rMatrix = new Matrix($this->toString($rArray));
653
+ return $rMatrix;
654
+ }
655
+ }
656
+ ?>
lib/jlawrence/eos/src/Parser.php ADDED
@@ -0,0 +1,593 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Equation Operating System Classes.
4
+ *
5
+ * This class was created for the safe parsing of mathematical equations
6
+ * in PHP. There is a need for a way to successfully parse equations
7
+ * in PHP that do NOT require the use of `eval`. `eval` at its core
8
+ * opens the system using it to so many security vulnerabilities it is oft
9
+ * suggested /never/ to use it, and for good reason. This class set will
10
+ * successfully take an equation, parse it, and provide solutions to the
11
+ * developer. It is a safe way to evaluate expressions without putting
12
+ * the system at risk.
13
+ *
14
+ *
15
+ * @author Jon Lawrence <jlawrence11@gmail.com>
16
+ * @copyright Copyright ©2005-2015, Jon Lawrence
17
+ * @license http://opensource.org/licenses/LGPL-2.1 LGPL 2.1 License
18
+ * @version 3.0.0
19
+ */
20
+
21
+ namespace jlawrence\eos;
22
+
23
+
24
+ /**
25
+ * Equation Operating System (EOS) Parser
26
+ *
27
+ * A class that can safely parse mathematical equations. Re-written portions
28
+ * from version 2.x to be extend-able with custom functions.
29
+ *
30
+ * @author Jon Lawrence <jlawrence11@gmail.com>
31
+ * @copyright Copyright ©2005-2015, Jon Lawrence
32
+ * @license http://opensource.org/licenses/LGPL-2.1 LGPL 2.1 License
33
+ * @version 3.0.0
34
+ */
35
+ class Parser {
36
+
37
+ /**
38
+ * @var string Infix equation
39
+ * Public so advanced/user-defined/etc can access it when throwing exceptions.
40
+ */
41
+ public static $inFix;
42
+
43
+ /**
44
+ * @var array Opening and closing selectors
45
+ */
46
+ protected static $SEP = array(
47
+ 'open' => array('(', '['),
48
+ 'close' => array(')', ']')
49
+ );
50
+
51
+ // Top precedence following operator - not in use
52
+ protected static $SGL = array('!');
53
+
54
+ // Order of operations arrays follow
55
+ protected static $ST = array('^', '!');
56
+ protected static $ST1 = array('/', '*', '%');
57
+ protected static $ST2 = array('+', '-');
58
+
59
+ /**
60
+ * @var array Allowed functions
61
+ */
62
+ protected static $FNC = array(
63
+ 'sin', 'cos', 'tan',
64
+ 'csc', 'sec', 'cot',
65
+ 'abs', 'ln', 'sqrt'
66
+ );
67
+
68
+ /**
69
+ * @var array Advanced functions container
70
+ */
71
+ protected static $AFNC = array();
72
+
73
+ /**
74
+ * Initialize
75
+ */
76
+ public static function init() {
77
+ if (empty(self::$AFNC)) {
78
+ //No advanced functions yet, so this function has not run, do so now.
79
+ self::$AFNC = AdvancedFunctions::map();
80
+ }
81
+ }
82
+
83
+ /**
84
+ * Add Advanced Function Class
85
+ *
86
+ * Adds a function class to the parser for user/programmer defined
87
+ * functions that can be parsed with the parser. For example
88
+ * class structure see jlawrence\eos\AdvancedFunctions.
89
+ * Class must be static, and must have a function named 'map'
90
+ *
91
+ * @param string $class Fully Qualified String to class (must include namespace)
92
+ * @return bool True on success
93
+ * @throws \Exception When the added class doesn't have the 'map' function or doesn't exist.
94
+ *
95
+ * @codeCoverageIgnore
96
+ */
97
+ public static function addFunctionClass($class)
98
+ {
99
+ self::init();
100
+ if(is_callable("{$class}::map")) {
101
+ $a = call_user_func($class.'::map');
102
+ self::$AFNC = array_merge($a, self::$AFNC);
103
+ } else {
104
+ throw new \Exception("{$class}::map() is not callable");
105
+ }
106
+ return true;
107
+ }
108
+
109
+ /**
110
+ * Check Infix for opening closing pair matches.
111
+ *
112
+ * This function is meant to solely check to make sure every opening
113
+ * statement has a matching closing one, and throws an exception if
114
+ * it doesn't.
115
+ *
116
+ * @param string $infix Equation to check
117
+ * @throws \Exception if malformed.
118
+ * @return Bool true if passes - throws an exception if not.
119
+ */
120
+ private static function checkInfix($infix) {
121
+ self::init();
122
+ if(trim($infix) == "") {
123
+ throw new \Exception("No Equation given", Math::E_NO_EQ);
124
+ }
125
+ //Make sure we have the same number of '(' as we do ')'
126
+ // and the same # of '[' as we do ']'
127
+ if(substr_count($infix, '(') != substr_count($infix, ')')) {
128
+ throw new \Exception("Mismatched parenthesis in ". self::$inFix, Math::E_NO_SET);
129
+ } elseif(substr_count($infix, '[') != substr_count($infix, ']')) {
130
+ throw new \Exception("Mismatched brackets in '". self::$inFix, Math::E_NO_SET);
131
+ }
132
+ return true;
133
+ }
134
+
135
+ /**
136
+ * Infix to Postfix
137
+ *
138
+ * Converts an infix (standard) equation to postfix (RPN) notation.
139
+ * Sets the internal variable $this->postFix for the Parser::solvePF()
140
+ * function to use.
141
+ *
142
+ * @link http://en.wikipedia.org/wiki/Infix_notation Infix Notation
143
+ * @link http://en.wikipedia.org/wiki/Reverse_Polish_notation Reverse Polish Notation
144
+ * @param string $infix A standard notation equation
145
+ * @throws \Exception When parenthesis are mismatched
146
+ * @return array Fully formed RPN Stack
147
+ */
148
+ public static function in2post($infix) {
149
+ // if an equation was not passed, use the one that was passed in the constructor
150
+ //$infix = (isset($infix)) ? $infix : $this->inFix;
151
+
152
+ //check to make sure 'valid' equation
153
+ self::checkInfix($infix);
154
+ $pf = array();
155
+ $ops = new Stack();
156
+ //$vars = new Stack();
157
+
158
+ // remove all white-space
159
+ $infix = preg_replace("/\s/", "", $infix);
160
+
161
+ // Create postfix array index
162
+ $pfIndex = 0;
163
+
164
+ //what was the last character? (useful for discerning between a sign for negation and subtraction)
165
+ $lChar = '';
166
+
167
+ //loop through all the characters and start doing stuff ^^
168
+ for($i=0;$i<strlen($infix);$i++) {
169
+ // pull out 1 character from the string
170
+ $chr = substr($infix, $i, 1);
171
+
172
+ // if the character is numerical
173
+ if(preg_match('/[0-9.]/i', $chr)) {
174
+ // if the previous character was not a '-' or a number
175
+ if((!preg_match('/[0-9.]/i', $lChar) && ($lChar != "")) && (isset($pf[$pfIndex]) && ($pf[$pfIndex]!="-")))
176
+ $pfIndex++; // increase the index so as not to overlap anything
177
+ // Add the number character to the array
178
+ if(isset($pf[$pfIndex])) {
179
+ $pf[$pfIndex] .= $chr;
180
+ } else {
181
+ $pf[$pfIndex] = $chr;
182
+ }
183
+
184
+ }
185
+ // If the character opens a set e.g. '(' or '['
186
+ elseif(in_array($chr, self::$SEP['open'])) {
187
+ // if the last character was a number, place an assumed '*' on the stack
188
+ if(preg_match('/[0-9.]/i', $lChar))
189
+ $ops->push('*');
190
+
191
+ $ops->push($chr);
192
+ }
193
+ // if the character closes a set e.g. ')' or ']'
194
+ elseif(in_array($chr, self::$SEP['close'])) {
195
+ // find what set it was i.e. matches ')' with '(' or ']' with '['
196
+ $key = array_search($chr, self::$SEP['close']);
197
+ // while the operator on the stack isn't the matching pair...pop it off
198
+ while($ops->peek() != self::$SEP['open'][$key]) {
199
+ $nchr = $ops->pop();
200
+ if($nchr)
201
+ $pf[++$pfIndex] = $nchr;
202
+ else {
203
+ //Should NEVER get here...
204
+ // @codeCoverageIgnoreStart
205
+ throw new \Exception("Error while searching for '". self::$SEP['open'][$key] ."' in ". self::$inFix, Math::E_NO_SET);
206
+ // @codeCoverageIgnoreEnd
207
+ }
208
+ }
209
+ $ops->pop();
210
+ }
211
+ // If a special operator that has precedence over everything else
212
+ elseif(in_array($chr, self::$ST)) {
213
+ while(in_array($ops->peek(), self::$ST))
214
+ $pf[++$pfIndex] = $ops->pop();
215
+ $ops->push($chr);
216
+ $pfIndex++;
217
+ }
218
+ // Any other operator other than '+' and '-'
219
+ elseif(in_array($chr, self::$ST1)) {
220
+ while(in_array($ops->peek(), self::$ST1) || in_array($ops->peek(), self::$ST))
221
+ $pf[++$pfIndex] = $ops->pop();
222
+
223
+ $ops->push($chr);
224
+ $pfIndex++;
225
+ }
226
+ // if a '+' or '-'
227
+ elseif(in_array($chr, self::$ST2)) {
228
+ // if it is a '-' and the character before it was an operator or nothingness (e.g. it negates a number)
229
+ if((in_array($lChar, array_merge(self::$ST1, self::$ST2, self::$ST, self::$SEP['open'])) || $lChar=="") && $chr=="-") {
230
+ // increase the index because there is no reason that it shouldn't..
231
+ $pfIndex++;
232
+ $pf[$pfIndex] = $chr;
233
+ }
234
+ // Otherwise it will function like a normal operator
235
+ else {
236
+ while(in_array($ops->peek(), array_merge(self::$ST1, self::$ST2, self::$ST)))
237
+ $pf[++$pfIndex] = $ops->pop();
238
+ $ops->push($chr);
239
+ $pfIndex++;
240
+ }
241
+ }
242
+ // make sure we record this character to be referred to by the next one
243
+ $lChar = $chr;
244
+ }
245
+ // if there is anything on the stack after we are done...add it to the back of the RPN array
246
+ while(($tmp = $ops->pop()) !== false)
247
+ $pf[++$pfIndex] = $tmp;
248
+
249
+ // re-index the array at 0
250
+ $pf = array_values($pf);
251
+
252
+ // set the private variable for later use if needed
253
+ //self::$postFix = $pf;
254
+
255
+ // return the RPN array in case developer wants to use it for some insane reason (bug testing ;] )
256
+ // Also... because we pass it right in to the RPN solver. So I guess there's that too.
257
+ return $pf;
258
+ }
259
+
260
+ /**
261
+ * Solve Postfix (RPN)
262
+ *
263
+ * This function will solve a RPN array. Default action is to solve
264
+ * the RPN array stored in the class from Parser::in2post(), can take
265
+ * an array input to solve as well, though default action is preferred.
266
+ *
267
+ * @link http://en.wikipedia.org/wiki/Reverse_Polish_notation Postix Notation
268
+ * @param array $pfArray RPN formatted array. Optional.
269
+ * @throws \Exception on division by 0
270
+ * @return float Result of the operation.
271
+ */
272
+ public static function solvePF($pfArray) {
273
+ $pf = $pfArray;
274
+
275
+ // create our temporary function variables
276
+ $temp = array();
277
+ //$tot = 0;
278
+ $hold = 0;
279
+
280
+ // Loop through each number/operator
281
+ for($i=0;$i<count($pf); $i++) {
282
+ // If the string isn't an operator, add it to the temp var as a holding place
283
+ if(!in_array($pf[$i], array_merge(self::$ST, self::$ST1, self::$ST2))) {
284
+ $temp[$hold++] = $pf[$i];
285
+ }
286
+ // ...Otherwise perform the operator on the last two numbers
287
+ else {
288
+ switch ($pf[$i]) {
289
+ case '+':
290
+ $temp[$hold-2] = $temp[$hold-2] + $temp[$hold-1];
291
+ break;
292
+ case '-':
293
+ $temp[$hold-2] = $temp[$hold-2] - $temp[$hold-1];
294
+ break;
295
+ case '*':
296
+ $temp[$hold-2] = $temp[$hold-2] * $temp[$hold-1];
297
+ break;
298
+ case '/':
299
+ if($temp[$hold-1] == 0) {
300
+ throw new \Exception("Division by 0 on: '{$temp[$hold-2]} / {$temp[$hold-1]}' in ". self::$inFix, Math::E_DIV_ZERO);
301
+ }
302
+ $temp[$hold-2] = $temp[$hold-2] / $temp[$hold-1];
303
+ break;
304
+ case '^':
305
+ $temp[$hold-2] = pow($temp[$hold-2], $temp[$hold-1]);
306
+ break;
307
+ case '!':
308
+ $temp[$hold-1] = self::factorial($temp[$hold-1]);
309
+ $hold++;
310
+ break;
311
+ case '%':
312
+ if($temp[$hold-1] == 0) {
313
+ throw new \Exception("Division by 0 on: '{$temp[$hold-2]} % {$temp[$hold-1]}' in ". self::$inFix, Math::E_DIV_ZERO);
314
+ }
315
+ $temp[$hold-2] = bcmod($temp[$hold-2], $temp[$hold-1]);
316
+ break;
317
+ }
318
+ // Decrease the hold var to one above where the last number is
319
+ $hold = $hold-1;
320
+ }
321
+ }
322
+
323
+ // return the last number in the array
324
+ return $temp[$hold-1];
325
+ }
326
+
327
+
328
+ /**
329
+ * Solve
330
+ *
331
+ * This function is called by the user to solve an equation within the parser system
332
+ * No internal functions or added advanced functions should ever call this. Sets
333
+ * the internal $infix variable for use in thrown exceptions. The variable array must
334
+ * be in the format of 'variable' => value. If variable array is scalar (ie 5), all
335
+ * variables will be replaced with it.
336
+ *
337
+ * @param string $equation Equation to Solve
338
+ * @param array|double $values variable values
339
+ * @return float Answer to the equation
340
+ */
341
+ public static function solve($equation, $values = null) {
342
+ if(is_array($equation)) {
343
+ return self::solvePF($equation);
344
+ } else {
345
+ self::$inFix = $equation;
346
+ return self::solveIF($equation, $values);
347
+ }
348
+ }
349
+
350
+ /**
351
+ * Solve Infix (Standard) Notation Equation
352
+ *
353
+ * Will take a standard equation with optional variables and solve it.
354
+ * This function is the one for programmers making modules for this
355
+ * package should call as it does not set the internal variable for
356
+ * the equation. This should not be used by the programmer/user that
357
+ * is using this package to solve equations.
358
+ *
359
+ * @param string $infix Standard Equation to solve
360
+ * @param string|array $vArray Variable replacement
361
+ * @throws \Exception On division by zero or NaN
362
+ * @return float Solved equation
363
+ */
364
+ public static function solveIF($infix, $vArray = null) {
365
+ //Check to make sure a 'valid' expression
366
+ self::checkInfix($infix);
367
+
368
+ //$ops = new Stack();
369
+ //$vars = new Stack();
370
+ $hand = null;
371
+
372
+ //remove all white-space
373
+ $infix = preg_replace("/\s/", "", $infix);
374
+
375
+ $infix = self::checkAdvancedInput($infix,$vArray);
376
+
377
+ // Finds all the 'functions' within the equation and calculates them
378
+ //Nested parenthesis are now a go!
379
+ while((preg_match("/(". implode("|", self::$FNC) . ")\(((?:[^()]|\((?2)\))*+)\)/", $infix, $match)) != 0) {
380
+ $func = self::solveIF($match[2], $vArray);
381
+ switch($match[1]) {
382
+ case "cos":
383
+ $ans = Trig::cos($func);
384
+ break;
385
+ case "sin":
386
+ $ans = Trig::sin($func);
387
+ break;
388
+ case "tan":
389
+ $ans = Trig::tan($func);
390
+ break;
391
+ case "sec":
392
+ $ans = Trig::sec($func);
393
+ break;
394
+ case "csc":
395
+ $ans = Trig::csc($func);
396
+ break;
397
+ case "cot":
398
+ $ans = Trig::cot($func);
399
+ break;
400
+ case "abs":
401
+ $ans = abs($func);
402
+ break;
403
+ case "ln":
404
+ $ans = log($func);
405
+ if(is_nan($ans) || is_infinite($ans)) {
406
+ throw new \Exception("Result of 'ln({$func}) = {$ans}' is either infinite or a non-number in ". self::$inFix, Math::E_NAN);
407
+ }
408
+ break;
409
+ case "sqrt":
410
+ if($func < 0) {
411
+ throw new \Exception("Result of 'sqrt({$func}) = i' in ". self::$inFix .". We can't handle imaginary numbers", Math::E_NAN);
412
+ }
413
+ $ans = sqrt($func);
414
+ break;
415
+ // @codeCoverageIgnoreStart
416
+ default:
417
+ $ans = 0;
418
+ break;
419
+ // @codeCoverageIgnoreEnd
420
+ }
421
+ $infix = str_replace($match[0], "({$ans})", $infix);
422
+ }
423
+
424
+ //replace scientific notation with normal notation (2e-9 to 2*10^-9)
425
+ $infix = preg_replace('/([\d])([eE])(-?\d)/', '$1*10^$3', $infix);
426
+
427
+ $infix = self::replaceVars($infix, $vArray);
428
+
429
+ return self::solvePF(self::in2post($infix));
430
+ }
431
+
432
+ /**
433
+ * checkAdvancedInput
434
+ *
435
+ * Will take the input from `Parser::solveIF()` and solve all the advanced functions
436
+ * that exist within it, returning it to the function when done for further
437
+ * processing.
438
+ *
439
+ * @param string $input Check for advanced functions, recursively go through them.
440
+ * @param array|int|null $vArray Variables from user-input
441
+ * @return string The input with all advanced functions solved for.
442
+ */
443
+ protected static function checkAdvancedInput($input, $vArray)
444
+ {
445
+ $infix = $input;
446
+ //Advanced/User-defined functions
447
+ while((preg_match("/(". implode("|", array_keys(self::$AFNC)) . ")\(((?:[^()]|\((?2)\))*+)\)/", $infix, $match)) != 0) {
448
+ $method = self::$AFNC[$match[1]];
449
+ if(stripos($match[2], '(') !== false) {
450
+ $match[2] = self::checkAdvancedInput($match[2], $vArray);
451
+ }
452
+ $ans = call_user_func($method, $match[2], $vArray);
453
+ $infix = str_replace($match[0], "({$ans})", $infix);
454
+ }
455
+ return $infix;
456
+ }
457
+
458
+ /**
459
+ * @param string $infix
460
+ * @param array $vArray
461
+ * @return string
462
+ * @throws \Exception
463
+ */
464
+ protected static function replaceVars($infix, $vArray)
465
+ {
466
+ //Remove old '$' and '&' signis so the regex works properly.
467
+ $infix = preg_replace('/[$&]/', "", $infix);
468
+ //Find all the variables that were passed and replaces them
469
+ while((preg_match('/([^a-zA-Z]){0,1}([a-zA-Z]+)([^a-zA-Z]){0,1}/', $infix, $match)) != 0) {
470
+
471
+ //remove notices by defining if undefined.
472
+ if(!isset($match[3])) {
473
+ $match[3] = "";
474
+ }
475
+
476
+ // Ensure that the variable has an operator or something of that sort in front and back - if it doesn't, add an implied '*'
477
+ if((!in_array($match[1], array_merge(self::$ST, self::$ST1, self::$ST2, self::$SEP['open'])) && $match[1] != "") || is_numeric($match[1])) //$this->SEP['close'] removed
478
+ $front = "*";
479
+ else
480
+ $front = "";
481
+
482
+ if((!in_array($match[3], array_merge(self::$ST, self::$ST1, self::$ST2, self::$SEP['close'])) && $match[3] != "") || is_numeric($match[3])) //$this->SEP['open'] removed
483
+ $back = "*";
484
+ else
485
+ $back = "";
486
+
487
+ //Make sure that the variable does have a replacement
488
+ //First check for pi and e variables that wll automatically be replaced
489
+ if(in_array(strtolower($match[2]), array('pi', 'e'))) {
490
+ $t = (strtolower($match[2])=='pi') ? pi() : exp(1);
491
+ $infix = str_replace($match[0], $match[1] . $front. $t. $back . $match[3], $infix);
492
+ } elseif(!isset($vArray[$match[2]]) && (!is_array($vArray != "") && !is_numeric($vArray) && 0 !== $vArray)) {
493
+ throw new \Exception("Variable replacement does not exist for '". $match[2] ."' in ". self::$inFix .".", Math::E_NO_VAR);
494
+ } elseif(!isset($vArray[$match[2]]) && (!is_array($vArray != "") && is_numeric($vArray))) {
495
+ $infix = str_replace($match[0], $match[1] . $front. $vArray. $back . $match[3], $infix);
496
+ } elseif(isset($vArray[$match[2]])) {
497
+ $infix = str_replace($match[0], $match[1] . $front. $vArray[$match[2]]. $back . $match[3], $infix);
498
+ }
499
+ }
500
+
501
+ return $infix;
502
+ }
503
+
504
+ /**
505
+ * Solve factorial (!)
506
+ *
507
+ * Will take an integer and solve for it's factorial. Eg.
508
+ * `5!` will become `1*2*3*4*5` = `120`
509
+ * DONE:
510
+ * Solve for non-integer factorials 2015/07/02
511
+ *
512
+ * @param float $num Non-negative real number to get factorial of
513
+ * @throws \Exception if number is at or less than 0
514
+ * @return float Solved factorial
515
+ */
516
+ protected static function factorial($num) {
517
+ if($num < 0) {
518
+ throw new \Exception("Factorial Error: Factorials don't exist for numbers < 0 in ". self::$inFix, Math::E_NAN);
519
+ }
520
+ //A non-integer! Gamma that sucker up!
521
+ if(intval($num) != $num) {
522
+ return self::gamma($num + 1);
523
+ }
524
+
525
+ $tot = 1;
526
+ for($i=1;$i<=$num;$i++) {
527
+ $tot *= $i;
528
+ }
529
+
530
+ return $tot;
531
+ }
532
+
533
+ /**
534
+ * Gamma Function
535
+ *
536
+ * Because we can. This function exists as a catch-all for different
537
+ * numerical approx. of gamma if I decide to add any past Lanczos'.
538
+ *
539
+ * @param $z Number to compute gamma from
540
+ * @return float The gamma (hopefully, I'll test it after writing the code)
541
+ */
542
+ public static function gamma($z)
543
+ {
544
+ return self::laGamma($z);
545
+ }
546
+
547
+ /**
548
+ * Lanczos Approximation
549
+ *
550
+ * The Lanczos Approximation method of finding gamma values
551
+ *
552
+ * @link http://www.rskey.org/CMS/index.php/the-library/11
553
+ * @link http://algolist.manual.ru/maths/count_fast/gamma_function.php
554
+ * @link https://en.wikipedia.org/wiki/Lanczos_approximation
555
+ * @param $z Number to obtain the gamma of
556
+ * @return float Answer
557
+ */
558
+ protected static function laGamma($z)
559
+ {
560
+ // Set up coefficients
561
+ $p = array(
562
+ 0 => 1.000000000190015,
563
+ 1 => 76.18009172947146,
564
+ 2 => -86.50532032941677,
565
+ 3 => 24.01409824083091,
566
+ 4 => -1.231739572450155,
567
+ 5 => 1.208650973866179E-3,
568
+ 6 => -5.395239384953E-6
569
+ );
570
+
571
+ // Formula:
572
+ // ((sqrt(2pi)/z)(p[0]+sum(p[n]/(z+n), 1, 6)))(z+5.5)^(z+0.5)*e^(-(z+5.5))
573
+
574
+ // Break it down now...
575
+ $g1 = sqrt(2*pi())/$z;
576
+
577
+ // Next comes our summation
578
+ $g2 =0;
579
+ for($n=1;$n<=6;$n++) {
580
+ $g2 += $p[$n]/($z+$n);
581
+ }
582
+
583
+ // Don't forget to add p[0] to it...
584
+ $g2 += $p[0];
585
+ $g3 = pow($z+5.5, $z + .5);
586
+ $g4 = exp(-($z+5.5));
587
+
588
+ //now just multiply them all together
589
+ $gamma = $g1 * $g2 * $g3 * $g4;
590
+
591
+ return $gamma;
592
+ }
593
+ }
lib/jlawrence/eos/src/Stack.php ADDED
@@ -0,0 +1,115 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace jlawrence\eos;
4
+
5
+ /**
6
+ * Basic Stack Class.
7
+ *
8
+ * Created for use with eqEOS. May eventually be replaced with native
9
+ * PHP functions `array_pop()`, `array_push()`, and `end()`
10
+ *
11
+ * @author Jon Lawrence <jlawrence11@gmail.com>
12
+ * @copyright Copyright ©2005-2015 Jon Lawrence
13
+ * @license http://opensource.org/licenses/LGPL-2.1 LGPL 2.1 License
14
+ * @package Math
15
+ * @version 0.1
16
+ */
17
+ class Stack {
18
+ private $index;
19
+ private $locArray;
20
+
21
+ /**
22
+ * Constructor
23
+ *
24
+ * Initializes the stack
25
+ */
26
+ public function __construct() {
27
+ //define the private vars
28
+ $this->locArray = array();
29
+ $this->index = -1;
30
+ }
31
+
32
+ /**
33
+ * Peek
34
+ *
35
+ * Will view the last element of the stack without removing it
36
+ *
37
+ * @return mixed An element of the array or false if none exist
38
+ */
39
+ public function peek() {
40
+ if($this->index > -1)
41
+ return $this->locArray[$this->index];
42
+ else
43
+ return false;
44
+ }
45
+
46
+ /**
47
+ * Poke
48
+ *
49
+ * Will add an element to the end of the stack
50
+ *
51
+ * @param mixed $data Element to add
52
+ */
53
+ public function poke($data) {
54
+ $this->locArray[++$this->index] = $data;
55
+ }
56
+
57
+ /**
58
+ * Push
59
+ *
60
+ * Alias of {@see Stack::poke()}
61
+ * Adds element to the stack
62
+ *
63
+ * @param mixed $data Element to add
64
+ */
65
+ public function push($data) {
66
+ //alias for 'poke'
67
+ $this->poke($data);
68
+ }
69
+
70
+ /**
71
+ * Pop
72
+ *
73
+ * Retrieves an element from the end of the stack, and removes it from
74
+ * the stack at the same time. If no elements, returns boolean false
75
+ *
76
+ * @return mixed Element at end of stack or false if none exist
77
+ */
78
+ public function pop() {
79
+ if($this->index > -1)
80
+ {
81
+ $this->index--;
82
+ return $this->locArray[$this->index+1];
83
+ }
84
+ else
85
+ return false;
86
+ }
87
+
88
+ /**
89
+ * Clear
90
+ *
91
+ * Clears the stack to be reused.
92
+ */
93
+ public function clear() {
94
+ $this->index = -1;
95
+ $this->locArray = array();
96
+ }
97
+
98
+ /**
99
+ * Get Stack
100
+ *
101
+ * Returns the array of stack elements, keeping all, indexed at 0
102
+ *
103
+ * @return mixed Array of stack elements or false if none exist.
104
+ */
105
+ public function getStack() {
106
+ if($this->index > -1)
107
+ {
108
+ return array_values($this->locArray);
109
+ }
110
+ else
111
+ return false;
112
+ }
113
+ }
114
+
115
+ ?>
lib/jlawrence/eos/src/Trig.php ADDED
@@ -0,0 +1,75 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+ /**
3
+ * Created by: Jon Lawrence on 2015-07-02 3:10 PM
4
+ */
5
+
6
+ namespace jlawrence\eos;
7
+
8
+ /**
9
+ * Class Trig
10
+ * @package jlawrence\Math
11
+ *
12
+ * Trig functions, primarily because there's a difference when dealing with
13
+ * radians and degrees, and this class will help with that - defaulting
14
+ * to radians, but allowing the default to be set to degrees for the
15
+ * project. Thus simplifying the amount of calculations the user
16
+ * of this project needs to do.
17
+ */
18
+ class Trig
19
+ {
20
+ /**
21
+ * @var bool Whether or not to convert to radians before calculation
22
+ * (Meaning input is in degree form)
23
+ */
24
+ public static $DEGREES = false;
25
+
26
+ protected static function getRadDeg($x)
27
+ {
28
+ if(self::$DEGREES == true) {
29
+ return deg2rad($x);
30
+ }
31
+ return $x;
32
+ }
33
+
34
+ public static function cos($x)
35
+ {
36
+ return cos(self::getRadDeg($x));
37
+ }
38
+
39
+ public static function sin($x)
40
+ {
41
+ return sin(self::getRadDeg($x));
42
+ }
43
+
44
+ public static function tan($x)
45
+ {
46
+ return tan(self::getRadDeg($x));
47
+ }
48
+
49
+ public static function sec($x)
50
+ {
51
+ $tmp = self::cos($x);
52
+ if($tmp == 0)
53
+ throw new \Exception("Division by 0 on: 'sec({$x}) = 1/cos({$x})' in ". Parser::$inFix, Math::E_DIV_ZERO);
54
+
55
+ return 1/$tmp;
56
+ }
57
+
58
+ public static function csc($x)
59
+ {
60
+ $tmp = self::sin($x);
61
+ if($tmp == 0)
62
+ throw new \Exception("Division by 0 on: 'csc({$x})) = 1/sin({$x})' in ". Parser::$inFix, Math::E_DIV_ZERO);
63
+
64
+ return 1/$tmp;
65
+ }
66
+
67
+ public static function cot($x)
68
+ {
69
+ $tmp = self::tan($x);
70
+ if($tmp == 0)
71
+ throw new \Exception("Division by 0 on: 'cot({$x})) = 1/tan({$x})' in ". Parser::$inFix, Math::E_DIV_ZERO);
72
+
73
+ return 1/$tmp;
74
+ }
75
+ }
lib/markbaker/complex/README.md ADDED
@@ -0,0 +1,156 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ PHPComplex
2
+ ==========
3
+
4
+ ---
5
+
6
+ PHP Class for handling Complex numbers
7
+
8
+ Master: [![Build Status](https://travis-ci.org/MarkBaker/PHPComplex.png?branch=master)](http://travis-ci.org/MarkBaker/PHPComplex)
9
+
10
+ Develop: [![Build Status](https://travis-ci.org/MarkBaker/PHPComplex.png?branch=develop)](http://travis-ci.org/MarkBaker/PHPComplex)
11
+
12
+ [![Complex Numbers](https://imgs.xkcd.com/comics/complex_numbers_2x.png)](https://xkcd.com/2028/)
13
+
14
+ ---
15
+
16
+ The library currently provides the following operations:
17
+
18
+ - addition
19
+ - subtraction
20
+ - multiplication
21
+ - division
22
+ - division by
23
+ - division into
24
+
25
+ together with functions for
26
+
27
+ - theta (polar theta angle)
28
+ - rho (polar distance/radius)
29
+ - conjugate
30
+ * negative
31
+ - inverse (1 / complex)
32
+ - cos (cosine)
33
+ - acos (inverse cosine)
34
+ - cosh (hyperbolic cosine)
35
+ - acosh (inverse hyperbolic cosine)
36
+ - sin (sine)
37
+ - asin (inverse sine)
38
+ - sinh (hyperbolic sine)
39
+ - asinh (inverse hyperbolic sine)
40
+ - sec (secant)
41
+ - asec (inverse secant)
42
+ - sech (hyperbolic secant)
43
+ - asech (inverse hyperbolic secant)
44
+ - csc (cosecant)
45
+ - acsc (inverse cosecant)
46
+ - csch (hyperbolic secant)
47
+ - acsch (inverse hyperbolic secant)
48
+ - tan (tangent)
49
+ - atan (inverse tangent)
50
+ - tanh (hyperbolic tangent)
51
+ - atanh (inverse hyperbolic tangent)
52
+ - cot (cotangent)
53
+ - acot (inverse cotangent)
54
+ - coth (hyperbolic cotangent)
55
+ - acoth (inverse hyperbolic cotangent)
56
+ - sqrt (square root)
57
+ - exp (exponential)
58
+ - ln (natural log)
59
+ - log10 (base-10 log)
60
+ - log2 (base-2 log)
61
+ - pow (raised to the power of a real number)
62
+
63
+
64
+ ---
65
+
66
+ # Usage
67
+
68
+ To create a new complex object, you can provide either the real, imaginary and suffix parts as individual values, or as an array of values passed passed to the constructor; or a string representing the value. e.g
69
+
70
+ ```
71
+ $real = 1.23;
72
+ $imaginary = -4.56;
73
+ $suffix = 'i';
74
+
75
+ $complexObject = new Complex\Complex($real, $imaginary, $suffix);
76
+ ```
77
+ or
78
+ ```
79
+ $real = 1.23;
80
+ $imaginary = -4.56;
81
+ $suffix = 'i';
82
+
83
+ $arguments = [$real, $imaginary, $suffix];
84
+
85
+ $complexObject = new Complex\Complex($arguments);
86
+ ```
87
+ or
88
+ ```
89
+ $complexString = '1.23-4.56i';
90
+
91
+ $complexObject = new Complex\Complex($complexString);
92
+ ```
93
+
94
+ Complex objects are immutable: whenever you call a method or pass a complex value to a function that returns a complex value, a new Complex object will be returned, and the original will remain unchanged.
95
+ This also allows you to chain multiple methods as you would for a fluent interface (as long as they are methods that will return a Complex result).
96
+
97
+ ## Performing Mathematical Operations
98
+
99
+ To perform mathematical operations with Complex values, you can call the appropriate method against a complex value, passing other values as arguments
100
+
101
+ ```
102
+ $complexString1 = '1.23-4.56i';
103
+ $complexString2 = '2.34+5.67i';
104
+
105
+ $complexObject = new Complex\Complex($complexString1);
106
+ echo $complexObject->add($complexString2);
107
+ ```
108
+ or pass all values to the appropriate function
109
+ ```
110
+ $complexString1 = '1.23-4.56i';
111
+ $complexString2 = '2.34+5.67i';
112
+
113
+ echo Complex\add($complexString1, $complexString2);
114
+ ```
115
+ If you want to perform the same operation against multiple values (e.g. to add three or more complex numbers), then you can pass multiple arguments to any of the operations.
116
+
117
+ You can pass these arguments as Complex objects, or as an array or string that will parse to a complex object.
118
+
119
+ ## Using functions
120
+
121
+ When calling any of the available functions for a complex value, you can either call the relevant method for the Complex object
122
+ ```
123
+ $complexString = '1.23-4.56i';
124
+
125
+ $complexObject = new Complex\Complex($complexString);
126
+ echo $complexObject->sinh();
127
+ ```
128
+ or you can call the function as you would in procedural code, passing the Complex object as an argument
129
+ ```
130
+ $complexString = '1.23-4.56i';
131
+
132
+ $complexObject = new Complex\Complex($complexString);
133
+ echo Complex\sinh($complexObject);
134
+ ```
135
+ When called procedurally using the function, you can pass in the argument as a Complex object, or as an array or string that will parse to a complex object.
136
+ ```
137
+ $complexString = '1.23-4.56i';
138
+
139
+ echo Complex\sinh($complexString);
140
+ ```
141
+
142
+ In the case of the `pow()` function (the only implemented function that requires an additional argument) you need to pass both arguments when calling the function procedurally
143
+
144
+ ```
145
+ $complexString = '1.23-4.56i';
146
+
147
+ $complexObject = new Complex\Complex($complexString);
148
+ echo Complex\pow($complexObject, 2);
149
+ ```
150
+ or pass the additional argument when calling the method
151
+ ```
152
+ $complexString = '1.23-4.56i';
153
+
154
+ $complexObject = new Complex\Complex($complexString);
155
+ echo $complexObject->pow(2);
156
+ ```
lib/markbaker/complex/classes/Autoloader.php ADDED
@@ -0,0 +1,53 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Complex;
4
+
5
+ /**
6
+ *
7
+ * Autoloader for Complex classes
8
+ *
9
+ * @package Complex
10
+ * @copyright Copyright (c) 2014 Mark Baker (https://github.com/MarkBaker/PHPComplex)
11
+ * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
12
+ */
13
+ class Autoloader
14
+ {
15
+ /**
16
+ * Register the Autoloader with SPL
17
+ *
18
+ */
19
+ public static function Register()
20
+ {
21
+ if (function_exists('__autoload')) {
22
+ // Register any existing autoloader function with SPL, so we don't get any clashes
23
+ spl_autoload_register('__autoload');
24
+ }
25
+ // Register ourselves with SPL
26
+ return spl_autoload_register(['Complex\\Autoloader', 'Load']);
27
+ }
28
+
29
+
30
+ /**
31
+ * Autoload a class identified by name
32
+ *
33
+ * @param string $pClassName Name of the object to load
34
+ */
35
+ public static function Load($pClassName)
36
+ {
37
+ if ((class_exists($pClassName, false)) || (strpos($pClassName, 'Complex\\') !== 0)) {
38
+ // Either already loaded, or not a Complex class request
39
+ return false;
40
+ }
41
+
42
+ $pClassFilePath = __DIR__ . DIRECTORY_SEPARATOR .
43
+ 'src' . DIRECTORY_SEPARATOR .
44
+ str_replace(['Complex\\', '\\'], ['', '/'], $pClassName) .
45
+ '.php';
46
+
47
+ if ((file_exists($pClassFilePath) === false) || (is_readable($pClassFilePath) === false)) {
48
+ // Can't load
49
+ return false;
50
+ }
51
+ require($pClassFilePath);
52
+ }
53
+ }
lib/markbaker/complex/classes/Bootstrap.php ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ include_once __DIR__ . '/Autoloader.php';
4
+
5
+ \Complex\Autoloader::Register();
6
+
7
+
8
+ abstract class FilesystemRegexFilter extends RecursiveRegexIterator
9
+ {
10
+ protected $regex;
11
+ public function __construct(RecursiveIterator $it, $regex)
12
+ {
13
+ $this->regex = $regex;
14
+ parent::__construct($it, $regex);
15
+ }
16
+ }
17
+
18
+ class FilenameFilter extends FilesystemRegexFilter
19
+ {
20
+ // Filter files against the regex
21
+ public function accept()
22
+ {
23
+ return (!$this->isFile() || preg_match($this->regex, $this->getFilename()));
24
+ }
25
+ }
26
+
27
+
28
+ $srcFolder = __DIR__ . DIRECTORY_SEPARATOR . 'src';
29
+ $srcDirectory = new RecursiveDirectoryIterator($srcFolder);
30
+
31
+ $filteredFileList = new FilenameFilter($srcDirectory, '/(?:php)$/i');
32
+ $filteredFileList = new FilenameFilter($filteredFileList, '/^(?!.*(Complex|Exception)\.php).*$/i');
33
+
34
+ foreach (new RecursiveIteratorIterator($filteredFileList) as $file) {
35
+ if ($file->isFile()) {
36
+ include_once $file;
37
+ }
38
+ }
lib/markbaker/complex/classes/src/Complex.php ADDED
@@ -0,0 +1,387 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Class for the management of Complex numbers
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Complex Number object.
14
+ *
15
+ * @package Complex
16
+ *
17
+ * @method float abs()
18
+ * @method Complex acos()
19
+ * @method Complex acosh()
20
+ * @method Complex acot()
21
+ * @method Complex acoth()
22
+ * @method Complex acsc()
23
+ * @method Complex acsch()
24
+ * @method float argument()
25
+ * @method Complex asec()
26
+ * @method Complex asech()
27
+ * @method Complex asin()
28
+ * @method Complex asinh()
29
+ * @method Complex atan()
30
+ * @method Complex atanh()
31
+ * @method Complex conjugate()
32
+ * @method Complex cos()
33
+ * @method Complex cosh()
34
+ * @method Complex cot()
35
+ * @method Complex coth()
36
+ * @method Complex csc()
37
+ * @method Complex csch()
38
+ * @method Complex exp()
39
+ * @method Complex inverse()
40
+ * @method Complex ln()
41
+ * @method Complex log2()
42
+ * @method Complex log10()
43
+ * @method Complex negative()
44
+ * @method Complex pow(int|float $power)
45
+ * @method float rho()
46
+ * @method Complex sec()
47
+ * @method Complex sech()
48
+ * @method Complex sin()
49
+ * @method Complex sinh()
50
+ * @method Complex sqrt()
51
+ * @method Complex tan()
52
+ * @method Complex tanh()
53
+ * @method float theta()
54
+ * @method Complex add(...$complexValues)
55
+ * @method Complex subtract(...$complexValues)
56
+ * @method Complex multiply(...$complexValues)
57
+ * @method Complex divideby(...$complexValues)
58
+ * @method Complex divideinto(...$complexValues)
59
+ */
60
+ class Complex
61
+ {
62
+ /**
63
+ * @constant Euler's Number.
64
+ */
65
+ const EULER = 2.7182818284590452353602874713526624977572;
66
+
67
+ /**
68
+ * @constant Regexp to split an input string into real and imaginary components and suffix
69
+ */
70
+ const NUMBER_SPLIT_REGEXP =
71
+ '` ^
72
+ ( # Real part
73
+ [-+]?(\d+\.?\d*|\d*\.?\d+) # Real value (integer or float)
74
+ ([Ee][-+]?[0-2]?\d{1,3})? # Optional real exponent for scientific format
75
+ )
76
+ ( # Imaginary part
77
+ [-+]?(\d+\.?\d*|\d*\.?\d+) # Imaginary value (integer or float)
78
+ ([Ee][-+]?[0-2]?\d{1,3})? # Optional imaginary exponent for scientific format
79
+ )?
80
+ ( # Imaginary part is optional
81
+ ([-+]?) # Imaginary (implicit 1 or -1) only
82
+ ([ij]?) # Imaginary i or j - depending on whether mathematical or engineering
83
+ )
84
+ $`uix';
85
+
86
+ /**
87
+ * @var float $realPart The value of of this complex number on the real plane.
88
+ */
89
+ protected $realPart = 0.0;
90
+
91
+ /**
92
+ * @var float $imaginaryPart The value of of this complex number on the imaginary plane.
93
+ */
94
+ protected $imaginaryPart = 0.0;
95
+
96
+ /**
97
+ * @var string $suffix The suffix for this complex number (i or j).
98
+ */
99
+ protected $suffix;
100
+
101
+
102
+ /**
103
+ * Validates whether the argument is a valid complex number, converting scalar or array values if possible
104
+ *
105
+ * @param mixed $complexNumber The value to parse
106
+ * @return array
107
+ * @throws Exception If the argument isn't a Complex number or cannot be converted to one
108
+ */
109
+ private static function parseComplex($complexNumber)
110
+ {
111
+ // Test for real number, with no imaginary part
112
+ if (is_numeric($complexNumber)) {
113
+ return [$complexNumber, 0, null];
114
+ }
115
+
116
+ // Fix silly human errors
117
+ $complexNumber = str_replace(
118
+ ['+-', '-+', '++', '--'],
119
+ ['-', '-', '+', '+'],
120
+ $complexNumber
121
+ );
122
+
123
+ // Basic validation of string, to parse out real and imaginary parts, and any suffix
124
+ $validComplex = preg_match(
125
+ self::NUMBER_SPLIT_REGEXP,
126
+ $complexNumber,
127
+ $complexParts
128
+ );
129
+
130
+ if (!$validComplex) {
131
+ // Neither real nor imaginary part, so test to see if we actually have a suffix
132
+ $validComplex = preg_match('/^([\-\+]?)([ij])$/ui', $complexNumber, $complexParts);
133
+ if (!$validComplex) {
134
+ throw new Exception('Invalid complex number');
135
+ }
136
+ // We have a suffix, so set the real to 0, the imaginary to either 1 or -1 (as defined by the sign)
137
+ $imaginary = 1;
138
+ if ($complexParts[1] === '-') {
139
+ $imaginary = 0 - $imaginary;
140
+ }
141
+ return [0, $imaginary, $complexParts[2]];
142
+ }
143
+
144
+ // If we don't have an imaginary part, identify whether it should be +1 or -1...
145
+ if (($complexParts[4] === '') && ($complexParts[9] !== '')) {
146
+ if ($complexParts[7] !== $complexParts[9]) {
147
+ $complexParts[4] = 1;
148
+ if ($complexParts[8] === '-') {
149
+ $complexParts[4] = -1;
150
+ }
151
+ } else {
152
+ // ... or if we have only the real and no imaginary part
153
+ // (in which case our real should be the imaginary)
154
+ $complexParts[4] = $complexParts[1];
155
+ $complexParts[1] = 0;
156
+ }
157
+ }
158
+
159
+ // Return real and imaginary parts and suffix as an array, and set a default suffix if user input lazily
160
+ return [
161
+ $complexParts[1],
162
+ $complexParts[4],
163
+ !empty($complexParts[9]) ? $complexParts[9] : 'i'
164
+ ];
165
+ }
166
+
167
+
168
+ public function __construct($realPart = 0.0, $imaginaryPart = null, $suffix = 'i')
169
+ {
170
+ if ($imaginaryPart === null) {
171
+ if (is_array($realPart)) {
172
+ // We have an array of (potentially) real and imaginary parts, and any suffix
173
+ list ($realPart, $imaginaryPart, $suffix) = array_values($realPart) + [0.0, 0.0, 'i'];
174
+ } elseif ((is_string($realPart)) || (is_numeric($realPart))) {
175
+ // We've been given a string to parse to extract the real and imaginary parts, and any suffix
176
+ list($realPart, $imaginaryPart, $suffix) = self::parseComplex($realPart);
177
+ }
178
+ }
179
+ if ($imaginaryPart <> 0.0 && empty($suffix)) {
180
+ $suffix = 'i';
181
+ }
182
+
183
+ // Set parsed values in our properties
184
+ $this->realPart = (float) $realPart;
185
+ $this->imaginaryPart = (float) $imaginaryPart;
186
+ $this->suffix = strtolower($suffix);
187
+ }
188
+
189
+ /**
190
+ * Gets the real part of this complex number
191
+ *
192
+ * @return Float
193
+ */
194
+ public function getReal()
195
+ {
196
+ return $this->realPart;
197
+ }
198
+
199
+ /**
200
+ * Gets the imaginary part of this complex number
201
+ *
202
+ * @return Float
203
+ */
204
+ public function getImaginary()
205
+ {
206
+ return $this->imaginaryPart;
207
+ }
208
+
209
+ /**
210
+ * Gets the suffix of this complex number
211
+ *
212
+ * @return String
213
+ */
214
+ public function getSuffix()
215
+ {
216
+ return $this->suffix;
217
+ }
218
+
219
+ /**
220
+ * Returns true if this is a real value, false if a complex value
221
+ *
222
+ * @return Bool
223
+ */
224
+ public function isReal()
225
+ {
226
+ return $this->imaginaryPart == 0.0;
227
+ }
228
+
229
+ /**
230
+ * Returns true if this is a complex value, false if a real value
231
+ *
232
+ * @return Bool
233
+ */
234
+ public function isComplex()
235
+ {
236
+ return !$this->isReal();
237
+ }
238
+
239
+ public function format()
240
+ {
241
+ $str = "";
242
+ if ($this->imaginaryPart != 0.0) {
243
+ if (\abs($this->imaginaryPart) != 1.0) {
244
+ $str .= $this->imaginaryPart . $this->suffix;
245
+ } else {
246
+ $str .= (($this->imaginaryPart < 0.0) ? '-' : '') . $this->suffix;
247
+ }
248
+ }
249
+ if ($this->realPart != 0.0) {
250
+ if (($str) && ($this->imaginaryPart > 0.0)) {
251
+ $str = "+" . $str;
252
+ }
253
+ $str = $this->realPart . $str;
254
+ }
255
+ if (!$str) {
256
+ $str = "0.0";
257
+ }
258
+
259
+ return $str;
260
+ }
261
+
262
+ public function __toString()
263
+ {
264
+ return $this->format();
265
+ }
266
+
267
+ /**
268
+ * Validates whether the argument is a valid complex number, converting scalar or array values if possible
269
+ *
270
+ * @param mixed $complex The value to validate
271
+ * @return Complex
272
+ * @throws Exception If the argument isn't a Complex number or cannot be converted to one
273
+ */
274
+ public static function validateComplexArgument($complex)
275
+ {
276
+ if (is_scalar($complex) || is_array($complex)) {
277
+ $complex = new Complex($complex);
278
+ } elseif (!is_object($complex) || !($complex instanceof Complex)) {
279
+ throw new Exception('Value is not a valid complex number');
280
+ }
281
+
282
+ return $complex;
283
+ }
284
+
285
+ /**
286
+ * Returns the reverse of this complex number
287
+ *
288
+ * @return Complex
289
+ */
290
+ public function reverse()
291
+ {
292
+ return new Complex(
293
+ $this->imaginaryPart,
294
+ $this->realPart,
295
+ ($this->realPart == 0.0) ? null : $this->suffix
296
+ );
297
+ }
298
+
299
+ public function invertImaginary()
300
+ {
301
+ return new Complex(
302
+ $this->realPart,
303
+ $this->imaginaryPart * -1,
304
+ ($this->imaginaryPart == 0.0) ? null : $this->suffix
305
+ );
306
+ }
307
+
308
+ public function invertReal()
309
+ {
310
+ return new Complex(
311
+ $this->realPart * -1,
312
+ $this->imaginaryPart,
313
+ ($this->imaginaryPart == 0.0) ? null : $this->suffix
314
+ );
315
+ }
316
+
317
+ protected static $functions = [
318
+ 'abs',
319
+ 'acos',
320
+ 'acosh',
321
+ 'acot',
322
+ 'acoth',
323
+ 'acsc',
324
+ 'acsch',
325
+ 'argument',
326
+ 'asec',
327
+ 'asech',
328
+ 'asin',
329
+ 'asinh',
330
+ 'atan',
331
+ 'atanh',
332
+ 'conjugate',
333
+ 'cos',
334
+ 'cosh',
335
+ 'cot',
336
+ 'coth',
337
+ 'csc',
338
+ 'csch',
339
+ 'exp',
340
+ 'inverse',
341
+ 'ln',
342
+ 'log2',
343
+ 'log10',
344
+ 'negative',
345
+ 'pow',
346
+ 'rho',
347
+ 'sec',
348
+ 'sech',
349
+ 'sin',
350
+ 'sinh',
351
+ 'sqrt',
352
+ 'tan',
353
+ 'tanh',
354
+ 'theta',
355
+ ];
356
+
357
+ protected static $operations = [
358
+ 'add',
359
+ 'subtract',
360
+ 'multiply',
361
+ 'divideby',
362
+ 'divideinto',
363
+ ];
364
+
365
+ /**
366
+ * Returns the result of the function call or operation
367
+ *
368
+ * @return Complex|float
369
+ * @throws Exception|\InvalidArgumentException
370
+ */
371
+ public function __call($functionName, $arguments)
372
+ {
373
+ $functionName = strtolower(str_replace('_', '', $functionName));
374
+
375
+ // Test for function calls
376
+ if (in_array($functionName, self::$functions)) {
377
+ $functionName = "\\" . __NAMESPACE__ . "\\{$functionName}";
378
+ return $functionName($this, ...$arguments);
379
+ }
380
+ // Test for operation calls
381
+ if (in_array($functionName, self::$operations)) {
382
+ $functionName = "\\" . __NAMESPACE__ . "\\{$functionName}";
383
+ return $functionName($this, ...$arguments);
384
+ }
385
+ throw new Exception('Function or Operation does not exist');
386
+ }
387
+ }
lib/markbaker/complex/classes/src/Exception.php ADDED
@@ -0,0 +1,13 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ * Exception.
5
+ *
6
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
7
+ * @license https://opensource.org/licenses/MIT MIT
8
+ */
9
+ namespace Complex;
10
+
11
+ class Exception extends \Exception
12
+ {
13
+ }
lib/markbaker/complex/classes/src/functions/abs.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex abs() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the absolute value (modulus) of a complex number.
14
+ * Also known as the rho of the complex number, i.e. the distance/radius
15
+ * from the centrepoint to the representation of the number in polar coordinates.
16
+ *
17
+ * This function is a synonym for rho()
18
+ *
19
+ * @param Complex|mixed $complex Complex number or a numeric value.
20
+ * @return float The absolute (or rho) value of the complex argument.
21
+ * @throws Exception If argument isn't a valid real or complex number.
22
+ *
23
+ * @see rho
24
+ *
25
+ */
26
+ function abs($complex)
27
+ {
28
+ return rho($complex);
29
+ }
lib/markbaker/complex/classes/src/functions/acos.php ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acos() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse cosine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse cosine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function acos($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ $square = clone $complex;
24
+ $square = multiply($square, $complex);
25
+ $invsqrt = new Complex(1.0);
26
+ $invsqrt = subtract($invsqrt, $square);
27
+ $invsqrt = sqrt($invsqrt);
28
+ $adjust = new Complex(
29
+ $complex->getReal() - $invsqrt->getImaginary(),
30
+ $complex->getImaginary() + $invsqrt->getReal()
31
+ );
32
+ $log = ln($adjust);
33
+
34
+ return new Complex(
35
+ $log->getImaginary(),
36
+ -1 * $log->getReal()
37
+ );
38
+ }
lib/markbaker/complex/classes/src/functions/acosh.php ADDED
@@ -0,0 +1,34 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acosh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic cosine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic cosine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function acosh($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal() && ($complex->getReal() > 1)) {
24
+ return new Complex(\acosh($complex->getReal()));
25
+ }
26
+
27
+ $acosh = acos($complex)
28
+ ->reverse();
29
+ if ($acosh->getReal() < 0.0) {
30
+ $acosh = $acosh->invertReal();
31
+ }
32
+
33
+ return $acosh;
34
+ }
lib/markbaker/complex/classes/src/functions/acot.php ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acot() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse cotangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse cotangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function acot($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ return atan(inverse($complex));
25
+ }
lib/markbaker/complex/classes/src/functions/acoth.php ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acoth() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic cotangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic cotangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function acoth($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ return atanh(inverse($complex));
25
+ }
lib/markbaker/complex/classes/src/functions/acsc.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acsc() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse cosecant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse cosecant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function acsc($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return asin(inverse($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/acsch.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex acsch() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic cosecant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic cosecant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function acsch($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return asinh(inverse($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/argument.php ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex argument() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the argument of a complex number.
14
+ * Also known as the theta of the complex number, i.e. the angle in radians
15
+ * from the real axis to the representation of the number in polar coordinates.
16
+ *
17
+ * This function is a synonym for theta()
18
+ *
19
+ * @param Complex|mixed $complex Complex number or a numeric value.
20
+ * @return float The argument (or theta) value of the complex argument.
21
+ * @throws Exception If argument isn't a valid real or complex number.
22
+ *
23
+ * @see theta
24
+ */
25
+ function argument($complex)
26
+ {
27
+ return theta($complex);
28
+ }
lib/markbaker/complex/classes/src/functions/asec.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex asec() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse secant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse secant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function asec($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return acos(inverse($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/asech.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex asech() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic secant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic secant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function asech($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return acosh(inverse($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/asin.php ADDED
@@ -0,0 +1,37 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex asin() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse sine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse sine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function asin($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ $square = multiply($complex, $complex);
24
+ $invsqrt = new Complex(1.0);
25
+ $invsqrt = subtract($invsqrt, $square);
26
+ $invsqrt = sqrt($invsqrt);
27
+ $adjust = new Complex(
28
+ $invsqrt->getReal() - $complex->getImaginary(),
29
+ $invsqrt->getImaginary() + $complex->getReal()
30
+ );
31
+ $log = ln($adjust);
32
+
33
+ return new Complex(
34
+ $log->getImaginary(),
35
+ -1 * $log->getReal()
36
+ );
37
+ }
lib/markbaker/complex/classes/src/functions/asinh.php ADDED
@@ -0,0 +1,33 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex asinh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic sine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic sine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function asinh($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal() && ($complex->getReal() > 1)) {
24
+ return new Complex(\asinh($complex->getReal()));
25
+ }
26
+
27
+ $asinh = clone $complex;
28
+ $asinh = $asinh->reverse()
29
+ ->invertReal();
30
+ $asinh = asin($asinh);
31
+ return $asinh->reverse()
32
+ ->invertImaginary();
33
+ }
lib/markbaker/complex/classes/src/functions/atan.php ADDED
@@ -0,0 +1,45 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex atan() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ //include_once 'Math/Complex.php';
13
+ //include_once 'Math/ComplexOp.php';
14
+
15
+ /**
16
+ * Returns the inverse tangent of a complex number.
17
+ *
18
+ * @param Complex|mixed $complex Complex number or a numeric value.
19
+ * @return Complex The inverse tangent of the complex argument.
20
+ * @throws Exception If argument isn't a valid real or complex number.
21
+ * @throws \InvalidArgumentException If function would result in a division by zero
22
+ */
23
+ function atan($complex)
24
+ {
25
+ $complex = Complex::validateComplexArgument($complex);
26
+
27
+ if ($complex->isReal()) {
28
+ return new Complex(\atan($complex->getReal()));
29
+ }
30
+
31
+ $t1Value = new Complex(-1 * $complex->getImaginary(), $complex->getReal());
32
+ $uValue = new Complex(1, 0);
33
+
34
+ $d1Value = clone $uValue;
35
+ $d1Value = subtract($d1Value, $t1Value);
36
+ $d2Value = add($t1Value, $uValue);
37
+ $uResult = $d1Value->divideBy($d2Value);
38
+ $uResult = ln($uResult);
39
+
40
+ return new Complex(
41
+ (($uResult->getImaginary() == M_PI) ? -M_PI : $uResult->getImaginary()) * -0.5,
42
+ $uResult->getReal() * 0.5,
43
+ $complex->getSuffix()
44
+ );
45
+ }
lib/markbaker/complex/classes/src/functions/atanh.php ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex atanh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse hyperbolic tangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse hyperbolic tangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function atanh($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal()) {
24
+ $real = $complex->getReal();
25
+ if ($real >= -1.0 && $real <= 1.0) {
26
+ return new Complex(\atanh($real));
27
+ } else {
28
+ return new Complex(\atanh(1 / $real), (($real < 0.0) ? M_PI_2 : -1 * M_PI_2));
29
+ }
30
+ }
31
+
32
+ $iComplex = clone $complex;
33
+ $iComplex = $iComplex->invertImaginary()
34
+ ->reverse();
35
+ return atan($iComplex)
36
+ ->invertReal()
37
+ ->reverse();
38
+ }
lib/markbaker/complex/classes/src/functions/conjugate.php ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex conjugate() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the complex conjugate of a complex number
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The conjugate of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function conjugate($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ return new Complex(
24
+ $complex->getReal(),
25
+ -1 * $complex->getImaginary(),
26
+ $complex->getSuffix()
27
+ );
28
+ }
lib/markbaker/complex/classes/src/functions/cos.php ADDED
@@ -0,0 +1,34 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex cos() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the cosine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The cosine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function cos($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal()) {
24
+ return new Complex(\cos($complex->getReal()));
25
+ }
26
+
27
+ return conjugate(
28
+ new Complex(
29
+ \cos($complex->getReal()) * \cosh($complex->getImaginary()),
30
+ \sin($complex->getReal()) * \sinh($complex->getImaginary()),
31
+ $complex->getSuffix()
32
+ )
33
+ );
34
+ }
lib/markbaker/complex/classes/src/functions/cosh.php ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex cosh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic cosine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic cosine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function cosh($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal()) {
24
+ return new Complex(\cosh($complex->getReal()));
25
+ }
26
+
27
+ return new Complex(
28
+ \cosh($complex->getReal()) * \cos($complex->getImaginary()),
29
+ \sinh($complex->getReal()) * \sin($complex->getImaginary()),
30
+ $complex->getSuffix()
31
+ );
32
+ }
lib/markbaker/complex/classes/src/functions/cot.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex cot() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the cotangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The cotangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function cot($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return new Complex(INF);
26
+ }
27
+
28
+ return inverse(tan($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/coth.php ADDED
@@ -0,0 +1,24 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex coth() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic cotangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic cotangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function coth($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+ return inverse(tanh($complex));
24
+ }
lib/markbaker/complex/classes/src/functions/csc.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex csc() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the cosecant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The cosecant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function csc($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return inverse(sin($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/csch.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex csch() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic cosecant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic cosecant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function csch($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ return INF;
26
+ }
27
+
28
+ return inverse(sinh($complex));
29
+ }
lib/markbaker/complex/classes/src/functions/exp.php ADDED
@@ -0,0 +1,34 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex exp() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the exponential of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The exponential of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function exp($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if (($complex->getReal() == 0.0) && (\abs($complex->getImaginary()) == M_PI)) {
24
+ return new Complex(-1.0, 0.0);
25
+ }
26
+
27
+ $rho = \exp($complex->getReal());
28
+
29
+ return new Complex(
30
+ $rho * \cos($complex->getImaginary()),
31
+ $rho * \sin($complex->getImaginary()),
32
+ $complex->getSuffix()
33
+ );
34
+ }
lib/markbaker/complex/classes/src/functions/inverse.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex inverse() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the inverse of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The inverse of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function inverse($complex)
21
+ {
22
+ $complex = clone Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
25
+ throw new \InvalidArgumentException('Division by zero');
26
+ }
27
+
28
+ return $complex->divideInto(1.0);
29
+ }
lib/markbaker/complex/classes/src/functions/ln.php ADDED
@@ -0,0 +1,33 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex ln() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the natural logarithm of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The natural logarithm of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If the real and the imaginary parts are both zero
19
+ */
20
+ function ln($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
25
+ throw new \InvalidArgumentException();
26
+ }
27
+
28
+ return new Complex(
29
+ \log(rho($complex)),
30
+ theta($complex),
31
+ $complex->getSuffix()
32
+ );
33
+ }
lib/markbaker/complex/classes/src/functions/log10.php ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex log10() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the common logarithm (base 10) of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The common logarithm (base 10) of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If the real and the imaginary parts are both zero
19
+ */
20
+ function log10($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
25
+ throw new \InvalidArgumentException();
26
+ } elseif (($complex->getReal() > 0.0) && ($complex->getImaginary() == 0.0)) {
27
+ return new Complex(\log10($complex->getReal()), 0.0, $complex->getSuffix());
28
+ }
29
+
30
+ return ln($complex)
31
+ ->multiply(\log10(Complex::EULER));
32
+ }
lib/markbaker/complex/classes/src/functions/log2.php ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex log2() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the base-2 logarithm of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The base-2 logarithm of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If the real and the imaginary parts are both zero
19
+ */
20
+ function log2($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if (($complex->getReal() == 0.0) && ($complex->getImaginary() == 0.0)) {
25
+ throw new \InvalidArgumentException();
26
+ } elseif (($complex->getReal() > 0.0) && ($complex->getImaginary() == 0.0)) {
27
+ return new Complex(\log($complex->getReal(), 2), 0.0, $complex->getSuffix());
28
+ }
29
+
30
+ return ln($complex)
31
+ ->multiply(\log(Complex::EULER, 2));
32
+ }
lib/markbaker/complex/classes/src/functions/negative.php ADDED
@@ -0,0 +1,31 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex negative() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the negative of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return float The negative value of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ *
19
+ * @see rho
20
+ *
21
+ */
22
+ function negative($complex)
23
+ {
24
+ $complex = Complex::validateComplexArgument($complex);
25
+
26
+ return new Complex(
27
+ -1 * $complex->getReal(),
28
+ -1 * $complex->getImaginary(),
29
+ $complex->getSuffix()
30
+ );
31
+ }
lib/markbaker/complex/classes/src/functions/pow.php ADDED
@@ -0,0 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex pow() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns a complex number raised to a power.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @param float|integer $power The power to raise this value to
17
+ * @return Complex The complex argument raised to the real power.
18
+ * @throws Exception If the power argument isn't a valid real
19
+ */
20
+ function pow($complex, $power)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if (!is_numeric($power)) {
25
+ throw new Exception('Power argument must be a real number');
26
+ }
27
+
28
+ if ($complex->getImaginary() == 0.0 && $complex->getReal() >= 0.0) {
29
+ return new Complex(\pow($complex->getReal(), $power));
30
+ }
31
+
32
+ $rValue = \sqrt(($complex->getReal() * $complex->getReal()) + ($complex->getImaginary() * $complex->getImaginary()));
33
+ $rPower = \pow($rValue, $power);
34
+ $theta = $complex->argument() * $power;
35
+ if ($theta == 0) {
36
+ return new Complex(1);
37
+ }
38
+
39
+ return new Complex($rPower * \cos($theta), $rPower * \sin($theta), $complex->getSuffix());
40
+ }
lib/markbaker/complex/classes/src/functions/rho.php ADDED
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex rho() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the rho of a complex number.
14
+ * This is the distance/radius from the centrepoint to the representation of the number in polar coordinates.
15
+ *
16
+ * @param Complex|mixed $complex Complex number or a numeric value.
17
+ * @return float The rho value of the complex argument.
18
+ * @throws Exception If argument isn't a valid real or complex number.
19
+ */
20
+ function rho($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ return \sqrt(
25
+ ($complex->getReal() * $complex->getReal()) +
26
+ ($complex->getImaginary() * $complex->getImaginary())
27
+ );
28
+ }
lib/markbaker/complex/classes/src/functions/sec.php ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex sec() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the secant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The secant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function sec($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ return inverse(cos($complex));
25
+ }
lib/markbaker/complex/classes/src/functions/sech.php ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex sech() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic secant of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic secant of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function sech($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ return inverse(cosh($complex));
25
+ }
lib/markbaker/complex/classes/src/functions/sin.php ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex sin() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the sine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The sine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function sin($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal()) {
24
+ return new Complex(\sin($complex->getReal()));
25
+ }
26
+
27
+ return new Complex(
28
+ \sin($complex->getReal()) * \cosh($complex->getImaginary()),
29
+ \cos($complex->getReal()) * \sinh($complex->getImaginary()),
30
+ $complex->getSuffix()
31
+ );
32
+ }
lib/markbaker/complex/classes/src/functions/sinh.php ADDED
@@ -0,0 +1,32 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex sinh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic sine of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic sine of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function sinh($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ if ($complex->isReal()) {
24
+ return new Complex(\sinh($complex->getReal()));
25
+ }
26
+
27
+ return new Complex(
28
+ \sinh($complex->getReal()) * \cos($complex->getImaginary()),
29
+ \cosh($complex->getReal()) * \sin($complex->getImaginary()),
30
+ $complex->getSuffix()
31
+ );
32
+ }
lib/markbaker/complex/classes/src/functions/sqrt.php ADDED
@@ -0,0 +1,29 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex sqrt() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the square root of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The Square root of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ */
19
+ function sqrt($complex)
20
+ {
21
+ $complex = Complex::validateComplexArgument($complex);
22
+
23
+ $theta = theta($complex);
24
+ $delta1 = \cos($theta / 2);
25
+ $delta2 = \sin($theta / 2);
26
+ $rho = \sqrt(rho($complex));
27
+
28
+ return new Complex($delta1 * $rho, $delta2 * $rho, $complex->getSuffix());
29
+ }
lib/markbaker/complex/classes/src/functions/tan.php ADDED
@@ -0,0 +1,40 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex tan() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the tangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The tangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function tan($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->isReal()) {
25
+ return new Complex(\tan($complex->getReal()));
26
+ }
27
+
28
+ $real = $complex->getReal();
29
+ $imaginary = $complex->getImaginary();
30
+ $divisor = 1 + \pow(\tan($real), 2) * \pow(\tanh($imaginary), 2);
31
+ if ($divisor == 0.0) {
32
+ throw new \InvalidArgumentException('Division by zero');
33
+ }
34
+
35
+ return new Complex(
36
+ \pow(sech($imaginary)->getReal(), 2) * \tan($real) / $divisor,
37
+ \pow(sec($real)->getReal(), 2) * \tanh($imaginary) / $divisor,
38
+ $complex->getSuffix()
39
+ );
40
+ }
lib/markbaker/complex/classes/src/functions/tanh.php ADDED
@@ -0,0 +1,35 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex tanh() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the hyperbolic tangent of a complex number.
14
+ *
15
+ * @param Complex|mixed $complex Complex number or a numeric value.
16
+ * @return Complex The hyperbolic tangent of the complex argument.
17
+ * @throws Exception If argument isn't a valid real or complex number.
18
+ * @throws \InvalidArgumentException If function would result in a division by zero
19
+ */
20
+ function tanh($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+ $real = $complex->getReal();
24
+ $imaginary = $complex->getImaginary();
25
+ $divisor = \cos($imaginary) * \cos($imaginary) + \sinh($real) * \sinh($real);
26
+ if ($divisor == 0.0) {
27
+ throw new \InvalidArgumentException('Division by zero');
28
+ }
29
+
30
+ return new Complex(
31
+ \sinh($real) * \cosh($real) / $divisor,
32
+ 0.5 * \sin(2 * $imaginary) / $divisor,
33
+ $complex->getSuffix()
34
+ );
35
+ }
lib/markbaker/complex/classes/src/functions/theta.php ADDED
@@ -0,0 +1,38 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex theta() function
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Returns the theta of a complex number.
14
+ * This is the angle in radians from the real axis to the representation of the number in polar coordinates.
15
+ *
16
+ * @param Complex|mixed $complex Complex number or a numeric value.
17
+ * @return float The theta value of the complex argument.
18
+ * @throws Exception If argument isn't a valid real or complex number.
19
+ */
20
+ function theta($complex)
21
+ {
22
+ $complex = Complex::validateComplexArgument($complex);
23
+
24
+ if ($complex->getReal() == 0.0) {
25
+ if ($complex->isReal()) {
26
+ return 0.0;
27
+ } elseif ($complex->getImaginary() < 0.0) {
28
+ return M_PI / -2;
29
+ }
30
+ return M_PI / 2;
31
+ } elseif ($complex->getReal() > 0.0) {
32
+ return \atan($complex->getImaginary() / $complex->getReal());
33
+ } elseif ($complex->getImaginary() < 0.0) {
34
+ return -(M_PI - \atan(\abs($complex->getImaginary()) / \abs($complex->getReal())));
35
+ }
36
+
37
+ return M_PI - \atan($complex->getImaginary() / \abs($complex->getReal()));
38
+ }
lib/markbaker/complex/classes/src/operations/add.php ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex addition operation
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Adds two or more complex numbers
14
+ *
15
+ * @param array of string|integer|float|Complex $complexValues The numbers to add
16
+ * @return Complex
17
+ */
18
+ function add(...$complexValues)
19
+ {
20
+ if (count($complexValues) < 2) {
21
+ throw new \Exception('This function requires at least 2 arguments');
22
+ }
23
+
24
+ $base = array_shift($complexValues);
25
+ $result = clone Complex::validateComplexArgument($base);
26
+
27
+ foreach ($complexValues as $complex) {
28
+ $complex = Complex::validateComplexArgument($complex);
29
+
30
+ if ($result->isComplex() && $complex->isComplex() &&
31
+ $result->getSuffix() !== $complex->getSuffix()) {
32
+ throw new Exception('Suffix Mismatch');
33
+ }
34
+
35
+ $real = $result->getReal() + $complex->getReal();
36
+ $imaginary = $result->getImaginary() + $complex->getImaginary();
37
+
38
+ $result = new Complex(
39
+ $real,
40
+ $imaginary,
41
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
42
+ );
43
+ }
44
+
45
+ return $result;
46
+ }
lib/markbaker/complex/classes/src/operations/divideby.php ADDED
@@ -0,0 +1,56 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex division operation
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Divides two or more complex numbers
14
+ *
15
+ * @param array of string|integer|float|Complex $complexValues The numbers to divide
16
+ * @return Complex
17
+ */
18
+ function divideby(...$complexValues)
19
+ {
20
+ if (count($complexValues) < 2) {
21
+ throw new \Exception('This function requires at least 2 arguments');
22
+ }
23
+
24
+ $base = array_shift($complexValues);
25
+ $result = clone Complex::validateComplexArgument($base);
26
+
27
+ foreach ($complexValues as $complex) {
28
+ $complex = Complex::validateComplexArgument($complex);
29
+
30
+ if ($result->isComplex() && $complex->isComplex() &&
31
+ $result->getSuffix() !== $complex->getSuffix()) {
32
+ throw new Exception('Suffix Mismatch');
33
+ }
34
+ if ($complex->getReal() == 0.0 && $complex->getImaginary() == 0.0) {
35
+ throw new \InvalidArgumentException('Division by zero');
36
+ }
37
+
38
+ $delta1 = ($result->getReal() * $complex->getReal()) +
39
+ ($result->getImaginary() * $complex->getImaginary());
40
+ $delta2 = ($result->getImaginary() * $complex->getReal()) -
41
+ ($result->getReal() * $complex->getImaginary());
42
+ $delta3 = ($complex->getReal() * $complex->getReal()) +
43
+ ($complex->getImaginary() * $complex->getImaginary());
44
+
45
+ $real = $delta1 / $delta3;
46
+ $imaginary = $delta2 / $delta3;
47
+
48
+ $result = new Complex(
49
+ $real,
50
+ $imaginary,
51
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
52
+ );
53
+ }
54
+
55
+ return $result;
56
+ }
lib/markbaker/complex/classes/src/operations/divideinto.php ADDED
@@ -0,0 +1,56 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex division operation
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Divides two or more complex numbers
14
+ *
15
+ * @param array of string|integer|float|Complex $complexValues The numbers to divide
16
+ * @return Complex
17
+ */
18
+ function divideinto(...$complexValues)
19
+ {
20
+ if (count($complexValues) < 2) {
21
+ throw new \Exception('This function requires at least 2 arguments');
22
+ }
23
+
24
+ $base = array_shift($complexValues);
25
+ $result = clone Complex::validateComplexArgument($base);
26
+
27
+ foreach ($complexValues as $complex) {
28
+ $complex = Complex::validateComplexArgument($complex);
29
+
30
+ if ($result->isComplex() && $complex->isComplex() &&
31
+ $result->getSuffix() !== $complex->getSuffix()) {
32
+ throw new Exception('Suffix Mismatch');
33
+ }
34
+ if ($result->getReal() == 0.0 && $result->getImaginary() == 0.0) {
35
+ throw new \InvalidArgumentException('Division by zero');
36
+ }
37
+
38
+ $delta1 = ($complex->getReal() * $result->getReal()) +
39
+ ($complex->getImaginary() * $result->getImaginary());
40
+ $delta2 = ($complex->getImaginary() * $result->getReal()) -
41
+ ($complex->getReal() * $result->getImaginary());
42
+ $delta3 = ($result->getReal() * $result->getReal()) +
43
+ ($result->getImaginary() * $result->getImaginary());
44
+
45
+ $real = $delta1 / $delta3;
46
+ $imaginary = $delta2 / $delta3;
47
+
48
+ $result = new Complex(
49
+ $real,
50
+ $imaginary,
51
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
52
+ );
53
+ }
54
+
55
+ return $result;
56
+ }
lib/markbaker/complex/classes/src/operations/multiply.php ADDED
@@ -0,0 +1,48 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex multiplication operation
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Multiplies two or more complex numbers
14
+ *
15
+ * @param array of string|integer|float|Complex $complexValues The numbers to multiply
16
+ * @return Complex
17
+ */
18
+ function multiply(...$complexValues)
19
+ {
20
+ if (count($complexValues) < 2) {
21
+ throw new \Exception('This function requires at least 2 arguments');
22
+ }
23
+
24
+ $base = array_shift($complexValues);
25
+ $result = clone Complex::validateComplexArgument($base);
26
+
27
+ foreach ($complexValues as $complex) {
28
+ $complex = Complex::validateComplexArgument($complex);
29
+
30
+ if ($result->isComplex() && $complex->isComplex() &&
31
+ $result->getSuffix() !== $complex->getSuffix()) {
32
+ throw new Exception('Suffix Mismatch');
33
+ }
34
+
35
+ $real = ($result->getReal() * $complex->getReal()) -
36
+ ($result->getImaginary() * $complex->getImaginary());
37
+ $imaginary = ($result->getReal() * $complex->getImaginary()) +
38
+ ($result->getImaginary() * $complex->getReal());
39
+
40
+ $result = new Complex(
41
+ $real,
42
+ $imaginary,
43
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
44
+ );
45
+ }
46
+
47
+ return $result;
48
+ }
lib/markbaker/complex/classes/src/operations/subtract.php ADDED
@@ -0,0 +1,46 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ /**
4
+ *
5
+ * Function code for the complex subtraction operation
6
+ *
7
+ * @copyright Copyright (c) 2013-2018 Mark Baker (https://github.com/MarkBaker/PHPComplex)
8
+ * @license https://opensource.org/licenses/MIT MIT
9
+ */
10
+ namespace Complex;
11
+
12
+ /**
13
+ * Subtracts two or more complex numbers
14
+ *
15
+ * @param array of string|integer|float|Complex $complexValues The numbers to subtract
16
+ * @return Complex
17
+ */
18
+ function subtract(...$complexValues)
19
+ {
20
+ if (count($complexValues) < 2) {
21
+ throw new \Exception('This function requires at least 2 arguments');
22
+ }
23
+
24
+ $base = array_shift($complexValues);
25
+ $result = clone Complex::validateComplexArgument($base);
26
+
27
+ foreach ($complexValues as $complex) {
28
+ $complex = Complex::validateComplexArgument($complex);
29
+
30
+ if ($result->isComplex() && $complex->isComplex() &&
31
+ $result->getSuffix() !== $complex->getSuffix()) {
32
+ throw new Exception('Suffix Mismatch');
33
+ }
34
+
35
+ $real = $result->getReal() - $complex->getReal();
36
+ $imaginary = $result->getImaginary() - $complex->getImaginary();
37
+
38
+ $result = new Complex(
39
+ $real,
40
+ $imaginary,
41
+ ($imaginary == 0.0) ? null : max($result->getSuffix(), $complex->getSuffix())
42
+ );
43
+ }
44
+
45
+ return $result;
46
+ }
lib/markbaker/complex/composer.json ADDED
@@ -0,0 +1,91 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ {
2
+ "name": "markbaker/complex",
3
+ "type": "library",
4
+ "description": "PHP Class for working with complex numbers",
5
+ "keywords": ["complex", "mathematics"],
6
+ "homepage": "https://github.com/MarkBaker/PHPComplex",
7
+ "license": "MIT",
8
+ "authors": [
9
+ {
10
+ "name": "Mark Baker",
11
+ "email": "mark@lange.demon.co.uk"
12
+ }
13
+ ],
14
+ "require": {
15
+ "php": "^5.6.0|^7.0.0"
16
+ },
17
+ "require-dev": {
18
+ "phpunit/phpunit": "^4.8.35|^5.4.0",
19
+ "phpdocumentor/phpdocumentor":"2.*",
20
+ "phpmd/phpmd": "2.*",
21
+ "sebastian/phpcpd": "2.*",
22
+ "phploc/phploc": "2.*",
23
+ "squizlabs/php_codesniffer": "^3.3.0",
24
+ "phpcompatibility/php-compatibility": "^8.0",
25
+ "dealerdirect/phpcodesniffer-composer-installer": "^0.4.3"
26
+ },
27
+ "autoload": {
28
+ "psr-4": {
29
+ "Complex\\": "classes/src/"
30
+ },
31
+ "files": [
32
+ "classes/src/functions/abs.php",
33
+ "classes/src/functions/acos.php",
34
+ "classes/src/functions/acosh.php",
35
+ "classes/src/functions/acot.php",
36
+ "classes/src/functions/acoth.php",
37
+ "classes/src/functions/acsc.php",
38
+ "classes/src/functions/acsch.php",
39
+ "classes/src/functions/argument.php",
40
+ "classes/src/functions/asec.php",
41
+ "classes/src/functions/asech.php",
42
+ "classes/src/functions/asin.php",
43
+ "classes/src/functions/asinh.php",
44
+ "classes/src/functions/atan.php",
45
+ "classes/src/functions/atanh.php",
46
+ "classes/src/functions/conjugate.php",
47
+ "classes/src/functions/cos.php",
48
+ "classes/src/functions/cosh.php",
49
+ "classes/src/functions/cot.php",
50
+ "classes/src/functions/coth.php",
51
+ "classes/src/functions/csc.php",
52
+ "classes/src/functions/csch.php",
53
+ "classes/src/functions/exp.php",
54
+ "classes/src/functions/inverse.php",
55
+ "classes/src/functions/ln.php",
56
+ "classes/src/functions/log2.php",
57
+ "classes/src/functions/log10.php",
58
+ "classes/src/functions/negative.php",
59
+ "classes/src/functions/pow.php",
60
+ "classes/src/functions/rho.php",
61
+ "classes/src/functions/sec.php",
62
+ "classes/src/functions/sech.php",
63
+ "classes/src/functions/sin.php",
64
+ "classes/src/functions/sinh.php",
65
+ "classes/src/functions/sqrt.php",
66
+ "classes/src/functions/tan.php",
67
+ "classes/src/functions/tanh.php",
68
+ "classes/src/functions/theta.php",
69
+ "classes/src/operations/add.php",
70
+ "classes/src/operations/subtract.php",
71
+ "classes/src/operations/multiply.php",
72
+ "classes/src/operations/divideby.php",
73
+ "classes/src/operations/divideinto.php"
74
+ ]
75
+ },
76
+ "scripts": {
77
+ "style": [
78
+ "phpcs --report-width=200 --report-summary --report-full classes/src/ --standard=PSR2 -n"
79
+ ],
80
+ "mess": [
81
+ "phpmd classes/src/ xml codesize,unusedcode,design,naming -n"
82
+ ],
83
+ "lines": [
84
+ "phploc classes/src/ -n"
85
+ ],
86
+ "cpd": [
87
+ "phpcpd classes/src/ -n"
88
+ ]
89
+ },
90
+ "minimum-stability": "dev"
91
+ }
lib/markbaker/complex/examples/complexTest.php ADDED
@@ -0,0 +1,154 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ use Complex\Complex as Complex;
4
+
5
+ include('../classes/Bootstrap.php');
6
+
7
+ echo 'Create', PHP_EOL;
8
+
9
+ $x = new Complex(123);
10
+ echo $x, PHP_EOL;
11
+
12
+ $x = new Complex(123, 456);
13
+ echo $x, PHP_EOL;
14
+
15
+ $x = new Complex(array(123,456,'j'));
16
+ echo $x, PHP_EOL;
17
+
18
+ $x = new Complex('1.23e-4--2.34e-5i');
19
+ echo $x, PHP_EOL;
20
+
21
+
22
+ echo PHP_EOL, 'Add', PHP_EOL;
23
+
24
+ $x = new Complex(123);
25
+ $x->add(456);
26
+ echo $x, PHP_EOL;
27
+
28
+ $x = new Complex(123.456);
29
+ $x->add(789.012);
30
+ echo $x, PHP_EOL;
31
+
32
+ $x = new Complex(123.456, 78.90);
33
+ $x->add(new Complex(-987.654, -32.1));
34
+ echo $x, PHP_EOL;
35
+
36
+ $x = new Complex(123.456, 78.90);
37
+ $x->add(-987.654);
38
+ echo $x, PHP_EOL;
39
+
40
+ $x = new Complex(-987.654, -32.1);
41
+ $x->add(new Complex(0, 1));
42
+ echo $x, PHP_EOL;
43
+
44
+ $x = new Complex(-987.654, -32.1);
45
+ $x->add(new Complex(0, -1));
46
+ echo $x, PHP_EOL;
47
+
48
+
49
+ echo PHP_EOL, 'Subtract', PHP_EOL;
50
+
51
+ $x = new Complex(123);
52
+ $x->subtract(456);
53
+ echo $x, PHP_EOL;
54
+
55
+ $x = new Complex(123.456);
56
+ $x->subtract(789.012);
57
+ echo $x, PHP_EOL;
58
+
59
+ $x = new Complex(123.456, 78.90);
60
+ $x->subtract(new Complex(-987.654, -32.1));
61
+ echo $x, PHP_EOL;
62
+
63
+ $x = new Complex(123.456, 78.90);
64
+ $x->subtract(-987.654);
65
+ echo $x, PHP_EOL;
66
+
67
+ $x = new Complex(-987.654, -32.1);
68
+ $x->subtract(new Complex(0, 1));
69
+ echo $x, PHP_EOL;
70
+
71
+ $x = new Complex(-987.654, -32.1);
72
+ $x->subtract(new Complex(0, -1));
73
+ echo $x, PHP_EOL;
74
+
75
+
76
+ echo PHP_EOL, 'Multiply', PHP_EOL;
77
+
78
+ $x = new Complex(123);
79
+ $x->multiply(456);
80
+ echo $x, PHP_EOL;
81
+
82
+ $x = new Complex(123.456);
83
+ $x->multiply(789.012);
84
+ echo $x, PHP_EOL;
85
+
86
+ $x = new Complex(123.456, 78.90);
87
+ $x->multiply(new Complex(-987.654, -32.1));
88
+ echo $x, PHP_EOL;
89
+
90
+ $x = new Complex(123.456, 78.90);
91
+ $x->multiply(-987.654);
92
+ echo $x, PHP_EOL;
93
+
94
+ $x = new Complex(-987.654, -32.1);
95
+ $x->multiply(new Complex(0, 1));
96
+ echo $x, PHP_EOL;
97
+
98
+ $x = new Complex(-987.654, -32.1);
99
+ $x->multiply(new Complex(0, -1));
100
+ echo $x, PHP_EOL;
101
+
102
+
103
+ echo PHP_EOL, 'Divide By', PHP_EOL;
104
+
105
+ $x = new Complex(123);
106
+ $x->divideBy(456);
107
+ echo $x, PHP_EOL;
108
+
109
+ $x = new Complex(123.456);
110
+ $x->divideBy(789.012);
111
+ echo $x, PHP_EOL;
112
+
113
+ $x = new Complex(123.456, 78.90);
114
+ $x->divideBy(new Complex(-987.654, -32.1));
115
+ echo $x, PHP_EOL;
116
+
117
+ $x = new Complex(123.456, 78.90);
118
+ $x->divideBy(-987.654);
119
+ echo $x, PHP_EOL;
120
+
121
+ $x = new Complex(-987.654, -32.1);
122
+ $x->divideBy(new Complex(0, 1));
123
+ echo $x, PHP_EOL;
124
+
125
+ $x = new Complex(-987.654, -32.1);
126
+ $x->divideBy(new Complex(0, -1));
127
+ echo $x, PHP_EOL;
128
+
129
+
130
+ echo PHP_EOL, 'Divide Into', PHP_EOL;
131
+
132
+ $x = new Complex(123);
133
+ $x->divideInto(456);
134
+ echo $x, PHP_EOL;
135
+
136
+ $x = new Complex(123.456);
137
+ $x->divideInto(789.012);
138
+ echo $x, PHP_EOL;
139
+
140
+ $x = new Complex(123.456, 78.90);
141
+ $x->divideInto(new Complex(-987.654, -32.1));
142
+ echo $x, PHP_EOL;
143
+
144
+ $x = new Complex(123.456, 78.90);
145
+ $x->divideInto(-987.654);
146
+ echo $x, PHP_EOL;
147
+
148
+ $x = new Complex(-987.654, -32.1);
149
+ $x->divideInto(new Complex(0, 1));
150
+ echo $x, PHP_EOL;
151
+
152
+ $x = new Complex(-987.654, -32.1);
153
+ $x->divideInto(new Complex(0, -1));
154
+ echo $x, PHP_EOL;
lib/markbaker/complex/examples/testFunctions.php ADDED
@@ -0,0 +1,52 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ namespace Complex;
4
+
5
+ include('../classes/Bootstrap.php');
6
+
7
+ echo 'Function Examples', PHP_EOL;
8
+
9
+ $functions = array(
10
+ 'abs',
11
+ 'acos',
12
+ 'acosh',
13
+ 'acsc',
14
+ 'acsch',
15
+ 'argument',
16
+ 'asec',
17
+ 'asech',
18
+ 'asin',
19
+ 'asinh',
20
+ 'conjugate',
21
+ 'cos',
22
+ 'cosh',
23
+ 'csc',
24
+ 'csch',
25
+ 'exp',
26
+ 'inverse',
27
+ 'ln',
28
+ 'log2',
29
+ 'log10',
30
+ 'rho',
31
+ 'sec',
32
+ 'sech',
33
+ 'sin',
34
+ 'sinh',
35
+ 'sqrt',
36
+ 'theta'
37
+ );
38
+
39
+ for ($real = -3.5; $real <= 3.5; $real += 0.5) {
40
+ for ($imaginary = -3.5; $imaginary <= 3.5; $imaginary += 0.5) {
41
+ foreach ($functions as $function) {
42
+ $complexFunction = __NAMESPACE__ . '\\' . $function;
43
+ $complex = new Complex($real, $imaginary);
44
+ try {
45
+ echo $function, '(', $complex, ') = ', $complexFunction($complex), PHP_EOL;
46
+ } catch (\Exception $e) {
47
+ echo $function, '(', $complex, ') ERROR: ', $e->getMessage(), PHP_EOL;
48
+ }
49
+ }
50
+ echo PHP_EOL;
51
+ }
52
+ }
lib/markbaker/complex/examples/testOperations.php ADDED
@@ -0,0 +1,34 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <?php
2
+
3
+ use Complex\Complex as Complex;
4
+
5
+ include('../classes/Bootstrap.php');
6
+
7
+ $values = [
8
+ new Complex(123),
9
+ new Complex(456, 123),
10
+ new Complex(0.0, 456),
11
+ ];
12
+
13
+ foreach ($values as $value) {
14
+ echo $value, PHP_EOL;
15
+ }
16
+
17
+ echo 'Addition', PHP_EOL;
18
+
19
+ $result = \Complex\add(...$values);
20
+ echo '=> ', $result, PHP_EOL;
21
+
22
+ echo PHP_EOL;
23
+
24
+ echo 'Subtraction', PHP_EOL;
25
+
26
+ $result = \Complex\subtract(...$values);
27
+ echo '=> ', $result, PHP_EOL;
28
+
29
+ echo PHP_EOL;
30
+
31
+ echo 'Multiplication', PHP_EOL;
32
+
33
+ $result = \Complex\multiply(...$values);
34
+ echo '=> ', $result, PHP_EOL;
lib/markbaker/complex/license.md ADDED
@@ -0,0 +1,25 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ The MIT License (MIT)
2
+ =====================
3
+
4
+ Copyright © `2017` `Mark Baker`
5
+
6
+ Permission is hereby granted, free of charge, to any person
7
+ obtaining a copy of this software and associated documentation
8
+ files (the “Software”), to deal in the Software without
9
+ restriction, including without limitation the rights to use,
10
+ copy, modify, merge, publish, distribute, sublicense, and/or sell
11
+ copies of the Software, and to permit persons to whom the
12
+ Software is furnished to do so, subject to the following
13
+ conditions:
14
+
15
+ The above copyright notice and this permission notice shall be
16
+ included in all copies or substantial portions of the Software.
17
+
18
+ THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
19
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
20
+ OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
22
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
23
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
24
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
25
+ OTHER DEALINGS IN THE SOFTWARE.
lib/phpExcel/PHPExcel.php DELETED
@@ -1,1153 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/');
6
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
7
- }
8
-
9
- /**
10
- * PHPExcel
11
- *
12
- * Copyright (c) 2006 - 2015 PHPExcel
13
- *
14
- * This library is free software; you can redistribute it and/or
15
- * modify it under the terms of the GNU Lesser General Public
16
- * License as published by the Free Software Foundation; either
17
- * version 2.1 of the License, or (at your option) any later version.
18
- *
19
- * This library is distributed in the hope that it will be useful,
20
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
21
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22
- * Lesser General Public License for more details.
23
- *
24
- * You should have received a copy of the GNU Lesser General Public
25
- * License along with this library; if not, write to the Free Software
26
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27
- *
28
- * @category PHPExcel
29
- * @package PHPExcel
30
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
31
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
32
- * @version ##VERSION##, ##DATE##
33
- */
34
- class PHPExcel
35
- {
36
- /**
37
- * Unique ID
38
- *
39
- * @var string
40
- */
41
- private $uniqueID;
42
-
43
- /**
44
- * Document properties
45
- *
46
- * @var PHPExcel_DocumentProperties
47
- */
48
- private $properties;
49
-
50
- /**
51
- * Document security
52
- *
53
- * @var PHPExcel_DocumentSecurity
54
- */
55
- private $security;
56
-
57
- /**
58
- * Collection of Worksheet objects
59
- *
60
- * @var PHPExcel_Worksheet[]
61
- */
62
- private $workSheetCollection = array();
63
-
64
- /**
65
- * Calculation Engine
66
- *
67
- * @var PHPExcel_Calculation
68
- */
69
- private $calculationEngine;
70
-
71
- /**
72
- * Active sheet index
73
- *
74
- * @var integer
75
- */
76
- private $activeSheetIndex = 0;
77
-
78
- /**
79
- * Named ranges
80
- *
81
- * @var PHPExcel_NamedRange[]
82
- */
83
- private $namedRanges = array();
84
-
85
- /**
86
- * CellXf supervisor
87
- *
88
- * @var PHPExcel_Style
89
- */
90
- private $cellXfSupervisor;
91
-
92
- /**
93
- * CellXf collection
94
- *
95
- * @var PHPExcel_Style[]
96
- */
97
- private $cellXfCollection = array();
98
-
99
- /**
100
- * CellStyleXf collection
101
- *
102
- * @var PHPExcel_Style[]
103
- */
104
- private $cellStyleXfCollection = array();
105
-
106
- /**
107
- * hasMacros : this workbook have macros ?
108
- *
109
- * @var bool
110
- */
111
- private $hasMacros = false;
112
-
113
- /**
114
- * macrosCode : all macros code (the vbaProject.bin file, this include form, code, etc.), null if no macro
115
- *
116
- * @var binary
117
- */
118
- private $macrosCode;
119
- /**
120
- * macrosCertificate : if macros are signed, contains vbaProjectSignature.bin file, null if not signed
121
- *
122
- * @var binary
123
- */
124
- private $macrosCertificate;
125
-
126
- /**
127
- * ribbonXMLData : null if workbook is'nt Excel 2007 or not contain a customized UI
128
- *
129
- * @var null|string
130
- */
131
- private $ribbonXMLData;
132
-
133
- /**
134
- * ribbonBinObjects : null if workbook is'nt Excel 2007 or not contain embedded objects (picture(s)) for Ribbon Elements
135
- * ignored if $ribbonXMLData is null
136
- *
137
- * @var null|array
138
- */
139
- private $ribbonBinObjects;
140
-
141
- /**
142
- * The workbook has macros ?
143
- *
144
- * @return boolean true if workbook has macros, false if not
145
- */
146
- public function hasMacros()
147
- {
148
- return $this->hasMacros;
149
- }
150
-
151
- /**
152
- * Define if a workbook has macros
153
- *
154
- * @param boolean $hasMacros true|false
155
- */
156
- public function setHasMacros($hasMacros = false)
157
- {
158
- $this->hasMacros = (bool) $hasMacros;
159
- }
160
-
161
- /**
162
- * Set the macros code
163
- *
164
- * @param string $MacrosCode string|null
165
- */
166
- public function setMacrosCode($MacrosCode = null)
167
- {
168
- $this->macrosCode=$MacrosCode;
169
- $this->setHasMacros(!is_null($MacrosCode));
170
- }
171
-
172
- /**
173
- * Return the macros code
174
- *
175
- * @return string|null
176
- */
177
- public function getMacrosCode()
178
- {
179
- return $this->macrosCode;
180
- }
181
-
182
- /**
183
- * Set the macros certificate
184
- *
185
- * @param string|null $Certificate
186
- */
187
- public function setMacrosCertificate($Certificate = null)
188
- {
189
- $this->macrosCertificate=$Certificate;
190
- }
191
-
192
- /**
193
- * Is the project signed ?
194
- *
195
- * @return boolean true|false
196
- */
197
- public function hasMacrosCertificate()
198
- {
199
- return !is_null($this->macrosCertificate);
200
- }
201
-
202
- /**
203
- * Return the macros certificate
204
- *
205
- * @return string|null
206
- */
207
- public function getMacrosCertificate()
208
- {
209
- return $this->macrosCertificate;
210
- }
211
-
212
- /**
213
- * Remove all macros, certificate from spreadsheet
214
- *
215
- */
216
- public function discardMacros()
217
- {
218
- $this->hasMacros=false;
219
- $this->macrosCode=null;
220
- $this->macrosCertificate=null;
221
- }
222
-
223
- /**
224
- * set ribbon XML data
225
- *
226
- */
227
- public function setRibbonXMLData($Target = null, $XMLData = null)
228
- {
229
- if (!is_null($Target) && !is_null($XMLData)) {
230
- $this->ribbonXMLData = array('target' => $Target, 'data' => $XMLData);
231
- } else {
232
- $this->ribbonXMLData = null;
233
- }
234
- }
235
-
236
- /**
237
- * retrieve ribbon XML Data
238
- *
239
- * return string|null|array
240
- */
241
- public function getRibbonXMLData($What = 'all') //we need some constants here...
242
- {
243
- $ReturnData = null;
244
- $What = strtolower($What);
245
- switch ($What){
246
- case 'all':
247
- $ReturnData = $this->ribbonXMLData;
248
- break;
249
- case 'target':
250
- case 'data':
251
- if (is_array($this->ribbonXMLData) && array_key_exists($What, $this->ribbonXMLData)) {
252
- $ReturnData = $this->ribbonXMLData[$What];
253
- }
254
- break;
255
- }
256
-
257
- return $ReturnData;
258
- }
259
-
260
- /**
261
- * store binaries ribbon objects (pictures)
262
- *
263
- */
264
- public function setRibbonBinObjects($BinObjectsNames = null, $BinObjectsData = null)
265
- {
266
- if (!is_null($BinObjectsNames) && !is_null($BinObjectsData)) {
267
- $this->ribbonBinObjects = array('names' => $BinObjectsNames, 'data' => $BinObjectsData);
268
- } else {
269
- $this->ribbonBinObjects = null;
270
- }
271
- }
272
- /**
273
- * return the extension of a filename. Internal use for a array_map callback (php<5.3 don't like lambda function)
274
- *
275
- */
276
- private function getExtensionOnly($ThePath)
277
- {
278
- return pathinfo($ThePath, PATHINFO_EXTENSION);
279
- }
280
-
281
- /**
282
- * retrieve Binaries Ribbon Objects
283
- *
284
- */
285
- public function getRibbonBinObjects($What = 'all')
286
- {
287
- $ReturnData = null;
288
- $What = strtolower($What);
289
- switch($What) {
290
- case 'all':
291
- return $this->ribbonBinObjects;
292
- break;
293
- case 'names':
294
- case 'data':
295
- if (is_array($this->ribbonBinObjects) && array_key_exists($What, $this->ribbonBinObjects)) {
296
- $ReturnData=$this->ribbonBinObjects[$What];
297
- }
298
- break;
299
- case 'types':
300
- if (is_array($this->ribbonBinObjects) &&
301
- array_key_exists('data', $this->ribbonBinObjects) && is_array($this->ribbonBinObjects['data'])) {
302
- $tmpTypes=array_keys($this->ribbonBinObjects['data']);
303
- $ReturnData = array_unique(array_map(array($this, 'getExtensionOnly'), $tmpTypes));
304
- } else {
305
- $ReturnData=array(); // the caller want an array... not null if empty
306
- }
307
- break;
308
- }
309
- return $ReturnData;
310
- }
311
-
312
- /**
313
- * This workbook have a custom UI ?
314
- *
315
- * @return boolean true|false
316
- */
317
- public function hasRibbon()
318
- {
319
- return !is_null($this->ribbonXMLData);
320
- }
321
-
322
- /**
323
- * This workbook have additionnal object for the ribbon ?
324
- *
325
- * @return boolean true|false
326
- */
327
- public function hasRibbonBinObjects()
328
- {
329
- return !is_null($this->ribbonBinObjects);
330
- }
331
-
332
- /**
333
- * Check if a sheet with a specified code name already exists
334
- *
335
- * @param string $pSheetCodeName Name of the worksheet to check
336
- * @return boolean
337
- */
338
- public function sheetCodeNameExists($pSheetCodeName)
339
- {
340
- return ($this->getSheetByCodeName($pSheetCodeName) !== null);
341
- }
342
-
343
- /**
344
- * Get sheet by code name. Warning : sheet don't have always a code name !
345
- *
346
- * @param string $pName Sheet name
347
- * @return PHPExcel_Worksheet
348
- */
349
- public function getSheetByCodeName($pName = '')
350
- {
351
- $worksheetCount = count($this->workSheetCollection);
352
- for ($i = 0; $i < $worksheetCount; ++$i) {
353
- if ($this->workSheetCollection[$i]->getCodeName() == $pName) {
354
- return $this->workSheetCollection[$i];
355
- }
356
- }
357
-
358
- return null;
359
- }
360
-
361
- /**
362
- * Create a new PHPExcel with one Worksheet
363
- */
364
- public function __construct()
365
- {
366
- $this->uniqueID = uniqid();
367
- $this->calculationEngine = new PHPExcel_Calculation($this);
368
-
369
- // Initialise worksheet collection and add one worksheet
370
- $this->workSheetCollection = array();
371
- $this->workSheetCollection[] = new PHPExcel_Worksheet($this);
372
- $this->activeSheetIndex = 0;
373
-
374
- // Create document properties
375
- $this->properties = new PHPExcel_DocumentProperties();
376
-
377
- // Create document security
378
- $this->security = new PHPExcel_DocumentSecurity();
379
-
380
- // Set named ranges
381
- $this->namedRanges = array();
382
-
383
- // Create the cellXf supervisor
384
- $this->cellXfSupervisor = new PHPExcel_Style(true);
385
- $this->cellXfSupervisor->bindParent($this);
386
-
387
- // Create the default style
388
- $this->addCellXf(new PHPExcel_Style);
389
- $this->addCellStyleXf(new PHPExcel_Style);
390
- }
391
-
392
- /**
393
- * Code to execute when this worksheet is unset()
394
- *
395
- */
396
- public function __destruct()
397
- {
398
- $this->calculationEngine = null;
399
- $this->disconnectWorksheets();
400
- }
401
-
402
- /**
403
- * Disconnect all worksheets from this PHPExcel workbook object,
404
- * typically so that the PHPExcel object can be unset
405
- *
406
- */
407
- public function disconnectWorksheets()
408
- {
409
- $worksheet = null;
410
- foreach ($this->workSheetCollection as $k => &$worksheet) {
411
- $worksheet->disconnectCells();
412
- $this->workSheetCollection[$k] = null;
413
- }
414
- unset($worksheet);
415
- $this->workSheetCollection = array();
416
- }
417
-
418
- /**
419
- * Return the calculation engine for this worksheet
420
- *
421
- * @return PHPExcel_Calculation
422
- */
423
- public function getCalculationEngine()
424
- {
425
- return $this->calculationEngine;
426
- } // function getCellCacheController()
427
-
428
- /**
429
- * Get properties
430
- *
431
- * @return PHPExcel_DocumentProperties
432
- */
433
- public function getProperties()
434
- {
435
- return $this->properties;
436
- }
437
-
438
- /**
439
- * Set properties
440
- *
441
- * @param PHPExcel_DocumentProperties $pValue
442
- */
443
- public function setProperties(PHPExcel_DocumentProperties $pValue)
444
- {
445
- $this->properties = $pValue;
446
- }
447
-
448
- /**
449
- * Get security
450
- *
451
- * @return PHPExcel_DocumentSecurity
452
- */
453
- public function getSecurity()
454
- {
455
- return $this->security;
456
- }
457
-
458
- /**
459
- * Set security
460
- *
461
- * @param PHPExcel_DocumentSecurity $pValue
462
- */
463
- public function setSecurity(PHPExcel_DocumentSecurity $pValue)
464
- {
465
- $this->security = $pValue;
466
- }
467
-
468
- /**
469
- * Get active sheet
470
- *
471
- * @return PHPExcel_Worksheet
472
- *
473
- * @throws PHPExcel_Exception
474
- */
475
- public function getActiveSheet()
476
- {
477
- return $this->getSheet($this->activeSheetIndex);
478
- }
479
-
480
- /**
481
- * Create sheet and add it to this workbook
482
- *
483
- * @param int|null $iSheetIndex Index where sheet should go (0,1,..., or null for last)
484
- * @return PHPExcel_Worksheet
485
- * @throws PHPExcel_Exception
486
- */
487
- public function createSheet($iSheetIndex = null)
488
- {
489
- $newSheet = new PHPExcel_Worksheet($this);
490
- $this->addSheet($newSheet, $iSheetIndex);
491
- return $newSheet;
492
- }
493
-
494
- /**
495
- * Check if a sheet with a specified name already exists
496
- *
497
- * @param string $pSheetName Name of the worksheet to check
498
- * @return boolean
499
- */
500
- public function sheetNameExists($pSheetName)
501
- {
502
- return ($this->getSheetByName($pSheetName) !== null);
503
- }
504
-
505
- /**
506
- * Add sheet
507
- *
508
- * @param PHPExcel_Worksheet $pSheet
509
- * @param int|null $iSheetIndex Index where sheet should go (0,1,..., or null for last)
510
- * @return PHPExcel_Worksheet
511
- * @throws PHPExcel_Exception
512
- */
513
- public function addSheet(PHPExcel_Worksheet $pSheet, $iSheetIndex = null)
514
- {
515
- if ($this->sheetNameExists($pSheet->getTitle())) {
516
- throw new PHPExcel_Exception(
517
- "Workbook already contains a worksheet named '{$pSheet->getTitle()}'. Rename this worksheet first."
518
- );
519
- }
520
-
521
- if ($iSheetIndex === null) {
522
- if ($this->activeSheetIndex < 0) {
523
- $this->activeSheetIndex = 0;
524
- }
525
- $this->workSheetCollection[] = $pSheet;
526
- } else {
527
- // Insert the sheet at the requested index
528
- array_splice(
529
- $this->workSheetCollection,
530
- $iSheetIndex,
531
- 0,
532
- array($pSheet)
533
- );
534
-
535
- // Adjust active sheet index if necessary
536
- if ($this->activeSheetIndex >= $iSheetIndex) {
537
- ++$this->activeSheetIndex;
538
- }
539
- }
540
-
541
- if ($pSheet->getParent() === null) {
542
- $pSheet->rebindParent($this);
543
- }
544
-
545
- return $pSheet;
546
- }
547
-
548
- /**
549
- * Remove sheet by index
550
- *
551
- * @param int $pIndex Active sheet index
552
- * @throws PHPExcel_Exception
553
- */
554
- public function removeSheetByIndex($pIndex = 0)
555
- {
556
-
557
- $numSheets = count($this->workSheetCollection);
558
- if ($pIndex > $numSheets - 1) {
559
- throw new PHPExcel_Exception(
560
- "You tried to remove a sheet by the out of bounds index: {$pIndex}. The actual number of sheets is {$numSheets}."
561
- );
562
- } else {
563
- array_splice($this->workSheetCollection, $pIndex, 1);
564
- }
565
- // Adjust active sheet index if necessary
566
- if (($this->activeSheetIndex >= $pIndex) &&
567
- ($pIndex > count($this->workSheetCollection) - 1)) {
568
- --$this->activeSheetIndex;
569
- }
570
-
571
- }
572
-
573
- /**
574
- * Get sheet by index
575
- *
576
- * @param int $pIndex Sheet index
577
- * @return PHPExcel_Worksheet
578
- * @throws PHPExcel_Exception
579
- */
580
- public function getSheet($pIndex = 0)
581
- {
582
- if (!isset($this->workSheetCollection[$pIndex])) {
583
- $numSheets = $this->getSheetCount();
584
- throw new PHPExcel_Exception(
585
- "Your requested sheet index: {$pIndex} is out of bounds. The actual number of sheets is {$numSheets}."
586
- );
587
- }
588
-
589
- return $this->workSheetCollection[$pIndex];
590
- }
591
-
592
- /**
593
- * Get all sheets
594
- *
595
- * @return PHPExcel_Worksheet[]
596
- */
597
- public function getAllSheets()
598
- {
599
- return $this->workSheetCollection;
600
- }
601
-
602
- /**
603
- * Get sheet by name
604
- *
605
- * @param string $pName Sheet name
606
- * @return PHPExcel_Worksheet
607
- */
608
- public function getSheetByName($pName = '')
609
- {
610
- $worksheetCount = count($this->workSheetCollection);
611
- for ($i = 0; $i < $worksheetCount; ++$i) {
612
- if ($this->workSheetCollection[$i]->getTitle() === $pName) {
613
- return $this->workSheetCollection[$i];
614
- }
615
- }
616
-
617
- return null;
618
- }
619
-
620
- /**
621
- * Get index for sheet
622
- *
623
- * @param PHPExcel_Worksheet $pSheet
624
- * @return int Sheet index
625
- * @throws PHPExcel_Exception
626
- */
627
- public function getIndex(PHPExcel_Worksheet $pSheet)
628
- {
629
- foreach ($this->workSheetCollection as $key => $value) {
630
- if ($value->getHashCode() == $pSheet->getHashCode()) {
631
- return $key;
632
- }
633
- }
634
-
635
- throw new PHPExcel_Exception("Sheet does not exist.");
636
- }
637
-
638
- /**
639
- * Set index for sheet by sheet name.
640
- *
641
- * @param string $sheetName Sheet name to modify index for
642
- * @param int $newIndex New index for the sheet
643
- * @return int New sheet index
644
- * @throws PHPExcel_Exception
645
- */
646
- public function setIndexByName($sheetName, $newIndex)
647
- {
648
- $oldIndex = $this->getIndex($this->getSheetByName($sheetName));
649
- $pSheet = array_splice(
650
- $this->workSheetCollection,
651
- $oldIndex,
652
- 1
653
- );
654
- array_splice(
655
- $this->workSheetCollection,
656
- $newIndex,
657
- 0,
658
- $pSheet
659
- );
660
- return $newIndex;
661
- }
662
-
663
- /**
664
- * Get sheet count
665
- *
666
- * @return int
667
- */
668
- public function getSheetCount()
669
- {
670
- return count($this->workSheetCollection);
671
- }
672
-
673
- /**
674
- * Get active sheet index
675
- *
676
- * @return int Active sheet index
677
- */
678
- public function getActiveSheetIndex()
679
- {
680
- return $this->activeSheetIndex;
681
- }
682
-
683
- /**
684
- * Set active sheet index
685
- *
686
- * @param int $pIndex Active sheet index
687
- * @throws PHPExcel_Exception
688
- * @return PHPExcel_Worksheet
689
- */
690
- public function setActiveSheetIndex($pIndex = 0)
691
- {
692
- $numSheets = count($this->workSheetCollection);
693
-
694
- if ($pIndex > $numSheets - 1) {
695
- throw new PHPExcel_Exception(
696
- "You tried to set a sheet active by the out of bounds index: {$pIndex}. The actual number of sheets is {$numSheets}."
697
- );
698
- } else {
699
- $this->activeSheetIndex = $pIndex;
700
- }
701
- return $this->getActiveSheet();
702
- }
703
-
704
- /**
705
- * Set active sheet index by name
706
- *
707
- * @param string $pValue Sheet title
708
- * @return PHPExcel_Worksheet
709
- * @throws PHPExcel_Exception
710
- */
711
- public function setActiveSheetIndexByName($pValue = '')
712
- {
713
- if (($worksheet = $this->getSheetByName($pValue)) instanceof PHPExcel_Worksheet) {
714
- $this->setActiveSheetIndex($this->getIndex($worksheet));
715
- return $worksheet;
716
- }
717
-
718
- throw new PHPExcel_Exception('Workbook does not contain sheet:' . $pValue);
719
- }
720
-
721
- /**
722
- * Get sheet names
723
- *
724
- * @return string[]
725
- */
726
- public function getSheetNames()
727
- {
728
- $returnValue = array();
729
- $worksheetCount = $this->getSheetCount();
730
- for ($i = 0; $i < $worksheetCount; ++$i) {
731
- $returnValue[] = $this->getSheet($i)->getTitle();
732
- }
733
-
734
- return $returnValue;
735
- }
736
-
737
- /**
738
- * Add external sheet
739
- *
740
- * @param PHPExcel_Worksheet $pSheet External sheet to add
741
- * @param int|null $iSheetIndex Index where sheet should go (0,1,..., or null for last)
742
- * @throws PHPExcel_Exception
743
- * @return PHPExcel_Worksheet
744
- */
745
- public function addExternalSheet(PHPExcel_Worksheet $pSheet, $iSheetIndex = null)
746
- {
747
- if ($this->sheetNameExists($pSheet->getTitle())) {
748
- throw new PHPExcel_Exception("Workbook already contains a worksheet named '{$pSheet->getTitle()}'. Rename the external sheet first.");
749
- }
750
-
751
- // count how many cellXfs there are in this workbook currently, we will need this below
752
- $countCellXfs = count($this->cellXfCollection);
753
-
754
- // copy all the shared cellXfs from the external workbook and append them to the current
755
- foreach ($pSheet->getParent()->getCellXfCollection() as $cellXf) {
756
- $this->addCellXf(clone $cellXf);
757
- }
758
-
759
- // move sheet to this workbook
760
- $pSheet->rebindParent($this);
761
-
762
- // update the cellXfs
763
- foreach ($pSheet->getCellCollection(false) as $cellID) {
764
- $cell = $pSheet->getCell($cellID);
765
- $cell->setXfIndex($cell->getXfIndex() + $countCellXfs);
766
- }
767
-
768
- return $this->addSheet($pSheet, $iSheetIndex);
769
- }
770
-
771
- /**
772
- * Get named ranges
773
- *
774
- * @return PHPExcel_NamedRange[]
775
- */
776
- public function getNamedRanges()
777
- {
778
- return $this->namedRanges;
779
- }
780
-
781
- /**
782
- * Add named range
783
- *
784
- * @param PHPExcel_NamedRange $namedRange
785
- * @return boolean
786
- */
787
- public function addNamedRange(PHPExcel_NamedRange $namedRange)
788
- {
789
- if ($namedRange->getScope() == null) {
790
- // global scope
791
- $this->namedRanges[$namedRange->getName()] = $namedRange;
792
- } else {
793
- // local scope
794
- $this->namedRanges[$namedRange->getScope()->getTitle().'!'.$namedRange->getName()] = $namedRange;
795
- }
796
- return true;
797
- }
798
-
799
- /**
800
- * Get named range
801
- *
802
- * @param string $namedRange
803
- * @param PHPExcel_Worksheet|null $pSheet Scope. Use null for global scope
804
- * @return PHPExcel_NamedRange|null
805
- */
806
- public function getNamedRange($namedRange, PHPExcel_Worksheet $pSheet = null)
807
- {
808
- $returnValue = null;
809
-
810
- if ($namedRange != '' && ($namedRange !== null)) {
811
- // first look for global defined name
812
- if (isset($this->namedRanges[$namedRange])) {
813
- $returnValue = $this->namedRanges[$namedRange];
814
- }
815
-
816
- // then look for local defined name (has priority over global defined name if both names exist)
817
- if (($pSheet !== null) && isset($this->namedRanges[$pSheet->getTitle() . '!' . $namedRange])) {
818
- $returnValue = $this->namedRanges[$pSheet->getTitle() . '!' . $namedRange];
819
- }
820
- }
821
-
822
- return $returnValue;
823
- }
824
-
825
- /**
826
- * Remove named range
827
- *
828
- * @param string $namedRange
829
- * @param PHPExcel_Worksheet|null $pSheet Scope: use null for global scope.
830
- * @return PHPExcel
831
- */
832
- public function removeNamedRange($namedRange, PHPExcel_Worksheet $pSheet = null)
833
- {
834
- if ($pSheet === null) {
835
- if (isset($this->namedRanges[$namedRange])) {
836
- unset($this->namedRanges[$namedRange]);
837
- }
838
- } else {
839
- if (isset($this->namedRanges[$pSheet->getTitle() . '!' . $namedRange])) {
840
- unset($this->namedRanges[$pSheet->getTitle() . '!' . $namedRange]);
841
- }
842
- }
843
- return $this;
844
- }
845
-
846
- /**
847
- * Get worksheet iterator
848
- *
849
- * @return PHPExcel_WorksheetIterator
850
- */
851
- public function getWorksheetIterator()
852
- {
853
- return new PHPExcel_WorksheetIterator($this);
854
- }
855
-
856
- /**
857
- * Copy workbook (!= clone!)
858
- *
859
- * @return PHPExcel
860
- */
861
- public function copy()
862
- {
863
- $copied = clone $this;
864
-
865
- $worksheetCount = count($this->workSheetCollection);
866
- for ($i = 0; $i < $worksheetCount; ++$i) {
867
- $this->workSheetCollection[$i] = $this->workSheetCollection[$i]->copy();
868
- $this->workSheetCollection[$i]->rebindParent($this);
869
- }
870
-
871
- return $copied;
872
- }
873
-
874
- /**
875
- * Implement PHP __clone to create a deep clone, not just a shallow copy.
876
- */
877
- public function __clone()
878
- {
879
- foreach ($this as $key => $val) {
880
- if (is_object($val) || (is_array($val))) {
881
- $this->{$key} = unserialize(serialize($val));
882
- }
883
- }
884
- }
885
-
886
- /**
887
- * Get the workbook collection of cellXfs
888
- *
889
- * @return PHPExcel_Style[]
890
- */
891
- public function getCellXfCollection()
892
- {
893
- return $this->cellXfCollection;
894
- }
895
-
896
- /**
897
- * Get cellXf by index
898
- *
899
- * @param int $pIndex
900
- * @return PHPExcel_Style
901
- */
902
- public function getCellXfByIndex($pIndex = 0)
903
- {
904
- return $this->cellXfCollection[$pIndex];
905
- }
906
-
907
- /**
908
- * Get cellXf by hash code
909
- *
910
- * @param string $pValue
911
- * @return PHPExcel_Style|boolean False if no match found
912
- */
913
- public function getCellXfByHashCode($pValue = '')
914
- {
915
- foreach ($this->cellXfCollection as $cellXf) {
916
- if ($cellXf->getHashCode() == $pValue) {
917
- return $cellXf;
918
- }
919
- }
920
- return false;
921
- }
922
-
923
- /**
924
- * Check if style exists in style collection
925
- *
926
- * @param PHPExcel_Style $pCellStyle
927
- * @return boolean
928
- */
929
- public function cellXfExists($pCellStyle = null)
930
- {
931
- return in_array($pCellStyle, $this->cellXfCollection, true);
932
- }
933
-
934
- /**
935
- * Get default style
936
- *
937
- * @return PHPExcel_Style
938
- * @throws PHPExcel_Exception
939
- */
940
- public function getDefaultStyle()
941
- {
942
- if (isset($this->cellXfCollection[0])) {
943
- return $this->cellXfCollection[0];
944
- }
945
- throw new PHPExcel_Exception('No default style found for this workbook');
946
- }
947
-
948
- /**
949
- * Add a cellXf to the workbook
950
- *
951
- * @param PHPExcel_Style $style
952
- */
953
- public function addCellXf(PHPExcel_Style $style)
954
- {
955
- $this->cellXfCollection[] = $style;
956
- $style->setIndex(count($this->cellXfCollection) - 1);
957
- }
958
-
959
- /**
960
- * Remove cellXf by index. It is ensured that all cells get their xf index updated.
961
- *
962
- * @param integer $pIndex Index to cellXf
963
- * @throws PHPExcel_Exception
964
- */
965
- public function removeCellXfByIndex($pIndex = 0)
966
- {
967
- if ($pIndex > count($this->cellXfCollection) - 1) {
968
- throw new PHPExcel_Exception("CellXf index is out of bounds.");
969
- } else {
970
- // first remove the cellXf
971
- array_splice($this->cellXfCollection, $pIndex, 1);
972
-
973
- // then update cellXf indexes for cells
974
- foreach ($this->workSheetCollection as $worksheet) {
975
- foreach ($worksheet->getCellCollection(false) as $cellID) {
976
- $cell = $worksheet->getCell($cellID);
977
- $xfIndex = $cell->getXfIndex();
978
- if ($xfIndex > $pIndex) {
979
- // decrease xf index by 1
980
- $cell->setXfIndex($xfIndex - 1);
981
- } elseif ($xfIndex == $pIndex) {
982
- // set to default xf index 0
983
- $cell->setXfIndex(0);
984
- }
985
- }
986
- }
987
- }
988
- }
989
-
990
- /**
991
- * Get the cellXf supervisor
992
- *
993
- * @return PHPExcel_Style
994
- */
995
- public function getCellXfSupervisor()
996
- {
997
- return $this->cellXfSupervisor;
998
- }
999
-
1000
- /**
1001
- * Get the workbook collection of cellStyleXfs
1002
- *
1003
- * @return PHPExcel_Style[]
1004
- */
1005
- public function getCellStyleXfCollection()
1006
- {
1007
- return $this->cellStyleXfCollection;
1008
- }
1009
-
1010
- /**
1011
- * Get cellStyleXf by index
1012
- *
1013
- * @param integer $pIndex Index to cellXf
1014
- * @return PHPExcel_Style
1015
- */
1016
- public function getCellStyleXfByIndex($pIndex = 0)
1017
- {
1018
- return $this->cellStyleXfCollection[$pIndex];
1019
- }
1020
-
1021
- /**
1022
- * Get cellStyleXf by hash code
1023
- *
1024
- * @param string $pValue
1025
- * @return PHPExcel_Style|boolean False if no match found
1026
- */
1027
- public function getCellStyleXfByHashCode($pValue = '')
1028
- {
1029
- foreach ($this->cellStyleXfCollection as $cellStyleXf) {
1030
- if ($cellStyleXf->getHashCode() == $pValue) {
1031
- return $cellStyleXf;
1032
- }
1033
- }
1034
- return false;
1035
- }
1036
-
1037
- /**
1038
- * Add a cellStyleXf to the workbook
1039
- *
1040
- * @param PHPExcel_Style $pStyle
1041
- */
1042
- public function addCellStyleXf(PHPExcel_Style $pStyle)
1043
- {
1044
- $this->cellStyleXfCollection[] = $pStyle;
1045
- $pStyle->setIndex(count($this->cellStyleXfCollection) - 1);
1046
- }
1047
-
1048
- /**
1049
- * Remove cellStyleXf by index
1050
- *
1051
- * @param integer $pIndex Index to cellXf
1052
- * @throws PHPExcel_Exception
1053
- */
1054
- public function removeCellStyleXfByIndex($pIndex = 0)
1055
- {
1056
- if ($pIndex > count($this->cellStyleXfCollection) - 1) {
1057
- throw new PHPExcel_Exception("CellStyleXf index is out of bounds.");
1058
- } else {
1059
- array_splice($this->cellStyleXfCollection, $pIndex, 1);
1060
- }
1061
- }
1062
-
1063
- /**
1064
- * Eliminate all unneeded cellXf and afterwards update the xfIndex for all cells
1065
- * and columns in the workbook
1066
- */
1067
- public function garbageCollect()
1068
- {
1069
- // how many references are there to each cellXf ?
1070
- $countReferencesCellXf = array();
1071
- foreach ($this->cellXfCollection as $index => $cellXf) {
1072
- $countReferencesCellXf[$index] = 0;
1073
- }
1074
-
1075
- foreach ($this->getWorksheetIterator() as $sheet) {
1076
- // from cells
1077
- foreach ($sheet->getCellCollection(false) as $cellID) {
1078
- $cell = $sheet->getCell($cellID);
1079
- ++$countReferencesCellXf[$cell->getXfIndex()];
1080
- }
1081
-
1082
- // from row dimensions
1083
- foreach ($sheet->getRowDimensions() as $rowDimension) {
1084
- if ($rowDimension->getXfIndex() !== null) {
1085
- ++$countReferencesCellXf[$rowDimension->getXfIndex()];
1086
- }
1087
- }
1088
-
1089
- // from column dimensions
1090
- foreach ($sheet->getColumnDimensions() as $columnDimension) {
1091
- ++$countReferencesCellXf[$columnDimension->getXfIndex()];
1092
- }
1093
- }
1094
-
1095
- // remove cellXfs without references and create mapping so we can update xfIndex
1096
- // for all cells and columns
1097
- $countNeededCellXfs = 0;
1098
- $map = array();
1099
- foreach ($this->cellXfCollection as $index => $cellXf) {
1100
- if ($countReferencesCellXf[$index] > 0 || $index == 0) { // we must never remove the first cellXf
1101
- ++$countNeededCellXfs;
1102
- } else {
1103
- unset($this->cellXfCollection[$index]);
1104
- }
1105
- $map[$index] = $countNeededCellXfs - 1;
1106
- }
1107
- $this->cellXfCollection = array_values($this->cellXfCollection);
1108
-
1109
- // update the index for all cellXfs
1110
- foreach ($this->cellXfCollection as $i => $cellXf) {
1111
- $cellXf->setIndex($i);
1112
- }
1113
-
1114
- // make sure there is always at least one cellXf (there should be)
1115
- if (empty($this->cellXfCollection)) {
1116
- $this->cellXfCollection[] = new PHPExcel_Style();
1117
- }
1118
-
1119
- // update the xfIndex for all cells, row dimensions, column dimensions
1120
- foreach ($this->getWorksheetIterator() as $sheet) {
1121
- // for all cells
1122
- foreach ($sheet->getCellCollection(false) as $cellID) {
1123
- $cell = $sheet->getCell($cellID);
1124
- $cell->setXfIndex($map[$cell->getXfIndex()]);
1125
- }
1126
-
1127
- // for all row dimensions
1128
- foreach ($sheet->getRowDimensions() as $rowDimension) {
1129
- if ($rowDimension->getXfIndex() !== null) {
1130
- $rowDimension->setXfIndex($map[$rowDimension->getXfIndex()]);
1131
- }
1132
- }
1133
-
1134
- // for all column dimensions
1135
- foreach ($sheet->getColumnDimensions() as $columnDimension) {
1136
- $columnDimension->setXfIndex($map[$columnDimension->getXfIndex()]);
1137
- }
1138
-
1139
- // also do garbage collection for all the sheets
1140
- $sheet->garbageCollect();
1141
- }
1142
- }
1143
-
1144
- /**
1145
- * Return the unique ID value assigned to this spreadsheet workbook
1146
- *
1147
- * @return string
1148
- */
1149
- public function getID()
1150
- {
1151
- return $this->uniqueID;
1152
- }
1153
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Autoloader.php DELETED
@@ -1,81 +0,0 @@
1
- <?php
2
-
3
- PHPExcel_Autoloader::register();
4
- // As we always try to run the autoloader before anything else, we can use it to do a few
5
- // simple checks and initialisations
6
- //PHPExcel_Shared_ZipStreamWrapper::register();
7
- // check mbstring.func_overload
8
- if (ini_get('mbstring.func_overload') & 2) {
9
- throw new PHPExcel_Exception('Multibyte function overloading in PHP must be disabled for string functions (2).');
10
- }
11
- PHPExcel_Shared_String::buildCharacterSets();
12
-
13
- /**
14
- * PHPExcel
15
- *
16
- * Copyright (c) 2006 - 2015 PHPExcel
17
- *
18
- * This library is free software; you can redistribute it and/or
19
- * modify it under the terms of the GNU Lesser General Public
20
- * License as published by the Free Software Foundation; either
21
- * version 2.1 of the License, or (at your option) any later version.
22
- *
23
- * This library is distributed in the hope that it will be useful,
24
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
25
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
26
- * Lesser General Public License for more details.
27
- *
28
- * You should have received a copy of the GNU Lesser General Public
29
- * License along with this library; if not, write to the Free Software
30
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
31
- *
32
- * @category PHPExcel
33
- * @package PHPExcel
34
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
35
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
36
- * @version ##VERSION##, ##DATE##
37
- */
38
- class PHPExcel_Autoloader
39
- {
40
- /**
41
- * Register the Autoloader with SPL
42
- *
43
- */
44
- public static function register()
45
- {
46
- if (function_exists('__autoload')) {
47
- // Register any existing autoloader function with SPL, so we don't get any clashes
48
- spl_autoload_register('__autoload');
49
- }
50
- // Register ourselves with SPL
51
- if (version_compare(PHP_VERSION, '5.3.0') >= 0) {
52
- return spl_autoload_register(array('PHPExcel_Autoloader', 'load'), true, true);
53
- } else {
54
- return spl_autoload_register(array('PHPExcel_Autoloader', 'load'));
55
- }
56
- }
57
-
58
- /**
59
- * Autoload a class identified by name
60
- *
61
- * @param string $pClassName Name of the object to load
62
- */
63
- public static function load($pClassName)
64
- {
65
- if ((class_exists($pClassName, false)) || (strpos($pClassName, 'PHPExcel') !== 0)) {
66
- // Either already loaded, or not a PHPExcel class request
67
- return false;
68
- }
69
-
70
- $pClassFilePath = PHPEXCEL_ROOT .
71
- str_replace('_', DIRECTORY_SEPARATOR, $pClassName) .
72
- '.php';
73
-
74
- if ((file_exists($pClassFilePath) === false) || (is_readable($pClassFilePath) === false)) {
75
- // Can't load
76
- return false;
77
- }
78
-
79
- require($pClassFilePath);
80
- }
81
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/APC.php DELETED
@@ -1,290 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_APC
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_APC extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Prefix used to uniquely identify cache data for this worksheet
32
- *
33
- * @access private
34
- * @var string
35
- */
36
- private $cachePrefix = null;
37
-
38
- /**
39
- * Cache timeout
40
- *
41
- * @access private
42
- * @var integer
43
- */
44
- private $cacheTime = 600;
45
-
46
- /**
47
- * Store cell data in cache for the current cell object if it's "dirty",
48
- * and the 'nullify' the current cell object
49
- *
50
- * @access private
51
- * @return void
52
- * @throws PHPExcel_Exception
53
- */
54
- protected function storeData()
55
- {
56
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
57
- $this->currentObject->detach();
58
-
59
- if (!apc_store(
60
- $this->cachePrefix . $this->currentObjectID . '.cache',
61
- serialize($this->currentObject),
62
- $this->cacheTime
63
- )) {
64
- $this->__destruct();
65
- throw new PHPExcel_Exception('Failed to store cell ' . $this->currentObjectID . ' in APC');
66
- }
67
- $this->currentCellIsDirty = false;
68
- }
69
- $this->currentObjectID = $this->currentObject = null;
70
- }
71
-
72
- /**
73
- * Add or Update a cell in cache identified by coordinate address
74
- *
75
- * @access public
76
- * @param string $pCoord Coordinate address of the cell to update
77
- * @param PHPExcel_Cell $cell Cell to update
78
- * @return PHPExcel_Cell
79
- * @throws PHPExcel_Exception
80
- */
81
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
82
- {
83
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
84
- $this->storeData();
85
- }
86
- $this->cellCache[$pCoord] = true;
87
-
88
- $this->currentObjectID = $pCoord;
89
- $this->currentObject = $cell;
90
- $this->currentCellIsDirty = true;
91
-
92
- return $cell;
93
- }
94
-
95
- /**
96
- * Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
97
- *
98
- * @access public
99
- * @param string $pCoord Coordinate address of the cell to check
100
- * @throws PHPExcel_Exception
101
- * @return boolean
102
- */
103
- public function isDataSet($pCoord)
104
- {
105
- // Check if the requested entry is the current object, or exists in the cache
106
- if (parent::isDataSet($pCoord)) {
107
- if ($this->currentObjectID == $pCoord) {
108
- return true;
109
- }
110
- // Check if the requested entry still exists in apc
111
- $success = apc_fetch($this->cachePrefix.$pCoord.'.cache');
112
- if ($success === false) {
113
- // Entry no longer exists in APC, so clear it from the cache array
114
- parent::deleteCacheData($pCoord);
115
- throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in APC cache');
116
- }
117
- return true;
118
- }
119
- return false;
120
- }
121
-
122
- /**
123
- * Get cell at a specific coordinate
124
- *
125
- * @access public
126
- * @param string $pCoord Coordinate of the cell
127
- * @throws PHPExcel_Exception
128
- * @return PHPExcel_Cell Cell that was found, or null if not found
129
- */
130
- public function getCacheData($pCoord)
131
- {
132
- if ($pCoord === $this->currentObjectID) {
133
- return $this->currentObject;
134
- }
135
- $this->storeData();
136
-
137
- // Check if the entry that has been requested actually exists
138
- if (parent::isDataSet($pCoord)) {
139
- $obj = apc_fetch($this->cachePrefix . $pCoord . '.cache');
140
- if ($obj === false) {
141
- // Entry no longer exists in APC, so clear it from the cache array
142
- parent::deleteCacheData($pCoord);
143
- throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in APC cache');
144
- }
145
- } else {
146
- // Return null if requested entry doesn't exist in cache
147
- return null;
148
- }
149
-
150
- // Set current entry to the requested entry
151
- $this->currentObjectID = $pCoord;
152
- $this->currentObject = unserialize($obj);
153
- // Re-attach this as the cell's parent
154
- $this->currentObject->attach($this);
155
-
156
- // Return requested entry
157
- return $this->currentObject;
158
- }
159
-
160
- /**
161
- * Get a list of all cell addresses currently held in cache
162
- *
163
- * @return string[]
164
- */
165
- public function getCellList()
166
- {
167
- if ($this->currentObjectID !== null) {
168
- $this->storeData();
169
- }
170
-
171
- return parent::getCellList();
172
- }
173
-
174
- /**
175
- * Delete a cell in cache identified by coordinate address
176
- *
177
- * @access public
178
- * @param string $pCoord Coordinate address of the cell to delete
179
- * @throws PHPExcel_Exception
180
- */
181
- public function deleteCacheData($pCoord)
182
- {
183
- // Delete the entry from APC
184
- apc_delete($this->cachePrefix.$pCoord.'.cache');
185
-
186
- // Delete the entry from our cell address array
187
- parent::deleteCacheData($pCoord);
188
- }
189
-
190
- /**
191
- * Clone the cell collection
192
- *
193
- * @access public
194
- * @param PHPExcel_Worksheet $parent The new worksheet
195
- * @throws PHPExcel_Exception
196
- * @return void
197
- */
198
- public function copyCellCollection(PHPExcel_Worksheet $parent)
199
- {
200
- parent::copyCellCollection($parent);
201
- // Get a new id for the new file name
202
- $baseUnique = $this->getUniqueID();
203
- $newCachePrefix = substr(md5($baseUnique), 0, 8) . '.';
204
- $cacheList = $this->getCellList();
205
- foreach ($cacheList as $cellID) {
206
- if ($cellID != $this->currentObjectID) {
207
- $obj = apc_fetch($this->cachePrefix . $cellID . '.cache');
208
- if ($obj === false) {
209
- // Entry no longer exists in APC, so clear it from the cache array
210
- parent::deleteCacheData($cellID);
211
- throw new PHPExcel_Exception('Cell entry ' . $cellID . ' no longer exists in APC');
212
- }
213
- if (!apc_store($newCachePrefix . $cellID . '.cache', $obj, $this->cacheTime)) {
214
- $this->__destruct();
215
- throw new PHPExcel_Exception('Failed to store cell ' . $cellID . ' in APC');
216
- }
217
- }
218
- }
219
- $this->cachePrefix = $newCachePrefix;
220
- }
221
-
222
- /**
223
- * Clear the cell collection and disconnect from our parent
224
- *
225
- * @return void
226
- */
227
- public function unsetWorksheetCells()
228
- {
229
- if ($this->currentObject !== null) {
230
- $this->currentObject->detach();
231
- $this->currentObject = $this->currentObjectID = null;
232
- }
233
-
234
- // Flush the APC cache
235
- $this->__destruct();
236
-
237
- $this->cellCache = array();
238
-
239
- // detach ourself from the worksheet, so that it can then delete this object successfully
240
- $this->parent = null;
241
- }
242
-
243
- /**
244
- * Initialise this new cell collection
245
- *
246
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
247
- * @param array of mixed $arguments Additional initialisation arguments
248
- */
249
- public function __construct(PHPExcel_Worksheet $parent, $arguments)
250
- {
251
- $cacheTime = (isset($arguments['cacheTime'])) ? $arguments['cacheTime'] : 600;
252
-
253
- if ($this->cachePrefix === null) {
254
- $baseUnique = $this->getUniqueID();
255
- $this->cachePrefix = substr(md5($baseUnique), 0, 8) . '.';
256
- $this->cacheTime = $cacheTime;
257
-
258
- parent::__construct($parent);
259
- }
260
- }
261
-
262
- /**
263
- * Destroy this cell collection
264
- */
265
- public function __destruct()
266
- {
267
- $cacheList = $this->getCellList();
268
- foreach ($cacheList as $cellID) {
269
- apc_delete($this->cachePrefix . $cellID . '.cache');
270
- }
271
- }
272
-
273
- /**
274
- * Identify whether the caching method is currently available
275
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
276
- *
277
- * @return boolean
278
- */
279
- public static function cacheMethodIsAvailable()
280
- {
281
- if (!function_exists('apc_store')) {
282
- return false;
283
- }
284
- if (apc_sma_info() === false) {
285
- return false;
286
- }
287
-
288
- return true;
289
- }
290
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/CacheBase.php DELETED
@@ -1,368 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_CacheBase
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- abstract class PHPExcel_CachedObjectStorage_CacheBase
29
- {
30
- /**
31
- * Parent worksheet
32
- *
33
- * @var PHPExcel_Worksheet
34
- */
35
- protected $parent;
36
-
37
- /**
38
- * The currently active Cell
39
- *
40
- * @var PHPExcel_Cell
41
- */
42
- protected $currentObject = null;
43
-
44
- /**
45
- * Coordinate address of the currently active Cell
46
- *
47
- * @var string
48
- */
49
- protected $currentObjectID = null;
50
-
51
- /**
52
- * Flag indicating whether the currently active Cell requires saving
53
- *
54
- * @var boolean
55
- */
56
- protected $currentCellIsDirty = true;
57
-
58
- /**
59
- * An array of cells or cell pointers for the worksheet cells held in this cache,
60
- * and indexed by their coordinate address within the worksheet
61
- *
62
- * @var array of mixed
63
- */
64
- protected $cellCache = array();
65
-
66
- /**
67
- * Initialise this new cell collection
68
- *
69
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
70
- */
71
- public function __construct(PHPExcel_Worksheet $parent)
72
- {
73
- // Set our parent worksheet.
74
- // This is maintained within the cache controller to facilitate re-attaching it to PHPExcel_Cell objects when
75
- // they are woken from a serialized state
76
- $this->parent = $parent;
77
- }
78
-
79
- /**
80
- * Return the parent worksheet for this cell collection
81
- *
82
- * @return PHPExcel_Worksheet
83
- */
84
- public function getParent()
85
- {
86
- return $this->parent;
87
- }
88
-
89
- /**
90
- * Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
91
- *
92
- * @param string $pCoord Coordinate address of the cell to check
93
- * @return boolean
94
- */
95
- public function isDataSet($pCoord)
96
- {
97
- if ($pCoord === $this->currentObjectID) {
98
- return true;
99
- }
100
- // Check if the requested entry exists in the cache
101
- return isset($this->cellCache[$pCoord]);
102
- }
103
-
104
- /**
105
- * Move a cell object from one address to another
106
- *
107
- * @param string $fromAddress Current address of the cell to move
108
- * @param string $toAddress Destination address of the cell to move
109
- * @return boolean
110
- */
111
- public function moveCell($fromAddress, $toAddress)
112
- {
113
- if ($fromAddress === $this->currentObjectID) {
114
- $this->currentObjectID = $toAddress;
115
- }
116
- $this->currentCellIsDirty = true;
117
- if (isset($this->cellCache[$fromAddress])) {
118
- $this->cellCache[$toAddress] = &$this->cellCache[$fromAddress];
119
- unset($this->cellCache[$fromAddress]);
120
- }
121
-
122
- return true;
123
- }
124
-
125
- /**
126
- * Add or Update a cell in cache
127
- *
128
- * @param PHPExcel_Cell $cell Cell to update
129
- * @return PHPExcel_Cell
130
- * @throws PHPExcel_Exception
131
- */
132
- public function updateCacheData(PHPExcel_Cell $cell)
133
- {
134
- return $this->addCacheData($cell->getCoordinate(), $cell);
135
- }
136
-
137
- /**
138
- * Delete a cell in cache identified by coordinate address
139
- *
140
- * @param string $pCoord Coordinate address of the cell to delete
141
- * @throws PHPExcel_Exception
142
- */
143
- public function deleteCacheData($pCoord)
144
- {
145
- if ($pCoord === $this->currentObjectID && !is_null($this->currentObject)) {
146
- $this->currentObject->detach();
147
- $this->currentObjectID = $this->currentObject = null;
148
- }
149
-
150
- if (is_object($this->cellCache[$pCoord])) {
151
- $this->cellCache[$pCoord]->detach();
152
- unset($this->cellCache[$pCoord]);
153
- }
154
- $this->currentCellIsDirty = false;
155
- }
156
-
157
- /**
158
- * Get a list of all cell addresses currently held in cache
159
- *
160
- * @return string[]
161
- */
162
- public function getCellList()
163
- {
164
- return array_keys($this->cellCache);
165
- }
166
-
167
- /**
168
- * Sort the list of all cell addresses currently held in cache by row and column
169
- *
170
- * @return string[]
171
- */
172
- public function getSortedCellList()
173
- {
174
- $sortKeys = array();
175
- foreach ($this->getCellList() as $coord) {
176
- sscanf($coord, '%[A-Z]%d', $column, $row);
177
- $sortKeys[sprintf('%09d%3s', $row, $column)] = $coord;
178
- }
179
- ksort($sortKeys);
180
-
181
- return array_values($sortKeys);
182
- }
183
-
184
- /**
185
- * Get highest worksheet column and highest row that have cell records
186
- *
187
- * @return array Highest column name and highest row number
188
- */
189
- public function getHighestRowAndColumn()
190
- {
191
- // Lookup highest column and highest row
192
- $col = array('A' => '1A');
193
- $row = array(1);
194
- foreach ($this->getCellList() as $coord) {
195
- sscanf($coord, '%[A-Z]%d', $c, $r);
196
- $row[$r] = $r;
197
- $col[$c] = strlen($c).$c;
198
- }
199
- if (!empty($row)) {
200
- // Determine highest column and row
201
- $highestRow = max($row);
202
- $highestColumn = substr(max($col), 1);
203
- }
204
-
205
- return array(
206
- 'row' => $highestRow,
207
- 'column' => $highestColumn
208
- );
209
- }
210
-
211
- /**
212
- * Return the cell address of the currently active cell object
213
- *
214
- * @return string
215
- */
216
- public function getCurrentAddress()
217
- {
218
- return $this->currentObjectID;
219
- }
220
-
221
- /**
222
- * Return the column address of the currently active cell object
223
- *
224
- * @return string
225
- */
226
- public function getCurrentColumn()
227
- {
228
- sscanf($this->currentObjectID, '%[A-Z]%d', $column, $row);
229
- return $column;
230
- }
231
-
232
- /**
233
- * Return the row address of the currently active cell object
234
- *
235
- * @return integer
236
- */
237
- public function getCurrentRow()
238
- {
239
- sscanf($this->currentObjectID, '%[A-Z]%d', $column, $row);
240
- return (integer) $row;
241
- }
242
-
243
- /**
244
- * Get highest worksheet column
245
- *
246
- * @param string $row Return the highest column for the specified row,
247
- * or the highest column of any row if no row number is passed
248
- * @return string Highest column name
249
- */
250
- public function getHighestColumn($row = null)
251
- {
252
- if ($row == null) {
253
- $colRow = $this->getHighestRowAndColumn();
254
- return $colRow['column'];
255
- }
256
-
257
- $columnList = array(1);
258
- foreach ($this->getCellList() as $coord) {
259
- sscanf($coord, '%[A-Z]%d', $c, $r);
260
- if ($r != $row) {
261
- continue;
262
- }
263
- $columnList[] = PHPExcel_Cell::columnIndexFromString($c);
264
- }
265
- return PHPExcel_Cell::stringFromColumnIndex(max($columnList) - 1);
266
- }
267
-
268
- /**
269
- * Get highest worksheet row
270
- *
271
- * @param string $column Return the highest row for the specified column,
272
- * or the highest row of any column if no column letter is passed
273
- * @return int Highest row number
274
- */
275
- public function getHighestRow($column = null)
276
- {
277
- if ($column == null) {
278
- $colRow = $this->getHighestRowAndColumn();
279
- return $colRow['row'];
280
- }
281
-
282
- $rowList = array(0);
283
- foreach ($this->getCellList() as $coord) {
284
- sscanf($coord, '%[A-Z]%d', $c, $r);
285
- if ($c != $column) {
286
- continue;
287
- }
288
- $rowList[] = $r;
289
- }
290
-
291
- return max($rowList);
292
- }
293
-
294
- /**
295
- * Generate a unique ID for cache referencing
296
- *
297
- * @return string Unique Reference
298
- */
299
- protected function getUniqueID()
300
- {
301
- if (function_exists('posix_getpid')) {
302
- $baseUnique = posix_getpid();
303
- } else {
304
- $baseUnique = mt_rand();
305
- }
306
- return uniqid($baseUnique, true);
307
- }
308
-
309
- /**
310
- * Clone the cell collection
311
- *
312
- * @param PHPExcel_Worksheet $parent The new worksheet
313
- * @return void
314
- */
315
- public function copyCellCollection(PHPExcel_Worksheet $parent)
316
- {
317
- $this->currentCellIsDirty;
318
- $this->storeData();
319
-
320
- $this->parent = $parent;
321
- if (($this->currentObject !== null) && (is_object($this->currentObject))) {
322
- $this->currentObject->attach($this);
323
- }
324
- } // function copyCellCollection()
325
-
326
- /**
327
- * Remove a row, deleting all cells in that row
328
- *
329
- * @param string $row Row number to remove
330
- * @return void
331
- */
332
- public function removeRow($row)
333
- {
334
- foreach ($this->getCellList() as $coord) {
335
- sscanf($coord, '%[A-Z]%d', $c, $r);
336
- if ($r == $row) {
337
- $this->deleteCacheData($coord);
338
- }
339
- }
340
- }
341
-
342
- /**
343
- * Remove a column, deleting all cells in that column
344
- *
345
- * @param string $column Column ID to remove
346
- * @return void
347
- */
348
- public function removeColumn($column)
349
- {
350
- foreach ($this->getCellList() as $coord) {
351
- sscanf($coord, '%[A-Z]%d', $c, $r);
352
- if ($c == $column) {
353
- $this->deleteCacheData($coord);
354
- }
355
- }
356
- }
357
-
358
- /**
359
- * Identify whether the caching method is currently available
360
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
361
- *
362
- * @return boolean
363
- */
364
- public static function cacheMethodIsAvailable()
365
- {
366
- return true;
367
- }
368
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/DiscISAM.php DELETED
@@ -1,208 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_DiscISAM
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_DiscISAM extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Name of the file for this cache
32
- *
33
- * @var string
34
- */
35
- private $fileName = null;
36
-
37
- /**
38
- * File handle for this cache file
39
- *
40
- * @var resource
41
- */
42
- private $fileHandle = null;
43
-
44
- /**
45
- * Directory/Folder where the cache file is located
46
- *
47
- * @var string
48
- */
49
- private $cacheDirectory = null;
50
-
51
- /**
52
- * Store cell data in cache for the current cell object if it's "dirty",
53
- * and the 'nullify' the current cell object
54
- *
55
- * @return void
56
- * @throws PHPExcel_Exception
57
- */
58
- protected function storeData()
59
- {
60
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
61
- $this->currentObject->detach();
62
-
63
- fseek($this->fileHandle, 0, SEEK_END);
64
-
65
- $this->cellCache[$this->currentObjectID] = array(
66
- 'ptr' => ftell($this->fileHandle),
67
- 'sz' => fwrite($this->fileHandle, serialize($this->currentObject))
68
- );
69
- $this->currentCellIsDirty = false;
70
- }
71
- $this->currentObjectID = $this->currentObject = null;
72
- }
73
-
74
- /**
75
- * Add or Update a cell in cache identified by coordinate address
76
- *
77
- * @param string $pCoord Coordinate address of the cell to update
78
- * @param PHPExcel_Cell $cell Cell to update
79
- * @return PHPExcel_Cell
80
- * @throws PHPExcel_Exception
81
- */
82
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
83
- {
84
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
85
- $this->storeData();
86
- }
87
-
88
- $this->currentObjectID = $pCoord;
89
- $this->currentObject = $cell;
90
- $this->currentCellIsDirty = true;
91
-
92
- return $cell;
93
- }
94
-
95
- /**
96
- * Get cell at a specific coordinate
97
- *
98
- * @param string $pCoord Coordinate of the cell
99
- * @throws PHPExcel_Exception
100
- * @return PHPExcel_Cell Cell that was found, or null if not found
101
- */
102
- public function getCacheData($pCoord)
103
- {
104
- if ($pCoord === $this->currentObjectID) {
105
- return $this->currentObject;
106
- }
107
- $this->storeData();
108
-
109
- // Check if the entry that has been requested actually exists
110
- if (!isset($this->cellCache[$pCoord])) {
111
- // Return null if requested entry doesn't exist in cache
112
- return null;
113
- }
114
-
115
- // Set current entry to the requested entry
116
- $this->currentObjectID = $pCoord;
117
- fseek($this->fileHandle, $this->cellCache[$pCoord]['ptr']);
118
- $this->currentObject = unserialize(fread($this->fileHandle, $this->cellCache[$pCoord]['sz']));
119
- // Re-attach this as the cell's parent
120
- $this->currentObject->attach($this);
121
-
122
- // Return requested entry
123
- return $this->currentObject;
124
- }
125
-
126
- /**
127
- * Get a list of all cell addresses currently held in cache
128
- *
129
- * @return string[]
130
- */
131
- public function getCellList()
132
- {
133
- if ($this->currentObjectID !== null) {
134
- $this->storeData();
135
- }
136
-
137
- return parent::getCellList();
138
- }
139
-
140
- /**
141
- * Clone the cell collection
142
- *
143
- * @param PHPExcel_Worksheet $parent The new worksheet
144
- */
145
- public function copyCellCollection(PHPExcel_Worksheet $parent)
146
- {
147
- parent::copyCellCollection($parent);
148
- // Get a new id for the new file name
149
- $baseUnique = $this->getUniqueID();
150
- $newFileName = $this->cacheDirectory.'/PHPExcel.'.$baseUnique.'.cache';
151
- // Copy the existing cell cache file
152
- copy($this->fileName, $newFileName);
153
- $this->fileName = $newFileName;
154
- // Open the copied cell cache file
155
- $this->fileHandle = fopen($this->fileName, 'a+');
156
- }
157
-
158
- /**
159
- * Clear the cell collection and disconnect from our parent
160
- *
161
- */
162
- public function unsetWorksheetCells()
163
- {
164
- if (!is_null($this->currentObject)) {
165
- $this->currentObject->detach();
166
- $this->currentObject = $this->currentObjectID = null;
167
- }
168
- $this->cellCache = array();
169
-
170
- // detach ourself from the worksheet, so that it can then delete this object successfully
171
- $this->parent = null;
172
-
173
- // Close down the temporary cache file
174
- $this->__destruct();
175
- }
176
-
177
- /**
178
- * Initialise this new cell collection
179
- *
180
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
181
- * @param array of mixed $arguments Additional initialisation arguments
182
- */
183
- public function __construct(PHPExcel_Worksheet $parent, $arguments)
184
- {
185
- $this->cacheDirectory = ((isset($arguments['dir'])) && ($arguments['dir'] !== null))
186
- ? $arguments['dir']
187
- : PHPExcel_Shared_File::sys_get_temp_dir();
188
-
189
- parent::__construct($parent);
190
- if (is_null($this->fileHandle)) {
191
- $baseUnique = $this->getUniqueID();
192
- $this->fileName = $this->cacheDirectory.'/PHPExcel.'.$baseUnique.'.cache';
193
- $this->fileHandle = fopen($this->fileName, 'a+');
194
- }
195
- }
196
-
197
- /**
198
- * Destroy this cell collection
199
- */
200
- public function __destruct()
201
- {
202
- if (!is_null($this->fileHandle)) {
203
- fclose($this->fileHandle);
204
- unlink($this->fileName);
205
- }
206
- $this->fileHandle = null;
207
- }
208
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/ICache.php DELETED
@@ -1,103 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_ICache
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- interface PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Add or Update a cell in cache identified by coordinate address
32
- *
33
- * @param string $pCoord Coordinate address of the cell to update
34
- * @param PHPExcel_Cell $cell Cell to update
35
- * @return PHPExcel_Cell
36
- * @throws PHPExcel_Exception
37
- */
38
- public function addCacheData($pCoord, PHPExcel_Cell $cell);
39
-
40
- /**
41
- * Add or Update a cell in cache
42
- *
43
- * @param PHPExcel_Cell $cell Cell to update
44
- * @return PHPExcel_Cell
45
- * @throws PHPExcel_Exception
46
- */
47
- public function updateCacheData(PHPExcel_Cell $cell);
48
-
49
- /**
50
- * Fetch a cell from cache identified by coordinate address
51
- *
52
- * @param string $pCoord Coordinate address of the cell to retrieve
53
- * @return PHPExcel_Cell Cell that was found, or null if not found
54
- * @throws PHPExcel_Exception
55
- */
56
- public function getCacheData($pCoord);
57
-
58
- /**
59
- * Delete a cell in cache identified by coordinate address
60
- *
61
- * @param string $pCoord Coordinate address of the cell to delete
62
- * @throws PHPExcel_Exception
63
- */
64
- public function deleteCacheData($pCoord);
65
-
66
- /**
67
- * Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
68
- *
69
- * @param string $pCoord Coordinate address of the cell to check
70
- * @return boolean
71
- */
72
- public function isDataSet($pCoord);
73
-
74
- /**
75
- * Get a list of all cell addresses currently held in cache
76
- *
77
- * @return string[]
78
- */
79
- public function getCellList();
80
-
81
- /**
82
- * Get the list of all cell addresses currently held in cache sorted by column and row
83
- *
84
- * @return string[]
85
- */
86
- public function getSortedCellList();
87
-
88
- /**
89
- * Clone the cell collection
90
- *
91
- * @param PHPExcel_Worksheet $parent The new worksheet
92
- * @return void
93
- */
94
- public function copyCellCollection(PHPExcel_Worksheet $parent);
95
-
96
- /**
97
- * Identify whether the caching method is currently available
98
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
99
- *
100
- * @return boolean
101
- */
102
- public static function cacheMethodIsAvailable();
103
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/Igbinary.php DELETED
@@ -1,149 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_Igbinary
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_Igbinary extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Store cell data in cache for the current cell object if it's "dirty",
32
- * and the 'nullify' the current cell object
33
- *
34
- * @return void
35
- * @throws PHPExcel_Exception
36
- */
37
- protected function storeData()
38
- {
39
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
40
- $this->currentObject->detach();
41
-
42
- $this->cellCache[$this->currentObjectID] = igbinary_serialize($this->currentObject);
43
- $this->currentCellIsDirty = false;
44
- }
45
- $this->currentObjectID = $this->currentObject = null;
46
- } // function _storeData()
47
-
48
-
49
- /**
50
- * Add or Update a cell in cache identified by coordinate address
51
- *
52
- * @param string $pCoord Coordinate address of the cell to update
53
- * @param PHPExcel_Cell $cell Cell to update
54
- * @return PHPExcel_Cell
55
- * @throws PHPExcel_Exception
56
- */
57
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
58
- {
59
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
60
- $this->storeData();
61
- }
62
-
63
- $this->currentObjectID = $pCoord;
64
- $this->currentObject = $cell;
65
- $this->currentCellIsDirty = true;
66
-
67
- return $cell;
68
- } // function addCacheData()
69
-
70
-
71
- /**
72
- * Get cell at a specific coordinate
73
- *
74
- * @param string $pCoord Coordinate of the cell
75
- * @throws PHPExcel_Exception
76
- * @return PHPExcel_Cell Cell that was found, or null if not found
77
- */
78
- public function getCacheData($pCoord)
79
- {
80
- if ($pCoord === $this->currentObjectID) {
81
- return $this->currentObject;
82
- }
83
- $this->storeData();
84
-
85
- // Check if the entry that has been requested actually exists
86
- if (!isset($this->cellCache[$pCoord])) {
87
- // Return null if requested entry doesn't exist in cache
88
- return null;
89
- }
90
-
91
- // Set current entry to the requested entry
92
- $this->currentObjectID = $pCoord;
93
- $this->currentObject = igbinary_unserialize($this->cellCache[$pCoord]);
94
- // Re-attach this as the cell's parent
95
- $this->currentObject->attach($this);
96
-
97
- // Return requested entry
98
- return $this->currentObject;
99
- } // function getCacheData()
100
-
101
-
102
- /**
103
- * Get a list of all cell addresses currently held in cache
104
- *
105
- * @return string[]
106
- */
107
- public function getCellList()
108
- {
109
- if ($this->currentObjectID !== null) {
110
- $this->storeData();
111
- }
112
-
113
- return parent::getCellList();
114
- }
115
-
116
-
117
- /**
118
- * Clear the cell collection and disconnect from our parent
119
- *
120
- * @return void
121
- */
122
- public function unsetWorksheetCells()
123
- {
124
- if (!is_null($this->currentObject)) {
125
- $this->currentObject->detach();
126
- $this->currentObject = $this->currentObjectID = null;
127
- }
128
- $this->cellCache = array();
129
-
130
- // detach ourself from the worksheet, so that it can then delete this object successfully
131
- $this->parent = null;
132
- } // function unsetWorksheetCells()
133
-
134
-
135
- /**
136
- * Identify whether the caching method is currently available
137
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
138
- *
139
- * @return boolean
140
- */
141
- public static function cacheMethodIsAvailable()
142
- {
143
- if (!function_exists('igbinary_serialize')) {
144
- return false;
145
- }
146
-
147
- return true;
148
- }
149
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/Memcache.php DELETED
@@ -1,308 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_Memcache
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_Memcache extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Prefix used to uniquely identify cache data for this worksheet
32
- *
33
- * @var string
34
- */
35
- private $cachePrefix = null;
36
-
37
- /**
38
- * Cache timeout
39
- *
40
- * @var integer
41
- */
42
- private $cacheTime = 600;
43
-
44
- /**
45
- * Memcache interface
46
- *
47
- * @var resource
48
- */
49
- private $memcache = null;
50
-
51
-
52
- /**
53
- * Store cell data in cache for the current cell object if it's "dirty",
54
- * and the 'nullify' the current cell object
55
- *
56
- * @return void
57
- * @throws PHPExcel_Exception
58
- */
59
- protected function storeData()
60
- {
61
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
62
- $this->currentObject->detach();
63
-
64
- $obj = serialize($this->currentObject);
65
- if (!$this->memcache->replace($this->cachePrefix . $this->currentObjectID . '.cache', $obj, null, $this->cacheTime)) {
66
- if (!$this->memcache->add($this->cachePrefix . $this->currentObjectID . '.cache', $obj, null, $this->cacheTime)) {
67
- $this->__destruct();
68
- throw new PHPExcel_Exception("Failed to store cell {$this->currentObjectID} in MemCache");
69
- }
70
- }
71
- $this->currentCellIsDirty = false;
72
- }
73
- $this->currentObjectID = $this->currentObject = null;
74
- } // function _storeData()
75
-
76
-
77
- /**
78
- * Add or Update a cell in cache identified by coordinate address
79
- *
80
- * @param string $pCoord Coordinate address of the cell to update
81
- * @param PHPExcel_Cell $cell Cell to update
82
- * @return PHPExcel_Cell
83
- * @throws PHPExcel_Exception
84
- */
85
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
86
- {
87
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
88
- $this->storeData();
89
- }
90
- $this->cellCache[$pCoord] = true;
91
-
92
- $this->currentObjectID = $pCoord;
93
- $this->currentObject = $cell;
94
- $this->currentCellIsDirty = true;
95
-
96
- return $cell;
97
- } // function addCacheData()
98
-
99
-
100
- /**
101
- * Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
102
- *
103
- * @param string $pCoord Coordinate address of the cell to check
104
- * @return boolean
105
- * @return boolean
106
- */
107
- public function isDataSet($pCoord)
108
- {
109
- // Check if the requested entry is the current object, or exists in the cache
110
- if (parent::isDataSet($pCoord)) {
111
- if ($this->currentObjectID == $pCoord) {
112
- return true;
113
- }
114
- // Check if the requested entry still exists in Memcache
115
- $success = $this->memcache->get($this->cachePrefix.$pCoord.'.cache');
116
- if ($success === false) {
117
- // Entry no longer exists in Memcache, so clear it from the cache array
118
- parent::deleteCacheData($pCoord);
119
- throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in MemCache');
120
- }
121
- return true;
122
- }
123
- return false;
124
- }
125
-
126
-
127
- /**
128
- * Get cell at a specific coordinate
129
- *
130
- * @param string $pCoord Coordinate of the cell
131
- * @throws PHPExcel_Exception
132
- * @return PHPExcel_Cell Cell that was found, or null if not found
133
- */
134
- public function getCacheData($pCoord)
135
- {
136
- if ($pCoord === $this->currentObjectID) {
137
- return $this->currentObject;
138
- }
139
- $this->storeData();
140
-
141
- // Check if the entry that has been requested actually exists
142
- if (parent::isDataSet($pCoord)) {
143
- $obj = $this->memcache->get($this->cachePrefix . $pCoord . '.cache');
144
- if ($obj === false) {
145
- // Entry no longer exists in Memcache, so clear it from the cache array
146
- parent::deleteCacheData($pCoord);
147
- throw new PHPExcel_Exception("Cell entry {$pCoord} no longer exists in MemCache");
148
- }
149
- } else {
150
- // Return null if requested entry doesn't exist in cache
151
- return null;
152
- }
153
-
154
- // Set current entry to the requested entry
155
- $this->currentObjectID = $pCoord;
156
- $this->currentObject = unserialize($obj);
157
- // Re-attach this as the cell's parent
158
- $this->currentObject->attach($this);
159
-
160
- // Return requested entry
161
- return $this->currentObject;
162
- }
163
-
164
- /**
165
- * Get a list of all cell addresses currently held in cache
166
- *
167
- * @return string[]
168
- */
169
- public function getCellList()
170
- {
171
- if ($this->currentObjectID !== null) {
172
- $this->storeData();
173
- }
174
-
175
- return parent::getCellList();
176
- }
177
-
178
- /**
179
- * Delete a cell in cache identified by coordinate address
180
- *
181
- * @param string $pCoord Coordinate address of the cell to delete
182
- * @throws PHPExcel_Exception
183
- */
184
- public function deleteCacheData($pCoord)
185
- {
186
- // Delete the entry from Memcache
187
- $this->memcache->delete($this->cachePrefix . $pCoord . '.cache');
188
-
189
- // Delete the entry from our cell address array
190
- parent::deleteCacheData($pCoord);
191
- }
192
-
193
- /**
194
- * Clone the cell collection
195
- *
196
- * @param PHPExcel_Worksheet $parent The new worksheet
197
- * @return void
198
- */
199
- public function copyCellCollection(PHPExcel_Worksheet $parent)
200
- {
201
- parent::copyCellCollection($parent);
202
- // Get a new id for the new file name
203
- $baseUnique = $this->getUniqueID();
204
- $newCachePrefix = substr(md5($baseUnique), 0, 8) . '.';
205
- $cacheList = $this->getCellList();
206
- foreach ($cacheList as $cellID) {
207
- if ($cellID != $this->currentObjectID) {
208
- $obj = $this->memcache->get($this->cachePrefix.$cellID.'.cache');
209
- if ($obj === false) {
210
- // Entry no longer exists in Memcache, so clear it from the cache array
211
- parent::deleteCacheData($cellID);
212
- throw new PHPExcel_Exception("Cell entry {$cellID} no longer exists in MemCache");
213
- }
214
- if (!$this->memcache->add($newCachePrefix . $cellID . '.cache', $obj, null, $this->cacheTime)) {
215
- $this->__destruct();
216
- throw new PHPExcel_Exception("Failed to store cell {$cellID} in MemCache");
217
- }
218
- }
219
- }
220
- $this->cachePrefix = $newCachePrefix;
221
- }
222
-
223
- /**
224
- * Clear the cell collection and disconnect from our parent
225
- *
226
- * @return void
227
- */
228
- public function unsetWorksheetCells()
229
- {
230
- if (!is_null($this->currentObject)) {
231
- $this->currentObject->detach();
232
- $this->currentObject = $this->currentObjectID = null;
233
- }
234
-
235
- // Flush the Memcache cache
236
- $this->__destruct();
237
-
238
- $this->cellCache = array();
239
-
240
- // detach ourself from the worksheet, so that it can then delete this object successfully
241
- $this->parent = null;
242
- }
243
-
244
- /**
245
- * Initialise this new cell collection
246
- *
247
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
248
- * @param array of mixed $arguments Additional initialisation arguments
249
- */
250
- public function __construct(PHPExcel_Worksheet $parent, $arguments)
251
- {
252
- $memcacheServer = (isset($arguments['memcacheServer'])) ? $arguments['memcacheServer'] : 'localhost';
253
- $memcachePort = (isset($arguments['memcachePort'])) ? $arguments['memcachePort'] : 11211;
254
- $cacheTime = (isset($arguments['cacheTime'])) ? $arguments['cacheTime'] : 600;
255
-
256
- if (is_null($this->cachePrefix)) {
257
- $baseUnique = $this->getUniqueID();
258
- $this->cachePrefix = substr(md5($baseUnique), 0, 8) . '.';
259
-
260
- // Set a new Memcache object and connect to the Memcache server
261
- $this->memcache = new Memcache();
262
- if (!$this->memcache->addServer($memcacheServer, $memcachePort, false, 50, 5, 5, true, array($this, 'failureCallback'))) {
263
- throw new PHPExcel_Exception("Could not connect to MemCache server at {$memcacheServer}:{$memcachePort}");
264
- }
265
- $this->cacheTime = $cacheTime;
266
-
267
- parent::__construct($parent);
268
- }
269
- }
270
-
271
- /**
272
- * Memcache error handler
273
- *
274
- * @param string $host Memcache server
275
- * @param integer $port Memcache port
276
- * @throws PHPExcel_Exception
277
- */
278
- public function failureCallback($host, $port)
279
- {
280
- throw new PHPExcel_Exception("memcache {$host}:{$port} failed");
281
- }
282
-
283
- /**
284
- * Destroy this cell collection
285
- */
286
- public function __destruct()
287
- {
288
- $cacheList = $this->getCellList();
289
- foreach ($cacheList as $cellID) {
290
- $this->memcache->delete($this->cachePrefix.$cellID . '.cache');
291
- }
292
- }
293
-
294
- /**
295
- * Identify whether the caching method is currently available
296
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
297
- *
298
- * @return boolean
299
- */
300
- public static function cacheMethodIsAvailable()
301
- {
302
- if (!function_exists('memcache_add')) {
303
- return false;
304
- }
305
-
306
- return true;
307
- }
308
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/Memory.php DELETED
@@ -1,118 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_Memory
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_Memory extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Dummy method callable from CacheBase, but unused by Memory cache
32
- *
33
- * @return void
34
- */
35
- protected function storeData()
36
- {
37
- }
38
-
39
- /**
40
- * Add or Update a cell in cache identified by coordinate address
41
- *
42
- * @param string $pCoord Coordinate address of the cell to update
43
- * @param PHPExcel_Cell $cell Cell to update
44
- * @return PHPExcel_Cell
45
- * @throws PHPExcel_Exception
46
- */
47
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
48
- {
49
- $this->cellCache[$pCoord] = $cell;
50
-
51
- // Set current entry to the new/updated entry
52
- $this->currentObjectID = $pCoord;
53
-
54
- return $cell;
55
- }
56
-
57
-
58
- /**
59
- * Get cell at a specific coordinate
60
- *
61
- * @param string $pCoord Coordinate of the cell
62
- * @throws PHPExcel_Exception
63
- * @return PHPExcel_Cell Cell that was found, or null if not found
64
- */
65
- public function getCacheData($pCoord)
66
- {
67
- // Check if the entry that has been requested actually exists
68
- if (!isset($this->cellCache[$pCoord])) {
69
- $this->currentObjectID = null;
70
- // Return null if requested entry doesn't exist in cache
71
- return null;
72
- }
73
-
74
- // Set current entry to the requested entry
75
- $this->currentObjectID = $pCoord;
76
-
77
- // Return requested entry
78
- return $this->cellCache[$pCoord];
79
- }
80
-
81
-
82
- /**
83
- * Clone the cell collection
84
- *
85
- * @param PHPExcel_Worksheet $parent The new worksheet
86
- */
87
- public function copyCellCollection(PHPExcel_Worksheet $parent)
88
- {
89
- parent::copyCellCollection($parent);
90
-
91
- $newCollection = array();
92
- foreach ($this->cellCache as $k => &$cell) {
93
- $newCollection[$k] = clone $cell;
94
- $newCollection[$k]->attach($this);
95
- }
96
-
97
- $this->cellCache = $newCollection;
98
- }
99
-
100
- /**
101
- * Clear the cell collection and disconnect from our parent
102
- *
103
- */
104
- public function unsetWorksheetCells()
105
- {
106
- // Because cells are all stored as intact objects in memory, we need to detach each one from the parent
107
- foreach ($this->cellCache as $k => &$cell) {
108
- $cell->detach();
109
- $this->cellCache[$k] = null;
110
- }
111
- unset($cell);
112
-
113
- $this->cellCache = array();
114
-
115
- // detach ourself from the worksheet, so that it can then delete this object successfully
116
- $this->parent = null;
117
- }
118
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/MemoryGZip.php DELETED
@@ -1,133 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_MemoryGZip
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_MemoryGZip extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Store cell data in cache for the current cell object if it's "dirty",
32
- * and the 'nullify' the current cell object
33
- *
34
- * @return void
35
- * @throws PHPExcel_Exception
36
- */
37
- protected function storeData()
38
- {
39
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
40
- $this->currentObject->detach();
41
-
42
- $this->cellCache[$this->currentObjectID] = gzdeflate(serialize($this->currentObject));
43
- $this->currentCellIsDirty = false;
44
- }
45
- $this->currentObjectID = $this->currentObject = null;
46
- }
47
-
48
-
49
- /**
50
- * Add or Update a cell in cache identified by coordinate address
51
- *
52
- * @param string $pCoord Coordinate address of the cell to update
53
- * @param PHPExcel_Cell $cell Cell to update
54
- * @return PHPExcel_Cell
55
- * @throws PHPExcel_Exception
56
- */
57
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
58
- {
59
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
60
- $this->storeData();
61
- }
62
-
63
- $this->currentObjectID = $pCoord;
64
- $this->currentObject = $cell;
65
- $this->currentCellIsDirty = true;
66
-
67
- return $cell;
68
- }
69
-
70
-
71
- /**
72
- * Get cell at a specific coordinate
73
- *
74
- * @param string $pCoord Coordinate of the cell
75
- * @throws PHPExcel_Exception
76
- * @return PHPExcel_Cell Cell that was found, or null if not found
77
- */
78
- public function getCacheData($pCoord)
79
- {
80
- if ($pCoord === $this->currentObjectID) {
81
- return $this->currentObject;
82
- }
83
- $this->storeData();
84
-
85
- // Check if the entry that has been requested actually exists
86
- if (!isset($this->cellCache[$pCoord])) {
87
- // Return null if requested entry doesn't exist in cache
88
- return null;
89
- }
90
-
91
- // Set current entry to the requested entry
92
- $this->currentObjectID = $pCoord;
93
- $this->currentObject = unserialize(gzinflate($this->cellCache[$pCoord]));
94
- // Re-attach this as the cell's parent
95
- $this->currentObject->attach($this);
96
-
97
- // Return requested entry
98
- return $this->currentObject;
99
- }
100
-
101
-
102
- /**
103
- * Get a list of all cell addresses currently held in cache
104
- *
105
- * @return string[]
106
- */
107
- public function getCellList()
108
- {
109
- if ($this->currentObjectID !== null) {
110
- $this->storeData();
111
- }
112
-
113
- return parent::getCellList();
114
- }
115
-
116
-
117
- /**
118
- * Clear the cell collection and disconnect from our parent
119
- *
120
- * @return void
121
- */
122
- public function unsetWorksheetCells()
123
- {
124
- if (!is_null($this->currentObject)) {
125
- $this->currentObject->detach();
126
- $this->currentObject = $this->currentObjectID = null;
127
- }
128
- $this->cellCache = array();
129
-
130
- // detach ourself from the worksheet, so that it can then delete this object successfully
131
- $this->parent = null;
132
- }
133
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/MemorySerialized.php DELETED
@@ -1,129 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_MemorySerialized
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_MemorySerialized extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Store cell data in cache for the current cell object if it's "dirty",
32
- * and the 'nullify' the current cell object
33
- *
34
- * @return void
35
- * @throws PHPExcel_Exception
36
- */
37
- protected function storeData()
38
- {
39
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
40
- $this->currentObject->detach();
41
-
42
- $this->cellCache[$this->currentObjectID] = serialize($this->currentObject);
43
- $this->currentCellIsDirty = false;
44
- }
45
- $this->currentObjectID = $this->currentObject = null;
46
- }
47
-
48
- /**
49
- * Add or Update a cell in cache identified by coordinate address
50
- *
51
- * @param string $pCoord Coordinate address of the cell to update
52
- * @param PHPExcel_Cell $cell Cell to update
53
- * @return PHPExcel_Cell
54
- * @throws PHPExcel_Exception
55
- */
56
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
57
- {
58
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
59
- $this->storeData();
60
- }
61
-
62
- $this->currentObjectID = $pCoord;
63
- $this->currentObject = $cell;
64
- $this->currentCellIsDirty = true;
65
-
66
- return $cell;
67
- }
68
-
69
- /**
70
- * Get cell at a specific coordinate
71
- *
72
- * @param string $pCoord Coordinate of the cell
73
- * @throws PHPExcel_Exception
74
- * @return PHPExcel_Cell Cell that was found, or null if not found
75
- */
76
- public function getCacheData($pCoord)
77
- {
78
- if ($pCoord === $this->currentObjectID) {
79
- return $this->currentObject;
80
- }
81
- $this->storeData();
82
-
83
- // Check if the entry that has been requested actually exists
84
- if (!isset($this->cellCache[$pCoord])) {
85
- // Return null if requested entry doesn't exist in cache
86
- return null;
87
- }
88
-
89
- // Set current entry to the requested entry
90
- $this->currentObjectID = $pCoord;
91
- $this->currentObject = unserialize($this->cellCache[$pCoord]);
92
- // Re-attach this as the cell's parent
93
- $this->currentObject->attach($this);
94
-
95
- // Return requested entry
96
- return $this->currentObject;
97
- }
98
-
99
- /**
100
- * Get a list of all cell addresses currently held in cache
101
- *
102
- * @return string[]
103
- */
104
- public function getCellList()
105
- {
106
- if ($this->currentObjectID !== null) {
107
- $this->storeData();
108
- }
109
-
110
- return parent::getCellList();
111
- }
112
-
113
- /**
114
- * Clear the cell collection and disconnect from our parent
115
- *
116
- * @return void
117
- */
118
- public function unsetWorksheetCells()
119
- {
120
- if (!is_null($this->currentObject)) {
121
- $this->currentObject->detach();
122
- $this->currentObject = $this->currentObjectID = null;
123
- }
124
- $this->cellCache = array();
125
-
126
- // detach ourself from the worksheet, so that it can then delete this object successfully
127
- $this->parent = null;
128
- }
129
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/PHPTemp.php DELETED
@@ -1,200 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_PHPTemp
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_PHPTemp extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Name of the file for this cache
32
- *
33
- * @var string
34
- */
35
- private $fileHandle = null;
36
-
37
- /**
38
- * Memory limit to use before reverting to file cache
39
- *
40
- * @var integer
41
- */
42
- private $memoryCacheSize = null;
43
-
44
- /**
45
- * Store cell data in cache for the current cell object if it's "dirty",
46
- * and the 'nullify' the current cell object
47
- *
48
- * @return void
49
- * @throws PHPExcel_Exception
50
- */
51
- protected function storeData()
52
- {
53
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
54
- $this->currentObject->detach();
55
-
56
- fseek($this->fileHandle, 0, SEEK_END);
57
-
58
- $this->cellCache[$this->currentObjectID] = array(
59
- 'ptr' => ftell($this->fileHandle),
60
- 'sz' => fwrite($this->fileHandle, serialize($this->currentObject))
61
- );
62
- $this->currentCellIsDirty = false;
63
- }
64
- $this->currentObjectID = $this->currentObject = null;
65
- }
66
-
67
-
68
- /**
69
- * Add or Update a cell in cache identified by coordinate address
70
- *
71
- * @param string $pCoord Coordinate address of the cell to update
72
- * @param PHPExcel_Cell $cell Cell to update
73
- * @return PHPExcel_Cell
74
- * @throws PHPExcel_Exception
75
- */
76
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
77
- {
78
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
79
- $this->storeData();
80
- }
81
-
82
- $this->currentObjectID = $pCoord;
83
- $this->currentObject = $cell;
84
- $this->currentCellIsDirty = true;
85
-
86
- return $cell;
87
- }
88
-
89
-
90
- /**
91
- * Get cell at a specific coordinate
92
- *
93
- * @param string $pCoord Coordinate of the cell
94
- * @throws PHPExcel_Exception
95
- * @return PHPExcel_Cell Cell that was found, or null if not found
96
- */
97
- public function getCacheData($pCoord)
98
- {
99
- if ($pCoord === $this->currentObjectID) {
100
- return $this->currentObject;
101
- }
102
- $this->storeData();
103
-
104
- // Check if the entry that has been requested actually exists
105
- if (!isset($this->cellCache[$pCoord])) {
106
- // Return null if requested entry doesn't exist in cache
107
- return null;
108
- }
109
-
110
- // Set current entry to the requested entry
111
- $this->currentObjectID = $pCoord;
112
- fseek($this->fileHandle, $this->cellCache[$pCoord]['ptr']);
113
- $this->currentObject = unserialize(fread($this->fileHandle, $this->cellCache[$pCoord]['sz']));
114
- // Re-attach this as the cell's parent
115
- $this->currentObject->attach($this);
116
-
117
- // Return requested entry
118
- return $this->currentObject;
119
- }
120
-
121
- /**
122
- * Get a list of all cell addresses currently held in cache
123
- *
124
- * @return string[]
125
- */
126
- public function getCellList()
127
- {
128
- if ($this->currentObjectID !== null) {
129
- $this->storeData();
130
- }
131
-
132
- return parent::getCellList();
133
- }
134
-
135
- /**
136
- * Clone the cell collection
137
- *
138
- * @param PHPExcel_Worksheet $parent The new worksheet
139
- * @return void
140
- */
141
- public function copyCellCollection(PHPExcel_Worksheet $parent)
142
- {
143
- parent::copyCellCollection($parent);
144
- // Open a new stream for the cell cache data
145
- $newFileHandle = fopen('php://temp/maxmemory:' . $this->memoryCacheSize, 'a+');
146
- // Copy the existing cell cache data to the new stream
147
- fseek($this->fileHandle, 0);
148
- while (!feof($this->fileHandle)) {
149
- fwrite($newFileHandle, fread($this->fileHandle, 1024));
150
- }
151
- $this->fileHandle = $newFileHandle;
152
- }
153
-
154
- /**
155
- * Clear the cell collection and disconnect from our parent
156
- *
157
- * @return void
158
- */
159
- public function unsetWorksheetCells()
160
- {
161
- if (!is_null($this->currentObject)) {
162
- $this->currentObject->detach();
163
- $this->currentObject = $this->currentObjectID = null;
164
- }
165
- $this->cellCache = array();
166
-
167
- // detach ourself from the worksheet, so that it can then delete this object successfully
168
- $this->parent = null;
169
-
170
- // Close down the php://temp file
171
- $this->__destruct();
172
- }
173
-
174
- /**
175
- * Initialise this new cell collection
176
- *
177
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
178
- * @param array of mixed $arguments Additional initialisation arguments
179
- */
180
- public function __construct(PHPExcel_Worksheet $parent, $arguments)
181
- {
182
- $this->memoryCacheSize = (isset($arguments['memoryCacheSize'])) ? $arguments['memoryCacheSize'] : '1MB';
183
-
184
- parent::__construct($parent);
185
- if (is_null($this->fileHandle)) {
186
- $this->fileHandle = fopen('php://temp/maxmemory:' . $this->memoryCacheSize, 'a+');
187
- }
188
- }
189
-
190
- /**
191
- * Destroy this cell collection
192
- */
193
- public function __destruct()
194
- {
195
- if (!is_null($this->fileHandle)) {
196
- fclose($this->fileHandle);
197
- }
198
- $this->fileHandle = null;
199
- }
200
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/SQLite.php DELETED
@@ -1,307 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_SQLite
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_SQLite extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Database table name
32
- *
33
- * @var string
34
- */
35
- private $TableName = null;
36
-
37
- /**
38
- * Database handle
39
- *
40
- * @var resource
41
- */
42
- private $DBHandle = null;
43
-
44
- /**
45
- * Store cell data in cache for the current cell object if it's "dirty",
46
- * and the 'nullify' the current cell object
47
- *
48
- * @return void
49
- * @throws PHPExcel_Exception
50
- */
51
- protected function storeData()
52
- {
53
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
54
- $this->currentObject->detach();
55
-
56
- if (!$this->DBHandle->queryExec("INSERT OR REPLACE INTO kvp_".$this->TableName." VALUES('".$this->currentObjectID."','".sqlite_escape_string(serialize($this->currentObject))."')")) {
57
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
58
- }
59
- $this->currentCellIsDirty = false;
60
- }
61
- $this->currentObjectID = $this->currentObject = null;
62
- }
63
-
64
- /**
65
- * Add or Update a cell in cache identified by coordinate address
66
- *
67
- * @param string $pCoord Coordinate address of the cell to update
68
- * @param PHPExcel_Cell $cell Cell to update
69
- * @return PHPExcel_Cell
70
- * @throws PHPExcel_Exception
71
- */
72
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
73
- {
74
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
75
- $this->storeData();
76
- }
77
-
78
- $this->currentObjectID = $pCoord;
79
- $this->currentObject = $cell;
80
- $this->currentCellIsDirty = true;
81
-
82
- return $cell;
83
- }
84
-
85
- /**
86
- * Get cell at a specific coordinate
87
- *
88
- * @param string $pCoord Coordinate of the cell
89
- * @throws PHPExcel_Exception
90
- * @return PHPExcel_Cell Cell that was found, or null if not found
91
- */
92
- public function getCacheData($pCoord)
93
- {
94
- if ($pCoord === $this->currentObjectID) {
95
- return $this->currentObject;
96
- }
97
- $this->storeData();
98
-
99
- $query = "SELECT value FROM kvp_".$this->TableName." WHERE id='".$pCoord."'";
100
- $cellResultSet = $this->DBHandle->query($query, SQLITE_ASSOC);
101
- if ($cellResultSet === false) {
102
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
103
- } elseif ($cellResultSet->numRows() == 0) {
104
- // Return null if requested entry doesn't exist in cache
105
- return null;
106
- }
107
-
108
- // Set current entry to the requested entry
109
- $this->currentObjectID = $pCoord;
110
-
111
- $cellResult = $cellResultSet->fetchSingle();
112
- $this->currentObject = unserialize($cellResult);
113
- // Re-attach this as the cell's parent
114
- $this->currentObject->attach($this);
115
-
116
- // Return requested entry
117
- return $this->currentObject;
118
- }
119
-
120
- /**
121
- * Is a value set for an indexed cell?
122
- *
123
- * @param string $pCoord Coordinate address of the cell to check
124
- * @return boolean
125
- */
126
- public function isDataSet($pCoord)
127
- {
128
- if ($pCoord === $this->currentObjectID) {
129
- return true;
130
- }
131
-
132
- // Check if the requested entry exists in the cache
133
- $query = "SELECT id FROM kvp_".$this->TableName." WHERE id='".$pCoord."'";
134
- $cellResultSet = $this->DBHandle->query($query, SQLITE_ASSOC);
135
- if ($cellResultSet === false) {
136
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
137
- } elseif ($cellResultSet->numRows() == 0) {
138
- // Return null if requested entry doesn't exist in cache
139
- return false;
140
- }
141
- return true;
142
- }
143
-
144
- /**
145
- * Delete a cell in cache identified by coordinate address
146
- *
147
- * @param string $pCoord Coordinate address of the cell to delete
148
- * @throws PHPExcel_Exception
149
- */
150
- public function deleteCacheData($pCoord)
151
- {
152
- if ($pCoord === $this->currentObjectID) {
153
- $this->currentObject->detach();
154
- $this->currentObjectID = $this->currentObject = null;
155
- }
156
-
157
- // Check if the requested entry exists in the cache
158
- $query = "DELETE FROM kvp_".$this->TableName." WHERE id='".$pCoord."'";
159
- if (!$this->DBHandle->queryExec($query)) {
160
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
161
- }
162
-
163
- $this->currentCellIsDirty = false;
164
- }
165
-
166
- /**
167
- * Move a cell object from one address to another
168
- *
169
- * @param string $fromAddress Current address of the cell to move
170
- * @param string $toAddress Destination address of the cell to move
171
- * @return boolean
172
- */
173
- public function moveCell($fromAddress, $toAddress)
174
- {
175
- if ($fromAddress === $this->currentObjectID) {
176
- $this->currentObjectID = $toAddress;
177
- }
178
-
179
- $query = "DELETE FROM kvp_".$this->TableName." WHERE id='".$toAddress."'";
180
- $result = $this->DBHandle->exec($query);
181
- if ($result === false) {
182
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
183
- }
184
-
185
- $query = "UPDATE kvp_".$this->TableName." SET id='".$toAddress."' WHERE id='".$fromAddress."'";
186
- $result = $this->DBHandle->exec($query);
187
- if ($result === false) {
188
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
189
- }
190
-
191
- return true;
192
- }
193
-
194
- /**
195
- * Get a list of all cell addresses currently held in cache
196
- *
197
- * @return string[]
198
- */
199
- public function getCellList()
200
- {
201
- if ($this->currentObjectID !== null) {
202
- $this->storeData();
203
- }
204
-
205
- $query = "SELECT id FROM kvp_".$this->TableName;
206
- $cellIdsResult = $this->DBHandle->unbufferedQuery($query, SQLITE_ASSOC);
207
- if ($cellIdsResult === false) {
208
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
209
- }
210
-
211
- $cellKeys = array();
212
- foreach ($cellIdsResult as $row) {
213
- $cellKeys[] = $row['id'];
214
- }
215
-
216
- return $cellKeys;
217
- }
218
-
219
- /**
220
- * Clone the cell collection
221
- *
222
- * @param PHPExcel_Worksheet $parent The new worksheet
223
- * @return void
224
- */
225
- public function copyCellCollection(PHPExcel_Worksheet $parent)
226
- {
227
- $this->currentCellIsDirty;
228
- $this->storeData();
229
-
230
- // Get a new id for the new table name
231
- $tableName = str_replace('.', '_', $this->getUniqueID());
232
- if (!$this->DBHandle->queryExec('CREATE TABLE kvp_'.$tableName.' (id VARCHAR(12) PRIMARY KEY, value BLOB)
233
- AS SELECT * FROM kvp_'.$this->TableName)
234
- ) {
235
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
236
- }
237
-
238
- // Copy the existing cell cache file
239
- $this->TableName = $tableName;
240
- }
241
-
242
- /**
243
- * Clear the cell collection and disconnect from our parent
244
- *
245
- * @return void
246
- */
247
- public function unsetWorksheetCells()
248
- {
249
- if (!is_null($this->currentObject)) {
250
- $this->currentObject->detach();
251
- $this->currentObject = $this->currentObjectID = null;
252
- }
253
- // detach ourself from the worksheet, so that it can then delete this object successfully
254
- $this->parent = null;
255
-
256
- // Close down the temporary cache file
257
- $this->__destruct();
258
- }
259
-
260
- /**
261
- * Initialise this new cell collection
262
- *
263
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
264
- */
265
- public function __construct(PHPExcel_Worksheet $parent)
266
- {
267
- parent::__construct($parent);
268
- if (is_null($this->DBHandle)) {
269
- $this->TableName = str_replace('.', '_', $this->getUniqueID());
270
- $_DBName = ':memory:';
271
-
272
- $this->DBHandle = new SQLiteDatabase($_DBName);
273
- if ($this->DBHandle === false) {
274
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
275
- }
276
- if (!$this->DBHandle->queryExec('CREATE TABLE kvp_'.$this->TableName.' (id VARCHAR(12) PRIMARY KEY, value BLOB)')) {
277
- throw new PHPExcel_Exception(sqlite_error_string($this->DBHandle->lastError()));
278
- }
279
- }
280
- }
281
-
282
- /**
283
- * Destroy this cell collection
284
- */
285
- public function __destruct()
286
- {
287
- if (!is_null($this->DBHandle)) {
288
- $this->DBHandle->queryExec('DROP TABLE kvp_'.$this->TableName);
289
- }
290
- $this->DBHandle = null;
291
- }
292
-
293
- /**
294
- * Identify whether the caching method is currently available
295
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
296
- *
297
- * @return boolean
298
- */
299
- public static function cacheMethodIsAvailable()
300
- {
301
- if (!function_exists('sqlite_open')) {
302
- return false;
303
- }
304
-
305
- return true;
306
- }
307
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/SQLite3.php DELETED
@@ -1,346 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_SQLite3
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_SQLite3 extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Database table name
32
- *
33
- * @var string
34
- */
35
- private $TableName = null;
36
-
37
- /**
38
- * Database handle
39
- *
40
- * @var resource
41
- */
42
- private $DBHandle = null;
43
-
44
- /**
45
- * Prepared statement for a SQLite3 select query
46
- *
47
- * @var SQLite3Stmt
48
- */
49
- private $selectQuery;
50
-
51
- /**
52
- * Prepared statement for a SQLite3 insert query
53
- *
54
- * @var SQLite3Stmt
55
- */
56
- private $insertQuery;
57
-
58
- /**
59
- * Prepared statement for a SQLite3 update query
60
- *
61
- * @var SQLite3Stmt
62
- */
63
- private $updateQuery;
64
-
65
- /**
66
- * Prepared statement for a SQLite3 delete query
67
- *
68
- * @var SQLite3Stmt
69
- */
70
- private $deleteQuery;
71
-
72
- /**
73
- * Store cell data in cache for the current cell object if it's "dirty",
74
- * and the 'nullify' the current cell object
75
- *
76
- * @return void
77
- * @throws PHPExcel_Exception
78
- */
79
- protected function storeData()
80
- {
81
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
82
- $this->currentObject->detach();
83
-
84
- $this->insertQuery->bindValue('id', $this->currentObjectID, SQLITE3_TEXT);
85
- $this->insertQuery->bindValue('data', serialize($this->currentObject), SQLITE3_BLOB);
86
- $result = $this->insertQuery->execute();
87
- if ($result === false) {
88
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
89
- }
90
- $this->currentCellIsDirty = false;
91
- }
92
- $this->currentObjectID = $this->currentObject = null;
93
- }
94
-
95
- /**
96
- * Add or Update a cell in cache identified by coordinate address
97
- *
98
- * @param string $pCoord Coordinate address of the cell to update
99
- * @param PHPExcel_Cell $cell Cell to update
100
- * @return PHPExcel_Cell
101
- * @throws PHPExcel_Exception
102
- */
103
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
104
- {
105
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
106
- $this->storeData();
107
- }
108
-
109
- $this->currentObjectID = $pCoord;
110
- $this->currentObject = $cell;
111
- $this->currentCellIsDirty = true;
112
-
113
- return $cell;
114
- }
115
-
116
- /**
117
- * Get cell at a specific coordinate
118
- *
119
- * @param string $pCoord Coordinate of the cell
120
- * @throws PHPExcel_Exception
121
- * @return PHPExcel_Cell Cell that was found, or null if not found
122
- */
123
- public function getCacheData($pCoord)
124
- {
125
- if ($pCoord === $this->currentObjectID) {
126
- return $this->currentObject;
127
- }
128
- $this->storeData();
129
-
130
- $this->selectQuery->bindValue('id', $pCoord, SQLITE3_TEXT);
131
- $cellResult = $this->selectQuery->execute();
132
- if ($cellResult === false) {
133
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
134
- }
135
- $cellData = $cellResult->fetchArray(SQLITE3_ASSOC);
136
- if ($cellData === false) {
137
- // Return null if requested entry doesn't exist in cache
138
- return null;
139
- }
140
-
141
- // Set current entry to the requested entry
142
- $this->currentObjectID = $pCoord;
143
-
144
- $this->currentObject = unserialize($cellData['value']);
145
- // Re-attach this as the cell's parent
146
- $this->currentObject->attach($this);
147
-
148
- // Return requested entry
149
- return $this->currentObject;
150
- }
151
-
152
- /**
153
- * Is a value set for an indexed cell?
154
- *
155
- * @param string $pCoord Coordinate address of the cell to check
156
- * @return boolean
157
- */
158
- public function isDataSet($pCoord)
159
- {
160
- if ($pCoord === $this->currentObjectID) {
161
- return true;
162
- }
163
-
164
- // Check if the requested entry exists in the cache
165
- $this->selectQuery->bindValue('id', $pCoord, SQLITE3_TEXT);
166
- $cellResult = $this->selectQuery->execute();
167
- if ($cellResult === false) {
168
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
169
- }
170
- $cellData = $cellResult->fetchArray(SQLITE3_ASSOC);
171
-
172
- return ($cellData === false) ? false : true;
173
- }
174
-
175
- /**
176
- * Delete a cell in cache identified by coordinate address
177
- *
178
- * @param string $pCoord Coordinate address of the cell to delete
179
- * @throws PHPExcel_Exception
180
- */
181
- public function deleteCacheData($pCoord)
182
- {
183
- if ($pCoord === $this->currentObjectID) {
184
- $this->currentObject->detach();
185
- $this->currentObjectID = $this->currentObject = null;
186
- }
187
-
188
- // Check if the requested entry exists in the cache
189
- $this->deleteQuery->bindValue('id', $pCoord, SQLITE3_TEXT);
190
- $result = $this->deleteQuery->execute();
191
- if ($result === false) {
192
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
193
- }
194
-
195
- $this->currentCellIsDirty = false;
196
- }
197
-
198
- /**
199
- * Move a cell object from one address to another
200
- *
201
- * @param string $fromAddress Current address of the cell to move
202
- * @param string $toAddress Destination address of the cell to move
203
- * @return boolean
204
- */
205
- public function moveCell($fromAddress, $toAddress)
206
- {
207
- if ($fromAddress === $this->currentObjectID) {
208
- $this->currentObjectID = $toAddress;
209
- }
210
-
211
- $this->deleteQuery->bindValue('id', $toAddress, SQLITE3_TEXT);
212
- $result = $this->deleteQuery->execute();
213
- if ($result === false) {
214
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
215
- }
216
-
217
- $this->updateQuery->bindValue('toid', $toAddress, SQLITE3_TEXT);
218
- $this->updateQuery->bindValue('fromid', $fromAddress, SQLITE3_TEXT);
219
- $result = $this->updateQuery->execute();
220
- if ($result === false) {
221
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
222
- }
223
-
224
- return true;
225
- }
226
-
227
- /**
228
- * Get a list of all cell addresses currently held in cache
229
- *
230
- * @return string[]
231
- */
232
- public function getCellList()
233
- {
234
- if ($this->currentObjectID !== null) {
235
- $this->storeData();
236
- }
237
-
238
- $query = "SELECT id FROM kvp_".$this->TableName;
239
- $cellIdsResult = $this->DBHandle->query($query);
240
- if ($cellIdsResult === false) {
241
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
242
- }
243
-
244
- $cellKeys = array();
245
- while ($row = $cellIdsResult->fetchArray(SQLITE3_ASSOC)) {
246
- $cellKeys[] = $row['id'];
247
- }
248
-
249
- return $cellKeys;
250
- }
251
-
252
- /**
253
- * Clone the cell collection
254
- *
255
- * @param PHPExcel_Worksheet $parent The new worksheet
256
- * @return void
257
- */
258
- public function copyCellCollection(PHPExcel_Worksheet $parent)
259
- {
260
- $this->currentCellIsDirty;
261
- $this->storeData();
262
-
263
- // Get a new id for the new table name
264
- $tableName = str_replace('.', '_', $this->getUniqueID());
265
- if (!$this->DBHandle->exec('CREATE TABLE kvp_'.$tableName.' (id VARCHAR(12) PRIMARY KEY, value BLOB)
266
- AS SELECT * FROM kvp_'.$this->TableName)
267
- ) {
268
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
269
- }
270
-
271
- // Copy the existing cell cache file
272
- $this->TableName = $tableName;
273
- }
274
-
275
- /**
276
- * Clear the cell collection and disconnect from our parent
277
- *
278
- * @return void
279
- */
280
- public function unsetWorksheetCells()
281
- {
282
- if (!is_null($this->currentObject)) {
283
- $this->currentObject->detach();
284
- $this->currentObject = $this->currentObjectID = null;
285
- }
286
- // detach ourself from the worksheet, so that it can then delete this object successfully
287
- $this->parent = null;
288
-
289
- // Close down the temporary cache file
290
- $this->__destruct();
291
- }
292
-
293
- /**
294
- * Initialise this new cell collection
295
- *
296
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
297
- */
298
- public function __construct(PHPExcel_Worksheet $parent)
299
- {
300
- parent::__construct($parent);
301
- if (is_null($this->DBHandle)) {
302
- $this->TableName = str_replace('.', '_', $this->getUniqueID());
303
- $_DBName = ':memory:';
304
-
305
- $this->DBHandle = new SQLite3($_DBName);
306
- if ($this->DBHandle === false) {
307
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
308
- }
309
- if (!$this->DBHandle->exec('CREATE TABLE kvp_'.$this->TableName.' (id VARCHAR(12) PRIMARY KEY, value BLOB)')) {
310
- throw new PHPExcel_Exception($this->DBHandle->lastErrorMsg());
311
- }
312
- }
313
-
314
- $this->selectQuery = $this->DBHandle->prepare("SELECT value FROM kvp_".$this->TableName." WHERE id = :id");
315
- $this->insertQuery = $this->DBHandle->prepare("INSERT OR REPLACE INTO kvp_".$this->TableName." VALUES(:id,:data)");
316
- $this->updateQuery = $this->DBHandle->prepare("UPDATE kvp_".$this->TableName." SET id=:toId WHERE id=:fromId");
317
- $this->deleteQuery = $this->DBHandle->prepare("DELETE FROM kvp_".$this->TableName." WHERE id = :id");
318
- }
319
-
320
- /**
321
- * Destroy this cell collection
322
- */
323
- public function __destruct()
324
- {
325
- if (!is_null($this->DBHandle)) {
326
- $this->DBHandle->exec('DROP TABLE kvp_'.$this->TableName);
327
- $this->DBHandle->close();
328
- }
329
- $this->DBHandle = null;
330
- }
331
-
332
- /**
333
- * Identify whether the caching method is currently available
334
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
335
- *
336
- * @return boolean
337
- */
338
- public static function cacheMethodIsAvailable()
339
- {
340
- if (!class_exists('SQLite3', false)) {
341
- return false;
342
- }
343
-
344
- return true;
345
- }
346
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorage/Wincache.php DELETED
@@ -1,289 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorage_Wincache
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorage_Wincache extends PHPExcel_CachedObjectStorage_CacheBase implements PHPExcel_CachedObjectStorage_ICache
29
- {
30
- /**
31
- * Prefix used to uniquely identify cache data for this worksheet
32
- *
33
- * @var string
34
- */
35
- private $cachePrefix = null;
36
-
37
- /**
38
- * Cache timeout
39
- *
40
- * @var integer
41
- */
42
- private $cacheTime = 600;
43
-
44
-
45
- /**
46
- * Store cell data in cache for the current cell object if it's "dirty",
47
- * and the 'nullify' the current cell object
48
- *
49
- * @return void
50
- * @throws PHPExcel_Exception
51
- */
52
- protected function storeData()
53
- {
54
- if ($this->currentCellIsDirty && !empty($this->currentObjectID)) {
55
- $this->currentObject->detach();
56
-
57
- $obj = serialize($this->currentObject);
58
- if (wincache_ucache_exists($this->cachePrefix.$this->currentObjectID.'.cache')) {
59
- if (!wincache_ucache_set($this->cachePrefix.$this->currentObjectID.'.cache', $obj, $this->cacheTime)) {
60
- $this->__destruct();
61
- throw new PHPExcel_Exception('Failed to store cell '.$this->currentObjectID.' in WinCache');
62
- }
63
- } else {
64
- if (!wincache_ucache_add($this->cachePrefix.$this->currentObjectID.'.cache', $obj, $this->cacheTime)) {
65
- $this->__destruct();
66
- throw new PHPExcel_Exception('Failed to store cell '.$this->currentObjectID.' in WinCache');
67
- }
68
- }
69
- $this->currentCellIsDirty = false;
70
- }
71
-
72
- $this->currentObjectID = $this->currentObject = null;
73
- }
74
-
75
- /**
76
- * Add or Update a cell in cache identified by coordinate address
77
- *
78
- * @param string $pCoord Coordinate address of the cell to update
79
- * @param PHPExcel_Cell $cell Cell to update
80
- * @return PHPExcel_Cell
81
- * @throws PHPExcel_Exception
82
- */
83
- public function addCacheData($pCoord, PHPExcel_Cell $cell)
84
- {
85
- if (($pCoord !== $this->currentObjectID) && ($this->currentObjectID !== null)) {
86
- $this->storeData();
87
- }
88
- $this->cellCache[$pCoord] = true;
89
-
90
- $this->currentObjectID = $pCoord;
91
- $this->currentObject = $cell;
92
- $this->currentCellIsDirty = true;
93
-
94
- return $cell;
95
- }
96
-
97
- /**
98
- * Is a value set in the current PHPExcel_CachedObjectStorage_ICache for an indexed cell?
99
- *
100
- * @param string $pCoord Coordinate address of the cell to check
101
- * @return boolean
102
- */
103
- public function isDataSet($pCoord)
104
- {
105
- // Check if the requested entry is the current object, or exists in the cache
106
- if (parent::isDataSet($pCoord)) {
107
- if ($this->currentObjectID == $pCoord) {
108
- return true;
109
- }
110
- // Check if the requested entry still exists in cache
111
- $success = wincache_ucache_exists($this->cachePrefix.$pCoord.'.cache');
112
- if ($success === false) {
113
- // Entry no longer exists in Wincache, so clear it from the cache array
114
- parent::deleteCacheData($pCoord);
115
- throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in WinCache');
116
- }
117
- return true;
118
- }
119
- return false;
120
- }
121
-
122
-
123
- /**
124
- * Get cell at a specific coordinate
125
- *
126
- * @param string $pCoord Coordinate of the cell
127
- * @throws PHPExcel_Exception
128
- * @return PHPExcel_Cell Cell that was found, or null if not found
129
- */
130
- public function getCacheData($pCoord)
131
- {
132
- if ($pCoord === $this->currentObjectID) {
133
- return $this->currentObject;
134
- }
135
- $this->storeData();
136
-
137
- // Check if the entry that has been requested actually exists
138
- $obj = null;
139
- if (parent::isDataSet($pCoord)) {
140
- $success = false;
141
- $obj = wincache_ucache_get($this->cachePrefix.$pCoord.'.cache', $success);
142
- if ($success === false) {
143
- // Entry no longer exists in WinCache, so clear it from the cache array
144
- parent::deleteCacheData($pCoord);
145
- throw new PHPExcel_Exception('Cell entry '.$pCoord.' no longer exists in WinCache');
146
- }
147
- } else {
148
- // Return null if requested entry doesn't exist in cache
149
- return null;
150
- }
151
-
152
- // Set current entry to the requested entry
153
- $this->currentObjectID = $pCoord;
154
- $this->currentObject = unserialize($obj);
155
- // Re-attach this as the cell's parent
156
- $this->currentObject->attach($this);
157
-
158
- // Return requested entry
159
- return $this->currentObject;
160
- }
161
-
162
-
163
- /**
164
- * Get a list of all cell addresses currently held in cache
165
- *
166
- * @return string[]
167
- */
168
- public function getCellList()
169
- {
170
- if ($this->currentObjectID !== null) {
171
- $this->storeData();
172
- }
173
-
174
- return parent::getCellList();
175
- }
176
-
177
- /**
178
- * Delete a cell in cache identified by coordinate address
179
- *
180
- * @param string $pCoord Coordinate address of the cell to delete
181
- * @throws PHPExcel_Exception
182
- */
183
- public function deleteCacheData($pCoord)
184
- {
185
- // Delete the entry from Wincache
186
- wincache_ucache_delete($this->cachePrefix.$pCoord.'.cache');
187
-
188
- // Delete the entry from our cell address array
189
- parent::deleteCacheData($pCoord);
190
- }
191
-
192
- /**
193
- * Clone the cell collection
194
- *
195
- * @param PHPExcel_Worksheet $parent The new worksheet
196
- * @return void
197
- */
198
- public function copyCellCollection(PHPExcel_Worksheet $parent)
199
- {
200
- parent::copyCellCollection($parent);
201
- // Get a new id for the new file name
202
- $baseUnique = $this->getUniqueID();
203
- $newCachePrefix = substr(md5($baseUnique), 0, 8) . '.';
204
- $cacheList = $this->getCellList();
205
- foreach ($cacheList as $cellID) {
206
- if ($cellID != $this->currentObjectID) {
207
- $success = false;
208
- $obj = wincache_ucache_get($this->cachePrefix.$cellID.'.cache', $success);
209
- if ($success === false) {
210
- // Entry no longer exists in WinCache, so clear it from the cache array
211
- parent::deleteCacheData($cellID);
212
- throw new PHPExcel_Exception('Cell entry '.$cellID.' no longer exists in Wincache');
213
- }
214
- if (!wincache_ucache_add($newCachePrefix.$cellID.'.cache', $obj, $this->cacheTime)) {
215
- $this->__destruct();
216
- throw new PHPExcel_Exception('Failed to store cell '.$cellID.' in Wincache');
217
- }
218
- }
219
- }
220
- $this->cachePrefix = $newCachePrefix;
221
- }
222
-
223
-
224
- /**
225
- * Clear the cell collection and disconnect from our parent
226
- *
227
- * @return void
228
- */
229
- public function unsetWorksheetCells()
230
- {
231
- if (!is_null($this->currentObject)) {
232
- $this->currentObject->detach();
233
- $this->currentObject = $this->currentObjectID = null;
234
- }
235
-
236
- // Flush the WinCache cache
237
- $this->__destruct();
238
-
239
- $this->cellCache = array();
240
-
241
- // detach ourself from the worksheet, so that it can then delete this object successfully
242
- $this->parent = null;
243
- }
244
-
245
- /**
246
- * Initialise this new cell collection
247
- *
248
- * @param PHPExcel_Worksheet $parent The worksheet for this cell collection
249
- * @param array of mixed $arguments Additional initialisation arguments
250
- */
251
- public function __construct(PHPExcel_Worksheet $parent, $arguments)
252
- {
253
- $cacheTime = (isset($arguments['cacheTime'])) ? $arguments['cacheTime'] : 600;
254
-
255
- if (is_null($this->cachePrefix)) {
256
- $baseUnique = $this->getUniqueID();
257
- $this->cachePrefix = substr(md5($baseUnique), 0, 8).'.';
258
- $this->cacheTime = $cacheTime;
259
-
260
- parent::__construct($parent);
261
- }
262
- }
263
-
264
- /**
265
- * Destroy this cell collection
266
- */
267
- public function __destruct()
268
- {
269
- $cacheList = $this->getCellList();
270
- foreach ($cacheList as $cellID) {
271
- wincache_ucache_delete($this->cachePrefix.$cellID.'.cache');
272
- }
273
- }
274
-
275
- /**
276
- * Identify whether the caching method is currently available
277
- * Some methods are dependent on the availability of certain extensions being enabled in the PHP build
278
- *
279
- * @return boolean
280
- */
281
- public static function cacheMethodIsAvailable()
282
- {
283
- if (!function_exists('wincache_ucache_add')) {
284
- return false;
285
- }
286
-
287
- return true;
288
- }
289
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CachedObjectStorageFactory.php DELETED
@@ -1,231 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CachedObjectStorageFactory
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_CachedObjectStorage
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CachedObjectStorageFactory
29
- {
30
- const cache_in_memory = 'Memory';
31
- const cache_in_memory_gzip = 'MemoryGZip';
32
- const cache_in_memory_serialized = 'MemorySerialized';
33
- const cache_igbinary = 'Igbinary';
34
- const cache_to_discISAM = 'DiscISAM';
35
- const cache_to_apc = 'APC';
36
- const cache_to_memcache = 'Memcache';
37
- const cache_to_phpTemp = 'PHPTemp';
38
- const cache_to_wincache = 'Wincache';
39
- const cache_to_sqlite = 'SQLite';
40
- const cache_to_sqlite3 = 'SQLite3';
41
-
42
- /**
43
- * Name of the method used for cell cacheing
44
- *
45
- * @var string
46
- */
47
- private static $cacheStorageMethod = null;
48
-
49
- /**
50
- * Name of the class used for cell cacheing
51
- *
52
- * @var string
53
- */
54
- private static $cacheStorageClass = null;
55
-
56
- /**
57
- * List of all possible cache storage methods
58
- *
59
- * @var string[]
60
- */
61
- private static $storageMethods = array(
62
- self::cache_in_memory,
63
- self::cache_in_memory_gzip,
64
- self::cache_in_memory_serialized,
65
- self::cache_igbinary,
66
- self::cache_to_phpTemp,
67
- self::cache_to_discISAM,
68
- self::cache_to_apc,
69
- self::cache_to_memcache,
70
- self::cache_to_wincache,
71
- self::cache_to_sqlite,
72
- self::cache_to_sqlite3,
73
- );
74
-
75
- /**
76
- * Default arguments for each cache storage method
77
- *
78
- * @var array of mixed array
79
- */
80
- private static $storageMethodDefaultParameters = array(
81
- self::cache_in_memory => array(
82
- ),
83
- self::cache_in_memory_gzip => array(
84
- ),
85
- self::cache_in_memory_serialized => array(
86
- ),
87
- self::cache_igbinary => array(
88
- ),
89
- self::cache_to_phpTemp => array( 'memoryCacheSize' => '1MB'
90
- ),
91
- self::cache_to_discISAM => array( 'dir' => null
92
- ),
93
- self::cache_to_apc => array( 'cacheTime' => 600
94
- ),
95
- self::cache_to_memcache => array( 'memcacheServer' => 'localhost',
96
- 'memcachePort' => 11211,
97
- 'cacheTime' => 600
98
- ),
99
- self::cache_to_wincache => array( 'cacheTime' => 600
100
- ),
101
- self::cache_to_sqlite => array(
102
- ),
103
- self::cache_to_sqlite3 => array(
104
- ),
105
- );
106
-
107
- /**
108
- * Arguments for the active cache storage method
109
- *
110
- * @var array of mixed array
111
- */
112
- private static $storageMethodParameters = array();
113
-
114
- /**
115
- * Return the current cache storage method
116
- *
117
- * @return string|null
118
- **/
119
- public static function getCacheStorageMethod()
120
- {
121
- return self::$cacheStorageMethod;
122
- }
123
-
124
- /**
125
- * Return the current cache storage class
126
- *
127
- * @return PHPExcel_CachedObjectStorage_ICache|null
128
- **/
129
- public static function getCacheStorageClass()
130
- {
131
- return self::$cacheStorageClass;
132
- }
133
-
134
- /**
135
- * Return the list of all possible cache storage methods
136
- *
137
- * @return string[]
138
- **/
139
- public static function getAllCacheStorageMethods()
140
- {
141
- return self::$storageMethods;
142
- }
143
-
144
- /**
145
- * Return the list of all available cache storage methods
146
- *
147
- * @return string[]
148
- **/
149
- public static function getCacheStorageMethods()
150
- {
151
- $activeMethods = array();
152
- foreach (self::$storageMethods as $storageMethod) {
153
- $cacheStorageClass = 'PHPExcel_CachedObjectStorage_' . $storageMethod;
154
- if (call_user_func(array($cacheStorageClass, 'cacheMethodIsAvailable'))) {
155
- $activeMethods[] = $storageMethod;
156
- }
157
- }
158
- return $activeMethods;
159
- }
160
-
161
- /**
162
- * Identify the cache storage method to use
163
- *
164
- * @param string $method Name of the method to use for cell cacheing
165
- * @param array of mixed $arguments Additional arguments to pass to the cell caching class
166
- * when instantiating
167
- * @return boolean
168
- **/
169
- public static function initialize($method = self::cache_in_memory, $arguments = array())
170
- {
171
- if (!in_array($method, self::$storageMethods)) {
172
- return false;
173
- }
174
-
175
- $cacheStorageClass = 'PHPExcel_CachedObjectStorage_'.$method;
176
- if (!call_user_func(array( $cacheStorageClass,
177
- 'cacheMethodIsAvailable'))) {
178
- return false;
179
- }
180
-
181
- self::$storageMethodParameters[$method] = self::$storageMethodDefaultParameters[$method];
182
- foreach ($arguments as $k => $v) {
183
- if (array_key_exists($k, self::$storageMethodParameters[$method])) {
184
- self::$storageMethodParameters[$method][$k] = $v;
185
- }
186
- }
187
-
188
- if (self::$cacheStorageMethod === null) {
189
- self::$cacheStorageClass = 'PHPExcel_CachedObjectStorage_' . $method;
190
- self::$cacheStorageMethod = $method;
191
- }
192
- return true;
193
- }
194
-
195
- /**
196
- * Initialise the cache storage
197
- *
198
- * @param PHPExcel_Worksheet $parent Enable cell caching for this worksheet
199
- * @return PHPExcel_CachedObjectStorage_ICache
200
- **/
201
- public static function getInstance(PHPExcel_Worksheet $parent)
202
- {
203
- $cacheMethodIsAvailable = true;
204
- if (self::$cacheStorageMethod === null) {
205
- $cacheMethodIsAvailable = self::initialize();
206
- }
207
-
208
- if ($cacheMethodIsAvailable) {
209
- $instance = new self::$cacheStorageClass(
210
- $parent,
211
- self::$storageMethodParameters[self::$cacheStorageMethod]
212
- );
213
- if ($instance !== null) {
214
- return $instance;
215
- }
216
- }
217
-
218
- return false;
219
- }
220
-
221
- /**
222
- * Clear the cache storage
223
- *
224
- **/
225
- public static function finalize()
226
- {
227
- self::$cacheStorageMethod = null;
228
- self::$cacheStorageClass = null;
229
- self::$storageMethodParameters = array();
230
- }
231
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CalcEngine/CyclicReferenceStack.php DELETED
@@ -1,94 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CalcEngine_CyclicReferenceStack
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_Calculation
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CalcEngine_CyclicReferenceStack
29
- {
30
- /**
31
- * The call stack for calculated cells
32
- *
33
- * @var mixed[]
34
- */
35
- private $stack = array();
36
-
37
- /**
38
- * Return the number of entries on the stack
39
- *
40
- * @return integer
41
- */
42
- public function count()
43
- {
44
- return count($this->stack);
45
- }
46
-
47
- /**
48
- * Push a new entry onto the stack
49
- *
50
- * @param mixed $value
51
- */
52
- public function push($value)
53
- {
54
- $this->stack[$value] = $value;
55
- }
56
-
57
- /**
58
- * Pop the last entry from the stack
59
- *
60
- * @return mixed
61
- */
62
- public function pop()
63
- {
64
- return array_pop($this->stack);
65
- }
66
-
67
- /**
68
- * Test to see if a specified entry exists on the stack
69
- *
70
- * @param mixed $value The value to test
71
- */
72
- public function onStack($value)
73
- {
74
- return isset($this->stack[$value]);
75
- }
76
-
77
- /**
78
- * Clear the stack
79
- */
80
- public function clear()
81
- {
82
- $this->stack = array();
83
- }
84
-
85
- /**
86
- * Return an array of all entries on the stack
87
- *
88
- * @return mixed[]
89
- */
90
- public function showStack()
91
- {
92
- return $this->stack;
93
- }
94
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/CalcEngine/Logger.php DELETED
@@ -1,151 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_CalcEngine_Logger
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_Calculation
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_CalcEngine_Logger
29
- {
30
- /**
31
- * Flag to determine whether a debug log should be generated by the calculation engine
32
- * If true, then a debug log will be generated
33
- * If false, then a debug log will not be generated
34
- *
35
- * @var boolean
36
- */
37
- private $writeDebugLog = false;
38
-
39
- /**
40
- * Flag to determine whether a debug log should be echoed by the calculation engine
41
- * If true, then a debug log will be echoed
42
- * If false, then a debug log will not be echoed
43
- * A debug log can only be echoed if it is generated
44
- *
45
- * @var boolean
46
- */
47
- private $echoDebugLog = false;
48
-
49
- /**
50
- * The debug log generated by the calculation engine
51
- *
52
- * @var string[]
53
- */
54
- private $debugLog = array();
55
-
56
- /**
57
- * The calculation engine cell reference stack
58
- *
59
- * @var PHPExcel_CalcEngine_CyclicReferenceStack
60
- */
61
- private $cellStack;
62
-
63
- /**
64
- * Instantiate a Calculation engine logger
65
- *
66
- * @param PHPExcel_CalcEngine_CyclicReferenceStack $stack
67
- */
68
- public function __construct(PHPExcel_CalcEngine_CyclicReferenceStack $stack)
69
- {
70
- $this->cellStack = $stack;
71
- }
72
-
73
- /**
74
- * Enable/Disable Calculation engine logging
75
- *
76
- * @param boolean $pValue
77
- */
78
- public function setWriteDebugLog($pValue = false)
79
- {
80
- $this->writeDebugLog = $pValue;
81
- }
82
-
83
- /**
84
- * Return whether calculation engine logging is enabled or disabled
85
- *
86
- * @return boolean
87
- */
88
- public function getWriteDebugLog()
89
- {
90
- return $this->writeDebugLog;
91
- }
92
-
93
- /**
94
- * Enable/Disable echoing of debug log information
95
- *
96
- * @param boolean $pValue
97
- */
98
- public function setEchoDebugLog($pValue = false)
99
- {
100
- $this->echoDebugLog = $pValue;
101
- }
102
-
103
- /**
104
- * Return whether echoing of debug log information is enabled or disabled
105
- *
106
- * @return boolean
107
- */
108
- public function getEchoDebugLog()
109
- {
110
- return $this->echoDebugLog;
111
- }
112
-
113
- /**
114
- * Write an entry to the calculation engine debug log
115
- */
116
- public function writeDebugLog()
117
- {
118
- // Only write the debug log if logging is enabled
119
- if ($this->writeDebugLog) {
120
- $message = implode(func_get_args());
121
- $cellReference = implode(' -> ', $this->cellStack->showStack());
122
- if ($this->echoDebugLog) {
123
- echo $cellReference,
124
- ($this->cellStack->count() > 0 ? ' => ' : ''),
125
- $message,
126
- PHP_EOL;
127
- }
128
- $this->debugLog[] = $cellReference .
129
- ($this->cellStack->count() > 0 ? ' => ' : '') .
130
- $message;
131
- }
132
- }
133
-
134
- /**
135
- * Clear the calculation engine debug log
136
- */
137
- public function clearLog()
138
- {
139
- $this->debugLog = array();
140
- }
141
-
142
- /**
143
- * Return the calculation engine debug log
144
- *
145
- * @return string[]
146
- */
147
- public function getLog()
148
- {
149
- return $this->debugLog;
150
- }
151
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation.php DELETED
@@ -1,4391 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
- if (!defined('CALCULATION_REGEXP_CELLREF')) {
13
- // Test for support of \P (multibyte options) in PCRE
14
- if (defined('PREG_BAD_UTF8_ERROR')) {
15
- // Cell reference (cell or range of cells, with or without a sheet reference)
16
- define('CALCULATION_REGEXP_CELLREF', '((([^\s,!&%^\/\*\+<>=-]*)|(\'[^\']*\')|(\"[^\"]*\"))!)?\$?([a-z]{1,3})\$?(\d{1,7})');
17
- // Named Range of cells
18
- define('CALCULATION_REGEXP_NAMEDRANGE', '((([^\s,!&%^\/\*\+<>=-]*)|(\'[^\']*\')|(\"[^\"]*\"))!)?([_A-Z][_A-Z0-9\.]*)');
19
- } else {
20
- // Cell reference (cell or range of cells, with or without a sheet reference)
21
- define('CALCULATION_REGEXP_CELLREF', '(((\w*)|(\'[^\']*\')|(\"[^\"]*\"))!)?\$?([a-z]{1,3})\$?(\d+)');
22
- // Named Range of cells
23
- define('CALCULATION_REGEXP_NAMEDRANGE', '(((\w*)|(\'.*\')|(\".*\"))!)?([_A-Z][_A-Z0-9\.]*)');
24
- }
25
- }
26
-
27
- /**
28
- * PHPExcel_Calculation (Multiton)
29
- *
30
- * Copyright (c) 2006 - 2015 PHPExcel
31
- *
32
- * This library is free software; you can redistribute it and/or
33
- * modify it under the terms of the GNU Lesser General Public
34
- * License as published by the Free Software Foundation; either
35
- * version 2.1 of the License, or (at your option) any later version.
36
- *
37
- * This library is distributed in the hope that it will be useful,
38
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
39
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
40
- * Lesser General Public License for more details.
41
- *
42
- * You should have received a copy of the GNU Lesser General Public
43
- * License along with this library; if not, write to the Free Software
44
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
45
- *
46
- * @category PHPExcel
47
- * @package PHPExcel_Calculation
48
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
49
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
50
- * @version ##VERSION##, ##DATE##
51
- */
52
- class PHPExcel_Calculation
53
- {
54
- /** Constants */
55
- /** Regular Expressions */
56
- // Numeric operand
57
- const CALCULATION_REGEXP_NUMBER = '[-+]?\d*\.?\d+(e[-+]?\d+)?';
58
- // String operand
59
- const CALCULATION_REGEXP_STRING = '"(?:[^"]|"")*"';
60
- // Opening bracket
61
- const CALCULATION_REGEXP_OPENBRACE = '\(';
62
- // Function (allow for the old @ symbol that could be used to prefix a function, but we'll ignore it)
63
- const CALCULATION_REGEXP_FUNCTION = '@?([A-Z][A-Z0-9\.]*)[\s]*\(';
64
- // Cell reference (cell or range of cells, with or without a sheet reference)
65
- const CALCULATION_REGEXP_CELLREF = CALCULATION_REGEXP_CELLREF;
66
- // Named Range of cells
67
- const CALCULATION_REGEXP_NAMEDRANGE = CALCULATION_REGEXP_NAMEDRANGE;
68
- // Error
69
- const CALCULATION_REGEXP_ERROR = '\#[A-Z][A-Z0_\/]*[!\?]?';
70
-
71
-
72
- /** constants */
73
- const RETURN_ARRAY_AS_ERROR = 'error';
74
- const RETURN_ARRAY_AS_VALUE = 'value';
75
- const RETURN_ARRAY_AS_ARRAY = 'array';
76
-
77
- private static $returnArrayAsType = self::RETURN_ARRAY_AS_VALUE;
78
-
79
-
80
- /**
81
- * Instance of this class
82
- *
83
- * @access private
84
- * @var PHPExcel_Calculation
85
- */
86
- private static $instance;
87
-
88
-
89
- /**
90
- * Instance of the workbook this Calculation Engine is using
91
- *
92
- * @access private
93
- * @var PHPExcel
94
- */
95
- private $workbook;
96
-
97
- /**
98
- * List of instances of the calculation engine that we've instantiated for individual workbooks
99
- *
100
- * @access private
101
- * @var PHPExcel_Calculation[]
102
- */
103
- private static $workbookSets;
104
-
105
- /**
106
- * Calculation cache
107
- *
108
- * @access private
109
- * @var array
110
- */
111
- private $calculationCache = array ();
112
-
113
-
114
- /**
115
- * Calculation cache enabled
116
- *
117
- * @access private
118
- * @var boolean
119
- */
120
- private $calculationCacheEnabled = true;
121
-
122
-
123
- /**
124
- * List of operators that can be used within formulae
125
- * The true/false value indicates whether it is a binary operator or a unary operator
126
- *
127
- * @access private
128
- * @var array
129
- */
130
- private static $operators = array(
131
- '+' => true, '-' => true, '*' => true, '/' => true,
132
- '^' => true, '&' => true, '%' => false, '~' => false,
133
- '>' => true, '<' => true, '=' => true, '>=' => true,
134
- '<=' => true, '<>' => true, '|' => true, ':' => true
135
- );
136
-
137
- /**
138
- * List of binary operators (those that expect two operands)
139
- *
140
- * @access private
141
- * @var array
142
- */
143
- private static $binaryOperators = array(
144
- '+' => true, '-' => true, '*' => true, '/' => true,
145
- '^' => true, '&' => true, '>' => true, '<' => true,
146
- '=' => true, '>=' => true, '<=' => true, '<>' => true,
147
- '|' => true, ':' => true
148
- );
149
-
150
- /**
151
- * The debug log generated by the calculation engine
152
- *
153
- * @access private
154
- * @var PHPExcel_CalcEngine_Logger
155
- *
156
- */
157
- private $debugLog;
158
-
159
- /**
160
- * Flag to determine how formula errors should be handled
161
- * If true, then a user error will be triggered
162
- * If false, then an exception will be thrown
163
- *
164
- * @access public
165
- * @var boolean
166
- *
167
- */
168
- public $suppressFormulaErrors = false;
169
-
170
- /**
171
- * Error message for any error that was raised/thrown by the calculation engine
172
- *
173
- * @access public
174
- * @var string
175
- *
176
- */
177
- public $formulaError = null;
178
-
179
- /**
180
- * An array of the nested cell references accessed by the calculation engine, used for the debug log
181
- *
182
- * @access private
183
- * @var array of string
184
- *
185
- */
186
- private $cyclicReferenceStack;
187
-
188
- private $cellStack = array();
189
-
190
- /**
191
- * Current iteration counter for cyclic formulae
192
- * If the value is 0 (or less) then cyclic formulae will throw an exception,
193
- * otherwise they will iterate to the limit defined here before returning a result
194
- *
195
- * @var integer
196
- *
197
- */
198
- private $cyclicFormulaCounter = 1;
199
-
200
- private $cyclicFormulaCell = '';
201
-
202
- /**
203
- * Number of iterations for cyclic formulae
204
- *
205
- * @var integer
206
- *
207
- */
208
- public $cyclicFormulaCount = 1;
209
-
210
- /**
211
- * Epsilon Precision used for comparisons in calculations
212
- *
213
- * @var float
214
- *
215
- */
216
- private $delta = 0.1e-12;
217
-
218
-
219
- /**
220
- * The current locale setting
221
- *
222
- * @var string
223
- *
224
- */
225
- private static $localeLanguage = 'en_us'; // US English (default locale)
226
-
227
- /**
228
- * List of available locale settings
229
- * Note that this is read for the locale subdirectory only when requested
230
- *
231
- * @var string[]
232
- *
233
- */
234
- private static $validLocaleLanguages = array(
235
- 'en' // English (default language)
236
- );
237
-
238
- /**
239
- * Locale-specific argument separator for function arguments
240
- *
241
- * @var string
242
- *
243
- */
244
- private static $localeArgumentSeparator = ',';
245
- private static $localeFunctions = array();
246
-
247
- /**
248
- * Locale-specific translations for Excel constants (True, False and Null)
249
- *
250
- * @var string[]
251
- *
252
- */
253
- public static $localeBoolean = array(
254
- 'TRUE' => 'TRUE',
255
- 'FALSE' => 'FALSE',
256
- 'NULL' => 'NULL'
257
- );
258
-
259
- /**
260
- * Excel constant string translations to their PHP equivalents
261
- * Constant conversion from text name/value to actual (datatyped) value
262
- *
263
- * @var string[]
264
- *
265
- */
266
- private static $excelConstants = array(
267
- 'TRUE' => true,
268
- 'FALSE' => false,
269
- 'NULL' => null
270
- );
271
-
272
- // PHPExcel functions
273
- private static $PHPExcelFunctions = array(
274
- 'ABS' => array(
275
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
276
- 'functionCall' => 'abs',
277
- 'argumentCount' => '1'
278
- ),
279
- 'ACCRINT' => array(
280
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
281
- 'functionCall' => 'PHPExcel_Calculation_Financial::ACCRINT',
282
- 'argumentCount' => '4-7'
283
- ),
284
- 'ACCRINTM' => array(
285
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
286
- 'functionCall' => 'PHPExcel_Calculation_Financial::ACCRINTM',
287
- 'argumentCount' => '3-5'
288
- ),
289
- 'ACOS' => array(
290
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
291
- 'functionCall' => 'acos',
292
- 'argumentCount' => '1'
293
- ),
294
- 'ACOSH' => array(
295
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
296
- 'functionCall' => 'acosh',
297
- 'argumentCount' => '1'
298
- ),
299
- 'ADDRESS' => array(
300
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
301
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::CELL_ADDRESS',
302
- 'argumentCount' => '2-5'
303
- ),
304
- 'AMORDEGRC' => array(
305
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
306
- 'functionCall' => 'PHPExcel_Calculation_Financial::AMORDEGRC',
307
- 'argumentCount' => '6,7'
308
- ),
309
- 'AMORLINC' => array(
310
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
311
- 'functionCall' => 'PHPExcel_Calculation_Financial::AMORLINC',
312
- 'argumentCount' => '6,7'
313
- ),
314
- 'AND' => array(
315
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
316
- 'functionCall' => 'PHPExcel_Calculation_Logical::LOGICAL_AND',
317
- 'argumentCount' => '1+'
318
- ),
319
- 'AREAS' => array(
320
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
321
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
322
- 'argumentCount' => '1'
323
- ),
324
- 'ASC' => array(
325
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
326
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
327
- 'argumentCount' => '1'
328
- ),
329
- 'ASIN' => array(
330
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
331
- 'functionCall' => 'asin',
332
- 'argumentCount' => '1'
333
- ),
334
- 'ASINH' => array(
335
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
336
- 'functionCall' => 'asinh',
337
- 'argumentCount' => '1'
338
- ),
339
- 'ATAN' => array(
340
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
341
- 'functionCall' => 'atan',
342
- 'argumentCount' => '1'
343
- ),
344
- 'ATAN2' => array(
345
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
346
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::ATAN2',
347
- 'argumentCount' => '2'
348
- ),
349
- 'ATANH' => array(
350
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
351
- 'functionCall' => 'atanh',
352
- 'argumentCount' => '1'
353
- ),
354
- 'AVEDEV' => array(
355
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
356
- 'functionCall' => 'PHPExcel_Calculation_Statistical::AVEDEV',
357
- 'argumentCount' => '1+'
358
- ),
359
- 'AVERAGE' => array(
360
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
361
- 'functionCall' => 'PHPExcel_Calculation_Statistical::AVERAGE',
362
- 'argumentCount' => '1+'
363
- ),
364
- 'AVERAGEA' => array(
365
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
366
- 'functionCall' => 'PHPExcel_Calculation_Statistical::AVERAGEA',
367
- 'argumentCount' => '1+'
368
- ),
369
- 'AVERAGEIF' => array(
370
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
371
- 'functionCall' => 'PHPExcel_Calculation_Statistical::AVERAGEIF',
372
- 'argumentCount' => '2,3'
373
- ),
374
- 'AVERAGEIFS' => array(
375
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
376
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
377
- 'argumentCount' => '3+'
378
- ),
379
- 'BAHTTEXT' => array(
380
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
381
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
382
- 'argumentCount' => '1'
383
- ),
384
- 'BESSELI' => array(
385
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
386
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BESSELI',
387
- 'argumentCount' => '2'
388
- ),
389
- 'BESSELJ' => array(
390
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
391
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BESSELJ',
392
- 'argumentCount' => '2'
393
- ),
394
- 'BESSELK' => array(
395
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
396
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BESSELK',
397
- 'argumentCount' => '2'
398
- ),
399
- 'BESSELY' => array(
400
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
401
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BESSELY',
402
- 'argumentCount' => '2'
403
- ),
404
- 'BETADIST' => array(
405
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
406
- 'functionCall' => 'PHPExcel_Calculation_Statistical::BETADIST',
407
- 'argumentCount' => '3-5'
408
- ),
409
- 'BETAINV' => array(
410
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
411
- 'functionCall' => 'PHPExcel_Calculation_Statistical::BETAINV',
412
- 'argumentCount' => '3-5'
413
- ),
414
- 'BIN2DEC' => array(
415
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
416
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BINTODEC',
417
- 'argumentCount' => '1'
418
- ),
419
- 'BIN2HEX' => array(
420
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
421
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BINTOHEX',
422
- 'argumentCount' => '1,2'
423
- ),
424
- 'BIN2OCT' => array(
425
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
426
- 'functionCall' => 'PHPExcel_Calculation_Engineering::BINTOOCT',
427
- 'argumentCount' => '1,2'
428
- ),
429
- 'BINOMDIST' => array(
430
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
431
- 'functionCall' => 'PHPExcel_Calculation_Statistical::BINOMDIST',
432
- 'argumentCount' => '4'
433
- ),
434
- 'CEILING' => array(
435
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
436
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::CEILING',
437
- 'argumentCount' => '2'
438
- ),
439
- 'CELL' => array(
440
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
441
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
442
- 'argumentCount' => '1,2'
443
- ),
444
- 'CHAR' => array(
445
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
446
- 'functionCall' => 'PHPExcel_Calculation_TextData::CHARACTER',
447
- 'argumentCount' => '1'
448
- ),
449
- 'CHIDIST' => array(
450
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
451
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CHIDIST',
452
- 'argumentCount' => '2'
453
- ),
454
- 'CHIINV' => array(
455
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
456
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CHIINV',
457
- 'argumentCount' => '2'
458
- ),
459
- 'CHITEST' => array(
460
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
461
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
462
- 'argumentCount' => '2'
463
- ),
464
- 'CHOOSE' => array(
465
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
466
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::CHOOSE',
467
- 'argumentCount' => '2+'
468
- ),
469
- 'CLEAN' => array(
470
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
471
- 'functionCall' => 'PHPExcel_Calculation_TextData::TRIMNONPRINTABLE',
472
- 'argumentCount' => '1'
473
- ),
474
- 'CODE' => array(
475
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
476
- 'functionCall' => 'PHPExcel_Calculation_TextData::ASCIICODE',
477
- 'argumentCount' => '1'
478
- ),
479
- 'COLUMN' => array(
480
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
481
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::COLUMN',
482
- 'argumentCount' => '-1',
483
- 'passByReference' => array(true)
484
- ),
485
- 'COLUMNS' => array(
486
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
487
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::COLUMNS',
488
- 'argumentCount' => '1'
489
- ),
490
- 'COMBIN' => array(
491
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
492
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::COMBIN',
493
- 'argumentCount' => '2'
494
- ),
495
- 'COMPLEX' => array(
496
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
497
- 'functionCall' => 'PHPExcel_Calculation_Engineering::COMPLEX',
498
- 'argumentCount' => '2,3'
499
- ),
500
- 'CONCATENATE' => array(
501
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
502
- 'functionCall' => 'PHPExcel_Calculation_TextData::CONCATENATE',
503
- 'argumentCount' => '1+'
504
- ),
505
- 'CONFIDENCE' => array(
506
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
507
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CONFIDENCE',
508
- 'argumentCount' => '3'
509
- ),
510
- 'CONVERT' => array(
511
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
512
- 'functionCall' => 'PHPExcel_Calculation_Engineering::CONVERTUOM',
513
- 'argumentCount' => '3'
514
- ),
515
- 'CORREL' => array(
516
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
517
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CORREL',
518
- 'argumentCount' => '2'
519
- ),
520
- 'COS' => array(
521
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
522
- 'functionCall' => 'cos',
523
- 'argumentCount' => '1'
524
- ),
525
- 'COSH' => array(
526
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
527
- 'functionCall' => 'cosh',
528
- 'argumentCount' => '1'
529
- ),
530
- 'COUNT' => array(
531
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
532
- 'functionCall' => 'PHPExcel_Calculation_Statistical::COUNT',
533
- 'argumentCount' => '1+'
534
- ),
535
- 'COUNTA' => array(
536
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
537
- 'functionCall' => 'PHPExcel_Calculation_Statistical::COUNTA',
538
- 'argumentCount' => '1+'
539
- ),
540
- 'COUNTBLANK' => array(
541
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
542
- 'functionCall' => 'PHPExcel_Calculation_Statistical::COUNTBLANK',
543
- 'argumentCount' => '1'
544
- ),
545
- 'COUNTIF' => array(
546
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
547
- 'functionCall' => 'PHPExcel_Calculation_Statistical::COUNTIF',
548
- 'argumentCount' => '2'
549
- ),
550
- 'COUNTIFS' => array(
551
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
552
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
553
- 'argumentCount' => '2'
554
- ),
555
- 'COUPDAYBS' => array(
556
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
557
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPDAYBS',
558
- 'argumentCount' => '3,4'
559
- ),
560
- 'COUPDAYS' => array(
561
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
562
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPDAYS',
563
- 'argumentCount' => '3,4'
564
- ),
565
- 'COUPDAYSNC' => array(
566
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
567
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPDAYSNC',
568
- 'argumentCount' => '3,4'
569
- ),
570
- 'COUPNCD' => array(
571
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
572
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPNCD',
573
- 'argumentCount' => '3,4'
574
- ),
575
- 'COUPNUM' => array(
576
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
577
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPNUM',
578
- 'argumentCount' => '3,4'
579
- ),
580
- 'COUPPCD' => array(
581
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
582
- 'functionCall' => 'PHPExcel_Calculation_Financial::COUPPCD',
583
- 'argumentCount' => '3,4'
584
- ),
585
- 'COVAR' => array(
586
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
587
- 'functionCall' => 'PHPExcel_Calculation_Statistical::COVAR',
588
- 'argumentCount' => '2'
589
- ),
590
- 'CRITBINOM' => array(
591
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
592
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CRITBINOM',
593
- 'argumentCount' => '3'
594
- ),
595
- 'CUBEKPIMEMBER' => array(
596
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
597
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
598
- 'argumentCount' => '?'
599
- ),
600
- 'CUBEMEMBER' => array(
601
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
602
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
603
- 'argumentCount' => '?'
604
- ),
605
- 'CUBEMEMBERPROPERTY' => array(
606
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
607
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
608
- 'argumentCount' => '?'
609
- ),
610
- 'CUBERANKEDMEMBER' => array(
611
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
612
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
613
- 'argumentCount' => '?'
614
- ),
615
- 'CUBESET' => array(
616
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
617
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
618
- 'argumentCount' => '?'
619
- ),
620
- 'CUBESETCOUNT' => array(
621
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
622
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
623
- 'argumentCount' => '?'
624
- ),
625
- 'CUBEVALUE' => array(
626
- 'category' => PHPExcel_Calculation_Function::CATEGORY_CUBE,
627
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
628
- 'argumentCount' => '?'
629
- ),
630
- 'CUMIPMT' => array(
631
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
632
- 'functionCall' => 'PHPExcel_Calculation_Financial::CUMIPMT',
633
- 'argumentCount' => '6'
634
- ),
635
- 'CUMPRINC' => array(
636
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
637
- 'functionCall' => 'PHPExcel_Calculation_Financial::CUMPRINC',
638
- 'argumentCount' => '6'
639
- ),
640
- 'DATE' => array(
641
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
642
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DATE',
643
- 'argumentCount' => '3'
644
- ),
645
- 'DATEDIF' => array(
646
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
647
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DATEDIF',
648
- 'argumentCount' => '2,3'
649
- ),
650
- 'DATEVALUE' => array(
651
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
652
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DATEVALUE',
653
- 'argumentCount' => '1'
654
- ),
655
- 'DAVERAGE' => array(
656
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
657
- 'functionCall' => 'PHPExcel_Calculation_Database::DAVERAGE',
658
- 'argumentCount' => '3'
659
- ),
660
- 'DAY' => array(
661
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
662
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DAYOFMONTH',
663
- 'argumentCount' => '1'
664
- ),
665
- 'DAYS360' => array(
666
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
667
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DAYS360',
668
- 'argumentCount' => '2,3'
669
- ),
670
- 'DB' => array(
671
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
672
- 'functionCall' => 'PHPExcel_Calculation_Financial::DB',
673
- 'argumentCount' => '4,5'
674
- ),
675
- 'DCOUNT' => array(
676
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
677
- 'functionCall' => 'PHPExcel_Calculation_Database::DCOUNT',
678
- 'argumentCount' => '3'
679
- ),
680
- 'DCOUNTA' => array(
681
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
682
- 'functionCall' => 'PHPExcel_Calculation_Database::DCOUNTA',
683
- 'argumentCount' => '3'
684
- ),
685
- 'DDB' => array(
686
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
687
- 'functionCall' => 'PHPExcel_Calculation_Financial::DDB',
688
- 'argumentCount' => '4,5'
689
- ),
690
- 'DEC2BIN' => array(
691
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
692
- 'functionCall' => 'PHPExcel_Calculation_Engineering::DECTOBIN',
693
- 'argumentCount' => '1,2'
694
- ),
695
- 'DEC2HEX' => array(
696
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
697
- 'functionCall' => 'PHPExcel_Calculation_Engineering::DECTOHEX',
698
- 'argumentCount' => '1,2'
699
- ),
700
- 'DEC2OCT' => array(
701
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
702
- 'functionCall' => 'PHPExcel_Calculation_Engineering::DECTOOCT',
703
- 'argumentCount' => '1,2'
704
- ),
705
- 'DEGREES' => array(
706
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
707
- 'functionCall' => 'rad2deg',
708
- 'argumentCount' => '1'
709
- ),
710
- 'DELTA' => array(
711
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
712
- 'functionCall' => 'PHPExcel_Calculation_Engineering::DELTA',
713
- 'argumentCount' => '1,2'
714
- ),
715
- 'DEVSQ' => array(
716
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
717
- 'functionCall' => 'PHPExcel_Calculation_Statistical::DEVSQ',
718
- 'argumentCount' => '1+'
719
- ),
720
- 'DGET' => array(
721
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
722
- 'functionCall' => 'PHPExcel_Calculation_Database::DGET',
723
- 'argumentCount' => '3'
724
- ),
725
- 'DISC' => array(
726
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
727
- 'functionCall' => 'PHPExcel_Calculation_Financial::DISC',
728
- 'argumentCount' => '4,5'
729
- ),
730
- 'DMAX' => array(
731
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
732
- 'functionCall' => 'PHPExcel_Calculation_Database::DMAX',
733
- 'argumentCount' => '3'
734
- ),
735
- 'DMIN' => array(
736
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
737
- 'functionCall' => 'PHPExcel_Calculation_Database::DMIN',
738
- 'argumentCount' => '3'
739
- ),
740
- 'DOLLAR' => array(
741
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
742
- 'functionCall' => 'PHPExcel_Calculation_TextData::DOLLAR',
743
- 'argumentCount' => '1,2'
744
- ),
745
- 'DOLLARDE' => array(
746
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
747
- 'functionCall' => 'PHPExcel_Calculation_Financial::DOLLARDE',
748
- 'argumentCount' => '2'
749
- ),
750
- 'DOLLARFR' => array(
751
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
752
- 'functionCall' => 'PHPExcel_Calculation_Financial::DOLLARFR',
753
- 'argumentCount' => '2'
754
- ),
755
- 'DPRODUCT' => array(
756
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
757
- 'functionCall' => 'PHPExcel_Calculation_Database::DPRODUCT',
758
- 'argumentCount' => '3'
759
- ),
760
- 'DSTDEV' => array(
761
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
762
- 'functionCall' => 'PHPExcel_Calculation_Database::DSTDEV',
763
- 'argumentCount' => '3'
764
- ),
765
- 'DSTDEVP' => array(
766
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
767
- 'functionCall' => 'PHPExcel_Calculation_Database::DSTDEVP',
768
- 'argumentCount' => '3'
769
- ),
770
- 'DSUM' => array(
771
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
772
- 'functionCall' => 'PHPExcel_Calculation_Database::DSUM',
773
- 'argumentCount' => '3'
774
- ),
775
- 'DURATION' => array(
776
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
777
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
778
- 'argumentCount' => '5,6'
779
- ),
780
- 'DVAR' => array(
781
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
782
- 'functionCall' => 'PHPExcel_Calculation_Database::DVAR',
783
- 'argumentCount' => '3'
784
- ),
785
- 'DVARP' => array(
786
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATABASE,
787
- 'functionCall' => 'PHPExcel_Calculation_Database::DVARP',
788
- 'argumentCount' => '3'
789
- ),
790
- 'EDATE' => array(
791
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
792
- 'functionCall' => 'PHPExcel_Calculation_DateTime::EDATE',
793
- 'argumentCount' => '2'
794
- ),
795
- 'EFFECT' => array(
796
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
797
- 'functionCall' => 'PHPExcel_Calculation_Financial::EFFECT',
798
- 'argumentCount' => '2'
799
- ),
800
- 'EOMONTH' => array(
801
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
802
- 'functionCall' => 'PHPExcel_Calculation_DateTime::EOMONTH',
803
- 'argumentCount' => '2'
804
- ),
805
- 'ERF' => array(
806
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
807
- 'functionCall' => 'PHPExcel_Calculation_Engineering::ERF',
808
- 'argumentCount' => '1,2'
809
- ),
810
- 'ERFC' => array(
811
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
812
- 'functionCall' => 'PHPExcel_Calculation_Engineering::ERFC',
813
- 'argumentCount' => '1'
814
- ),
815
- 'ERROR.TYPE' => array(
816
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
817
- 'functionCall' => 'PHPExcel_Calculation_Functions::ERROR_TYPE',
818
- 'argumentCount' => '1'
819
- ),
820
- 'EVEN' => array(
821
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
822
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::EVEN',
823
- 'argumentCount' => '1'
824
- ),
825
- 'EXACT' => array(
826
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
827
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
828
- 'argumentCount' => '2'
829
- ),
830
- 'EXP' => array(
831
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
832
- 'functionCall' => 'exp',
833
- 'argumentCount' => '1'
834
- ),
835
- 'EXPONDIST' => array(
836
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
837
- 'functionCall' => 'PHPExcel_Calculation_Statistical::EXPONDIST',
838
- 'argumentCount' => '3'
839
- ),
840
- 'FACT' => array(
841
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
842
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::FACT',
843
- 'argumentCount' => '1'
844
- ),
845
- 'FACTDOUBLE' => array(
846
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
847
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::FACTDOUBLE',
848
- 'argumentCount' => '1'
849
- ),
850
- 'FALSE' => array(
851
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
852
- 'functionCall' => 'PHPExcel_Calculation_Logical::FALSE',
853
- 'argumentCount' => '0'
854
- ),
855
- 'FDIST' => array(
856
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
857
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
858
- 'argumentCount' => '3'
859
- ),
860
- 'FIND' => array(
861
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
862
- 'functionCall' => 'PHPExcel_Calculation_TextData::SEARCHSENSITIVE',
863
- 'argumentCount' => '2,3'
864
- ),
865
- 'FINDB' => array(
866
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
867
- 'functionCall' => 'PHPExcel_Calculation_TextData::SEARCHSENSITIVE',
868
- 'argumentCount' => '2,3'
869
- ),
870
- 'FINV' => array(
871
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
872
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
873
- 'argumentCount' => '3'
874
- ),
875
- 'FISHER' => array(
876
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
877
- 'functionCall' => 'PHPExcel_Calculation_Statistical::FISHER',
878
- 'argumentCount' => '1'
879
- ),
880
- 'FISHERINV' => array(
881
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
882
- 'functionCall' => 'PHPExcel_Calculation_Statistical::FISHERINV',
883
- 'argumentCount' => '1'
884
- ),
885
- 'FIXED' => array(
886
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
887
- 'functionCall' => 'PHPExcel_Calculation_TextData::FIXEDFORMAT',
888
- 'argumentCount' => '1-3'
889
- ),
890
- 'FLOOR' => array(
891
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
892
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::FLOOR',
893
- 'argumentCount' => '2'
894
- ),
895
- 'FORECAST' => array(
896
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
897
- 'functionCall' => 'PHPExcel_Calculation_Statistical::FORECAST',
898
- 'argumentCount' => '3'
899
- ),
900
- 'FREQUENCY' => array(
901
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
902
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
903
- 'argumentCount' => '2'
904
- ),
905
- 'FTEST' => array(
906
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
907
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
908
- 'argumentCount' => '2'
909
- ),
910
- 'FV' => array(
911
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
912
- 'functionCall' => 'PHPExcel_Calculation_Financial::FV',
913
- 'argumentCount' => '3-5'
914
- ),
915
- 'FVSCHEDULE' => array(
916
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
917
- 'functionCall' => 'PHPExcel_Calculation_Financial::FVSCHEDULE',
918
- 'argumentCount' => '2'
919
- ),
920
- 'GAMMADIST' => array(
921
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
922
- 'functionCall' => 'PHPExcel_Calculation_Statistical::GAMMADIST',
923
- 'argumentCount' => '4'
924
- ),
925
- 'GAMMAINV' => array(
926
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
927
- 'functionCall' => 'PHPExcel_Calculation_Statistical::GAMMAINV',
928
- 'argumentCount' => '3'
929
- ),
930
- 'GAMMALN' => array(
931
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
932
- 'functionCall' => 'PHPExcel_Calculation_Statistical::GAMMALN',
933
- 'argumentCount' => '1'
934
- ),
935
- 'GCD' => array(
936
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
937
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::GCD',
938
- 'argumentCount' => '1+'
939
- ),
940
- 'GEOMEAN' => array(
941
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
942
- 'functionCall' => 'PHPExcel_Calculation_Statistical::GEOMEAN',
943
- 'argumentCount' => '1+'
944
- ),
945
- 'GESTEP' => array(
946
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
947
- 'functionCall' => 'PHPExcel_Calculation_Engineering::GESTEP',
948
- 'argumentCount' => '1,2'
949
- ),
950
- 'GETPIVOTDATA' => array(
951
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
952
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
953
- 'argumentCount' => '2+'
954
- ),
955
- 'GROWTH' => array(
956
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
957
- 'functionCall' => 'PHPExcel_Calculation_Statistical::GROWTH',
958
- 'argumentCount' => '1-4'
959
- ),
960
- 'HARMEAN' => array(
961
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
962
- 'functionCall' => 'PHPExcel_Calculation_Statistical::HARMEAN',
963
- 'argumentCount' => '1+'
964
- ),
965
- 'HEX2BIN' => array(
966
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
967
- 'functionCall' => 'PHPExcel_Calculation_Engineering::HEXTOBIN',
968
- 'argumentCount' => '1,2'
969
- ),
970
- 'HEX2DEC' => array(
971
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
972
- 'functionCall' => 'PHPExcel_Calculation_Engineering::HEXTODEC',
973
- 'argumentCount' => '1'
974
- ),
975
- 'HEX2OCT' => array(
976
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
977
- 'functionCall' => 'PHPExcel_Calculation_Engineering::HEXTOOCT',
978
- 'argumentCount' => '1,2'
979
- ),
980
- 'HLOOKUP' => array(
981
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
982
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::HLOOKUP',
983
- 'argumentCount' => '3,4'
984
- ),
985
- 'HOUR' => array(
986
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
987
- 'functionCall' => 'PHPExcel_Calculation_DateTime::HOUROFDAY',
988
- 'argumentCount' => '1'
989
- ),
990
- 'HYPERLINK' => array(
991
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
992
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::HYPERLINK',
993
- 'argumentCount' => '1,2',
994
- 'passCellReference' => true
995
- ),
996
- 'HYPGEOMDIST' => array(
997
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
998
- 'functionCall' => 'PHPExcel_Calculation_Statistical::HYPGEOMDIST',
999
- 'argumentCount' => '4'
1000
- ),
1001
- 'IF' => array(
1002
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
1003
- 'functionCall' => 'PHPExcel_Calculation_Logical::STATEMENT_IF',
1004
- 'argumentCount' => '1-3'
1005
- ),
1006
- 'IFERROR' => array(
1007
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
1008
- 'functionCall' => 'PHPExcel_Calculation_Logical::IFERROR',
1009
- 'argumentCount' => '2'
1010
- ),
1011
- 'IMABS' => array(
1012
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1013
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMABS',
1014
- 'argumentCount' => '1'
1015
- ),
1016
- 'IMAGINARY' => array(
1017
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1018
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMAGINARY',
1019
- 'argumentCount' => '1'
1020
- ),
1021
- 'IMARGUMENT' => array(
1022
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1023
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMARGUMENT',
1024
- 'argumentCount' => '1'
1025
- ),
1026
- 'IMCONJUGATE' => array(
1027
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1028
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMCONJUGATE',
1029
- 'argumentCount' => '1'
1030
- ),
1031
- 'IMCOS' => array(
1032
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1033
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMCOS',
1034
- 'argumentCount' => '1'
1035
- ),
1036
- 'IMDIV' => array(
1037
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1038
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMDIV',
1039
- 'argumentCount' => '2'
1040
- ),
1041
- 'IMEXP' => array(
1042
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1043
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMEXP',
1044
- 'argumentCount' => '1'
1045
- ),
1046
- 'IMLN' => array(
1047
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1048
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMLN',
1049
- 'argumentCount' => '1'
1050
- ),
1051
- 'IMLOG10' => array(
1052
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1053
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMLOG10',
1054
- 'argumentCount' => '1'
1055
- ),
1056
- 'IMLOG2' => array(
1057
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1058
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMLOG2',
1059
- 'argumentCount' => '1'
1060
- ),
1061
- 'IMPOWER' => array(
1062
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1063
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMPOWER',
1064
- 'argumentCount' => '2'
1065
- ),
1066
- 'IMPRODUCT' => array(
1067
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1068
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMPRODUCT',
1069
- 'argumentCount' => '1+'
1070
- ),
1071
- 'IMREAL' => array(
1072
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1073
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMREAL',
1074
- 'argumentCount' => '1'
1075
- ),
1076
- 'IMSIN' => array(
1077
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1078
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMSIN',
1079
- 'argumentCount' => '1'
1080
- ),
1081
- 'IMSQRT' => array(
1082
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1083
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMSQRT',
1084
- 'argumentCount' => '1'
1085
- ),
1086
- 'IMSUB' => array(
1087
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1088
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMSUB',
1089
- 'argumentCount' => '2'
1090
- ),
1091
- 'IMSUM' => array(
1092
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1093
- 'functionCall' => 'PHPExcel_Calculation_Engineering::IMSUM',
1094
- 'argumentCount' => '1+'
1095
- ),
1096
- 'INDEX' => array(
1097
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1098
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::INDEX',
1099
- 'argumentCount' => '1-4'
1100
- ),
1101
- 'INDIRECT' => array(
1102
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1103
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::INDIRECT',
1104
- 'argumentCount' => '1,2',
1105
- 'passCellReference' => true
1106
- ),
1107
- 'INFO' => array(
1108
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1109
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1110
- 'argumentCount' => '1'
1111
- ),
1112
- 'INT' => array(
1113
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1114
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::INT',
1115
- 'argumentCount' => '1'
1116
- ),
1117
- 'INTERCEPT' => array(
1118
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1119
- 'functionCall' => 'PHPExcel_Calculation_Statistical::INTERCEPT',
1120
- 'argumentCount' => '2'
1121
- ),
1122
- 'INTRATE' => array(
1123
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1124
- 'functionCall' => 'PHPExcel_Calculation_Financial::INTRATE',
1125
- 'argumentCount' => '4,5'
1126
- ),
1127
- 'IPMT' => array(
1128
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1129
- 'functionCall' => 'PHPExcel_Calculation_Financial::IPMT',
1130
- 'argumentCount' => '4-6'
1131
- ),
1132
- 'IRR' => array(
1133
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1134
- 'functionCall' => 'PHPExcel_Calculation_Financial::IRR',
1135
- 'argumentCount' => '1,2'
1136
- ),
1137
- 'ISBLANK' => array(
1138
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1139
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_BLANK',
1140
- 'argumentCount' => '1'
1141
- ),
1142
- 'ISERR' => array(
1143
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1144
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_ERR',
1145
- 'argumentCount' => '1'
1146
- ),
1147
- 'ISERROR' => array(
1148
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1149
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_ERROR',
1150
- 'argumentCount' => '1'
1151
- ),
1152
- 'ISEVEN' => array(
1153
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1154
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_EVEN',
1155
- 'argumentCount' => '1'
1156
- ),
1157
- 'ISLOGICAL' => array(
1158
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1159
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_LOGICAL',
1160
- 'argumentCount' => '1'
1161
- ),
1162
- 'ISNA' => array(
1163
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1164
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_NA',
1165
- 'argumentCount' => '1'
1166
- ),
1167
- 'ISNONTEXT' => array(
1168
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1169
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_NONTEXT',
1170
- 'argumentCount' => '1'
1171
- ),
1172
- 'ISNUMBER' => array(
1173
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1174
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_NUMBER',
1175
- 'argumentCount' => '1'
1176
- ),
1177
- 'ISODD' => array(
1178
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1179
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_ODD',
1180
- 'argumentCount' => '1'
1181
- ),
1182
- 'ISPMT' => array(
1183
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1184
- 'functionCall' => 'PHPExcel_Calculation_Financial::ISPMT',
1185
- 'argumentCount' => '4'
1186
- ),
1187
- 'ISREF' => array(
1188
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1189
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1190
- 'argumentCount' => '1'
1191
- ),
1192
- 'ISTEXT' => array(
1193
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1194
- 'functionCall' => 'PHPExcel_Calculation_Functions::IS_TEXT',
1195
- 'argumentCount' => '1'
1196
- ),
1197
- 'JIS' => array(
1198
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1199
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1200
- 'argumentCount' => '1'
1201
- ),
1202
- 'KURT' => array(
1203
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1204
- 'functionCall' => 'PHPExcel_Calculation_Statistical::KURT',
1205
- 'argumentCount' => '1+'
1206
- ),
1207
- 'LARGE' => array(
1208
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1209
- 'functionCall' => 'PHPExcel_Calculation_Statistical::LARGE',
1210
- 'argumentCount' => '2'
1211
- ),
1212
- 'LCM' => array(
1213
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1214
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::LCM',
1215
- 'argumentCount' => '1+'
1216
- ),
1217
- 'LEFT' => array(
1218
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1219
- 'functionCall' => 'PHPExcel_Calculation_TextData::LEFT',
1220
- 'argumentCount' => '1,2'
1221
- ),
1222
- 'LEFTB' => array(
1223
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1224
- 'functionCall' => 'PHPExcel_Calculation_TextData::LEFT',
1225
- 'argumentCount' => '1,2'
1226
- ),
1227
- 'LEN' => array(
1228
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1229
- 'functionCall' => 'PHPExcel_Calculation_TextData::STRINGLENGTH',
1230
- 'argumentCount' => '1'
1231
- ),
1232
- 'LENB' => array(
1233
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1234
- 'functionCall' => 'PHPExcel_Calculation_TextData::STRINGLENGTH',
1235
- 'argumentCount' => '1'
1236
- ),
1237
- 'LINEST' => array(
1238
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1239
- 'functionCall' => 'PHPExcel_Calculation_Statistical::LINEST',
1240
- 'argumentCount' => '1-4'
1241
- ),
1242
- 'LN' => array(
1243
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1244
- 'functionCall' => 'log',
1245
- 'argumentCount' => '1'
1246
- ),
1247
- 'LOG' => array(
1248
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1249
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::LOG_BASE',
1250
- 'argumentCount' => '1,2'
1251
- ),
1252
- 'LOG10' => array(
1253
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1254
- 'functionCall' => 'log10',
1255
- 'argumentCount' => '1'
1256
- ),
1257
- 'LOGEST' => array(
1258
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1259
- 'functionCall' => 'PHPExcel_Calculation_Statistical::LOGEST',
1260
- 'argumentCount' => '1-4'
1261
- ),
1262
- 'LOGINV' => array(
1263
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1264
- 'functionCall' => 'PHPExcel_Calculation_Statistical::LOGINV',
1265
- 'argumentCount' => '3'
1266
- ),
1267
- 'LOGNORMDIST' => array(
1268
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1269
- 'functionCall' => 'PHPExcel_Calculation_Statistical::LOGNORMDIST',
1270
- 'argumentCount' => '3'
1271
- ),
1272
- 'LOOKUP' => array(
1273
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1274
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::LOOKUP',
1275
- 'argumentCount' => '2,3'
1276
- ),
1277
- 'LOWER' => array(
1278
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1279
- 'functionCall' => 'PHPExcel_Calculation_TextData::LOWERCASE',
1280
- 'argumentCount' => '1'
1281
- ),
1282
- 'MATCH' => array(
1283
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1284
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::MATCH',
1285
- 'argumentCount' => '2,3'
1286
- ),
1287
- 'MAX' => array(
1288
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1289
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MAX',
1290
- 'argumentCount' => '1+'
1291
- ),
1292
- 'MAXA' => array(
1293
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1294
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MAXA',
1295
- 'argumentCount' => '1+'
1296
- ),
1297
- 'MAXIF' => array(
1298
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1299
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MAXIF',
1300
- 'argumentCount' => '2+'
1301
- ),
1302
- 'MDETERM' => array(
1303
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1304
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MDETERM',
1305
- 'argumentCount' => '1'
1306
- ),
1307
- 'MDURATION' => array(
1308
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1309
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1310
- 'argumentCount' => '5,6'
1311
- ),
1312
- 'MEDIAN' => array(
1313
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1314
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MEDIAN',
1315
- 'argumentCount' => '1+'
1316
- ),
1317
- 'MEDIANIF' => array(
1318
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1319
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1320
- 'argumentCount' => '2+'
1321
- ),
1322
- 'MID' => array(
1323
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1324
- 'functionCall' => 'PHPExcel_Calculation_TextData::MID',
1325
- 'argumentCount' => '3'
1326
- ),
1327
- 'MIDB' => array(
1328
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1329
- 'functionCall' => 'PHPExcel_Calculation_TextData::MID',
1330
- 'argumentCount' => '3'
1331
- ),
1332
- 'MIN' => array(
1333
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1334
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MIN',
1335
- 'argumentCount' => '1+'
1336
- ),
1337
- 'MINA' => array(
1338
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1339
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MINA',
1340
- 'argumentCount' => '1+'
1341
- ),
1342
- 'MINIF' => array(
1343
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1344
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MINIF',
1345
- 'argumentCount' => '2+'
1346
- ),
1347
- 'MINUTE' => array(
1348
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1349
- 'functionCall' => 'PHPExcel_Calculation_DateTime::MINUTEOFHOUR',
1350
- 'argumentCount' => '1'
1351
- ),
1352
- 'MINVERSE' => array(
1353
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1354
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MINVERSE',
1355
- 'argumentCount' => '1'
1356
- ),
1357
- 'MIRR' => array(
1358
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1359
- 'functionCall' => 'PHPExcel_Calculation_Financial::MIRR',
1360
- 'argumentCount' => '3'
1361
- ),
1362
- 'MMULT' => array(
1363
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1364
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MMULT',
1365
- 'argumentCount' => '2'
1366
- ),
1367
- 'MOD' => array(
1368
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1369
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MOD',
1370
- 'argumentCount' => '2'
1371
- ),
1372
- 'MODE' => array(
1373
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1374
- 'functionCall' => 'PHPExcel_Calculation_Statistical::MODE',
1375
- 'argumentCount' => '1+'
1376
- ),
1377
- 'MONTH' => array(
1378
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1379
- 'functionCall' => 'PHPExcel_Calculation_DateTime::MONTHOFYEAR',
1380
- 'argumentCount' => '1'
1381
- ),
1382
- 'MROUND' => array(
1383
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1384
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MROUND',
1385
- 'argumentCount' => '2'
1386
- ),
1387
- 'MULTINOMIAL' => array(
1388
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1389
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::MULTINOMIAL',
1390
- 'argumentCount' => '1+'
1391
- ),
1392
- 'N' => array(
1393
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1394
- 'functionCall' => 'PHPExcel_Calculation_Functions::N',
1395
- 'argumentCount' => '1'
1396
- ),
1397
- 'NA' => array(
1398
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1399
- 'functionCall' => 'PHPExcel_Calculation_Functions::NA',
1400
- 'argumentCount' => '0'
1401
- ),
1402
- 'NEGBINOMDIST' => array(
1403
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1404
- 'functionCall' => 'PHPExcel_Calculation_Statistical::NEGBINOMDIST',
1405
- 'argumentCount' => '3'
1406
- ),
1407
- 'NETWORKDAYS' => array(
1408
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1409
- 'functionCall' => 'PHPExcel_Calculation_DateTime::NETWORKDAYS',
1410
- 'argumentCount' => '2+'
1411
- ),
1412
- 'NOMINAL' => array(
1413
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1414
- 'functionCall' => 'PHPExcel_Calculation_Financial::NOMINAL',
1415
- 'argumentCount' => '2'
1416
- ),
1417
- 'NORMDIST' => array(
1418
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1419
- 'functionCall' => 'PHPExcel_Calculation_Statistical::NORMDIST',
1420
- 'argumentCount' => '4'
1421
- ),
1422
- 'NORMINV' => array(
1423
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1424
- 'functionCall' => 'PHPExcel_Calculation_Statistical::NORMINV',
1425
- 'argumentCount' => '3'
1426
- ),
1427
- 'NORMSDIST' => array(
1428
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1429
- 'functionCall' => 'PHPExcel_Calculation_Statistical::NORMSDIST',
1430
- 'argumentCount' => '1'
1431
- ),
1432
- 'NORMSINV' => array(
1433
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1434
- 'functionCall' => 'PHPExcel_Calculation_Statistical::NORMSINV',
1435
- 'argumentCount' => '1'
1436
- ),
1437
- 'NOT' => array(
1438
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
1439
- 'functionCall' => 'PHPExcel_Calculation_Logical::NOT',
1440
- 'argumentCount' => '1'
1441
- ),
1442
- 'NOW' => array(
1443
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1444
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DATETIMENOW',
1445
- 'argumentCount' => '0'
1446
- ),
1447
- 'NPER' => array(
1448
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1449
- 'functionCall' => 'PHPExcel_Calculation_Financial::NPER',
1450
- 'argumentCount' => '3-5'
1451
- ),
1452
- 'NPV' => array(
1453
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1454
- 'functionCall' => 'PHPExcel_Calculation_Financial::NPV',
1455
- 'argumentCount' => '2+'
1456
- ),
1457
- 'OCT2BIN' => array(
1458
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1459
- 'functionCall' => 'PHPExcel_Calculation_Engineering::OCTTOBIN',
1460
- 'argumentCount' => '1,2'
1461
- ),
1462
- 'OCT2DEC' => array(
1463
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1464
- 'functionCall' => 'PHPExcel_Calculation_Engineering::OCTTODEC',
1465
- 'argumentCount' => '1'
1466
- ),
1467
- 'OCT2HEX' => array(
1468
- 'category' => PHPExcel_Calculation_Function::CATEGORY_ENGINEERING,
1469
- 'functionCall' => 'PHPExcel_Calculation_Engineering::OCTTOHEX',
1470
- 'argumentCount' => '1,2'
1471
- ),
1472
- 'ODD' => array(
1473
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1474
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::ODD',
1475
- 'argumentCount' => '1'
1476
- ),
1477
- 'ODDFPRICE' => array(
1478
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1479
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1480
- 'argumentCount' => '8,9'
1481
- ),
1482
- 'ODDFYIELD' => array(
1483
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1484
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1485
- 'argumentCount' => '8,9'
1486
- ),
1487
- 'ODDLPRICE' => array(
1488
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1489
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1490
- 'argumentCount' => '7,8'
1491
- ),
1492
- 'ODDLYIELD' => array(
1493
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1494
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1495
- 'argumentCount' => '7,8'
1496
- ),
1497
- 'OFFSET' => array(
1498
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1499
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::OFFSET',
1500
- 'argumentCount' => '3-5',
1501
- 'passCellReference' => true,
1502
- 'passByReference' => array(true)
1503
- ),
1504
- 'OR' => array(
1505
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
1506
- 'functionCall' => 'PHPExcel_Calculation_Logical::LOGICAL_OR',
1507
- 'argumentCount' => '1+'
1508
- ),
1509
- 'PEARSON' => array(
1510
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1511
- 'functionCall' => 'PHPExcel_Calculation_Statistical::CORREL',
1512
- 'argumentCount' => '2'
1513
- ),
1514
- 'PERCENTILE' => array(
1515
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1516
- 'functionCall' => 'PHPExcel_Calculation_Statistical::PERCENTILE',
1517
- 'argumentCount' => '2'
1518
- ),
1519
- 'PERCENTRANK' => array(
1520
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1521
- 'functionCall' => 'PHPExcel_Calculation_Statistical::PERCENTRANK',
1522
- 'argumentCount' => '2,3'
1523
- ),
1524
- 'PERMUT' => array(
1525
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1526
- 'functionCall' => 'PHPExcel_Calculation_Statistical::PERMUT',
1527
- 'argumentCount' => '2'
1528
- ),
1529
- 'PHONETIC' => array(
1530
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1531
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1532
- 'argumentCount' => '1'
1533
- ),
1534
- 'PI' => array(
1535
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1536
- 'functionCall' => 'pi',
1537
- 'argumentCount' => '0'
1538
- ),
1539
- 'PMT' => array(
1540
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1541
- 'functionCall' => 'PHPExcel_Calculation_Financial::PMT',
1542
- 'argumentCount' => '3-5'
1543
- ),
1544
- 'POISSON' => array(
1545
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1546
- 'functionCall' => 'PHPExcel_Calculation_Statistical::POISSON',
1547
- 'argumentCount' => '3'
1548
- ),
1549
- 'POWER' => array(
1550
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1551
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::POWER',
1552
- 'argumentCount' => '2'
1553
- ),
1554
- 'PPMT' => array(
1555
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1556
- 'functionCall' => 'PHPExcel_Calculation_Financial::PPMT',
1557
- 'argumentCount' => '4-6'
1558
- ),
1559
- 'PRICE' => array(
1560
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1561
- 'functionCall' => 'PHPExcel_Calculation_Financial::PRICE',
1562
- 'argumentCount' => '6,7'
1563
- ),
1564
- 'PRICEDISC' => array(
1565
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1566
- 'functionCall' => 'PHPExcel_Calculation_Financial::PRICEDISC',
1567
- 'argumentCount' => '4,5'
1568
- ),
1569
- 'PRICEMAT' => array(
1570
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1571
- 'functionCall' => 'PHPExcel_Calculation_Financial::PRICEMAT',
1572
- 'argumentCount' => '5,6'
1573
- ),
1574
- 'PROB' => array(
1575
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1576
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1577
- 'argumentCount' => '3,4'
1578
- ),
1579
- 'PRODUCT' => array(
1580
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1581
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::PRODUCT',
1582
- 'argumentCount' => '1+'
1583
- ),
1584
- 'PROPER' => array(
1585
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1586
- 'functionCall' => 'PHPExcel_Calculation_TextData::PROPERCASE',
1587
- 'argumentCount' => '1'
1588
- ),
1589
- 'PV' => array(
1590
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1591
- 'functionCall' => 'PHPExcel_Calculation_Financial::PV',
1592
- 'argumentCount' => '3-5'
1593
- ),
1594
- 'QUARTILE' => array(
1595
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1596
- 'functionCall' => 'PHPExcel_Calculation_Statistical::QUARTILE',
1597
- 'argumentCount' => '2'
1598
- ),
1599
- 'QUOTIENT' => array(
1600
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1601
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::QUOTIENT',
1602
- 'argumentCount' => '2'
1603
- ),
1604
- 'RADIANS' => array(
1605
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1606
- 'functionCall' => 'deg2rad',
1607
- 'argumentCount' => '1'
1608
- ),
1609
- 'RAND' => array(
1610
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1611
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::RAND',
1612
- 'argumentCount' => '0'
1613
- ),
1614
- 'RANDBETWEEN' => array(
1615
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1616
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::RAND',
1617
- 'argumentCount' => '2'
1618
- ),
1619
- 'RANK' => array(
1620
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1621
- 'functionCall' => 'PHPExcel_Calculation_Statistical::RANK',
1622
- 'argumentCount' => '2,3'
1623
- ),
1624
- 'RATE' => array(
1625
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1626
- 'functionCall' => 'PHPExcel_Calculation_Financial::RATE',
1627
- 'argumentCount' => '3-6'
1628
- ),
1629
- 'RECEIVED' => array(
1630
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1631
- 'functionCall' => 'PHPExcel_Calculation_Financial::RECEIVED',
1632
- 'argumentCount' => '4-5'
1633
- ),
1634
- 'REPLACE' => array(
1635
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1636
- 'functionCall' => 'PHPExcel_Calculation_TextData::REPLACE',
1637
- 'argumentCount' => '4'
1638
- ),
1639
- 'REPLACEB' => array(
1640
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1641
- 'functionCall' => 'PHPExcel_Calculation_TextData::REPLACE',
1642
- 'argumentCount' => '4'
1643
- ),
1644
- 'REPT' => array(
1645
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1646
- 'functionCall' => 'str_repeat',
1647
- 'argumentCount' => '2'
1648
- ),
1649
- 'RIGHT' => array(
1650
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1651
- 'functionCall' => 'PHPExcel_Calculation_TextData::RIGHT',
1652
- 'argumentCount' => '1,2'
1653
- ),
1654
- 'RIGHTB' => array(
1655
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1656
- 'functionCall' => 'PHPExcel_Calculation_TextData::RIGHT',
1657
- 'argumentCount' => '1,2'
1658
- ),
1659
- 'ROMAN' => array(
1660
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1661
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::ROMAN',
1662
- 'argumentCount' => '1,2'
1663
- ),
1664
- 'ROUND' => array(
1665
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1666
- 'functionCall' => 'round',
1667
- 'argumentCount' => '2'
1668
- ),
1669
- 'ROUNDDOWN' => array(
1670
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1671
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::ROUNDDOWN',
1672
- 'argumentCount' => '2'
1673
- ),
1674
- 'ROUNDUP' => array(
1675
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1676
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::ROUNDUP',
1677
- 'argumentCount' => '2'
1678
- ),
1679
- 'ROW' => array(
1680
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1681
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::ROW',
1682
- 'argumentCount' => '-1',
1683
- 'passByReference' => array(true)
1684
- ),
1685
- 'ROWS' => array(
1686
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1687
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::ROWS',
1688
- 'argumentCount' => '1'
1689
- ),
1690
- 'RSQ' => array(
1691
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1692
- 'functionCall' => 'PHPExcel_Calculation_Statistical::RSQ',
1693
- 'argumentCount' => '2'
1694
- ),
1695
- 'RTD' => array(
1696
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1697
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1698
- 'argumentCount' => '1+'
1699
- ),
1700
- 'SEARCH' => array(
1701
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1702
- 'functionCall' => 'PHPExcel_Calculation_TextData::SEARCHINSENSITIVE',
1703
- 'argumentCount' => '2,3'
1704
- ),
1705
- 'SEARCHB' => array(
1706
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1707
- 'functionCall' => 'PHPExcel_Calculation_TextData::SEARCHINSENSITIVE',
1708
- 'argumentCount' => '2,3'
1709
- ),
1710
- 'SECOND' => array(
1711
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1712
- 'functionCall' => 'PHPExcel_Calculation_DateTime::SECONDOFMINUTE',
1713
- 'argumentCount' => '1'
1714
- ),
1715
- 'SERIESSUM' => array(
1716
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1717
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SERIESSUM',
1718
- 'argumentCount' => '4'
1719
- ),
1720
- 'SIGN' => array(
1721
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1722
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SIGN',
1723
- 'argumentCount' => '1'
1724
- ),
1725
- 'SIN' => array(
1726
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1727
- 'functionCall' => 'sin',
1728
- 'argumentCount' => '1'
1729
- ),
1730
- 'SINH' => array(
1731
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1732
- 'functionCall' => 'sinh',
1733
- 'argumentCount' => '1'
1734
- ),
1735
- 'SKEW' => array(
1736
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1737
- 'functionCall' => 'PHPExcel_Calculation_Statistical::SKEW',
1738
- 'argumentCount' => '1+'
1739
- ),
1740
- 'SLN' => array(
1741
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1742
- 'functionCall' => 'PHPExcel_Calculation_Financial::SLN',
1743
- 'argumentCount' => '3'
1744
- ),
1745
- 'SLOPE' => array(
1746
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1747
- 'functionCall' => 'PHPExcel_Calculation_Statistical::SLOPE',
1748
- 'argumentCount' => '2'
1749
- ),
1750
- 'SMALL' => array(
1751
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1752
- 'functionCall' => 'PHPExcel_Calculation_Statistical::SMALL',
1753
- 'argumentCount' => '2'
1754
- ),
1755
- 'SQRT' => array(
1756
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1757
- 'functionCall' => 'sqrt',
1758
- 'argumentCount' => '1'
1759
- ),
1760
- 'SQRTPI' => array(
1761
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1762
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SQRTPI',
1763
- 'argumentCount' => '1'
1764
- ),
1765
- 'STANDARDIZE' => array(
1766
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1767
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STANDARDIZE',
1768
- 'argumentCount' => '3'
1769
- ),
1770
- 'STDEV' => array(
1771
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1772
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STDEV',
1773
- 'argumentCount' => '1+'
1774
- ),
1775
- 'STDEVA' => array(
1776
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1777
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STDEVA',
1778
- 'argumentCount' => '1+'
1779
- ),
1780
- 'STDEVP' => array(
1781
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1782
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STDEVP',
1783
- 'argumentCount' => '1+'
1784
- ),
1785
- 'STDEVPA' => array(
1786
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1787
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STDEVPA',
1788
- 'argumentCount' => '1+'
1789
- ),
1790
- 'STEYX' => array(
1791
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1792
- 'functionCall' => 'PHPExcel_Calculation_Statistical::STEYX',
1793
- 'argumentCount' => '2'
1794
- ),
1795
- 'SUBSTITUTE' => array(
1796
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1797
- 'functionCall' => 'PHPExcel_Calculation_TextData::SUBSTITUTE',
1798
- 'argumentCount' => '3,4'
1799
- ),
1800
- 'SUBTOTAL' => array(
1801
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1802
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUBTOTAL',
1803
- 'argumentCount' => '2+'
1804
- ),
1805
- 'SUM' => array(
1806
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1807
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUM',
1808
- 'argumentCount' => '1+'
1809
- ),
1810
- 'SUMIF' => array(
1811
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1812
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMIF',
1813
- 'argumentCount' => '2,3'
1814
- ),
1815
- 'SUMIFS' => array(
1816
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1817
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMIFS',
1818
- 'argumentCount' => '3+'
1819
- ),
1820
- 'SUMPRODUCT' => array(
1821
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1822
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMPRODUCT',
1823
- 'argumentCount' => '1+'
1824
- ),
1825
- 'SUMSQ' => array(
1826
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1827
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMSQ',
1828
- 'argumentCount' => '1+'
1829
- ),
1830
- 'SUMX2MY2' => array(
1831
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1832
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMX2MY2',
1833
- 'argumentCount' => '2'
1834
- ),
1835
- 'SUMX2PY2' => array(
1836
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1837
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMX2PY2',
1838
- 'argumentCount' => '2'
1839
- ),
1840
- 'SUMXMY2' => array(
1841
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1842
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::SUMXMY2',
1843
- 'argumentCount' => '2'
1844
- ),
1845
- 'SYD' => array(
1846
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1847
- 'functionCall' => 'PHPExcel_Calculation_Financial::SYD',
1848
- 'argumentCount' => '4'
1849
- ),
1850
- 'T' => array(
1851
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1852
- 'functionCall' => 'PHPExcel_Calculation_TextData::RETURNSTRING',
1853
- 'argumentCount' => '1'
1854
- ),
1855
- 'TAN' => array(
1856
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1857
- 'functionCall' => 'tan',
1858
- 'argumentCount' => '1'
1859
- ),
1860
- 'TANH' => array(
1861
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1862
- 'functionCall' => 'tanh',
1863
- 'argumentCount' => '1'
1864
- ),
1865
- 'TBILLEQ' => array(
1866
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1867
- 'functionCall' => 'PHPExcel_Calculation_Financial::TBILLEQ',
1868
- 'argumentCount' => '3'
1869
- ),
1870
- 'TBILLPRICE' => array(
1871
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1872
- 'functionCall' => 'PHPExcel_Calculation_Financial::TBILLPRICE',
1873
- 'argumentCount' => '3'
1874
- ),
1875
- 'TBILLYIELD' => array(
1876
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1877
- 'functionCall' => 'PHPExcel_Calculation_Financial::TBILLYIELD',
1878
- 'argumentCount' => '3'
1879
- ),
1880
- 'TDIST' => array(
1881
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1882
- 'functionCall' => 'PHPExcel_Calculation_Statistical::TDIST',
1883
- 'argumentCount' => '3'
1884
- ),
1885
- 'TEXT' => array(
1886
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1887
- 'functionCall' => 'PHPExcel_Calculation_TextData::TEXTFORMAT',
1888
- 'argumentCount' => '2'
1889
- ),
1890
- 'TIME' => array(
1891
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1892
- 'functionCall' => 'PHPExcel_Calculation_DateTime::TIME',
1893
- 'argumentCount' => '3'
1894
- ),
1895
- 'TIMEVALUE' => array(
1896
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1897
- 'functionCall' => 'PHPExcel_Calculation_DateTime::TIMEVALUE',
1898
- 'argumentCount' => '1'
1899
- ),
1900
- 'TINV' => array(
1901
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1902
- 'functionCall' => 'PHPExcel_Calculation_Statistical::TINV',
1903
- 'argumentCount' => '2'
1904
- ),
1905
- 'TODAY' => array(
1906
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
1907
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DATENOW',
1908
- 'argumentCount' => '0'
1909
- ),
1910
- 'TRANSPOSE' => array(
1911
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1912
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::TRANSPOSE',
1913
- 'argumentCount' => '1'
1914
- ),
1915
- 'TREND' => array(
1916
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1917
- 'functionCall' => 'PHPExcel_Calculation_Statistical::TREND',
1918
- 'argumentCount' => '1-4'
1919
- ),
1920
- 'TRIM' => array(
1921
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1922
- 'functionCall' => 'PHPExcel_Calculation_TextData::TRIMSPACES',
1923
- 'argumentCount' => '1'
1924
- ),
1925
- 'TRIMMEAN' => array(
1926
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1927
- 'functionCall' => 'PHPExcel_Calculation_Statistical::TRIMMEAN',
1928
- 'argumentCount' => '2'
1929
- ),
1930
- 'TRUE' => array(
1931
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOGICAL,
1932
- 'functionCall' => 'PHPExcel_Calculation_Logical::TRUE',
1933
- 'argumentCount' => '0'
1934
- ),
1935
- 'TRUNC' => array(
1936
- 'category' => PHPExcel_Calculation_Function::CATEGORY_MATH_AND_TRIG,
1937
- 'functionCall' => 'PHPExcel_Calculation_MathTrig::TRUNC',
1938
- 'argumentCount' => '1,2'
1939
- ),
1940
- 'TTEST' => array(
1941
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1942
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1943
- 'argumentCount' => '4'
1944
- ),
1945
- 'TYPE' => array(
1946
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1947
- 'functionCall' => 'PHPExcel_Calculation_Functions::TYPE',
1948
- 'argumentCount' => '1'
1949
- ),
1950
- 'UPPER' => array(
1951
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1952
- 'functionCall' => 'PHPExcel_Calculation_TextData::UPPERCASE',
1953
- 'argumentCount' => '1'
1954
- ),
1955
- 'USDOLLAR' => array(
1956
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1957
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1958
- 'argumentCount' => '2'
1959
- ),
1960
- 'VALUE' => array(
1961
- 'category' => PHPExcel_Calculation_Function::CATEGORY_TEXT_AND_DATA,
1962
- 'functionCall' => 'PHPExcel_Calculation_TextData::VALUE',
1963
- 'argumentCount' => '1'
1964
- ),
1965
- 'VAR' => array(
1966
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1967
- 'functionCall' => 'PHPExcel_Calculation_Statistical::VARFunc',
1968
- 'argumentCount' => '1+'
1969
- ),
1970
- 'VARA' => array(
1971
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1972
- 'functionCall' => 'PHPExcel_Calculation_Statistical::VARA',
1973
- 'argumentCount' => '1+'
1974
- ),
1975
- 'VARP' => array(
1976
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1977
- 'functionCall' => 'PHPExcel_Calculation_Statistical::VARP',
1978
- 'argumentCount' => '1+'
1979
- ),
1980
- 'VARPA' => array(
1981
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
1982
- 'functionCall' => 'PHPExcel_Calculation_Statistical::VARPA',
1983
- 'argumentCount' => '1+'
1984
- ),
1985
- 'VDB' => array(
1986
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
1987
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
1988
- 'argumentCount' => '5-7'
1989
- ),
1990
- 'VERSION' => array(
1991
- 'category' => PHPExcel_Calculation_Function::CATEGORY_INFORMATION,
1992
- 'functionCall' => 'PHPExcel_Calculation_Functions::VERSION',
1993
- 'argumentCount' => '0'
1994
- ),
1995
- 'VLOOKUP' => array(
1996
- 'category' => PHPExcel_Calculation_Function::CATEGORY_LOOKUP_AND_REFERENCE,
1997
- 'functionCall' => 'PHPExcel_Calculation_LookupRef::VLOOKUP',
1998
- 'argumentCount' => '3,4'
1999
- ),
2000
- 'WEEKDAY' => array(
2001
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
2002
- 'functionCall' => 'PHPExcel_Calculation_DateTime::DAYOFWEEK',
2003
- 'argumentCount' => '1,2'
2004
- ),
2005
- 'WEEKNUM' => array(
2006
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
2007
- 'functionCall' => 'PHPExcel_Calculation_DateTime::WEEKOFYEAR',
2008
- 'argumentCount' => '1,2'
2009
- ),
2010
- 'WEIBULL' => array(
2011
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
2012
- 'functionCall' => 'PHPExcel_Calculation_Statistical::WEIBULL',
2013
- 'argumentCount' => '4'
2014
- ),
2015
- 'WORKDAY' => array(
2016
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
2017
- 'functionCall' => 'PHPExcel_Calculation_DateTime::WORKDAY',
2018
- 'argumentCount' => '2+'
2019
- ),
2020
- 'XIRR' => array(
2021
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
2022
- 'functionCall' => 'PHPExcel_Calculation_Financial::XIRR',
2023
- 'argumentCount' => '2,3'
2024
- ),
2025
- 'XNPV' => array(
2026
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
2027
- 'functionCall' => 'PHPExcel_Calculation_Financial::XNPV',
2028
- 'argumentCount' => '3'
2029
- ),
2030
- 'YEAR' => array(
2031
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
2032
- 'functionCall' => 'PHPExcel_Calculation_DateTime::YEAR',
2033
- 'argumentCount' => '1'
2034
- ),
2035
- 'YEARFRAC' => array(
2036
- 'category' => PHPExcel_Calculation_Function::CATEGORY_DATE_AND_TIME,
2037
- 'functionCall' => 'PHPExcel_Calculation_DateTime::YEARFRAC',
2038
- 'argumentCount' => '2,3'
2039
- ),
2040
- 'YIELD' => array(
2041
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
2042
- 'functionCall' => 'PHPExcel_Calculation_Functions::DUMMY',
2043
- 'argumentCount' => '6,7'
2044
- ),
2045
- 'YIELDDISC' => array(
2046
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
2047
- 'functionCall' => 'PHPExcel_Calculation_Financial::YIELDDISC',
2048
- 'argumentCount' => '4,5'
2049
- ),
2050
- 'YIELDMAT' => array(
2051
- 'category' => PHPExcel_Calculation_Function::CATEGORY_FINANCIAL,
2052
- 'functionCall' => 'PHPExcel_Calculation_Financial::YIELDMAT',
2053
- 'argumentCount' => '5,6'
2054
- ),
2055
- 'ZTEST' => array(
2056
- 'category' => PHPExcel_Calculation_Function::CATEGORY_STATISTICAL,
2057
- 'functionCall' => 'PHPExcel_Calculation_Statistical::ZTEST',
2058
- 'argumentCount' => '2-3'
2059
- )
2060
- );
2061
-
2062
- // Internal functions used for special control purposes
2063
- private static $controlFunctions = array(
2064
- 'MKMATRIX' => array(
2065
- 'argumentCount' => '*',
2066
- 'functionCall' => 'self::mkMatrix'
2067
- )
2068
- );
2069
-
2070
-
2071
- public function __construct(PHPExcel $workbook = null)
2072
- {
2073
- $this->delta = 1 * pow(10, 0 - ini_get('precision'));
2074
-
2075
- $this->workbook = $workbook;
2076
- $this->cyclicReferenceStack = new PHPExcel_CalcEngine_CyclicReferenceStack();
2077
- $this->_debugLog = new PHPExcel_CalcEngine_Logger($this->cyclicReferenceStack);
2078
- }
2079
-
2080
-
2081
- private static function loadLocales()
2082
- {
2083
- $localeFileDirectory = PHPEXCEL_ROOT.'PHPExcel/locale/';
2084
- foreach (glob($localeFileDirectory.'/*', GLOB_ONLYDIR) as $filename) {
2085
- $filename = substr($filename, strlen($localeFileDirectory)+1);
2086
- if ($filename != 'en') {
2087
- self::$validLocaleLanguages[] = $filename;
2088
- }
2089
- }
2090
- }
2091
-
2092
- /**
2093
- * Get an instance of this class
2094
- *
2095
- * @access public
2096
- * @param PHPExcel $workbook Injected workbook for working with a PHPExcel object,
2097
- * or NULL to create a standalone claculation engine
2098
- * @return PHPExcel_Calculation
2099
- */
2100
- public static function getInstance(PHPExcel $workbook = null)
2101
- {
2102
- if ($workbook !== null) {
2103
- $instance = $workbook->getCalculationEngine();
2104
- if (isset($instance)) {
2105
- return $instance;
2106
- }
2107
- }
2108
-
2109
- if (!isset(self::$instance) || (self::$instance === null)) {
2110
- self::$instance = new PHPExcel_Calculation();
2111
- }
2112
- return self::$instance;
2113
- }
2114
-
2115
- /**
2116
- * Unset an instance of this class
2117
- *
2118
- * @access public
2119
- */
2120
- public function __destruct()
2121
- {
2122
- $this->workbook = null;
2123
- }
2124
-
2125
- /**
2126
- * Flush the calculation cache for any existing instance of this class
2127
- * but only if a PHPExcel_Calculation instance exists
2128
- *
2129
- * @access public
2130
- * @return null
2131
- */
2132
- public function flushInstance()
2133
- {
2134
- $this->clearCalculationCache();
2135
- }
2136
-
2137
-
2138
- /**
2139
- * Get the debuglog for this claculation engine instance
2140
- *
2141
- * @access public
2142
- * @return PHPExcel_CalcEngine_Logger
2143
- */
2144
- public function getDebugLog()
2145
- {
2146
- return $this->_debugLog;
2147
- }
2148
-
2149
- /**
2150
- * __clone implementation. Cloning should not be allowed in a Singleton!
2151
- *
2152
- * @access public
2153
- * @throws PHPExcel_Calculation_Exception
2154
- */
2155
- final public function __clone()
2156
- {
2157
- throw new PHPExcel_Calculation_Exception('Cloning the calculation engine is not allowed!');
2158
- }
2159
-
2160
-
2161
- /**
2162
- * Return the locale-specific translation of TRUE
2163
- *
2164
- * @access public
2165
- * @return string locale-specific translation of TRUE
2166
- */
2167
- public static function getTRUE()
2168
- {
2169
- return self::$localeBoolean['TRUE'];
2170
- }
2171
-
2172
- /**
2173
- * Return the locale-specific translation of FALSE
2174
- *
2175
- * @access public
2176
- * @return string locale-specific translation of FALSE
2177
- */
2178
- public static function getFALSE()
2179
- {
2180
- return self::$localeBoolean['FALSE'];
2181
- }
2182
-
2183
- /**
2184
- * Set the Array Return Type (Array or Value of first element in the array)
2185
- *
2186
- * @access public
2187
- * @param string $returnType Array return type
2188
- * @return boolean Success or failure
2189
- */
2190
- public static function setArrayReturnType($returnType)
2191
- {
2192
- if (($returnType == self::RETURN_ARRAY_AS_VALUE) ||
2193
- ($returnType == self::RETURN_ARRAY_AS_ERROR) ||
2194
- ($returnType == self::RETURN_ARRAY_AS_ARRAY)) {
2195
- self::$returnArrayAsType = $returnType;
2196
- return true;
2197
- }
2198
- return false;
2199
- }
2200
-
2201
-
2202
- /**
2203
- * Return the Array Return Type (Array or Value of first element in the array)
2204
- *
2205
- * @access public
2206
- * @return string $returnType Array return type
2207
- */
2208
- public static function getArrayReturnType()
2209
- {
2210
- return self::$returnArrayAsType;
2211
- }
2212
-
2213
-
2214
- /**
2215
- * Is calculation caching enabled?
2216
- *
2217
- * @access public
2218
- * @return boolean
2219
- */
2220
- public function getCalculationCacheEnabled()
2221
- {
2222
- return $this->calculationCacheEnabled;
2223
- }
2224
-
2225
- /**
2226
- * Enable/disable calculation cache
2227
- *
2228
- * @access public
2229
- * @param boolean $pValue
2230
- */
2231
- public function setCalculationCacheEnabled($pValue = true)
2232
- {
2233
- $this->calculationCacheEnabled = $pValue;
2234
- $this->clearCalculationCache();
2235
- }
2236
-
2237
-
2238
- /**
2239
- * Enable calculation cache
2240
- */
2241
- public function enableCalculationCache()
2242
- {
2243
- $this->setCalculationCacheEnabled(true);
2244
- }
2245
-
2246
-
2247
- /**
2248
- * Disable calculation cache
2249
- */
2250
- public function disableCalculationCache()
2251
- {
2252
- $this->setCalculationCacheEnabled(false);
2253
- }
2254
-
2255
-
2256
- /**
2257
- * Clear calculation cache
2258
- */
2259
- public function clearCalculationCache()
2260
- {
2261
- $this->calculationCache = array();
2262
- }
2263
-
2264
- /**
2265
- * Clear calculation cache for a specified worksheet
2266
- *
2267
- * @param string $worksheetName
2268
- */
2269
- public function clearCalculationCacheForWorksheet($worksheetName)
2270
- {
2271
- if (isset($this->calculationCache[$worksheetName])) {
2272
- unset($this->calculationCache[$worksheetName]);
2273
- }
2274
- }
2275
-
2276
- /**
2277
- * Rename calculation cache for a specified worksheet
2278
- *
2279
- * @param string $fromWorksheetName
2280
- * @param string $toWorksheetName
2281
- */
2282
- public function renameCalculationCacheForWorksheet($fromWorksheetName, $toWorksheetName)
2283
- {
2284
- if (isset($this->calculationCache[$fromWorksheetName])) {
2285
- $this->calculationCache[$toWorksheetName] = &$this->calculationCache[$fromWorksheetName];
2286
- unset($this->calculationCache[$fromWorksheetName]);
2287
- }
2288
- }
2289
-
2290
-
2291
- /**
2292
- * Get the currently defined locale code
2293
- *
2294
- * @return string
2295
- */
2296
- public function getLocale()
2297
- {
2298
- return self::$localeLanguage;
2299
- }
2300
-
2301
-
2302
- /**
2303
- * Set the locale code
2304
- *
2305
- * @param string $locale The locale to use for formula translation
2306
- * @return boolean
2307
- */
2308
- public function setLocale($locale = 'en_us')
2309
- {
2310
- // Identify our locale and language
2311
- $language = $locale = strtolower($locale);
2312
- if (strpos($locale, '_') !== false) {
2313
- list($language) = explode('_', $locale);
2314
- }
2315
-
2316
- if (count(self::$validLocaleLanguages) == 1) {
2317
- self::loadLocales();
2318
- }
2319
- // Test whether we have any language data for this language (any locale)
2320
- if (in_array($language, self::$validLocaleLanguages)) {
2321
- // initialise language/locale settings
2322
- self::$localeFunctions = array();
2323
- self::$localeArgumentSeparator = ',';
2324
- self::$localeBoolean = array('TRUE' => 'TRUE', 'FALSE' => 'FALSE', 'NULL' => 'NULL');
2325
- // Default is English, if user isn't requesting english, then read the necessary data from the locale files
2326
- if ($locale != 'en_us') {
2327
- // Search for a file with a list of function names for locale
2328
- $functionNamesFile = PHPEXCEL_ROOT . 'PHPExcel'.DIRECTORY_SEPARATOR.'locale'.DIRECTORY_SEPARATOR.str_replace('_', DIRECTORY_SEPARATOR, $locale).DIRECTORY_SEPARATOR.'functions';
2329
- if (!file_exists($functionNamesFile)) {
2330
- // If there isn't a locale specific function file, look for a language specific function file
2331
- $functionNamesFile = PHPEXCEL_ROOT . 'PHPExcel'.DIRECTORY_SEPARATOR.'locale'.DIRECTORY_SEPARATOR.$language.DIRECTORY_SEPARATOR.'functions';
2332
- if (!file_exists($functionNamesFile)) {
2333
- return false;
2334
- }
2335
- }
2336
- // Retrieve the list of locale or language specific function names
2337
- $localeFunctions = file($functionNamesFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
2338
- foreach ($localeFunctions as $localeFunction) {
2339
- list($localeFunction) = explode('##', $localeFunction); // Strip out comments
2340
- if (strpos($localeFunction, '=') !== false) {
2341
- list($fName, $lfName) = explode('=', $localeFunction);
2342
- $fName = trim($fName);
2343
- $lfName = trim($lfName);
2344
- if ((isset(self::$PHPExcelFunctions[$fName])) && ($lfName != '') && ($fName != $lfName)) {
2345
- self::$localeFunctions[$fName] = $lfName;
2346
- }
2347
- }
2348
- }
2349
- // Default the TRUE and FALSE constants to the locale names of the TRUE() and FALSE() functions
2350
- if (isset(self::$localeFunctions['TRUE'])) {
2351
- self::$localeBoolean['TRUE'] = self::$localeFunctions['TRUE'];
2352
- }
2353
- if (isset(self::$localeFunctions['FALSE'])) {
2354
- self::$localeBoolean['FALSE'] = self::$localeFunctions['FALSE'];
2355
- }
2356
-
2357
- $configFile = PHPEXCEL_ROOT . 'PHPExcel'.DIRECTORY_SEPARATOR.'locale'.DIRECTORY_SEPARATOR.str_replace('_', DIRECTORY_SEPARATOR, $locale).DIRECTORY_SEPARATOR.'config';
2358
- if (!file_exists($configFile)) {
2359
- $configFile = PHPEXCEL_ROOT . 'PHPExcel'.DIRECTORY_SEPARATOR.'locale'.DIRECTORY_SEPARATOR.$language.DIRECTORY_SEPARATOR.'config';
2360
- }
2361
- if (file_exists($configFile)) {
2362
- $localeSettings = file($configFile, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
2363
- foreach ($localeSettings as $localeSetting) {
2364
- list($localeSetting) = explode('##', $localeSetting); // Strip out comments
2365
- if (strpos($localeSetting, '=') !== false) {
2366
- list($settingName, $settingValue) = explode('=', $localeSetting);
2367
- $settingName = strtoupper(trim($settingName));
2368
- switch ($settingName) {
2369
- case 'ARGUMENTSEPARATOR':
2370
- self::$localeArgumentSeparator = trim($settingValue);
2371
- break;
2372
- }
2373
- }
2374
- }
2375
- }
2376
- }
2377
-
2378
- self::$functionReplaceFromExcel = self::$functionReplaceToExcel =
2379
- self::$functionReplaceFromLocale = self::$functionReplaceToLocale = null;
2380
- self::$localeLanguage = $locale;
2381
- return true;
2382
- }
2383
- return false;
2384
- }
2385
-
2386
-
2387
-
2388
- public static function translateSeparator($fromSeparator, $toSeparator, $formula, &$inBraces)
2389
- {
2390
- $strlen = mb_strlen($formula);
2391
- for ($i = 0; $i < $strlen; ++$i) {
2392
- $chr = mb_substr($formula, $i, 1);
2393
- switch ($chr) {
2394
- case '{':
2395
- $inBraces = true;
2396
- break;
2397
- case '}':
2398
- $inBraces = false;
2399
- break;
2400
- case $fromSeparator:
2401
- if (!$inBraces) {
2402
- $formula = mb_substr($formula, 0, $i).$toSeparator.mb_substr($formula, $i+1);
2403
- }
2404
- }
2405
- }
2406
- return $formula;
2407
- }
2408
-
2409
- private static function translateFormula($from, $to, $formula, $fromSeparator, $toSeparator)
2410
- {
2411
- // Convert any Excel function names to the required language
2412
- if (self::$localeLanguage !== 'en_us') {
2413
- $inBraces = false;
2414
- // If there is the possibility of braces within a quoted string, then we don't treat those as matrix indicators
2415
- if (strpos($formula, '"') !== false) {
2416
- // So instead we skip replacing in any quoted strings by only replacing in every other array element after we've exploded
2417
- // the formula
2418
- $temp = explode('"', $formula);
2419
- $i = false;
2420
- foreach ($temp as &$value) {
2421
- // Only count/replace in alternating array entries
2422
- if ($i = !$i) {
2423
- $value = preg_replace($from, $to, $value);
2424
- $value = self::translateSeparator($fromSeparator, $toSeparator, $value, $inBraces);
2425
- }
2426
- }
2427
- unset($value);
2428
- // Then rebuild the formula string
2429
- $formula = implode('"', $temp);
2430
- } else {
2431
- // If there's no quoted strings, then we do a simple count/replace
2432
- $formula = preg_replace($from, $to, $formula);
2433
- $formula = self::translateSeparator($fromSeparator, $toSeparator, $formula, $inBraces);
2434
- }
2435
- }
2436
-
2437
- return $formula;
2438
- }
2439
-
2440
- private static $functionReplaceFromExcel = null;
2441
- private static $functionReplaceToLocale = null;
2442
-
2443
- public function _translateFormulaToLocale($formula)
2444
- {
2445
- if (self::$functionReplaceFromExcel === null) {
2446
- self::$functionReplaceFromExcel = array();
2447
- foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {
2448
- self::$functionReplaceFromExcel[] = '/(@?[^\w\.])'.preg_quote($excelFunctionName).'([\s]*\()/Ui';
2449
- }
2450
- foreach (array_keys(self::$localeBoolean) as $excelBoolean) {
2451
- self::$functionReplaceFromExcel[] = '/(@?[^\w\.])'.preg_quote($excelBoolean).'([^\w\.])/Ui';
2452
- }
2453
-
2454
- }
2455
-
2456
- if (self::$functionReplaceToLocale === null) {
2457
- self::$functionReplaceToLocale = array();
2458
- foreach (array_values(self::$localeFunctions) as $localeFunctionName) {
2459
- self::$functionReplaceToLocale[] = '$1'.trim($localeFunctionName).'$2';
2460
- }
2461
- foreach (array_values(self::$localeBoolean) as $localeBoolean) {
2462
- self::$functionReplaceToLocale[] = '$1'.trim($localeBoolean).'$2';
2463
- }
2464
- }
2465
-
2466
- return self::translateFormula(self::$functionReplaceFromExcel, self::$functionReplaceToLocale, $formula, ',', self::$localeArgumentSeparator);
2467
- }
2468
-
2469
-
2470
- private static $functionReplaceFromLocale = null;
2471
- private static $functionReplaceToExcel = null;
2472
-
2473
- public function _translateFormulaToEnglish($formula)
2474
- {
2475
- if (self::$functionReplaceFromLocale === null) {
2476
- self::$functionReplaceFromLocale = array();
2477
- foreach (array_values(self::$localeFunctions) as $localeFunctionName) {
2478
- self::$functionReplaceFromLocale[] = '/(@?[^\w\.])'.preg_quote($localeFunctionName).'([\s]*\()/Ui';
2479
- }
2480
- foreach (array_values(self::$localeBoolean) as $excelBoolean) {
2481
- self::$functionReplaceFromLocale[] = '/(@?[^\w\.])'.preg_quote($excelBoolean).'([^\w\.])/Ui';
2482
- }
2483
- }
2484
-
2485
- if (self::$functionReplaceToExcel === null) {
2486
- self::$functionReplaceToExcel = array();
2487
- foreach (array_keys(self::$localeFunctions) as $excelFunctionName) {
2488
- self::$functionReplaceToExcel[] = '$1'.trim($excelFunctionName).'$2';
2489
- }
2490
- foreach (array_keys(self::$localeBoolean) as $excelBoolean) {
2491
- self::$functionReplaceToExcel[] = '$1'.trim($excelBoolean).'$2';
2492
- }
2493
- }
2494
-
2495
- return self::translateFormula(self::$functionReplaceFromLocale, self::$functionReplaceToExcel, $formula, self::$localeArgumentSeparator, ',');
2496
- }
2497
-
2498
-
2499
- public static function localeFunc($function)
2500
- {
2501
- if (self::$localeLanguage !== 'en_us') {
2502
- $functionName = trim($function, '(');
2503
- if (isset(self::$localeFunctions[$functionName])) {
2504
- $brace = ($functionName != $function);
2505
- $function = self::$localeFunctions[$functionName];
2506
- if ($brace) {
2507
- $function .= '(';
2508
- }
2509
- }
2510
- }
2511
- return $function;
2512
- }
2513
-
2514
-
2515
-
2516
-
2517
- /**
2518
- * Wrap string values in quotes
2519
- *
2520
- * @param mixed $value
2521
- * @return mixed
2522
- */
2523
- public static function wrapResult($value)
2524
- {
2525
- if (is_string($value)) {
2526
- // Error values cannot be "wrapped"
2527
- if (preg_match('/^'.self::CALCULATION_REGEXP_ERROR.'$/i', $value, $match)) {
2528
- // Return Excel errors "as is"
2529
- return $value;
2530
- }
2531
- // Return strings wrapped in quotes
2532
- return '"'.$value.'"';
2533
- // Convert numeric errors to NaN error
2534
- } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {
2535
- return PHPExcel_Calculation_Functions::NaN();
2536
- }
2537
-
2538
- return $value;
2539
- }
2540
-
2541
-
2542
- /**
2543
- * Remove quotes used as a wrapper to identify string values
2544
- *
2545
- * @param mixed $value
2546
- * @return mixed
2547
- */
2548
- public static function unwrapResult($value)
2549
- {
2550
- if (is_string($value)) {
2551
- if ((isset($value{0})) && ($value{0} == '"') && (substr($value, -1) == '"')) {
2552
- return substr($value, 1, -1);
2553
- }
2554
- // Convert numeric errors to NaN error
2555
- } elseif ((is_float($value)) && ((is_nan($value)) || (is_infinite($value)))) {
2556
- return PHPExcel_Calculation_Functions::NaN();
2557
- }
2558
- return $value;
2559
- }
2560
-
2561
-
2562
-
2563
-
2564
- /**
2565
- * Calculate cell value (using formula from a cell ID)
2566
- * Retained for backward compatibility
2567
- *
2568
- * @access public
2569
- * @param PHPExcel_Cell $pCell Cell to calculate
2570
- * @return mixed
2571
- * @throws PHPExcel_Calculation_Exception
2572
- */
2573
- public function calculate(PHPExcel_Cell $pCell = null)
2574
- {
2575
- try {
2576
- return $this->calculateCellValue($pCell);
2577
- } catch (PHPExcel_Exception $e) {
2578
- throw new PHPExcel_Calculation_Exception($e->getMessage());
2579
- }
2580
- }
2581
-
2582
-
2583
- /**
2584
- * Calculate the value of a cell formula
2585
- *
2586
- * @access public
2587
- * @param PHPExcel_Cell $pCell Cell to calculate
2588
- * @param Boolean $resetLog Flag indicating whether the debug log should be reset or not
2589
- * @return mixed
2590
- * @throws PHPExcel_Calculation_Exception
2591
- */
2592
- public function calculateCellValue(PHPExcel_Cell $pCell = null, $resetLog = true)
2593
- {
2594
- if ($pCell === null) {
2595
- return null;
2596
- }
2597
-
2598
- $returnArrayAsType = self::$returnArrayAsType;
2599
- if ($resetLog) {
2600
- // Initialise the logging settings if requested
2601
- $this->formulaError = null;
2602
- $this->_debugLog->clearLog();
2603
- $this->cyclicReferenceStack->clear();
2604
- $this->cyclicFormulaCounter = 1;
2605
-
2606
- self::$returnArrayAsType = self::RETURN_ARRAY_AS_ARRAY;
2607
- }
2608
-
2609
- // Execute the calculation for the cell formula
2610
- $this->cellStack[] = array(
2611
- 'sheet' => $pCell->getWorksheet()->getTitle(),
2612
- 'cell' => $pCell->getCoordinate(),
2613
- );
2614
- try {
2615
- $result = self::unwrapResult($this->_calculateFormulaValue($pCell->getValue(), $pCell->getCoordinate(), $pCell));
2616
- $cellAddress = array_pop($this->cellStack);
2617
- $this->workbook->getSheetByName($cellAddress['sheet'])->getCell($cellAddress['cell']);
2618
- } catch (PHPExcel_Exception $e) {
2619
- $cellAddress = array_pop($this->cellStack);
2620
- $this->workbook->getSheetByName($cellAddress['sheet'])->getCell($cellAddress['cell']);
2621
- throw new PHPExcel_Calculation_Exception($e->getMessage());
2622
- }
2623
-
2624
- if ((is_array($result)) && (self::$returnArrayAsType != self::RETURN_ARRAY_AS_ARRAY)) {
2625
- self::$returnArrayAsType = $returnArrayAsType;
2626
- $testResult = PHPExcel_Calculation_Functions::flattenArray($result);
2627
- if (self::$returnArrayAsType == self::RETURN_ARRAY_AS_ERROR) {
2628
- return PHPExcel_Calculation_Functions::VALUE();
2629
- }
2630
- // If there's only a single cell in the array, then we allow it
2631
- if (count($testResult) != 1) {
2632
- // If keys are numeric, then it's a matrix result rather than a cell range result, so we permit it
2633
- $r = array_keys($result);
2634
- $r = array_shift($r);
2635
- if (!is_numeric($r)) {
2636
- return PHPExcel_Calculation_Functions::VALUE();
2637
- }
2638
- if (is_array($result[$r])) {
2639
- $c = array_keys($result[$r]);
2640
- $c = array_shift($c);
2641
- if (!is_numeric($c)) {
2642
- return PHPExcel_Calculation_Functions::VALUE();
2643
- }
2644
- }
2645
- }
2646
- $result = array_shift($testResult);
2647
- }
2648
- self::$returnArrayAsType = $returnArrayAsType;
2649
-
2650
-
2651
- if ($result === null) {
2652
- return 0;
2653
- } elseif ((is_float($result)) && ((is_nan($result)) || (is_infinite($result)))) {
2654
- return PHPExcel_Calculation_Functions::NaN();
2655
- }
2656
- return $result;
2657
- }
2658
-
2659
-
2660
- /**
2661
- * Validate and parse a formula string
2662
- *
2663
- * @param string $formula Formula to parse
2664
- * @return array
2665
- * @throws PHPExcel_Calculation_Exception
2666
- */
2667
- public function parseFormula($formula)
2668
- {
2669
- // Basic validation that this is indeed a formula
2670
- // We return an empty array if not
2671
- $formula = trim($formula);
2672
- if ((!isset($formula{0})) || ($formula{0} != '=')) {
2673
- return array();
2674
- }
2675
- $formula = ltrim(substr($formula, 1));
2676
- if (!isset($formula{0})) {
2677
- return array();
2678
- }
2679
-
2680
- // Parse the formula and return the token stack
2681
- return $this->_parseFormula($formula);
2682
- }
2683
-
2684
-
2685
- /**
2686
- * Calculate the value of a formula
2687
- *
2688
- * @param string $formula Formula to parse
2689
- * @param string $cellID Address of the cell to calculate
2690
- * @param PHPExcel_Cell $pCell Cell to calculate
2691
- * @return mixed
2692
- * @throws PHPExcel_Calculation_Exception
2693
- */
2694
- public function calculateFormula($formula, $cellID = null, PHPExcel_Cell $pCell = null)
2695
- {
2696
- // Initialise the logging settings
2697
- $this->formulaError = null;
2698
- $this->_debugLog->clearLog();
2699
- $this->cyclicReferenceStack->clear();
2700
-
2701
- if ($this->workbook !== null && $cellID === null && $pCell === null) {
2702
- $cellID = 'A1';
2703
- $pCell = $this->workbook->getActiveSheet()->getCell($cellID);
2704
- } else {
2705
- // Disable calculation cacheing because it only applies to cell calculations, not straight formulae
2706
- // But don't actually flush any cache
2707
- $resetCache = $this->getCalculationCacheEnabled();
2708
- $this->calculationCacheEnabled = false;
2709
- }
2710
-
2711
- // Execute the calculation
2712
- try {
2713
- $result = self::unwrapResult($this->_calculateFormulaValue($formula, $cellID, $pCell));
2714
- } catch (PHPExcel_Exception $e) {
2715
- throw new PHPExcel_Calculation_Exception($e->getMessage());
2716
- }
2717
-
2718
- if ($this->workbook === null) {
2719
- // Reset calculation cacheing to its previous state
2720
- $this->calculationCacheEnabled = $resetCache;
2721
- }
2722
-
2723
- return $result;
2724
- }
2725
-
2726
-
2727
- public function getValueFromCache($cellReference, &$cellValue)
2728
- {
2729
- // Is calculation cacheing enabled?
2730
- // Is the value present in calculation cache?
2731
- $this->_debugLog->writeDebugLog('Testing cache value for cell ', $cellReference);
2732
- if (($this->calculationCacheEnabled) && (isset($this->calculationCache[$cellReference]))) {
2733
- $this->_debugLog->writeDebugLog('Retrieving value for cell ', $cellReference, ' from cache');
2734
- // Return the cached result
2735
- $cellValue = $this->calculationCache[$cellReference];
2736
- return true;
2737
- }
2738
- return false;
2739
- }
2740
-
2741
- public function saveValueToCache($cellReference, $cellValue)
2742
- {
2743
- if ($this->calculationCacheEnabled) {
2744
- $this->calculationCache[$cellReference] = $cellValue;
2745
- }
2746
- }
2747
-
2748
- /**
2749
- * Parse a cell formula and calculate its value
2750
- *
2751
- * @param string $formula The formula to parse and calculate
2752
- * @param string $cellID The ID (e.g. A3) of the cell that we are calculating
2753
- * @param PHPExcel_Cell $pCell Cell to calculate
2754
- * @return mixed
2755
- * @throws PHPExcel_Calculation_Exception
2756
- */
2757
- public function _calculateFormulaValue($formula, $cellID = null, PHPExcel_Cell $pCell = null)
2758
- {
2759
- $cellValue = null;
2760
-
2761
- // Basic validation that this is indeed a formula
2762
- // We simply return the cell value if not
2763
- $formula = trim($formula);
2764
- if ($formula{0} != '=') {
2765
- return self::wrapResult($formula);
2766
- }
2767
- $formula = ltrim(substr($formula, 1));
2768
- if (!isset($formula{0})) {
2769
- return self::wrapResult($formula);
2770
- }
2771
-
2772
- $pCellParent = ($pCell !== null) ? $pCell->getWorksheet() : null;
2773
- $wsTitle = ($pCellParent !== null) ? $pCellParent->getTitle() : "\x00Wrk";
2774
- $wsCellReference = $wsTitle . '!' . $cellID;
2775
-
2776
- if (($cellID !== null) && ($this->getValueFromCache($wsCellReference, $cellValue))) {
2777
- return $cellValue;
2778
- }
2779
-
2780
- if (($wsTitle{0} !== "\x00") && ($this->cyclicReferenceStack->onStack($wsCellReference))) {
2781
- if ($this->cyclicFormulaCount <= 0) {
2782
- $this->cyclicFormulaCell = '';
2783
- return $this->raiseFormulaError('Cyclic Reference in Formula');
2784
- } elseif ($this->cyclicFormulaCell === $wsCellReference) {
2785
- ++$this->cyclicFormulaCounter;
2786
- if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {
2787
- $this->cyclicFormulaCell = '';
2788
- return $cellValue;
2789
- }
2790
- } elseif ($this->cyclicFormulaCell == '') {
2791
- if ($this->cyclicFormulaCounter >= $this->cyclicFormulaCount) {
2792
- return $cellValue;
2793
- }
2794
- $this->cyclicFormulaCell = $wsCellReference;
2795
- }
2796
- }
2797
-
2798
- // Parse the formula onto the token stack and calculate the value
2799
- $this->cyclicReferenceStack->push($wsCellReference);
2800
- $cellValue = $this->processTokenStack($this->_parseFormula($formula, $pCell), $cellID, $pCell);
2801
- $this->cyclicReferenceStack->pop();
2802
-
2803
- // Save to calculation cache
2804
- if ($cellID !== null) {
2805
- $this->saveValueToCache($wsCellReference, $cellValue);
2806
- }
2807
-
2808
- // Return the calculated value
2809
- return $cellValue;
2810
- }
2811
-
2812
-
2813
- /**
2814
- * Ensure that paired matrix operands are both matrices and of the same size
2815
- *
2816
- * @param mixed &$operand1 First matrix operand
2817
- * @param mixed &$operand2 Second matrix operand
2818
- * @param integer $resize Flag indicating whether the matrices should be resized to match
2819
- * and (if so), whether the smaller dimension should grow or the
2820
- * larger should shrink.
2821
- * 0 = no resize
2822
- * 1 = shrink to fit
2823
- * 2 = extend to fit
2824
- */
2825
- private static function checkMatrixOperands(&$operand1, &$operand2, $resize = 1)
2826
- {
2827
- // Examine each of the two operands, and turn them into an array if they aren't one already
2828
- // Note that this function should only be called if one or both of the operand is already an array
2829
- if (!is_array($operand1)) {
2830
- list($matrixRows, $matrixColumns) = self::getMatrixDimensions($operand2);
2831
- $operand1 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand1));
2832
- $resize = 0;
2833
- } elseif (!is_array($operand2)) {
2834
- list($matrixRows, $matrixColumns) = self::getMatrixDimensions($operand1);
2835
- $operand2 = array_fill(0, $matrixRows, array_fill(0, $matrixColumns, $operand2));
2836
- $resize = 0;
2837
- }
2838
-
2839
- list($matrix1Rows, $matrix1Columns) = self::getMatrixDimensions($operand1);
2840
- list($matrix2Rows, $matrix2Columns) = self::getMatrixDimensions($operand2);
2841
- if (($matrix1Rows == $matrix2Columns) && ($matrix2Rows == $matrix1Columns)) {
2842
- $resize = 1;
2843
- }
2844
-
2845
- if ($resize == 2) {
2846
- // Given two matrices of (potentially) unequal size, convert the smaller in each dimension to match the larger
2847
- self::resizeMatricesExtend($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);
2848
- } elseif ($resize == 1) {
2849
- // Given two matrices of (potentially) unequal size, convert the larger in each dimension to match the smaller
2850
- self::resizeMatricesShrink($operand1, $operand2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);
2851
- }
2852
- return array( $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns);
2853
- }
2854
-
2855
-
2856
- /**
2857
- * Read the dimensions of a matrix, and re-index it with straight numeric keys starting from row 0, column 0
2858
- *
2859
- * @param mixed &$matrix matrix operand
2860
- * @return array An array comprising the number of rows, and number of columns
2861
- */
2862
- private static function getMatrixDimensions(&$matrix)
2863
- {
2864
- $matrixRows = count($matrix);
2865
- $matrixColumns = 0;
2866
- foreach ($matrix as $rowKey => $rowValue) {
2867
- $matrixColumns = max(count($rowValue), $matrixColumns);
2868
- if (!is_array($rowValue)) {
2869
- $matrix[$rowKey] = array($rowValue);
2870
- } else {
2871
- $matrix[$rowKey] = array_values($rowValue);
2872
- }
2873
- }
2874
- $matrix = array_values($matrix);
2875
- return array($matrixRows, $matrixColumns);
2876
- }
2877
-
2878
-
2879
- /**
2880
- * Ensure that paired matrix operands are both matrices of the same size
2881
- *
2882
- * @param mixed &$matrix1 First matrix operand
2883
- * @param mixed &$matrix2 Second matrix operand
2884
- * @param integer $matrix1Rows Row size of first matrix operand
2885
- * @param integer $matrix1Columns Column size of first matrix operand
2886
- * @param integer $matrix2Rows Row size of second matrix operand
2887
- * @param integer $matrix2Columns Column size of second matrix operand
2888
- */
2889
- private static function resizeMatricesShrink(&$matrix1, &$matrix2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns)
2890
- {
2891
- if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {
2892
- if ($matrix2Rows < $matrix1Rows) {
2893
- for ($i = $matrix2Rows; $i < $matrix1Rows; ++$i) {
2894
- unset($matrix1[$i]);
2895
- }
2896
- }
2897
- if ($matrix2Columns < $matrix1Columns) {
2898
- for ($i = 0; $i < $matrix1Rows; ++$i) {
2899
- for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {
2900
- unset($matrix1[$i][$j]);
2901
- }
2902
- }
2903
- }
2904
- }
2905
-
2906
- if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {
2907
- if ($matrix1Rows < $matrix2Rows) {
2908
- for ($i = $matrix1Rows; $i < $matrix2Rows; ++$i) {
2909
- unset($matrix2[$i]);
2910
- }
2911
- }
2912
- if ($matrix1Columns < $matrix2Columns) {
2913
- for ($i = 0; $i < $matrix2Rows; ++$i) {
2914
- for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {
2915
- unset($matrix2[$i][$j]);
2916
- }
2917
- }
2918
- }
2919
- }
2920
- }
2921
-
2922
-
2923
- /**
2924
- * Ensure that paired matrix operands are both matrices of the same size
2925
- *
2926
- * @param mixed &$matrix1 First matrix operand
2927
- * @param mixed &$matrix2 Second matrix operand
2928
- * @param integer $matrix1Rows Row size of first matrix operand
2929
- * @param integer $matrix1Columns Column size of first matrix operand
2930
- * @param integer $matrix2Rows Row size of second matrix operand
2931
- * @param integer $matrix2Columns Column size of second matrix operand
2932
- */
2933
- private static function resizeMatricesExtend(&$matrix1, &$matrix2, $matrix1Rows, $matrix1Columns, $matrix2Rows, $matrix2Columns)
2934
- {
2935
- if (($matrix2Columns < $matrix1Columns) || ($matrix2Rows < $matrix1Rows)) {
2936
- if ($matrix2Columns < $matrix1Columns) {
2937
- for ($i = 0; $i < $matrix2Rows; ++$i) {
2938
- $x = $matrix2[$i][$matrix2Columns-1];
2939
- for ($j = $matrix2Columns; $j < $matrix1Columns; ++$j) {
2940
- $matrix2[$i][$j] = $x;
2941
- }
2942
- }
2943
- }
2944
- if ($matrix2Rows < $matrix1Rows) {
2945
- $x = $matrix2[$matrix2Rows-1];
2946
- for ($i = 0; $i < $matrix1Rows; ++$i) {
2947
- $matrix2[$i] = $x;
2948
- }
2949
- }
2950
- }
2951
-
2952
- if (($matrix1Columns < $matrix2Columns) || ($matrix1Rows < $matrix2Rows)) {
2953
- if ($matrix1Columns < $matrix2Columns) {
2954
- for ($i = 0; $i < $matrix1Rows; ++$i) {
2955
- $x = $matrix1[$i][$matrix1Columns-1];
2956
- for ($j = $matrix1Columns; $j < $matrix2Columns; ++$j) {
2957
- $matrix1[$i][$j] = $x;
2958
- }
2959
- }
2960
- }
2961
- if ($matrix1Rows < $matrix2Rows) {
2962
- $x = $matrix1[$matrix1Rows-1];
2963
- for ($i = 0; $i < $matrix2Rows; ++$i) {
2964
- $matrix1[$i] = $x;
2965
- }
2966
- }
2967
- }
2968
- }
2969
-
2970
-
2971
- /**
2972
- * Format details of an operand for display in the log (based on operand type)
2973
- *
2974
- * @param mixed $value First matrix operand
2975
- * @return mixed
2976
- */
2977
- private function showValue($value)
2978
- {
2979
- if ($this->_debugLog->getWriteDebugLog()) {
2980
- $testArray = PHPExcel_Calculation_Functions::flattenArray($value);
2981
- if (count($testArray) == 1) {
2982
- $value = array_pop($testArray);
2983
- }
2984
-
2985
- if (is_array($value)) {
2986
- $returnMatrix = array();
2987
- $pad = $rpad = ', ';
2988
- foreach ($value as $row) {
2989
- if (is_array($row)) {
2990
- $returnMatrix[] = implode($pad, array_map(array($this, 'showValue'), $row));
2991
- $rpad = '; ';
2992
- } else {
2993
- $returnMatrix[] = $this->showValue($row);
2994
- }
2995
- }
2996
- return '{ '.implode($rpad, $returnMatrix).' }';
2997
- } elseif (is_string($value) && (trim($value, '"') == $value)) {
2998
- return '"'.$value.'"';
2999
- } elseif (is_bool($value)) {
3000
- return ($value) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];
3001
- }
3002
- }
3003
- return PHPExcel_Calculation_Functions::flattenSingleValue($value);
3004
- }
3005
-
3006
-
3007
- /**
3008
- * Format type and details of an operand for display in the log (based on operand type)
3009
- *
3010
- * @param mixed $value First matrix operand
3011
- * @return mixed
3012
- */
3013
- private function showTypeDetails($value)
3014
- {
3015
- if ($this->_debugLog->getWriteDebugLog()) {
3016
- $testArray = PHPExcel_Calculation_Functions::flattenArray($value);
3017
- if (count($testArray) == 1) {
3018
- $value = array_pop($testArray);
3019
- }
3020
-
3021
- if ($value === null) {
3022
- return 'a NULL value';
3023
- } elseif (is_float($value)) {
3024
- $typeString = 'a floating point number';
3025
- } elseif (is_int($value)) {
3026
- $typeString = 'an integer number';
3027
- } elseif (is_bool($value)) {
3028
- $typeString = 'a boolean';
3029
- } elseif (is_array($value)) {
3030
- $typeString = 'a matrix';
3031
- } else {
3032
- if ($value == '') {
3033
- return 'an empty string';
3034
- } elseif ($value{0} == '#') {
3035
- return 'a '.$value.' error';
3036
- } else {
3037
- $typeString = 'a string';
3038
- }
3039
- }
3040
- return $typeString.' with a value of '.$this->showValue($value);
3041
- }
3042
- }
3043
-
3044
-
3045
- private function convertMatrixReferences($formula)
3046
- {
3047
- static $matrixReplaceFrom = array('{', ';', '}');
3048
- static $matrixReplaceTo = array('MKMATRIX(MKMATRIX(', '),MKMATRIX(', '))');
3049
-
3050
- // Convert any Excel matrix references to the MKMATRIX() function
3051
- if (strpos($formula, '{') !== false) {
3052
- // If there is the possibility of braces within a quoted string, then we don't treat those as matrix indicators
3053
- if (strpos($formula, '"') !== false) {
3054
- // So instead we skip replacing in any quoted strings by only replacing in every other array element after we've exploded
3055
- // the formula
3056
- $temp = explode('"', $formula);
3057
- // Open and Closed counts used for trapping mismatched braces in the formula
3058
- $openCount = $closeCount = 0;
3059
- $i = false;
3060
- foreach ($temp as &$value) {
3061
- // Only count/replace in alternating array entries
3062
- if ($i = !$i) {
3063
- $openCount += substr_count($value, '{');
3064
- $closeCount += substr_count($value, '}');
3065
- $value = str_replace($matrixReplaceFrom, $matrixReplaceTo, $value);
3066
- }
3067
- }
3068
- unset($value);
3069
- // Then rebuild the formula string
3070
- $formula = implode('"', $temp);
3071
- } else {
3072
- // If there's no quoted strings, then we do a simple count/replace
3073
- $openCount = substr_count($formula, '{');
3074
- $closeCount = substr_count($formula, '}');
3075
- $formula = str_replace($matrixReplaceFrom, $matrixReplaceTo, $formula);
3076
- }
3077
- // Trap for mismatched braces and trigger an appropriate error
3078
- if ($openCount < $closeCount) {
3079
- if ($openCount > 0) {
3080
- return $this->raiseFormulaError("Formula Error: Mismatched matrix braces '}'");
3081
- } else {
3082
- return $this->raiseFormulaError("Formula Error: Unexpected '}' encountered");
3083
- }
3084
- } elseif ($openCount > $closeCount) {
3085
- if ($closeCount > 0) {
3086
- return $this->raiseFormulaError("Formula Error: Mismatched matrix braces '{'");
3087
- } else {
3088
- return $this->raiseFormulaError("Formula Error: Unexpected '{' encountered");
3089
- }
3090
- }
3091
- }
3092
-
3093
- return $formula;
3094
- }
3095
-
3096
-
3097
- private static function mkMatrix()
3098
- {
3099
- return func_get_args();
3100
- }
3101
-
3102
-
3103
- // Binary Operators
3104
- // These operators always work on two values
3105
- // Array key is the operator, the value indicates whether this is a left or right associative operator
3106
- private static $operatorAssociativity = array(
3107
- '^' => 0, // Exponentiation
3108
- '*' => 0, '/' => 0, // Multiplication and Division
3109
- '+' => 0, '-' => 0, // Addition and Subtraction
3110
- '&' => 0, // Concatenation
3111
- '|' => 0, ':' => 0, // Intersect and Range
3112
- '>' => 0, '<' => 0, '=' => 0, '>=' => 0, '<=' => 0, '<>' => 0 // Comparison
3113
- );
3114
-
3115
- // Comparison (Boolean) Operators
3116
- // These operators work on two values, but always return a boolean result
3117
- private static $comparisonOperators = array('>' => true, '<' => true, '=' => true, '>=' => true, '<=' => true, '<>' => true);
3118
-
3119
- // Operator Precedence
3120
- // This list includes all valid operators, whether binary (including boolean) or unary (such as %)
3121
- // Array key is the operator, the value is its precedence
3122
- private static $operatorPrecedence = array(
3123
- ':' => 8, // Range
3124
- '|' => 7, // Intersect
3125
- '~' => 6, // Negation
3126
- '%' => 5, // Percentage
3127
- '^' => 4, // Exponentiation
3128
- '*' => 3, '/' => 3, // Multiplication and Division
3129
- '+' => 2, '-' => 2, // Addition and Subtraction
3130
- '&' => 1, // Concatenation
3131
- '>' => 0, '<' => 0, '=' => 0, '>=' => 0, '<=' => 0, '<>' => 0 // Comparison
3132
- );
3133
-
3134
- // Convert infix to postfix notation
3135
- private function _parseFormula($formula, PHPExcel_Cell $pCell = null)
3136
- {
3137
- if (($formula = $this->convertMatrixReferences(trim($formula))) === false) {
3138
- return false;
3139
- }
3140
-
3141
- // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent worksheet),
3142
- // so we store the parent worksheet so that we can re-attach it when necessary
3143
- $pCellParent = ($pCell !== null) ? $pCell->getWorksheet() : null;
3144
-
3145
- $regexpMatchString = '/^('.self::CALCULATION_REGEXP_FUNCTION.
3146
- '|'.self::CALCULATION_REGEXP_CELLREF.
3147
- '|'.self::CALCULATION_REGEXP_NUMBER.
3148
- '|'.self::CALCULATION_REGEXP_STRING.
3149
- '|'.self::CALCULATION_REGEXP_OPENBRACE.
3150
- '|'.self::CALCULATION_REGEXP_NAMEDRANGE.
3151
- '|'.self::CALCULATION_REGEXP_ERROR.
3152
- ')/si';
3153
-
3154
- // Start with initialisation
3155
- $index = 0;
3156
- $stack = new PHPExcel_Calculation_Token_Stack;
3157
- $output = array();
3158
- $expectingOperator = false; // We use this test in syntax-checking the expression to determine when a
3159
- // - is a negation or + is a positive operator rather than an operation
3160
- $expectingOperand = false; // We use this test in syntax-checking the expression to determine whether an operand
3161
- // should be null in a function call
3162
- // The guts of the lexical parser
3163
- // Loop through the formula extracting each operator and operand in turn
3164
- while (true) {
3165
- //echo 'Assessing Expression '.substr($formula, $index), PHP_EOL;
3166
- $opCharacter = $formula{$index}; // Get the first character of the value at the current index position
3167
- //echo 'Initial character of expression block is '.$opCharacter, PHP_EOL;
3168
- if ((isset(self::$comparisonOperators[$opCharacter])) && (strlen($formula) > $index) && (isset(self::$comparisonOperators[$formula{$index+1}]))) {
3169
- $opCharacter .= $formula{++$index};
3170
- //echo 'Initial character of expression block is comparison operator '.$opCharacter.PHP_EOL;
3171
- }
3172
-
3173
- // Find out if we're currently at the beginning of a number, variable, cell reference, function, parenthesis or operand
3174
- $isOperandOrFunction = preg_match($regexpMatchString, substr($formula, $index), $match);
3175
- //echo '$isOperandOrFunction is '.(($isOperandOrFunction) ? 'True' : 'False').PHP_EOL;
3176
- //var_dump($match);
3177
-
3178
- if ($opCharacter == '-' && !$expectingOperator) { // Is it a negation instead of a minus?
3179
- //echo 'Element is a Negation operator', PHP_EOL;
3180
- $stack->push('Unary Operator', '~'); // Put a negation on the stack
3181
- ++$index; // and drop the negation symbol
3182
- } elseif ($opCharacter == '%' && $expectingOperator) {
3183
- //echo 'Element is a Percentage operator', PHP_EOL;
3184
- $stack->push('Unary Operator', '%'); // Put a percentage on the stack
3185
- ++$index;
3186
- } elseif ($opCharacter == '+' && !$expectingOperator) { // Positive (unary plus rather than binary operator plus) can be discarded?
3187
- //echo 'Element is a Positive number, not Plus operator', PHP_EOL;
3188
- ++$index; // Drop the redundant plus symbol
3189
- } elseif ((($opCharacter == '~') || ($opCharacter == '|')) && (!$isOperandOrFunction)) { // We have to explicitly deny a tilde or pipe, because they are legal
3190
- return $this->raiseFormulaError("Formula Error: Illegal character '~'"); // on the stack but not in the input expression
3191
-
3192
- } elseif ((isset(self::$operators[$opCharacter]) or $isOperandOrFunction) && $expectingOperator) { // Are we putting an operator on the stack?
3193
- //echo 'Element with value '.$opCharacter.' is an Operator', PHP_EOL;
3194
- while ($stack->count() > 0 &&
3195
- ($o2 = $stack->last()) &&
3196
- isset(self::$operators[$o2['value']]) &&
3197
- @(self::$operatorAssociativity[$opCharacter] ? self::$operatorPrecedence[$opCharacter] < self::$operatorPrecedence[$o2['value']] : self::$operatorPrecedence[$opCharacter] <= self::$operatorPrecedence[$o2['value']])) {
3198
- $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output
3199
- }
3200
- $stack->push('Binary Operator', $opCharacter); // Finally put our current operator onto the stack
3201
- ++$index;
3202
- $expectingOperator = false;
3203
-
3204
- } elseif ($opCharacter == ')' && $expectingOperator) { // Are we expecting to close a parenthesis?
3205
- //echo 'Element is a Closing bracket', PHP_EOL;
3206
- $expectingOperand = false;
3207
- while (($o2 = $stack->pop()) && $o2['value'] != '(') { // Pop off the stack back to the last (
3208
- if ($o2 === null) {
3209
- return $this->raiseFormulaError('Formula Error: Unexpected closing brace ")"');
3210
- } else {
3211
- $output[] = $o2;
3212
- }
3213
- }
3214
- $d = $stack->last(2);
3215
- if (preg_match('/^'.self::CALCULATION_REGEXP_FUNCTION.'$/i', $d['value'], $matches)) { // Did this parenthesis just close a function?
3216
- $functionName = $matches[1]; // Get the function name
3217
- //echo 'Closed Function is '.$functionName, PHP_EOL;
3218
- $d = $stack->pop();
3219
- $argumentCount = $d['value']; // See how many arguments there were (argument count is the next value stored on the stack)
3220
- //if ($argumentCount == 0) {
3221
- // echo 'With no arguments', PHP_EOL;
3222
- //} elseif ($argumentCount == 1) {
3223
- // echo 'With 1 argument', PHP_EOL;
3224
- //} else {
3225
- // echo 'With '.$argumentCount.' arguments', PHP_EOL;
3226
- //}
3227
- $output[] = $d; // Dump the argument count on the output
3228
- $output[] = $stack->pop(); // Pop the function and push onto the output
3229
- if (isset(self::$controlFunctions[$functionName])) {
3230
- //echo 'Built-in function '.$functionName, PHP_EOL;
3231
- $expectedArgumentCount = self::$controlFunctions[$functionName]['argumentCount'];
3232
- $functionCall = self::$controlFunctions[$functionName]['functionCall'];
3233
- } elseif (isset(self::$PHPExcelFunctions[$functionName])) {
3234
- //echo 'PHPExcel function '.$functionName, PHP_EOL;
3235
- $expectedArgumentCount = self::$PHPExcelFunctions[$functionName]['argumentCount'];
3236
- $functionCall = self::$PHPExcelFunctions[$functionName]['functionCall'];
3237
- } else { // did we somehow push a non-function on the stack? this should never happen
3238
- return $this->raiseFormulaError("Formula Error: Internal error, non-function on stack");
3239
- }
3240
- // Check the argument count
3241
- $argumentCountError = false;
3242
- if (is_numeric($expectedArgumentCount)) {
3243
- if ($expectedArgumentCount < 0) {
3244
- //echo '$expectedArgumentCount is between 0 and '.abs($expectedArgumentCount), PHP_EOL;
3245
- if ($argumentCount > abs($expectedArgumentCount)) {
3246
- $argumentCountError = true;
3247
- $expectedArgumentCountString = 'no more than '.abs($expectedArgumentCount);
3248
- }
3249
- } else {
3250
- //echo '$expectedArgumentCount is numeric '.$expectedArgumentCount, PHP_EOL;
3251
- if ($argumentCount != $expectedArgumentCount) {
3252
- $argumentCountError = true;
3253
- $expectedArgumentCountString = $expectedArgumentCount;
3254
- }
3255
- }
3256
- } elseif ($expectedArgumentCount != '*') {
3257
- $isOperandOrFunction = preg_match('/(\d*)([-+,])(\d*)/', $expectedArgumentCount, $argMatch);
3258
- //print_r($argMatch);
3259
- //echo PHP_EOL;
3260
- switch ($argMatch[2]) {
3261
- case '+':
3262
- if ($argumentCount < $argMatch[1]) {
3263
- $argumentCountError = true;
3264
- $expectedArgumentCountString = $argMatch[1].' or more ';
3265
- }
3266
- break;
3267
- case '-':
3268
- if (($argumentCount < $argMatch[1]) || ($argumentCount > $argMatch[3])) {
3269
- $argumentCountError = true;
3270
- $expectedArgumentCountString = 'between '.$argMatch[1].' and '.$argMatch[3];
3271
- }
3272
- break;
3273
- case ',':
3274
- if (($argumentCount != $argMatch[1]) && ($argumentCount != $argMatch[3])) {
3275
- $argumentCountError = true;
3276
- $expectedArgumentCountString = 'either '.$argMatch[1].' or '.$argMatch[3];
3277
- }
3278
- break;
3279
- }
3280
- }
3281
- if ($argumentCountError) {
3282
- return $this->raiseFormulaError("Formula Error: Wrong number of arguments for $functionName() function: $argumentCount given, ".$expectedArgumentCountString." expected");
3283
- }
3284
- }
3285
- ++$index;
3286
-
3287
- } elseif ($opCharacter == ',') { // Is this the separator for function arguments?
3288
- //echo 'Element is a Function argument separator', PHP_EOL;
3289
- while (($o2 = $stack->pop()) && $o2['value'] != '(') { // Pop off the stack back to the last (
3290
- if ($o2 === null) {
3291
- return $this->raiseFormulaError("Formula Error: Unexpected ,");
3292
- } else {
3293
- $output[] = $o2; // pop the argument expression stuff and push onto the output
3294
- }
3295
- }
3296
- // If we've a comma when we're expecting an operand, then what we actually have is a null operand;
3297
- // so push a null onto the stack
3298
- if (($expectingOperand) || (!$expectingOperator)) {
3299
- $output[] = array('type' => 'NULL Value', 'value' => self::$excelConstants['NULL'], 'reference' => null);
3300
- }
3301
- // make sure there was a function
3302
- $d = $stack->last(2);
3303
- if (!preg_match('/^'.self::CALCULATION_REGEXP_FUNCTION.'$/i', $d['value'], $matches)) {
3304
- return $this->raiseFormulaError("Formula Error: Unexpected ,");
3305
- }
3306
- $d = $stack->pop();
3307
- $stack->push($d['type'], ++$d['value'], $d['reference']); // increment the argument count
3308
- $stack->push('Brace', '('); // put the ( back on, we'll need to pop back to it again
3309
- $expectingOperator = false;
3310
- $expectingOperand = true;
3311
- ++$index;
3312
-
3313
- } elseif ($opCharacter == '(' && !$expectingOperator) {
3314
- // echo 'Element is an Opening Bracket<br />';
3315
- $stack->push('Brace', '(');
3316
- ++$index;
3317
-
3318
- } elseif ($isOperandOrFunction && !$expectingOperator) { // do we now have a function/variable/number?
3319
- $expectingOperator = true;
3320
- $expectingOperand = false;
3321
- $val = $match[1];
3322
- $length = strlen($val);
3323
- // echo 'Element with value '.$val.' is an Operand, Variable, Constant, String, Number, Cell Reference or Function<br />';
3324
-
3325
- if (preg_match('/^'.self::CALCULATION_REGEXP_FUNCTION.'$/i', $val, $matches)) {
3326
- $val = preg_replace('/\s/u', '', $val);
3327
- // echo 'Element '.$val.' is a Function<br />';
3328
- if (isset(self::$PHPExcelFunctions[strtoupper($matches[1])]) || isset(self::$controlFunctions[strtoupper($matches[1])])) { // it's a function
3329
- $stack->push('Function', strtoupper($val));
3330
- $ax = preg_match('/^\s*(\s*\))/ui', substr($formula, $index+$length), $amatch);
3331
- if ($ax) {
3332
- $stack->push('Operand Count for Function '.strtoupper($val).')', 0);
3333
- $expectingOperator = true;
3334
- } else {
3335
- $stack->push('Operand Count for Function '.strtoupper($val).')', 1);
3336
- $expectingOperator = false;
3337
- }
3338
- $stack->push('Brace', '(');
3339
- } else { // it's a var w/ implicit multiplication
3340
- $output[] = array('type' => 'Value', 'value' => $matches[1], 'reference' => null);
3341
- }
3342
- } elseif (preg_match('/^'.self::CALCULATION_REGEXP_CELLREF.'$/i', $val, $matches)) {
3343
- // echo 'Element '.$val.' is a Cell reference<br />';
3344
- // Watch for this case-change when modifying to allow cell references in different worksheets...
3345
- // Should only be applied to the actual cell column, not the worksheet name
3346
-
3347
- // If the last entry on the stack was a : operator, then we have a cell range reference
3348
- $testPrevOp = $stack->last(1);
3349
- if ($testPrevOp['value'] == ':') {
3350
- // If we have a worksheet reference, then we're playing with a 3D reference
3351
- if ($matches[2] == '') {
3352
- // Otherwise, we 'inherit' the worksheet reference from the start cell reference
3353
- // The start of the cell range reference should be the last entry in $output
3354
- $startCellRef = $output[count($output)-1]['value'];
3355
- preg_match('/^'.self::CALCULATION_REGEXP_CELLREF.'$/i', $startCellRef, $startMatches);
3356
- if ($startMatches[2] > '') {
3357
- $val = $startMatches[2].'!'.$val;
3358
- }
3359
- } else {
3360
- return $this->raiseFormulaError("3D Range references are not yet supported");
3361
- }
3362
- }
3363
-
3364
- $output[] = array('type' => 'Cell Reference', 'value' => $val, 'reference' => $val);
3365
- // $expectingOperator = FALSE;
3366
- } else { // it's a variable, constant, string, number or boolean
3367
- // echo 'Element is a Variable, Constant, String, Number or Boolean<br />';
3368
- // If the last entry on the stack was a : operator, then we may have a row or column range reference
3369
- $testPrevOp = $stack->last(1);
3370
- if ($testPrevOp['value'] == ':') {
3371
- $startRowColRef = $output[count($output)-1]['value'];
3372
- $rangeWS1 = '';
3373
- if (strpos('!', $startRowColRef) !== false) {
3374
- list($rangeWS1, $startRowColRef) = explode('!', $startRowColRef);
3375
- }
3376
- if ($rangeWS1 != '') {
3377
- $rangeWS1 .= '!';
3378
- }
3379
- $rangeWS2 = $rangeWS1;
3380
- if (strpos('!', $val) !== false) {
3381
- list($rangeWS2, $val) = explode('!', $val);
3382
- }
3383
- if ($rangeWS2 != '') {
3384
- $rangeWS2 .= '!';
3385
- }
3386
- if ((is_integer($startRowColRef)) && (ctype_digit($val)) &&
3387
- ($startRowColRef <= 1048576) && ($val <= 1048576)) {
3388
- // Row range
3389
- $endRowColRef = ($pCellParent !== null) ? $pCellParent->getHighestColumn() : 'XFD'; // Max 16,384 columns for Excel2007
3390
- $output[count($output)-1]['value'] = $rangeWS1.'A'.$startRowColRef;
3391
- $val = $rangeWS2.$endRowColRef.$val;
3392
- } elseif ((ctype_alpha($startRowColRef)) && (ctype_alpha($val)) &&
3393
- (strlen($startRowColRef) <= 3) && (strlen($val) <= 3)) {
3394
- // Column range
3395
- $endRowColRef = ($pCellParent !== null) ? $pCellParent->getHighestRow() : 1048576; // Max 1,048,576 rows for Excel2007
3396
- $output[count($output)-1]['value'] = $rangeWS1.strtoupper($startRowColRef).'1';
3397
- $val = $rangeWS2.$val.$endRowColRef;
3398
- }
3399
- }
3400
-
3401
- $localeConstant = false;
3402
- if ($opCharacter == '"') {
3403
- // echo 'Element is a String<br />';
3404
- // UnEscape any quotes within the string
3405
- $val = self::wrapResult(str_replace('""', '"', self::unwrapResult($val)));
3406
- } elseif (is_numeric($val)) {
3407
- // echo 'Element is a Number<br />';
3408
- if ((strpos($val, '.') !== false) || (stripos($val, 'e') !== false) || ($val > PHP_INT_MAX) || ($val < -PHP_INT_MAX)) {
3409
- // echo 'Casting '.$val.' to float<br />';
3410
- $val = (float) $val;
3411
- } else {
3412
- // echo 'Casting '.$val.' to integer<br />';
3413
- $val = (integer) $val;
3414
- }
3415
- } elseif (isset(self::$excelConstants[trim(strtoupper($val))])) {
3416
- $excelConstant = trim(strtoupper($val));
3417
- // echo 'Element '.$excelConstant.' is an Excel Constant<br />';
3418
- $val = self::$excelConstants[$excelConstant];
3419
- } elseif (($localeConstant = array_search(trim(strtoupper($val)), self::$localeBoolean)) !== false) {
3420
- // echo 'Element '.$localeConstant.' is an Excel Constant<br />';
3421
- $val = self::$excelConstants[$localeConstant];
3422
- }
3423
- $details = array('type' => 'Value', 'value' => $val, 'reference' => null);
3424
- if ($localeConstant) {
3425
- $details['localeValue'] = $localeConstant;
3426
- }
3427
- $output[] = $details;
3428
- }
3429
- $index += $length;
3430
-
3431
- } elseif ($opCharacter == '$') { // absolute row or column range
3432
- ++$index;
3433
- } elseif ($opCharacter == ')') { // miscellaneous error checking
3434
- if ($expectingOperand) {
3435
- $output[] = array('type' => 'NULL Value', 'value' => self::$excelConstants['NULL'], 'reference' => null);
3436
- $expectingOperand = false;
3437
- $expectingOperator = true;
3438
- } else {
3439
- return $this->raiseFormulaError("Formula Error: Unexpected ')'");
3440
- }
3441
- } elseif (isset(self::$operators[$opCharacter]) && !$expectingOperator) {
3442
- return $this->raiseFormulaError("Formula Error: Unexpected operator '$opCharacter'");
3443
- } else { // I don't even want to know what you did to get here
3444
- return $this->raiseFormulaError("Formula Error: An unexpected error occured");
3445
- }
3446
- // Test for end of formula string
3447
- if ($index == strlen($formula)) {
3448
- // Did we end with an operator?.
3449
- // Only valid for the % unary operator
3450
- if ((isset(self::$operators[$opCharacter])) && ($opCharacter != '%')) {
3451
- return $this->raiseFormulaError("Formula Error: Operator '$opCharacter' has no operands");
3452
- } else {
3453
- break;
3454
- }
3455
- }
3456
- // Ignore white space
3457
- while (($formula{$index} == "\n") || ($formula{$index} == "\r")) {
3458
- ++$index;
3459
- }
3460
- if ($formula{$index} == ' ') {
3461
- while ($formula{$index} == ' ') {
3462
- ++$index;
3463
- }
3464
- // If we're expecting an operator, but only have a space between the previous and next operands (and both are
3465
- // Cell References) then we have an INTERSECTION operator
3466
- // echo 'Possible Intersect Operator<br />';
3467
- if (($expectingOperator) && (preg_match('/^'.self::CALCULATION_REGEXP_CELLREF.'.*/Ui', substr($formula, $index), $match)) &&
3468
- ($output[count($output)-1]['type'] == 'Cell Reference')) {
3469
- // echo 'Element is an Intersect Operator<br />';
3470
- while ($stack->count() > 0 &&
3471
- ($o2 = $stack->last()) &&
3472
- isset(self::$operators[$o2['value']]) &&
3473
- @(self::$operatorAssociativity[$opCharacter] ? self::$operatorPrecedence[$opCharacter] < self::$operatorPrecedence[$o2['value']] : self::$operatorPrecedence[$opCharacter] <= self::$operatorPrecedence[$o2['value']])) {
3474
- $output[] = $stack->pop(); // Swap operands and higher precedence operators from the stack to the output
3475
- }
3476
- $stack->push('Binary Operator', '|'); // Put an Intersect Operator on the stack
3477
- $expectingOperator = false;
3478
- }
3479
- }
3480
- }
3481
-
3482
- while (($op = $stack->pop()) !== null) { // pop everything off the stack and push onto output
3483
- if ((is_array($op) && $op['value'] == '(') || ($op === '(')) {
3484
- return $this->raiseFormulaError("Formula Error: Expecting ')'"); // if there are any opening braces on the stack, then braces were unbalanced
3485
- }
3486
- $output[] = $op;
3487
- }
3488
- return $output;
3489
- }
3490
-
3491
-
3492
- private static function dataTestReference(&$operandData)
3493
- {
3494
- $operand = $operandData['value'];
3495
- if (($operandData['reference'] === null) && (is_array($operand))) {
3496
- $rKeys = array_keys($operand);
3497
- $rowKey = array_shift($rKeys);
3498
- $cKeys = array_keys(array_keys($operand[$rowKey]));
3499
- $colKey = array_shift($cKeys);
3500
- if (ctype_upper($colKey)) {
3501
- $operandData['reference'] = $colKey.$rowKey;
3502
- }
3503
- }
3504
- return $operand;
3505
- }
3506
-
3507
- // evaluate postfix notation
3508
- private function processTokenStack($tokens, $cellID = null, PHPExcel_Cell $pCell = null)
3509
- {
3510
- if ($tokens == false) {
3511
- return false;
3512
- }
3513
-
3514
- // If we're using cell caching, then $pCell may well be flushed back to the cache (which detaches the parent cell collection),
3515
- // so we store the parent cell collection so that we can re-attach it when necessary
3516
- $pCellWorksheet = ($pCell !== null) ? $pCell->getWorksheet() : null;
3517
- $pCellParent = ($pCell !== null) ? $pCell->getParent() : null;
3518
- $stack = new PHPExcel_Calculation_Token_Stack;
3519
-
3520
- // Loop through each token in turn
3521
- foreach ($tokens as $tokenData) {
3522
- // print_r($tokenData);
3523
- // echo '<br />';
3524
- $token = $tokenData['value'];
3525
- // echo '<b>Token is '.$token.'</b><br />';
3526
- // if the token is a binary operator, pop the top two values off the stack, do the operation, and push the result back on the stack
3527
- if (isset(self::$binaryOperators[$token])) {
3528
- // echo 'Token is a binary operator<br />';
3529
- // We must have two operands, error if we don't
3530
- if (($operand2Data = $stack->pop()) === null) {
3531
- return $this->raiseFormulaError('Internal error - Operand value missing from stack');
3532
- }
3533
- if (($operand1Data = $stack->pop()) === null) {
3534
- return $this->raiseFormulaError('Internal error - Operand value missing from stack');
3535
- }
3536
-
3537
- $operand1 = self::dataTestReference($operand1Data);
3538
- $operand2 = self::dataTestReference($operand2Data);
3539
-
3540
- // Log what we're doing
3541
- if ($token == ':') {
3542
- $this->_debugLog->writeDebugLog('Evaluating Range ', $this->showValue($operand1Data['reference']), ' ', $token, ' ', $this->showValue($operand2Data['reference']));
3543
- } else {
3544
- $this->_debugLog->writeDebugLog('Evaluating ', $this->showValue($operand1), ' ', $token, ' ', $this->showValue($operand2));
3545
- }
3546
-
3547
- // Process the operation in the appropriate manner
3548
- switch ($token) {
3549
- // Comparison (Boolean) Operators
3550
- case '>': // Greater than
3551
- case '<': // Less than
3552
- case '>=': // Greater than or Equal to
3553
- case '<=': // Less than or Equal to
3554
- case '=': // Equality
3555
- case '<>': // Inequality
3556
- $this->executeBinaryComparisonOperation($cellID, $operand1, $operand2, $token, $stack);
3557
- break;
3558
- // Binary Operators
3559
- case ':': // Range
3560
- $sheet1 = $sheet2 = '';
3561
- if (strpos($operand1Data['reference'], '!') !== false) {
3562
- list($sheet1, $operand1Data['reference']) = explode('!', $operand1Data['reference']);
3563
- } else {
3564
- $sheet1 = ($pCellParent !== null) ? $pCellWorksheet->getTitle() : '';
3565
- }
3566
- if (strpos($operand2Data['reference'], '!') !== false) {
3567
- list($sheet2, $operand2Data['reference']) = explode('!', $operand2Data['reference']);
3568
- } else {
3569
- $sheet2 = $sheet1;
3570
- }
3571
- if ($sheet1 == $sheet2) {
3572
- if ($operand1Data['reference'] === null) {
3573
- if ((trim($operand1Data['value']) != '') && (is_numeric($operand1Data['value']))) {
3574
- $operand1Data['reference'] = $pCell->getColumn().$operand1Data['value'];
3575
- } elseif (trim($operand1Data['reference']) == '') {
3576
- $operand1Data['reference'] = $pCell->getCoordinate();
3577
- } else {
3578
- $operand1Data['reference'] = $operand1Data['value'].$pCell->getRow();
3579
- }
3580
- }
3581
- if ($operand2Data['reference'] === null) {
3582
- if ((trim($operand2Data['value']) != '') && (is_numeric($operand2Data['value']))) {
3583
- $operand2Data['reference'] = $pCell->getColumn().$operand2Data['value'];
3584
- } elseif (trim($operand2Data['reference']) == '') {
3585
- $operand2Data['reference'] = $pCell->getCoordinate();
3586
- } else {
3587
- $operand2Data['reference'] = $operand2Data['value'].$pCell->getRow();
3588
- }
3589
- }
3590
-
3591
- $oData = array_merge(explode(':', $operand1Data['reference']), explode(':', $operand2Data['reference']));
3592
- $oCol = $oRow = array();
3593
- foreach ($oData as $oDatum) {
3594
- $oCR = PHPExcel_Cell::coordinateFromString($oDatum);
3595
- $oCol[] = PHPExcel_Cell::columnIndexFromString($oCR[0]) - 1;
3596
- $oRow[] = $oCR[1];
3597
- }
3598
- $cellRef = PHPExcel_Cell::stringFromColumnIndex(min($oCol)).min($oRow).':'.PHPExcel_Cell::stringFromColumnIndex(max($oCol)).max($oRow);
3599
- if ($pCellParent !== null) {
3600
- $cellValue = $this->extractCellRange($cellRef, $this->workbook->getSheetByName($sheet1), false);
3601
- } else {
3602
- return $this->raiseFormulaError('Unable to access Cell Reference');
3603
- }
3604
- $stack->push('Cell Reference', $cellValue, $cellRef);
3605
- } else {
3606
- $stack->push('Error', PHPExcel_Calculation_Functions::REF(), null);
3607
- }
3608
- break;
3609
- case '+': // Addition
3610
- $this->executeNumericBinaryOperation($cellID, $operand1, $operand2, $token, 'plusEquals', $stack);
3611
- break;
3612
- case '-': // Subtraction
3613
- $this->executeNumericBinaryOperation($cellID, $operand1, $operand2, $token, 'minusEquals', $stack);
3614
- break;
3615
- case '*': // Multiplication
3616
- $this->executeNumericBinaryOperation($cellID, $operand1, $operand2, $token, 'arrayTimesEquals', $stack);
3617
- break;
3618
- case '/': // Division
3619
- $this->executeNumericBinaryOperation($cellID, $operand1, $operand2, $token, 'arrayRightDivide', $stack);
3620
- break;
3621
- case '^': // Exponential
3622
- $this->executeNumericBinaryOperation($cellID, $operand1, $operand2, $token, 'power', $stack);
3623
- break;
3624
- case '&': // Concatenation
3625
- // If either of the operands is a matrix, we need to treat them both as matrices
3626
- // (converting the other operand to a matrix if need be); then perform the required
3627
- // matrix operation
3628
- if (is_bool($operand1)) {
3629
- $operand1 = ($operand1) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];
3630
- }
3631
- if (is_bool($operand2)) {
3632
- $operand2 = ($operand2) ? self::$localeBoolean['TRUE'] : self::$localeBoolean['FALSE'];
3633
- }
3634
- if ((is_array($operand1)) || (is_array($operand2))) {
3635
- // Ensure that both operands are arrays/matrices
3636
- self::checkMatrixOperands($operand1, $operand2, 2);
3637
- try {
3638
- // Convert operand 1 from a PHP array to a matrix
3639
- $matrix = new PHPExcel_Shared_JAMA_Matrix($operand1);
3640
- // Perform the required operation against the operand 1 matrix, passing in operand 2
3641
- $matrixResult = $matrix->concat($operand2);
3642
- $result = $matrixResult->getArray();
3643
- } catch (PHPExcel_Exception $ex) {
3644
- $this->_debugLog->writeDebugLog('JAMA Matrix Exception: ', $ex->getMessage());
3645
- $result = '#VALUE!';
3646
- }
3647
- } else {
3648
- $result = '"'.str_replace('""', '"', self::unwrapResult($operand1, '"').self::unwrapResult($operand2, '"')).'"';
3649
- }
3650
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($result));
3651
- $stack->push('Value', $result);
3652
- break;
3653
- case '|': // Intersect
3654
- $rowIntersect = array_intersect_key($operand1, $operand2);
3655
- $cellIntersect = $oCol = $oRow = array();
3656
- foreach (array_keys($rowIntersect) as $row) {
3657
- $oRow[] = $row;
3658
- foreach ($rowIntersect[$row] as $col => $data) {
3659
- $oCol[] = PHPExcel_Cell::columnIndexFromString($col) - 1;
3660
- $cellIntersect[$row] = array_intersect_key($operand1[$row], $operand2[$row]);
3661
- }
3662
- }
3663
- $cellRef = PHPExcel_Cell::stringFromColumnIndex(min($oCol)).min($oRow).':'.PHPExcel_Cell::stringFromColumnIndex(max($oCol)).max($oRow);
3664
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($cellIntersect));
3665
- $stack->push('Value', $cellIntersect, $cellRef);
3666
- break;
3667
- }
3668
-
3669
- // if the token is a unary operator, pop one value off the stack, do the operation, and push it back on
3670
- } elseif (($token === '~') || ($token === '%')) {
3671
- // echo 'Token is a unary operator<br />';
3672
- if (($arg = $stack->pop()) === null) {
3673
- return $this->raiseFormulaError('Internal error - Operand value missing from stack');
3674
- }
3675
- $arg = $arg['value'];
3676
- if ($token === '~') {
3677
- // echo 'Token is a negation operator<br />';
3678
- $this->_debugLog->writeDebugLog('Evaluating Negation of ', $this->showValue($arg));
3679
- $multiplier = -1;
3680
- } else {
3681
- // echo 'Token is a percentile operator<br />';
3682
- $this->_debugLog->writeDebugLog('Evaluating Percentile of ', $this->showValue($arg));
3683
- $multiplier = 0.01;
3684
- }
3685
- if (is_array($arg)) {
3686
- self::checkMatrixOperands($arg, $multiplier, 2);
3687
- try {
3688
- $matrix1 = new PHPExcel_Shared_JAMA_Matrix($arg);
3689
- $matrixResult = $matrix1->arrayTimesEquals($multiplier);
3690
- $result = $matrixResult->getArray();
3691
- } catch (PHPExcel_Exception $ex) {
3692
- $this->_debugLog->writeDebugLog('JAMA Matrix Exception: ', $ex->getMessage());
3693
- $result = '#VALUE!';
3694
- }
3695
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($result));
3696
- $stack->push('Value', $result);
3697
- } else {
3698
- $this->executeNumericBinaryOperation($cellID, $multiplier, $arg, '*', 'arrayTimesEquals', $stack);
3699
- }
3700
-
3701
- } elseif (preg_match('/^'.self::CALCULATION_REGEXP_CELLREF.'$/i', $token, $matches)) {
3702
- $cellRef = null;
3703
- // echo 'Element '.$token.' is a Cell reference<br />';
3704
- if (isset($matches[8])) {
3705
- // echo 'Reference is a Range of cells<br />';
3706
- if ($pCell === null) {
3707
- // We can't access the range, so return a REF error
3708
- $cellValue = PHPExcel_Calculation_Functions::REF();
3709
- } else {
3710
- $cellRef = $matches[6].$matches[7].':'.$matches[9].$matches[10];
3711
- if ($matches[2] > '') {
3712
- $matches[2] = trim($matches[2], "\"'");
3713
- if ((strpos($matches[2], '[') !== false) || (strpos($matches[2], ']') !== false)) {
3714
- // It's a Reference to an external workbook (not currently supported)
3715
- return $this->raiseFormulaError('Unable to access External Workbook');
3716
- }
3717
- $matches[2] = trim($matches[2], "\"'");
3718
- // echo '$cellRef='.$cellRef.' in worksheet '.$matches[2].'<br />';
3719
- $this->_debugLog->writeDebugLog('Evaluating Cell Range ', $cellRef, ' in worksheet ', $matches[2]);
3720
- if ($pCellParent !== null) {
3721
- $cellValue = $this->extractCellRange($cellRef, $this->workbook->getSheetByName($matches[2]), false);
3722
- } else {
3723
- return $this->raiseFormulaError('Unable to access Cell Reference');
3724
- }
3725
- $this->_debugLog->writeDebugLog('Evaluation Result for cells ', $cellRef, ' in worksheet ', $matches[2], ' is ', $this->showTypeDetails($cellValue));
3726
- // $cellRef = $matches[2].'!'.$cellRef;
3727
- } else {
3728
- // echo '$cellRef='.$cellRef.' in current worksheet<br />';
3729
- $this->_debugLog->writeDebugLog('Evaluating Cell Range ', $cellRef, ' in current worksheet');
3730
- if ($pCellParent !== null) {
3731
- $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);
3732
- } else {
3733
- return $this->raiseFormulaError('Unable to access Cell Reference');
3734
- }
3735
- $this->_debugLog->writeDebugLog('Evaluation Result for cells ', $cellRef, ' is ', $this->showTypeDetails($cellValue));
3736
- }
3737
- }
3738
- } else {
3739
- // echo 'Reference is a single Cell<br />';
3740
- if ($pCell === null) {
3741
- // We can't access the cell, so return a REF error
3742
- $cellValue = PHPExcel_Calculation_Functions::REF();
3743
- } else {
3744
- $cellRef = $matches[6].$matches[7];
3745
- if ($matches[2] > '') {
3746
- $matches[2] = trim($matches[2], "\"'");
3747
- if ((strpos($matches[2], '[') !== false) || (strpos($matches[2], ']') !== false)) {
3748
- // It's a Reference to an external workbook (not currently supported)
3749
- return $this->raiseFormulaError('Unable to access External Workbook');
3750
- }
3751
- // echo '$cellRef='.$cellRef.' in worksheet '.$matches[2].'<br />';
3752
- $this->_debugLog->writeDebugLog('Evaluating Cell ', $cellRef, ' in worksheet ', $matches[2]);
3753
- if ($pCellParent !== null) {
3754
- $cellSheet = $this->workbook->getSheetByName($matches[2]);
3755
- if ($cellSheet && $cellSheet->cellExists($cellRef)) {
3756
- $cellValue = $this->extractCellRange($cellRef, $this->workbook->getSheetByName($matches[2]), false);
3757
- $pCell->attach($pCellParent);
3758
- } else {
3759
- $cellValue = null;
3760
- }
3761
- } else {
3762
- return $this->raiseFormulaError('Unable to access Cell Reference');
3763
- }
3764
- $this->_debugLog->writeDebugLog('Evaluation Result for cell ', $cellRef, ' in worksheet ', $matches[2], ' is ', $this->showTypeDetails($cellValue));
3765
- // $cellRef = $matches[2].'!'.$cellRef;
3766
- } else {
3767
- // echo '$cellRef='.$cellRef.' in current worksheet<br />';
3768
- $this->_debugLog->writeDebugLog('Evaluating Cell ', $cellRef, ' in current worksheet');
3769
- if ($pCellParent->isDataSet($cellRef)) {
3770
- $cellValue = $this->extractCellRange($cellRef, $pCellWorksheet, false);
3771
- $pCell->attach($pCellParent);
3772
- } else {
3773
- $cellValue = null;
3774
- }
3775
- $this->_debugLog->writeDebugLog('Evaluation Result for cell ', $cellRef, ' is ', $this->showTypeDetails($cellValue));
3776
- }
3777
- }
3778
- }
3779
- $stack->push('Value', $cellValue, $cellRef);
3780
-
3781
- // if the token is a function, pop arguments off the stack, hand them to the function, and push the result back on
3782
- } elseif (preg_match('/^'.self::CALCULATION_REGEXP_FUNCTION.'$/i', $token, $matches)) {
3783
- // echo 'Token is a function<br />';
3784
- $functionName = $matches[1];
3785
- $argCount = $stack->pop();
3786
- $argCount = $argCount['value'];
3787
- if ($functionName != 'MKMATRIX') {
3788
- $this->_debugLog->writeDebugLog('Evaluating Function ', self::localeFunc($functionName), '() with ', (($argCount == 0) ? 'no' : $argCount), ' argument', (($argCount == 1) ? '' : 's'));
3789
- }
3790
- if ((isset(self::$PHPExcelFunctions[$functionName])) || (isset(self::$controlFunctions[$functionName]))) { // function
3791
- if (isset(self::$PHPExcelFunctions[$functionName])) {
3792
- $functionCall = self::$PHPExcelFunctions[$functionName]['functionCall'];
3793
- $passByReference = isset(self::$PHPExcelFunctions[$functionName]['passByReference']);
3794
- $passCellReference = isset(self::$PHPExcelFunctions[$functionName]['passCellReference']);
3795
- } elseif (isset(self::$controlFunctions[$functionName])) {
3796
- $functionCall = self::$controlFunctions[$functionName]['functionCall'];
3797
- $passByReference = isset(self::$controlFunctions[$functionName]['passByReference']);
3798
- $passCellReference = isset(self::$controlFunctions[$functionName]['passCellReference']);
3799
- }
3800
- // get the arguments for this function
3801
- // echo 'Function '.$functionName.' expects '.$argCount.' arguments<br />';
3802
- $args = $argArrayVals = array();
3803
- for ($i = 0; $i < $argCount; ++$i) {
3804
- $arg = $stack->pop();
3805
- $a = $argCount - $i - 1;
3806
- if (($passByReference) &&
3807
- (isset(self::$PHPExcelFunctions[$functionName]['passByReference'][$a])) &&
3808
- (self::$PHPExcelFunctions[$functionName]['passByReference'][$a])) {
3809
- if ($arg['reference'] === null) {
3810
- $args[] = $cellID;
3811
- if ($functionName != 'MKMATRIX') {
3812
- $argArrayVals[] = $this->showValue($cellID);
3813
- }
3814
- } else {
3815
- $args[] = $arg['reference'];
3816
- if ($functionName != 'MKMATRIX') {
3817
- $argArrayVals[] = $this->showValue($arg['reference']);
3818
- }
3819
- }
3820
- } else {
3821
- $args[] = self::unwrapResult($arg['value']);
3822
- if ($functionName != 'MKMATRIX') {
3823
- $argArrayVals[] = $this->showValue($arg['value']);
3824
- }
3825
- }
3826
- }
3827
- // Reverse the order of the arguments
3828
- krsort($args);
3829
- if (($passByReference) && ($argCount == 0)) {
3830
- $args[] = $cellID;
3831
- $argArrayVals[] = $this->showValue($cellID);
3832
- }
3833
- // echo 'Arguments are: ';
3834
- // print_r($args);
3835
- // echo '<br />';
3836
- if ($functionName != 'MKMATRIX') {
3837
- if ($this->_debugLog->getWriteDebugLog()) {
3838
- krsort($argArrayVals);
3839
- $this->_debugLog->writeDebugLog('Evaluating ', self::localeFunc($functionName), '( ', implode(self::$localeArgumentSeparator.' ', PHPExcel_Calculation_Functions::flattenArray($argArrayVals)), ' )');
3840
- }
3841
- }
3842
- // Process each argument in turn, building the return value as an array
3843
- // if (($argCount == 1) && (is_array($args[1])) && ($functionName != 'MKMATRIX')) {
3844
- // $operand1 = $args[1];
3845
- // $this->_debugLog->writeDebugLog('Argument is a matrix: ', $this->showValue($operand1));
3846
- // $result = array();
3847
- // $row = 0;
3848
- // foreach($operand1 as $args) {
3849
- // if (is_array($args)) {
3850
- // foreach($args as $arg) {
3851
- // $this->_debugLog->writeDebugLog('Evaluating ', self::localeFunc($functionName), '( ', $this->showValue($arg), ' )');
3852
- // $r = call_user_func_array($functionCall, $arg);
3853
- // $this->_debugLog->writeDebugLog('Evaluation Result for ', self::localeFunc($functionName), '() function call is ', $this->showTypeDetails($r));
3854
- // $result[$row][] = $r;
3855
- // }
3856
- // ++$row;
3857
- // } else {
3858
- // $this->_debugLog->writeDebugLog('Evaluating ', self::localeFunc($functionName), '( ', $this->showValue($args), ' )');
3859
- // $r = call_user_func_array($functionCall, $args);
3860
- // $this->_debugLog->writeDebugLog('Evaluation Result for ', self::localeFunc($functionName), '() function call is ', $this->showTypeDetails($r));
3861
- // $result[] = $r;
3862
- // }
3863
- // }
3864
- // } else {
3865
- // Process the argument with the appropriate function call
3866
- if ($passCellReference) {
3867
- $args[] = $pCell;
3868
- }
3869
- if (strpos($functionCall, '::') !== false) {
3870
- $result = call_user_func_array(explode('::', $functionCall), $args);
3871
- } else {
3872
- foreach ($args as &$arg) {
3873
- $arg = PHPExcel_Calculation_Functions::flattenSingleValue($arg);
3874
- }
3875
- unset($arg);
3876
- $result = call_user_func_array($functionCall, $args);
3877
- }
3878
- if ($functionName != 'MKMATRIX') {
3879
- $this->_debugLog->writeDebugLog('Evaluation Result for ', self::localeFunc($functionName), '() function call is ', $this->showTypeDetails($result));
3880
- }
3881
- $stack->push('Value', self::wrapResult($result));
3882
- }
3883
-
3884
- } else {
3885
- // if the token is a number, boolean, string or an Excel error, push it onto the stack
3886
- if (isset(self::$excelConstants[strtoupper($token)])) {
3887
- $excelConstant = strtoupper($token);
3888
- // echo 'Token is a PHPExcel constant: '.$excelConstant.'<br />';
3889
- $stack->push('Constant Value', self::$excelConstants[$excelConstant]);
3890
- $this->_debugLog->writeDebugLog('Evaluating Constant ', $excelConstant, ' as ', $this->showTypeDetails(self::$excelConstants[$excelConstant]));
3891
- } elseif ((is_numeric($token)) || ($token === null) || (is_bool($token)) || ($token == '') || ($token{0} == '"') || ($token{0} == '#')) {
3892
- // echo 'Token is a number, boolean, string, null or an Excel error<br />';
3893
- $stack->push('Value', $token);
3894
- // if the token is a named range, push the named range name onto the stack
3895
- } elseif (preg_match('/^'.self::CALCULATION_REGEXP_NAMEDRANGE.'$/i', $token, $matches)) {
3896
- // echo 'Token is a named range<br />';
3897
- $namedRange = $matches[6];
3898
- // echo 'Named Range is '.$namedRange.'<br />';
3899
- $this->_debugLog->writeDebugLog('Evaluating Named Range ', $namedRange);
3900
- $cellValue = $this->extractNamedRange($namedRange, ((null !== $pCell) ? $pCellWorksheet : null), false);
3901
- $pCell->attach($pCellParent);
3902
- $this->_debugLog->writeDebugLog('Evaluation Result for named range ', $namedRange, ' is ', $this->showTypeDetails($cellValue));
3903
- $stack->push('Named Range', $cellValue, $namedRange);
3904
- } else {
3905
- return $this->raiseFormulaError("undefined variable '$token'");
3906
- }
3907
- }
3908
- }
3909
- // when we're out of tokens, the stack should have a single element, the final result
3910
- if ($stack->count() != 1) {
3911
- return $this->raiseFormulaError("internal error");
3912
- }
3913
- $output = $stack->pop();
3914
- $output = $output['value'];
3915
-
3916
- // if ((is_array($output)) && (self::$returnArrayAsType != self::RETURN_ARRAY_AS_ARRAY)) {
3917
- // return array_shift(PHPExcel_Calculation_Functions::flattenArray($output));
3918
- // }
3919
- return $output;
3920
- }
3921
-
3922
-
3923
- private function validateBinaryOperand($cellID, &$operand, &$stack)
3924
- {
3925
- if (is_array($operand)) {
3926
- if ((count($operand, COUNT_RECURSIVE) - count($operand)) == 1) {
3927
- do {
3928
- $operand = array_pop($operand);
3929
- } while (is_array($operand));
3930
- }
3931
- }
3932
- // Numbers, matrices and booleans can pass straight through, as they're already valid
3933
- if (is_string($operand)) {
3934
- // We only need special validations for the operand if it is a string
3935
- // Start by stripping off the quotation marks we use to identify true excel string values internally
3936
- if ($operand > '' && $operand{0} == '"') {
3937
- $operand = self::unwrapResult($operand);
3938
- }
3939
- // If the string is a numeric value, we treat it as a numeric, so no further testing
3940
- if (!is_numeric($operand)) {
3941
- // If not a numeric, test to see if the value is an Excel error, and so can't be used in normal binary operations
3942
- if ($operand > '' && $operand{0} == '#') {
3943
- $stack->push('Value', $operand);
3944
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($operand));
3945
- return false;
3946
- } elseif (!PHPExcel_Shared_String::convertToNumberIfFraction($operand)) {
3947
- // If not a numeric or a fraction, then it's a text string, and so can't be used in mathematical binary operations
3948
- $stack->push('Value', '#VALUE!');
3949
- $this->_debugLog->writeDebugLog('Evaluation Result is a ', $this->showTypeDetails('#VALUE!'));
3950
- return false;
3951
- }
3952
- }
3953
- }
3954
-
3955
- // return a true if the value of the operand is one that we can use in normal binary operations
3956
- return true;
3957
- }
3958
-
3959
-
3960
- private function executeBinaryComparisonOperation($cellID, $operand1, $operand2, $operation, &$stack, $recursingArrays = false)
3961
- {
3962
- // If we're dealing with matrix operations, we want a matrix result
3963
- if ((is_array($operand1)) || (is_array($operand2))) {
3964
- $result = array();
3965
- if ((is_array($operand1)) && (!is_array($operand2))) {
3966
- foreach ($operand1 as $x => $operandData) {
3967
- $this->_debugLog->writeDebugLog('Evaluating Comparison ', $this->showValue($operandData), ' ', $operation, ' ', $this->showValue($operand2));
3968
- $this->executeBinaryComparisonOperation($cellID, $operandData, $operand2, $operation, $stack);
3969
- $r = $stack->pop();
3970
- $result[$x] = $r['value'];
3971
- }
3972
- } elseif ((!is_array($operand1)) && (is_array($operand2))) {
3973
- foreach ($operand2 as $x => $operandData) {
3974
- $this->_debugLog->writeDebugLog('Evaluating Comparison ', $this->showValue($operand1), ' ', $operation, ' ', $this->showValue($operandData));
3975
- $this->executeBinaryComparisonOperation($cellID, $operand1, $operandData, $operation, $stack);
3976
- $r = $stack->pop();
3977
- $result[$x] = $r['value'];
3978
- }
3979
- } else {
3980
- if (!$recursingArrays) {
3981
- self::checkMatrixOperands($operand1, $operand2, 2);
3982
- }
3983
- foreach ($operand1 as $x => $operandData) {
3984
- $this->_debugLog->writeDebugLog('Evaluating Comparison ', $this->showValue($operandData), ' ', $operation, ' ', $this->showValue($operand2[$x]));
3985
- $this->executeBinaryComparisonOperation($cellID, $operandData, $operand2[$x], $operation, $stack, true);
3986
- $r = $stack->pop();
3987
- $result[$x] = $r['value'];
3988
- }
3989
- }
3990
- // Log the result details
3991
- $this->_debugLog->writeDebugLog('Comparison Evaluation Result is ', $this->showTypeDetails($result));
3992
- // And push the result onto the stack
3993
- $stack->push('Array', $result);
3994
- return true;
3995
- }
3996
-
3997
- // Simple validate the two operands if they are string values
3998
- if (is_string($operand1) && $operand1 > '' && $operand1{0} == '"') {
3999
- $operand1 = self::unwrapResult($operand1);
4000
- }
4001
- if (is_string($operand2) && $operand2 > '' && $operand2{0} == '"') {
4002
- $operand2 = self::unwrapResult($operand2);
4003
- }
4004
-
4005
- // Use case insensitive comparaison if not OpenOffice mode
4006
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() != PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
4007
- if (is_string($operand1)) {
4008
- $operand1 = strtoupper($operand1);
4009
- }
4010
- if (is_string($operand2)) {
4011
- $operand2 = strtoupper($operand2);
4012
- }
4013
- }
4014
-
4015
- $useLowercaseFirstComparison = is_string($operand1) && is_string($operand2) && PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE;
4016
-
4017
- // execute the necessary operation
4018
- switch ($operation) {
4019
- // Greater than
4020
- case '>':
4021
- if ($useLowercaseFirstComparison) {
4022
- $result = $this->strcmpLowercaseFirst($operand1, $operand2) > 0;
4023
- } else {
4024
- $result = ($operand1 > $operand2);
4025
- }
4026
- break;
4027
- // Less than
4028
- case '<':
4029
- if ($useLowercaseFirstComparison) {
4030
- $result = $this->strcmpLowercaseFirst($operand1, $operand2) < 0;
4031
- } else {
4032
- $result = ($operand1 < $operand2);
4033
- }
4034
- break;
4035
- // Equality
4036
- case '=':
4037
- if (is_numeric($operand1) && is_numeric($operand2)) {
4038
- $result = (abs($operand1 - $operand2) < $this->delta);
4039
- } else {
4040
- $result = strcmp($operand1, $operand2) == 0;
4041
- }
4042
- break;
4043
- // Greater than or equal
4044
- case '>=':
4045
- if (is_numeric($operand1) && is_numeric($operand2)) {
4046
- $result = ((abs($operand1 - $operand2) < $this->delta) || ($operand1 > $operand2));
4047
- } elseif ($useLowercaseFirstComparison) {
4048
- $result = $this->strcmpLowercaseFirst($operand1, $operand2) >= 0;
4049
- } else {
4050
- $result = strcmp($operand1, $operand2) >= 0;
4051
- }
4052
- break;
4053
- // Less than or equal
4054
- case '<=':
4055
- if (is_numeric($operand1) && is_numeric($operand2)) {
4056
- $result = ((abs($operand1 - $operand2) < $this->delta) || ($operand1 < $operand2));
4057
- } elseif ($useLowercaseFirstComparison) {
4058
- $result = $this->strcmpLowercaseFirst($operand1, $operand2) <= 0;
4059
- } else {
4060
- $result = strcmp($operand1, $operand2) <= 0;
4061
- }
4062
- break;
4063
- // Inequality
4064
- case '<>':
4065
- if (is_numeric($operand1) && is_numeric($operand2)) {
4066
- $result = (abs($operand1 - $operand2) > 1E-14);
4067
- } else {
4068
- $result = strcmp($operand1, $operand2) != 0;
4069
- }
4070
- break;
4071
- }
4072
-
4073
- // Log the result details
4074
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($result));
4075
- // And push the result onto the stack
4076
- $stack->push('Value', $result);
4077
- return true;
4078
- }
4079
-
4080
- /**
4081
- * Compare two strings in the same way as strcmp() except that lowercase come before uppercase letters
4082
- * @param string $str1 First string value for the comparison
4083
- * @param string $str2 Second string value for the comparison
4084
- * @return integer
4085
- */
4086
- private function strcmpLowercaseFirst($str1, $str2)
4087
- {
4088
- $inversedStr1 = PHPExcel_Shared_String::StrCaseReverse($str1);
4089
- $inversedStr2 = PHPExcel_Shared_String::StrCaseReverse($str2);
4090
-
4091
- return strcmp($inversedStr1, $inversedStr2);
4092
- }
4093
-
4094
- private function executeNumericBinaryOperation($cellID, $operand1, $operand2, $operation, $matrixFunction, &$stack)
4095
- {
4096
- // Validate the two operands
4097
- if (!$this->validateBinaryOperand($cellID, $operand1, $stack)) {
4098
- return false;
4099
- }
4100
- if (!$this->validateBinaryOperand($cellID, $operand2, $stack)) {
4101
- return false;
4102
- }
4103
-
4104
- // If either of the operands is a matrix, we need to treat them both as matrices
4105
- // (converting the other operand to a matrix if need be); then perform the required
4106
- // matrix operation
4107
- if ((is_array($operand1)) || (is_array($operand2))) {
4108
- // Ensure that both operands are arrays/matrices of the same size
4109
- self::checkMatrixOperands($operand1, $operand2, 2);
4110
-
4111
- try {
4112
- // Convert operand 1 from a PHP array to a matrix
4113
- $matrix = new PHPExcel_Shared_JAMA_Matrix($operand1);
4114
- // Perform the required operation against the operand 1 matrix, passing in operand 2
4115
- $matrixResult = $matrix->$matrixFunction($operand2);
4116
- $result = $matrixResult->getArray();
4117
- } catch (PHPExcel_Exception $ex) {
4118
- $this->_debugLog->writeDebugLog('JAMA Matrix Exception: ', $ex->getMessage());
4119
- $result = '#VALUE!';
4120
- }
4121
- } else {
4122
- if ((PHPExcel_Calculation_Functions::getCompatibilityMode() != PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) &&
4123
- ((is_string($operand1) && !is_numeric($operand1) && strlen($operand1)>0) ||
4124
- (is_string($operand2) && !is_numeric($operand2) && strlen($operand2)>0))) {
4125
- $result = PHPExcel_Calculation_Functions::VALUE();
4126
- } else {
4127
- // If we're dealing with non-matrix operations, execute the necessary operation
4128
- switch ($operation) {
4129
- // Addition
4130
- case '+':
4131
- $result = $operand1 + $operand2;
4132
- break;
4133
- // Subtraction
4134
- case '-':
4135
- $result = $operand1 - $operand2;
4136
- break;
4137
- // Multiplication
4138
- case '*':
4139
- $result = $operand1 * $operand2;
4140
- break;
4141
- // Division
4142
- case '/':
4143
- if ($operand2 == 0) {
4144
- // Trap for Divide by Zero error
4145
- $stack->push('Value', '#DIV/0!');
4146
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails('#DIV/0!'));
4147
- return false;
4148
- } else {
4149
- $result = $operand1 / $operand2;
4150
- }
4151
- break;
4152
- // Power
4153
- case '^':
4154
- $result = pow($operand1, $operand2);
4155
- break;
4156
- }
4157
- }
4158
- }
4159
-
4160
- // Log the result details
4161
- $this->_debugLog->writeDebugLog('Evaluation Result is ', $this->showTypeDetails($result));
4162
- // And push the result onto the stack
4163
- $stack->push('Value', $result);
4164
- return true;
4165
- }
4166
-
4167
-
4168
- // trigger an error, but nicely, if need be
4169
- protected function raiseFormulaError($errorMessage)
4170
- {
4171
- $this->formulaError = $errorMessage;
4172
- $this->cyclicReferenceStack->clear();
4173
- if (!$this->suppressFormulaErrors) {
4174
- throw new PHPExcel_Calculation_Exception($errorMessage);
4175
- }
4176
- trigger_error($errorMessage, E_USER_ERROR);
4177
- }
4178
-
4179
-
4180
- /**
4181
- * Extract range values
4182
- *
4183
- * @param string &$pRange String based range representation
4184
- * @param PHPExcel_Worksheet $pSheet Worksheet
4185
- * @param boolean $resetLog Flag indicating whether calculation log should be reset or not
4186
- * @return mixed Array of values in range if range contains more than one element. Otherwise, a single value is returned.
4187
- * @throws PHPExcel_Calculation_Exception
4188
- */
4189
- public function extractCellRange(&$pRange = 'A1', PHPExcel_Worksheet $pSheet = null, $resetLog = true)
4190
- {
4191
- // Return value
4192
- $returnValue = array ();
4193
-
4194
- // echo 'extractCellRange('.$pRange.')', PHP_EOL;
4195
- if ($pSheet !== null) {
4196
- $pSheetName = $pSheet->getTitle();
4197
- // echo 'Passed sheet name is '.$pSheetName.PHP_EOL;
4198
- // echo 'Range reference is '.$pRange.PHP_EOL;
4199
- if (strpos($pRange, '!') !== false) {
4200
- // echo '$pRange reference includes sheet reference', PHP_EOL;
4201
- list($pSheetName, $pRange) = PHPExcel_Worksheet::extractSheetTitle($pRange, true);
4202
- // echo 'New sheet name is '.$pSheetName, PHP_EOL;
4203
- // echo 'Adjusted Range reference is '.$pRange, PHP_EOL;
4204
- $pSheet = $this->workbook->getSheetByName($pSheetName);
4205
- }
4206
-
4207
- // Extract range
4208
- $aReferences = PHPExcel_Cell::extractAllCellReferencesInRange($pRange);
4209
- $pRange = $pSheetName.'!'.$pRange;
4210
- if (!isset($aReferences[1])) {
4211
- // Single cell in range
4212
- sscanf($aReferences[0], '%[A-Z]%d', $currentCol, $currentRow);
4213
- $cellValue = null;
4214
- if ($pSheet->cellExists($aReferences[0])) {
4215
- $returnValue[$currentRow][$currentCol] = $pSheet->getCell($aReferences[0])->getCalculatedValue($resetLog);
4216
- } else {
4217
- $returnValue[$currentRow][$currentCol] = null;
4218
- }
4219
- } else {
4220
- // Extract cell data for all cells in the range
4221
- foreach ($aReferences as $reference) {
4222
- // Extract range
4223
- sscanf($reference, '%[A-Z]%d', $currentCol, $currentRow);
4224
- $cellValue = null;
4225
- if ($pSheet->cellExists($reference)) {
4226
- $returnValue[$currentRow][$currentCol] = $pSheet->getCell($reference)->getCalculatedValue($resetLog);
4227
- } else {
4228
- $returnValue[$currentRow][$currentCol] = null;
4229
- }
4230
- }
4231
- }
4232
- }
4233
-
4234
- return $returnValue;
4235
- }
4236
-
4237
-
4238
- /**
4239
- * Extract range values
4240
- *
4241
- * @param string &$pRange String based range representation
4242
- * @param PHPExcel_Worksheet $pSheet Worksheet
4243
- * @return mixed Array of values in range if range contains more than one element. Otherwise, a single value is returned.
4244
- * @param boolean $resetLog Flag indicating whether calculation log should be reset or not
4245
- * @throws PHPExcel_Calculation_Exception
4246
- */
4247
- public function extractNamedRange(&$pRange = 'A1', PHPExcel_Worksheet $pSheet = null, $resetLog = true)
4248
- {
4249
- // Return value
4250
- $returnValue = array ();
4251
-
4252
- // echo 'extractNamedRange('.$pRange.')<br />';
4253
- if ($pSheet !== null) {
4254
- $pSheetName = $pSheet->getTitle();
4255
- // echo 'Current sheet name is '.$pSheetName.'<br />';
4256
- // echo 'Range reference is '.$pRange.'<br />';
4257
- if (strpos($pRange, '!') !== false) {
4258
- // echo '$pRange reference includes sheet reference', PHP_EOL;
4259
- list($pSheetName, $pRange) = PHPExcel_Worksheet::extractSheetTitle($pRange, true);
4260
- // echo 'New sheet name is '.$pSheetName, PHP_EOL;
4261
- // echo 'Adjusted Range reference is '.$pRange, PHP_EOL;
4262
- $pSheet = $this->workbook->getSheetByName($pSheetName);
4263
- }
4264
-
4265
- // Named range?
4266
- $namedRange = PHPExcel_NamedRange::resolveRange($pRange, $pSheet);
4267
- if ($namedRange !== null) {
4268
- $pSheet = $namedRange->getWorksheet();
4269
- // echo 'Named Range '.$pRange.' (';
4270
- $pRange = $namedRange->getRange();
4271
- $splitRange = PHPExcel_Cell::splitRange($pRange);
4272
- // Convert row and column references
4273
- if (ctype_alpha($splitRange[0][0])) {
4274
- $pRange = $splitRange[0][0] . '1:' . $splitRange[0][1] . $namedRange->getWorksheet()->getHighestRow();
4275
- } elseif (ctype_digit($splitRange[0][0])) {
4276
- $pRange = 'A' . $splitRange[0][0] . ':' . $namedRange->getWorksheet()->getHighestColumn() . $splitRange[0][1];
4277
- }
4278
- // echo $pRange.') is in sheet '.$namedRange->getWorksheet()->getTitle().'<br />';
4279
-
4280
- // if ($pSheet->getTitle() != $namedRange->getWorksheet()->getTitle()) {
4281
- // if (!$namedRange->getLocalOnly()) {
4282
- // $pSheet = $namedRange->getWorksheet();
4283
- // } else {
4284
- // return $returnValue;
4285
- // }
4286
- // }
4287
- } else {
4288
- return PHPExcel_Calculation_Functions::REF();
4289
- }
4290
-
4291
- // Extract range
4292
- $aReferences = PHPExcel_Cell::extractAllCellReferencesInRange($pRange);
4293
- // var_dump($aReferences);
4294
- if (!isset($aReferences[1])) {
4295
- // Single cell (or single column or row) in range
4296
- list($currentCol, $currentRow) = PHPExcel_Cell::coordinateFromString($aReferences[0]);
4297
- $cellValue = null;
4298
- if ($pSheet->cellExists($aReferences[0])) {
4299
- $returnValue[$currentRow][$currentCol] = $pSheet->getCell($aReferences[0])->getCalculatedValue($resetLog);
4300
- } else {
4301
- $returnValue[$currentRow][$currentCol] = null;
4302
- }
4303
- } else {
4304
- // Extract cell data for all cells in the range
4305
- foreach ($aReferences as $reference) {
4306
- // Extract range
4307
- list($currentCol, $currentRow) = PHPExcel_Cell::coordinateFromString($reference);
4308
- // echo 'NAMED RANGE: $currentCol='.$currentCol.' $currentRow='.$currentRow.'<br />';
4309
- $cellValue = null;
4310
- if ($pSheet->cellExists($reference)) {
4311
- $returnValue[$currentRow][$currentCol] = $pSheet->getCell($reference)->getCalculatedValue($resetLog);
4312
- } else {
4313
- $returnValue[$currentRow][$currentCol] = null;
4314
- }
4315
- }
4316
- }
4317
- // print_r($returnValue);
4318
- // echo '<br />';
4319
- }
4320
-
4321
- return $returnValue;
4322
- }
4323
-
4324
-
4325
- /**
4326
- * Is a specific function implemented?
4327
- *
4328
- * @param string $pFunction Function Name
4329
- * @return boolean
4330
- */
4331
- public function isImplemented($pFunction = '')
4332
- {
4333
- $pFunction = strtoupper($pFunction);
4334
- if (isset(self::$PHPExcelFunctions[$pFunction])) {
4335
- return (self::$PHPExcelFunctions[$pFunction]['functionCall'] != 'PHPExcel_Calculation_Functions::DUMMY');
4336
- } else {
4337
- return false;
4338
- }
4339
- }
4340
-
4341
-
4342
- /**
4343
- * Get a list of all implemented functions as an array of function objects
4344
- *
4345
- * @return array of PHPExcel_Calculation_Function
4346
- */
4347
- public function listFunctions()
4348
- {
4349
- $returnValue = array();
4350
-
4351
- foreach (self::$PHPExcelFunctions as $functionName => $function) {
4352
- if ($function['functionCall'] != 'PHPExcel_Calculation_Functions::DUMMY') {
4353
- $returnValue[$functionName] = new PHPExcel_Calculation_Function(
4354
- $function['category'],
4355
- $functionName,
4356
- $function['functionCall']
4357
- );
4358
- }
4359
- }
4360
-
4361
- return $returnValue;
4362
- }
4363
-
4364
-
4365
- /**
4366
- * Get a list of all Excel function names
4367
- *
4368
- * @return array
4369
- */
4370
- public function listAllFunctionNames()
4371
- {
4372
- return array_keys(self::$PHPExcelFunctions);
4373
- }
4374
-
4375
- /**
4376
- * Get a list of implemented Excel function names
4377
- *
4378
- * @return array
4379
- */
4380
- public function listFunctionNames()
4381
- {
4382
- $returnValue = array();
4383
- foreach (self::$PHPExcelFunctions as $functionName => $function) {
4384
- if ($function['functionCall'] != 'PHPExcel_Calculation_Functions::DUMMY') {
4385
- $returnValue[] = $functionName;
4386
- }
4387
- }
4388
-
4389
- return $returnValue;
4390
- }
4391
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Database.php DELETED
@@ -1,676 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
- /**
13
- * PHPExcel_Calculation_Database
14
- *
15
- * Copyright (c) 2006 - 2015 PHPExcel
16
- *
17
- * This library is free software; you can redistribute it and/or
18
- * modify it under the terms of the GNU Lesser General Public
19
- * License as published by the Free Software Foundation; either
20
- * version 2.1 of the License, or (at your option) any later version.
21
- *
22
- * This library is distributed in the hope that it will be useful,
23
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
24
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
25
- * Lesser General Public License for more details.
26
- *
27
- * You should have received a copy of the GNU Lesser General Public
28
- * License along with this library; if not, write to the Free Software
29
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
30
- *
31
- * @category PHPExcel
32
- * @package PHPExcel_Calculation
33
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
34
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
35
- * @version ##VERSION##, ##DATE##
36
- */
37
- class PHPExcel_Calculation_Database
38
- {
39
- /**
40
- * fieldExtract
41
- *
42
- * Extracts the column ID to use for the data field.
43
- *
44
- * @access private
45
- * @param mixed[] $database The range of cells that makes up the list or database.
46
- * A database is a list of related data in which rows of related
47
- * information are records, and columns of data are fields. The
48
- * first row of the list contains labels for each column.
49
- * @param mixed $field Indicates which column is used in the function. Enter the
50
- * column label enclosed between double quotation marks, such as
51
- * "Age" or "Yield," or a number (without quotation marks) that
52
- * represents the position of the column within the list: 1 for
53
- * the first column, 2 for the second column, and so on.
54
- * @return string|NULL
55
- *
56
- */
57
- private static function fieldExtract($database, $field)
58
- {
59
- $field = strtoupper(PHPExcel_Calculation_Functions::flattenSingleValue($field));
60
- $fieldNames = array_map('strtoupper', array_shift($database));
61
-
62
- if (is_numeric($field)) {
63
- $keys = array_keys($fieldNames);
64
- return $keys[$field-1];
65
- }
66
- $key = array_search($field, $fieldNames);
67
- return ($key) ? $key : null;
68
- }
69
-
70
- /**
71
- * filter
72
- *
73
- * Parses the selection criteria, extracts the database rows that match those criteria, and
74
- * returns that subset of rows.
75
- *
76
- * @access private
77
- * @param mixed[] $database The range of cells that makes up the list or database.
78
- * A database is a list of related data in which rows of related
79
- * information are records, and columns of data are fields. The
80
- * first row of the list contains labels for each column.
81
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
82
- * You can use any range for the criteria argument, as long as it
83
- * includes at least one column label and at least one cell below
84
- * the column label in which you specify a condition for the
85
- * column.
86
- * @return array of mixed
87
- *
88
- */
89
- private static function filter($database, $criteria)
90
- {
91
- $fieldNames = array_shift($database);
92
- $criteriaNames = array_shift($criteria);
93
-
94
- // Convert the criteria into a set of AND/OR conditions with [:placeholders]
95
- $testConditions = $testValues = array();
96
- $testConditionsCount = 0;
97
- foreach ($criteriaNames as $key => $criteriaName) {
98
- $testCondition = array();
99
- $testConditionCount = 0;
100
- foreach ($criteria as $row => $criterion) {
101
- if ($criterion[$key] > '') {
102
- $testCondition[] = '[:'.$criteriaName.']'.PHPExcel_Calculation_Functions::ifCondition($criterion[$key]);
103
- $testConditionCount++;
104
- }
105
- }
106
- if ($testConditionCount > 1) {
107
- $testConditions[] = 'OR(' . implode(',', $testCondition) . ')';
108
- $testConditionsCount++;
109
- } elseif ($testConditionCount == 1) {
110
- $testConditions[] = $testCondition[0];
111
- $testConditionsCount++;
112
- }
113
- }
114
-
115
- if ($testConditionsCount > 1) {
116
- $testConditionSet = 'AND(' . implode(',', $testConditions) . ')';
117
- } elseif ($testConditionsCount == 1) {
118
- $testConditionSet = $testConditions[0];
119
- }
120
-
121
- // Loop through each row of the database
122
- foreach ($database as $dataRow => $dataValues) {
123
- // Substitute actual values from the database row for our [:placeholders]
124
- $testConditionList = $testConditionSet;
125
- foreach ($criteriaNames as $key => $criteriaName) {
126
- $k = array_search($criteriaName, $fieldNames);
127
- if (isset($dataValues[$k])) {
128
- $dataValue = $dataValues[$k];
129
- $dataValue = (is_string($dataValue)) ? PHPExcel_Calculation::wrapResult(strtoupper($dataValue)) : $dataValue;
130
- $testConditionList = str_replace('[:' . $criteriaName . ']', $dataValue, $testConditionList);
131
- }
132
- }
133
- // evaluate the criteria against the row data
134
- $result = PHPExcel_Calculation::getInstance()->_calculateFormulaValue('='.$testConditionList);
135
- // If the row failed to meet the criteria, remove it from the database
136
- if (!$result) {
137
- unset($database[$dataRow]);
138
- }
139
- }
140
-
141
- return $database;
142
- }
143
-
144
-
145
- private static function getFilteredColumn($database, $field, $criteria)
146
- {
147
- // reduce the database to a set of rows that match all the criteria
148
- $database = self::filter($database, $criteria);
149
- // extract an array of values for the requested column
150
- $colData = array();
151
- foreach ($database as $row) {
152
- $colData[] = $row[$field];
153
- }
154
-
155
- return $colData;
156
- }
157
-
158
- /**
159
- * DAVERAGE
160
- *
161
- * Averages the values in a column of a list or database that match conditions you specify.
162
- *
163
- * Excel Function:
164
- * DAVERAGE(database,field,criteria)
165
- *
166
- * @access public
167
- * @category Database Functions
168
- * @param mixed[] $database The range of cells that makes up the list or database.
169
- * A database is a list of related data in which rows of related
170
- * information are records, and columns of data are fields. The
171
- * first row of the list contains labels for each column.
172
- * @param string|integer $field Indicates which column is used in the function. Enter the
173
- * column label enclosed between double quotation marks, such as
174
- * "Age" or "Yield," or a number (without quotation marks) that
175
- * represents the position of the column within the list: 1 for
176
- * the first column, 2 for the second column, and so on.
177
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
178
- * You can use any range for the criteria argument, as long as it
179
- * includes at least one column label and at least one cell below
180
- * the column label in which you specify a condition for the
181
- * column.
182
- * @return float
183
- *
184
- */
185
- public static function DAVERAGE($database, $field, $criteria)
186
- {
187
- $field = self::fieldExtract($database, $field);
188
- if (is_null($field)) {
189
- return null;
190
- }
191
-
192
- // Return
193
- return PHPExcel_Calculation_Statistical::AVERAGE(
194
- self::getFilteredColumn($database, $field, $criteria)
195
- );
196
- }
197
-
198
-
199
- /**
200
- * DCOUNT
201
- *
202
- * Counts the cells that contain numbers in a column of a list or database that match conditions
203
- * that you specify.
204
- *
205
- * Excel Function:
206
- * DCOUNT(database,[field],criteria)
207
- *
208
- * Excel Function:
209
- * DAVERAGE(database,field,criteria)
210
- *
211
- * @access public
212
- * @category Database Functions
213
- * @param mixed[] $database The range of cells that makes up the list or database.
214
- * A database is a list of related data in which rows of related
215
- * information are records, and columns of data are fields. The
216
- * first row of the list contains labels for each column.
217
- * @param string|integer $field Indicates which column is used in the function. Enter the
218
- * column label enclosed between double quotation marks, such as
219
- * "Age" or "Yield," or a number (without quotation marks) that
220
- * represents the position of the column within the list: 1 for
221
- * the first column, 2 for the second column, and so on.
222
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
223
- * You can use any range for the criteria argument, as long as it
224
- * includes at least one column label and at least one cell below
225
- * the column label in which you specify a condition for the
226
- * column.
227
- * @return integer
228
- *
229
- * @TODO The field argument is optional. If field is omitted, DCOUNT counts all records in the
230
- * database that match the criteria.
231
- *
232
- */
233
- public static function DCOUNT($database, $field, $criteria)
234
- {
235
- $field = self::fieldExtract($database, $field);
236
- if (is_null($field)) {
237
- return null;
238
- }
239
-
240
- // Return
241
- return PHPExcel_Calculation_Statistical::COUNT(
242
- self::getFilteredColumn($database, $field, $criteria)
243
- );
244
- }
245
-
246
-
247
- /**
248
- * DCOUNTA
249
- *
250
- * Counts the nonblank cells in a column of a list or database that match conditions that you specify.
251
- *
252
- * Excel Function:
253
- * DCOUNTA(database,[field],criteria)
254
- *
255
- * @access public
256
- * @category Database Functions
257
- * @param mixed[] $database The range of cells that makes up the list or database.
258
- * A database is a list of related data in which rows of related
259
- * information are records, and columns of data are fields. The
260
- * first row of the list contains labels for each column.
261
- * @param string|integer $field Indicates which column is used in the function. Enter the
262
- * column label enclosed between double quotation marks, such as
263
- * "Age" or "Yield," or a number (without quotation marks) that
264
- * represents the position of the column within the list: 1 for
265
- * the first column, 2 for the second column, and so on.
266
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
267
- * You can use any range for the criteria argument, as long as it
268
- * includes at least one column label and at least one cell below
269
- * the column label in which you specify a condition for the
270
- * column.
271
- * @return integer
272
- *
273
- * @TODO The field argument is optional. If field is omitted, DCOUNTA counts all records in the
274
- * database that match the criteria.
275
- *
276
- */
277
- public static function DCOUNTA($database, $field, $criteria)
278
- {
279
- $field = self::fieldExtract($database, $field);
280
- if (is_null($field)) {
281
- return null;
282
- }
283
-
284
- // reduce the database to a set of rows that match all the criteria
285
- $database = self::filter($database, $criteria);
286
- // extract an array of values for the requested column
287
- $colData = array();
288
- foreach ($database as $row) {
289
- $colData[] = $row[$field];
290
- }
291
-
292
- // Return
293
- return PHPExcel_Calculation_Statistical::COUNTA(
294
- self::getFilteredColumn($database, $field, $criteria)
295
- );
296
- }
297
-
298
-
299
- /**
300
- * DGET
301
- *
302
- * Extracts a single value from a column of a list or database that matches conditions that you
303
- * specify.
304
- *
305
- * Excel Function:
306
- * DGET(database,field,criteria)
307
- *
308
- * @access public
309
- * @category Database Functions
310
- * @param mixed[] $database The range of cells that makes up the list or database.
311
- * A database is a list of related data in which rows of related
312
- * information are records, and columns of data are fields. The
313
- * first row of the list contains labels for each column.
314
- * @param string|integer $field Indicates which column is used in the function. Enter the
315
- * column label enclosed between double quotation marks, such as
316
- * "Age" or "Yield," or a number (without quotation marks) that
317
- * represents the position of the column within the list: 1 for
318
- * the first column, 2 for the second column, and so on.
319
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
320
- * You can use any range for the criteria argument, as long as it
321
- * includes at least one column label and at least one cell below
322
- * the column label in which you specify a condition for the
323
- * column.
324
- * @return mixed
325
- *
326
- */
327
- public static function DGET($database, $field, $criteria)
328
- {
329
- $field = self::fieldExtract($database, $field);
330
- if (is_null($field)) {
331
- return null;
332
- }
333
-
334
- // Return
335
- $colData = self::getFilteredColumn($database, $field, $criteria);
336
- if (count($colData) > 1) {
337
- return PHPExcel_Calculation_Functions::NaN();
338
- }
339
-
340
- return $colData[0];
341
- }
342
-
343
-
344
- /**
345
- * DMAX
346
- *
347
- * Returns the largest number in a column of a list or database that matches conditions you that
348
- * specify.
349
- *
350
- * Excel Function:
351
- * DMAX(database,field,criteria)
352
- *
353
- * @access public
354
- * @category Database Functions
355
- * @param mixed[] $database The range of cells that makes up the list or database.
356
- * A database is a list of related data in which rows of related
357
- * information are records, and columns of data are fields. The
358
- * first row of the list contains labels for each column.
359
- * @param string|integer $field Indicates which column is used in the function. Enter the
360
- * column label enclosed between double quotation marks, such as
361
- * "Age" or "Yield," or a number (without quotation marks) that
362
- * represents the position of the column within the list: 1 for
363
- * the first column, 2 for the second column, and so on.
364
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
365
- * You can use any range for the criteria argument, as long as it
366
- * includes at least one column label and at least one cell below
367
- * the column label in which you specify a condition for the
368
- * column.
369
- * @return float
370
- *
371
- */
372
- public static function DMAX($database, $field, $criteria)
373
- {
374
- $field = self::fieldExtract($database, $field);
375
- if (is_null($field)) {
376
- return null;
377
- }
378
-
379
- // Return
380
- return PHPExcel_Calculation_Statistical::MAX(
381
- self::getFilteredColumn($database, $field, $criteria)
382
- );
383
- }
384
-
385
-
386
- /**
387
- * DMIN
388
- *
389
- * Returns the smallest number in a column of a list or database that matches conditions you that
390
- * specify.
391
- *
392
- * Excel Function:
393
- * DMIN(database,field,criteria)
394
- *
395
- * @access public
396
- * @category Database Functions
397
- * @param mixed[] $database The range of cells that makes up the list or database.
398
- * A database is a list of related data in which rows of related
399
- * information are records, and columns of data are fields. The
400
- * first row of the list contains labels for each column.
401
- * @param string|integer $field Indicates which column is used in the function. Enter the
402
- * column label enclosed between double quotation marks, such as
403
- * "Age" or "Yield," or a number (without quotation marks) that
404
- * represents the position of the column within the list: 1 for
405
- * the first column, 2 for the second column, and so on.
406
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
407
- * You can use any range for the criteria argument, as long as it
408
- * includes at least one column label and at least one cell below
409
- * the column label in which you specify a condition for the
410
- * column.
411
- * @return float
412
- *
413
- */
414
- public static function DMIN($database, $field, $criteria)
415
- {
416
- $field = self::fieldExtract($database, $field);
417
- if (is_null($field)) {
418
- return null;
419
- }
420
-
421
- // Return
422
- return PHPExcel_Calculation_Statistical::MIN(
423
- self::getFilteredColumn($database, $field, $criteria)
424
- );
425
- }
426
-
427
-
428
- /**
429
- * DPRODUCT
430
- *
431
- * Multiplies the values in a column of a list or database that match conditions that you specify.
432
- *
433
- * Excel Function:
434
- * DPRODUCT(database,field,criteria)
435
- *
436
- * @access public
437
- * @category Database Functions
438
- * @param mixed[] $database The range of cells that makes up the list or database.
439
- * A database is a list of related data in which rows of related
440
- * information are records, and columns of data are fields. The
441
- * first row of the list contains labels for each column.
442
- * @param string|integer $field Indicates which column is used in the function. Enter the
443
- * column label enclosed between double quotation marks, such as
444
- * "Age" or "Yield," or a number (without quotation marks) that
445
- * represents the position of the column within the list: 1 for
446
- * the first column, 2 for the second column, and so on.
447
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
448
- * You can use any range for the criteria argument, as long as it
449
- * includes at least one column label and at least one cell below
450
- * the column label in which you specify a condition for the
451
- * column.
452
- * @return float
453
- *
454
- */
455
- public static function DPRODUCT($database, $field, $criteria)
456
- {
457
- $field = self::fieldExtract($database, $field);
458
- if (is_null($field)) {
459
- return null;
460
- }
461
-
462
- // Return
463
- return PHPExcel_Calculation_MathTrig::PRODUCT(
464
- self::getFilteredColumn($database, $field, $criteria)
465
- );
466
- }
467
-
468
-
469
- /**
470
- * DSTDEV
471
- *
472
- * Estimates the standard deviation of a population based on a sample by using the numbers in a
473
- * column of a list or database that match conditions that you specify.
474
- *
475
- * Excel Function:
476
- * DSTDEV(database,field,criteria)
477
- *
478
- * @access public
479
- * @category Database Functions
480
- * @param mixed[] $database The range of cells that makes up the list or database.
481
- * A database is a list of related data in which rows of related
482
- * information are records, and columns of data are fields. The
483
- * first row of the list contains labels for each column.
484
- * @param string|integer $field Indicates which column is used in the function. Enter the
485
- * column label enclosed between double quotation marks, such as
486
- * "Age" or "Yield," or a number (without quotation marks) that
487
- * represents the position of the column within the list: 1 for
488
- * the first column, 2 for the second column, and so on.
489
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
490
- * You can use any range for the criteria argument, as long as it
491
- * includes at least one column label and at least one cell below
492
- * the column label in which you specify a condition for the
493
- * column.
494
- * @return float
495
- *
496
- */
497
- public static function DSTDEV($database, $field, $criteria)
498
- {
499
- $field = self::fieldExtract($database, $field);
500
- if (is_null($field)) {
501
- return null;
502
- }
503
-
504
- // Return
505
- return PHPExcel_Calculation_Statistical::STDEV(
506
- self::getFilteredColumn($database, $field, $criteria)
507
- );
508
- }
509
-
510
-
511
- /**
512
- * DSTDEVP
513
- *
514
- * Calculates the standard deviation of a population based on the entire population by using the
515
- * numbers in a column of a list or database that match conditions that you specify.
516
- *
517
- * Excel Function:
518
- * DSTDEVP(database,field,criteria)
519
- *
520
- * @access public
521
- * @category Database Functions
522
- * @param mixed[] $database The range of cells that makes up the list or database.
523
- * A database is a list of related data in which rows of related
524
- * information are records, and columns of data are fields. The
525
- * first row of the list contains labels for each column.
526
- * @param string|integer $field Indicates which column is used in the function. Enter the
527
- * column label enclosed between double quotation marks, such as
528
- * "Age" or "Yield," or a number (without quotation marks) that
529
- * represents the position of the column within the list: 1 for
530
- * the first column, 2 for the second column, and so on.
531
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
532
- * You can use any range for the criteria argument, as long as it
533
- * includes at least one column label and at least one cell below
534
- * the column label in which you specify a condition for the
535
- * column.
536
- * @return float
537
- *
538
- */
539
- public static function DSTDEVP($database, $field, $criteria)
540
- {
541
- $field = self::fieldExtract($database, $field);
542
- if (is_null($field)) {
543
- return null;
544
- }
545
-
546
- // Return
547
- return PHPExcel_Calculation_Statistical::STDEVP(
548
- self::getFilteredColumn($database, $field, $criteria)
549
- );
550
- }
551
-
552
-
553
- /**
554
- * DSUM
555
- *
556
- * Adds the numbers in a column of a list or database that match conditions that you specify.
557
- *
558
- * Excel Function:
559
- * DSUM(database,field,criteria)
560
- *
561
- * @access public
562
- * @category Database Functions
563
- * @param mixed[] $database The range of cells that makes up the list or database.
564
- * A database is a list of related data in which rows of related
565
- * information are records, and columns of data are fields. The
566
- * first row of the list contains labels for each column.
567
- * @param string|integer $field Indicates which column is used in the function. Enter the
568
- * column label enclosed between double quotation marks, such as
569
- * "Age" or "Yield," or a number (without quotation marks) that
570
- * represents the position of the column within the list: 1 for
571
- * the first column, 2 for the second column, and so on.
572
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
573
- * You can use any range for the criteria argument, as long as it
574
- * includes at least one column label and at least one cell below
575
- * the column label in which you specify a condition for the
576
- * column.
577
- * @return float
578
- *
579
- */
580
- public static function DSUM($database, $field, $criteria)
581
- {
582
- $field = self::fieldExtract($database, $field);
583
- if (is_null($field)) {
584
- return null;
585
- }
586
-
587
- // Return
588
- return PHPExcel_Calculation_MathTrig::SUM(
589
- self::getFilteredColumn($database, $field, $criteria)
590
- );
591
- }
592
-
593
-
594
- /**
595
- * DVAR
596
- *
597
- * Estimates the variance of a population based on a sample by using the numbers in a column
598
- * of a list or database that match conditions that you specify.
599
- *
600
- * Excel Function:
601
- * DVAR(database,field,criteria)
602
- *
603
- * @access public
604
- * @category Database Functions
605
- * @param mixed[] $database The range of cells that makes up the list or database.
606
- * A database is a list of related data in which rows of related
607
- * information are records, and columns of data are fields. The
608
- * first row of the list contains labels for each column.
609
- * @param string|integer $field Indicates which column is used in the function. Enter the
610
- * column label enclosed between double quotation marks, such as
611
- * "Age" or "Yield," or a number (without quotation marks) that
612
- * represents the position of the column within the list: 1 for
613
- * the first column, 2 for the second column, and so on.
614
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
615
- * You can use any range for the criteria argument, as long as it
616
- * includes at least one column label and at least one cell below
617
- * the column label in which you specify a condition for the
618
- * column.
619
- * @return float
620
- *
621
- */
622
- public static function DVAR($database, $field, $criteria)
623
- {
624
- $field = self::fieldExtract($database, $field);
625
- if (is_null($field)) {
626
- return null;
627
- }
628
-
629
- // Return
630
- return PHPExcel_Calculation_Statistical::VARFunc(
631
- self::getFilteredColumn($database, $field, $criteria)
632
- );
633
- }
634
-
635
-
636
- /**
637
- * DVARP
638
- *
639
- * Calculates the variance of a population based on the entire population by using the numbers
640
- * in a column of a list or database that match conditions that you specify.
641
- *
642
- * Excel Function:
643
- * DVARP(database,field,criteria)
644
- *
645
- * @access public
646
- * @category Database Functions
647
- * @param mixed[] $database The range of cells that makes up the list or database.
648
- * A database is a list of related data in which rows of related
649
- * information are records, and columns of data are fields. The
650
- * first row of the list contains labels for each column.
651
- * @param string|integer $field Indicates which column is used in the function. Enter the
652
- * column label enclosed between double quotation marks, such as
653
- * "Age" or "Yield," or a number (without quotation marks) that
654
- * represents the position of the column within the list: 1 for
655
- * the first column, 2 for the second column, and so on.
656
- * @param mixed[] $criteria The range of cells that contains the conditions you specify.
657
- * You can use any range for the criteria argument, as long as it
658
- * includes at least one column label and at least one cell below
659
- * the column label in which you specify a condition for the
660
- * column.
661
- * @return float
662
- *
663
- */
664
- public static function DVARP($database, $field, $criteria)
665
- {
666
- $field = self::fieldExtract($database, $field);
667
- if (is_null($field)) {
668
- return null;
669
- }
670
-
671
- // Return
672
- return PHPExcel_Calculation_Statistical::VARP(
673
- self::getFilteredColumn($database, $field, $criteria)
674
- );
675
- }
676
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/DateTime.php DELETED
@@ -1,1553 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
- /**
13
- * PHPExcel_Calculation_DateTime
14
- *
15
- * Copyright (c) 2006 - 2015 PHPExcel
16
- *
17
- * This library is free software; you can redistribute it and/or
18
- * modify it under the terms of the GNU Lesser General Public
19
- * License as published by the Free Software Foundation; either
20
- * version 2.1 of the License, or (at your option) any later version.
21
- *
22
- * This library is distributed in the hope that it will be useful,
23
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
24
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
25
- * Lesser General Public License for more details.
26
- *
27
- * You should have received a copy of the GNU Lesser General Public
28
- * License along with this library; if not, write to the Free Software
29
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
30
- *
31
- * @category PHPExcel
32
- * @package PHPExcel_Calculation
33
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
34
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
35
- * @version ##VERSION##, ##DATE##
36
- */
37
- class PHPExcel_Calculation_DateTime
38
- {
39
- /**
40
- * Identify if a year is a leap year or not
41
- *
42
- * @param integer $year The year to test
43
- * @return boolean TRUE if the year is a leap year, otherwise FALSE
44
- */
45
- public static function isLeapYear($year)
46
- {
47
- return ((($year % 4) == 0) && (($year % 100) != 0) || (($year % 400) == 0));
48
- }
49
-
50
-
51
- /**
52
- * Return the number of days between two dates based on a 360 day calendar
53
- *
54
- * @param integer $startDay Day of month of the start date
55
- * @param integer $startMonth Month of the start date
56
- * @param integer $startYear Year of the start date
57
- * @param integer $endDay Day of month of the start date
58
- * @param integer $endMonth Month of the start date
59
- * @param integer $endYear Year of the start date
60
- * @param boolean $methodUS Whether to use the US method or the European method of calculation
61
- * @return integer Number of days between the start date and the end date
62
- */
63
- private static function dateDiff360($startDay, $startMonth, $startYear, $endDay, $endMonth, $endYear, $methodUS)
64
- {
65
- if ($startDay == 31) {
66
- --$startDay;
67
- } elseif ($methodUS && ($startMonth == 2 && ($startDay == 29 || ($startDay == 28 && !self::isLeapYear($startYear))))) {
68
- $startDay = 30;
69
- }
70
- if ($endDay == 31) {
71
- if ($methodUS && $startDay != 30) {
72
- $endDay = 1;
73
- if ($endMonth == 12) {
74
- ++$endYear;
75
- $endMonth = 1;
76
- } else {
77
- ++$endMonth;
78
- }
79
- } else {
80
- $endDay = 30;
81
- }
82
- }
83
-
84
- return $endDay + $endMonth * 30 + $endYear * 360 - $startDay - $startMonth * 30 - $startYear * 360;
85
- }
86
-
87
-
88
- /**
89
- * getDateValue
90
- *
91
- * @param string $dateValue
92
- * @return mixed Excel date/time serial value, or string if error
93
- */
94
- public static function getDateValue($dateValue)
95
- {
96
- if (!is_numeric($dateValue)) {
97
- if ((is_string($dateValue)) &&
98
- (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC)) {
99
- return PHPExcel_Calculation_Functions::VALUE();
100
- }
101
- if ((is_object($dateValue)) && ($dateValue instanceof DateTime)) {
102
- $dateValue = PHPExcel_Shared_Date::PHPToExcel($dateValue);
103
- } else {
104
- $saveReturnDateType = PHPExcel_Calculation_Functions::getReturnDateType();
105
- PHPExcel_Calculation_Functions::setReturnDateType(PHPExcel_Calculation_Functions::RETURNDATE_EXCEL);
106
- $dateValue = self::DATEVALUE($dateValue);
107
- PHPExcel_Calculation_Functions::setReturnDateType($saveReturnDateType);
108
- }
109
- }
110
- return $dateValue;
111
- }
112
-
113
-
114
- /**
115
- * getTimeValue
116
- *
117
- * @param string $timeValue
118
- * @return mixed Excel date/time serial value, or string if error
119
- */
120
- private static function getTimeValue($timeValue)
121
- {
122
- $saveReturnDateType = PHPExcel_Calculation_Functions::getReturnDateType();
123
- PHPExcel_Calculation_Functions::setReturnDateType(PHPExcel_Calculation_Functions::RETURNDATE_EXCEL);
124
- $timeValue = self::TIMEVALUE($timeValue);
125
- PHPExcel_Calculation_Functions::setReturnDateType($saveReturnDateType);
126
- return $timeValue;
127
- }
128
-
129
-
130
- private static function adjustDateByMonths($dateValue = 0, $adjustmentMonths = 0)
131
- {
132
- // Execute function
133
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
134
- $oMonth = (int) $PHPDateObject->format('m');
135
- $oYear = (int) $PHPDateObject->format('Y');
136
-
137
- $adjustmentMonthsString = (string) $adjustmentMonths;
138
- if ($adjustmentMonths > 0) {
139
- $adjustmentMonthsString = '+'.$adjustmentMonths;
140
- }
141
- if ($adjustmentMonths != 0) {
142
- $PHPDateObject->modify($adjustmentMonthsString.' months');
143
- }
144
- $nMonth = (int) $PHPDateObject->format('m');
145
- $nYear = (int) $PHPDateObject->format('Y');
146
-
147
- $monthDiff = ($nMonth - $oMonth) + (($nYear - $oYear) * 12);
148
- if ($monthDiff != $adjustmentMonths) {
149
- $adjustDays = (int) $PHPDateObject->format('d');
150
- $adjustDaysString = '-'.$adjustDays.' days';
151
- $PHPDateObject->modify($adjustDaysString);
152
- }
153
- return $PHPDateObject;
154
- }
155
-
156
-
157
- /**
158
- * DATETIMENOW
159
- *
160
- * Returns the current date and time.
161
- * The NOW function is useful when you need to display the current date and time on a worksheet or
162
- * calculate a value based on the current date and time, and have that value updated each time you
163
- * open the worksheet.
164
- *
165
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date
166
- * and time format of your regional settings. PHPExcel does not change cell formatting in this way.
167
- *
168
- * Excel Function:
169
- * NOW()
170
- *
171
- * @access public
172
- * @category Date/Time Functions
173
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
174
- * depending on the value of the ReturnDateType flag
175
- */
176
- public static function DATETIMENOW()
177
- {
178
- $saveTimeZone = date_default_timezone_get();
179
- date_default_timezone_set('UTC');
180
- $retValue = false;
181
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
182
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
183
- $retValue = (float) PHPExcel_Shared_Date::PHPToExcel(time());
184
- break;
185
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
186
- $retValue = (integer) time();
187
- break;
188
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
189
- $retValue = new DateTime();
190
- break;
191
- }
192
- date_default_timezone_set($saveTimeZone);
193
-
194
- return $retValue;
195
- }
196
-
197
-
198
- /**
199
- * DATENOW
200
- *
201
- * Returns the current date.
202
- * The NOW function is useful when you need to display the current date and time on a worksheet or
203
- * calculate a value based on the current date and time, and have that value updated each time you
204
- * open the worksheet.
205
- *
206
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date
207
- * and time format of your regional settings. PHPExcel does not change cell formatting in this way.
208
- *
209
- * Excel Function:
210
- * TODAY()
211
- *
212
- * @access public
213
- * @category Date/Time Functions
214
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
215
- * depending on the value of the ReturnDateType flag
216
- */
217
- public static function DATENOW()
218
- {
219
- $saveTimeZone = date_default_timezone_get();
220
- date_default_timezone_set('UTC');
221
- $retValue = false;
222
- $excelDateTime = floor(PHPExcel_Shared_Date::PHPToExcel(time()));
223
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
224
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
225
- $retValue = (float) $excelDateTime;
226
- break;
227
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
228
- $retValue = (integer) PHPExcel_Shared_Date::ExcelToPHP($excelDateTime);
229
- break;
230
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
231
- $retValue = PHPExcel_Shared_Date::ExcelToPHPObject($excelDateTime);
232
- break;
233
- }
234
- date_default_timezone_set($saveTimeZone);
235
-
236
- return $retValue;
237
- }
238
-
239
-
240
- /**
241
- * DATE
242
- *
243
- * The DATE function returns a value that represents a particular date.
244
- *
245
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date
246
- * format of your regional settings. PHPExcel does not change cell formatting in this way.
247
- *
248
- * Excel Function:
249
- * DATE(year,month,day)
250
- *
251
- * PHPExcel is a lot more forgiving than MS Excel when passing non numeric values to this function.
252
- * A Month name or abbreviation (English only at this point) such as 'January' or 'Jan' will still be accepted,
253
- * as will a day value with a suffix (e.g. '21st' rather than simply 21); again only English language.
254
- *
255
- * @access public
256
- * @category Date/Time Functions
257
- * @param integer $year The value of the year argument can include one to four digits.
258
- * Excel interprets the year argument according to the configured
259
- * date system: 1900 or 1904.
260
- * If year is between 0 (zero) and 1899 (inclusive), Excel adds that
261
- * value to 1900 to calculate the year. For example, DATE(108,1,2)
262
- * returns January 2, 2008 (1900+108).
263
- * If year is between 1900 and 9999 (inclusive), Excel uses that
264
- * value as the year. For example, DATE(2008,1,2) returns January 2,
265
- * 2008.
266
- * If year is less than 0 or is 10000 or greater, Excel returns the
267
- * #NUM! error value.
268
- * @param integer $month A positive or negative integer representing the month of the year
269
- * from 1 to 12 (January to December).
270
- * If month is greater than 12, month adds that number of months to
271
- * the first month in the year specified. For example, DATE(2008,14,2)
272
- * returns the serial number representing February 2, 2009.
273
- * If month is less than 1, month subtracts the magnitude of that
274
- * number of months, plus 1, from the first month in the year
275
- * specified. For example, DATE(2008,-3,2) returns the serial number
276
- * representing September 2, 2007.
277
- * @param integer $day A positive or negative integer representing the day of the month
278
- * from 1 to 31.
279
- * If day is greater than the number of days in the month specified,
280
- * day adds that number of days to the first day in the month. For
281
- * example, DATE(2008,1,35) returns the serial number representing
282
- * February 4, 2008.
283
- * If day is less than 1, day subtracts the magnitude that number of
284
- * days, plus one, from the first day of the month specified. For
285
- * example, DATE(2008,1,-15) returns the serial number representing
286
- * December 16, 2007.
287
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
288
- * depending on the value of the ReturnDateType flag
289
- */
290
- public static function DATE($year = 0, $month = 1, $day = 1)
291
- {
292
- $year = PHPExcel_Calculation_Functions::flattenSingleValue($year);
293
- $month = PHPExcel_Calculation_Functions::flattenSingleValue($month);
294
- $day = PHPExcel_Calculation_Functions::flattenSingleValue($day);
295
-
296
- if (($month !== null) && (!is_numeric($month))) {
297
- $month = PHPExcel_Shared_Date::monthStringToNumber($month);
298
- }
299
-
300
- if (($day !== null) && (!is_numeric($day))) {
301
- $day = PHPExcel_Shared_Date::dayStringToNumber($day);
302
- }
303
-
304
- $year = ($year !== null) ? PHPExcel_Shared_String::testStringAsNumeric($year) : 0;
305
- $month = ($month !== null) ? PHPExcel_Shared_String::testStringAsNumeric($month) : 0;
306
- $day = ($day !== null) ? PHPExcel_Shared_String::testStringAsNumeric($day) : 0;
307
- if ((!is_numeric($year)) ||
308
- (!is_numeric($month)) ||
309
- (!is_numeric($day))) {
310
- return PHPExcel_Calculation_Functions::VALUE();
311
- }
312
- $year = (integer) $year;
313
- $month = (integer) $month;
314
- $day = (integer) $day;
315
-
316
- $baseYear = PHPExcel_Shared_Date::getExcelCalendar();
317
- // Validate parameters
318
- if ($year < ($baseYear-1900)) {
319
- return PHPExcel_Calculation_Functions::NaN();
320
- }
321
- if ((($baseYear-1900) != 0) && ($year < $baseYear) && ($year >= 1900)) {
322
- return PHPExcel_Calculation_Functions::NaN();
323
- }
324
-
325
- if (($year < $baseYear) && ($year >= ($baseYear-1900))) {
326
- $year += 1900;
327
- }
328
-
329
- if ($month < 1) {
330
- // Handle year/month adjustment if month < 1
331
- --$month;
332
- $year += ceil($month / 12) - 1;
333
- $month = 13 - abs($month % 12);
334
- } elseif ($month > 12) {
335
- // Handle year/month adjustment if month > 12
336
- $year += floor($month / 12);
337
- $month = ($month % 12);
338
- }
339
-
340
- // Re-validate the year parameter after adjustments
341
- if (($year < $baseYear) || ($year >= 10000)) {
342
- return PHPExcel_Calculation_Functions::NaN();
343
- }
344
-
345
- // Execute function
346
- $excelDateValue = PHPExcel_Shared_Date::FormattedPHPToExcel($year, $month, $day);
347
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
348
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
349
- return (float) $excelDateValue;
350
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
351
- return (integer) PHPExcel_Shared_Date::ExcelToPHP($excelDateValue);
352
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
353
- return PHPExcel_Shared_Date::ExcelToPHPObject($excelDateValue);
354
- }
355
- }
356
-
357
-
358
- /**
359
- * TIME
360
- *
361
- * The TIME function returns a value that represents a particular time.
362
- *
363
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the time
364
- * format of your regional settings. PHPExcel does not change cell formatting in this way.
365
- *
366
- * Excel Function:
367
- * TIME(hour,minute,second)
368
- *
369
- * @access public
370
- * @category Date/Time Functions
371
- * @param integer $hour A number from 0 (zero) to 32767 representing the hour.
372
- * Any value greater than 23 will be divided by 24 and the remainder
373
- * will be treated as the hour value. For example, TIME(27,0,0) =
374
- * TIME(3,0,0) = .125 or 3:00 AM.
375
- * @param integer $minute A number from 0 to 32767 representing the minute.
376
- * Any value greater than 59 will be converted to hours and minutes.
377
- * For example, TIME(0,750,0) = TIME(12,30,0) = .520833 or 12:30 PM.
378
- * @param integer $second A number from 0 to 32767 representing the second.
379
- * Any value greater than 59 will be converted to hours, minutes,
380
- * and seconds. For example, TIME(0,0,2000) = TIME(0,33,22) = .023148
381
- * or 12:33:20 AM
382
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
383
- * depending on the value of the ReturnDateType flag
384
- */
385
- public static function TIME($hour = 0, $minute = 0, $second = 0)
386
- {
387
- $hour = PHPExcel_Calculation_Functions::flattenSingleValue($hour);
388
- $minute = PHPExcel_Calculation_Functions::flattenSingleValue($minute);
389
- $second = PHPExcel_Calculation_Functions::flattenSingleValue($second);
390
-
391
- if ($hour == '') {
392
- $hour = 0;
393
- }
394
- if ($minute == '') {
395
- $minute = 0;
396
- }
397
- if ($second == '') {
398
- $second = 0;
399
- }
400
-
401
- if ((!is_numeric($hour)) || (!is_numeric($minute)) || (!is_numeric($second))) {
402
- return PHPExcel_Calculation_Functions::VALUE();
403
- }
404
- $hour = (integer) $hour;
405
- $minute = (integer) $minute;
406
- $second = (integer) $second;
407
-
408
- if ($second < 0) {
409
- $minute += floor($second / 60);
410
- $second = 60 - abs($second % 60);
411
- if ($second == 60) {
412
- $second = 0;
413
- }
414
- } elseif ($second >= 60) {
415
- $minute += floor($second / 60);
416
- $second = $second % 60;
417
- }
418
- if ($minute < 0) {
419
- $hour += floor($minute / 60);
420
- $minute = 60 - abs($minute % 60);
421
- if ($minute == 60) {
422
- $minute = 0;
423
- }
424
- } elseif ($minute >= 60) {
425
- $hour += floor($minute / 60);
426
- $minute = $minute % 60;
427
- }
428
-
429
- if ($hour > 23) {
430
- $hour = $hour % 24;
431
- } elseif ($hour < 0) {
432
- return PHPExcel_Calculation_Functions::NaN();
433
- }
434
-
435
- // Execute function
436
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
437
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
438
- $date = 0;
439
- $calendar = PHPExcel_Shared_Date::getExcelCalendar();
440
- if ($calendar != PHPExcel_Shared_Date::CALENDAR_WINDOWS_1900) {
441
- $date = 1;
442
- }
443
- return (float) PHPExcel_Shared_Date::FormattedPHPToExcel($calendar, 1, $date, $hour, $minute, $second);
444
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
445
- return (integer) PHPExcel_Shared_Date::ExcelToPHP(PHPExcel_Shared_Date::FormattedPHPToExcel(1970, 1, 1, $hour, $minute, $second)); // -2147468400; // -2147472000 + 3600
446
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
447
- $dayAdjust = 0;
448
- if ($hour < 0) {
449
- $dayAdjust = floor($hour / 24);
450
- $hour = 24 - abs($hour % 24);
451
- if ($hour == 24) {
452
- $hour = 0;
453
- }
454
- } elseif ($hour >= 24) {
455
- $dayAdjust = floor($hour / 24);
456
- $hour = $hour % 24;
457
- }
458
- $phpDateObject = new DateTime('1900-01-01 '.$hour.':'.$minute.':'.$second);
459
- if ($dayAdjust != 0) {
460
- $phpDateObject->modify($dayAdjust.' days');
461
- }
462
- return $phpDateObject;
463
- }
464
- }
465
-
466
-
467
- /**
468
- * DATEVALUE
469
- *
470
- * Returns a value that represents a particular date.
471
- * Use DATEVALUE to convert a date represented by a text string to an Excel or PHP date/time stamp
472
- * value.
473
- *
474
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the date
475
- * format of your regional settings. PHPExcel does not change cell formatting in this way.
476
- *
477
- * Excel Function:
478
- * DATEVALUE(dateValue)
479
- *
480
- * @access public
481
- * @category Date/Time Functions
482
- * @param string $dateValue Text that represents a date in a Microsoft Excel date format.
483
- * For example, "1/30/2008" or "30-Jan-2008" are text strings within
484
- * quotation marks that represent dates. Using the default date
485
- * system in Excel for Windows, date_text must represent a date from
486
- * January 1, 1900, to December 31, 9999. Using the default date
487
- * system in Excel for the Macintosh, date_text must represent a date
488
- * from January 1, 1904, to December 31, 9999. DATEVALUE returns the
489
- * #VALUE! error value if date_text is out of this range.
490
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
491
- * depending on the value of the ReturnDateType flag
492
- */
493
- public static function DATEVALUE($dateValue = 1)
494
- {
495
- $dateValue = trim(PHPExcel_Calculation_Functions::flattenSingleValue($dateValue), '"');
496
- // Strip any ordinals because they're allowed in Excel (English only)
497
- $dateValue = preg_replace('/(\d)(st|nd|rd|th)([ -\/])/Ui', '$1$3', $dateValue);
498
- // Convert separators (/ . or space) to hyphens (should also handle dot used for ordinals in some countries, e.g. Denmark, Germany)
499
- $dateValue = str_replace(array('/', '.', '-', ' '), array(' ', ' ', ' ', ' '), $dateValue);
500
-
501
- $yearFound = false;
502
- $t1 = explode(' ', $dateValue);
503
- foreach ($t1 as &$t) {
504
- if ((is_numeric($t)) && ($t > 31)) {
505
- if ($yearFound) {
506
- return PHPExcel_Calculation_Functions::VALUE();
507
- } else {
508
- if ($t < 100) {
509
- $t += 1900;
510
- }
511
- $yearFound = true;
512
- }
513
- }
514
- }
515
- if ((count($t1) == 1) && (strpos($t, ':') != false)) {
516
- // We've been fed a time value without any date
517
- return 0.0;
518
- } elseif (count($t1) == 2) {
519
- // We only have two parts of the date: either day/month or month/year
520
- if ($yearFound) {
521
- array_unshift($t1, 1);
522
- } else {
523
- array_push($t1, date('Y'));
524
- }
525
- }
526
- unset($t);
527
- $dateValue = implode(' ', $t1);
528
-
529
- $PHPDateArray = date_parse($dateValue);
530
- if (($PHPDateArray === false) || ($PHPDateArray['error_count'] > 0)) {
531
- $testVal1 = strtok($dateValue, '- ');
532
- if ($testVal1 !== false) {
533
- $testVal2 = strtok('- ');
534
- if ($testVal2 !== false) {
535
- $testVal3 = strtok('- ');
536
- if ($testVal3 === false) {
537
- $testVal3 = strftime('%Y');
538
- }
539
- } else {
540
- return PHPExcel_Calculation_Functions::VALUE();
541
- }
542
- } else {
543
- return PHPExcel_Calculation_Functions::VALUE();
544
- }
545
- $PHPDateArray = date_parse($testVal1.'-'.$testVal2.'-'.$testVal3);
546
- if (($PHPDateArray === false) || ($PHPDateArray['error_count'] > 0)) {
547
- $PHPDateArray = date_parse($testVal2.'-'.$testVal1.'-'.$testVal3);
548
- if (($PHPDateArray === false) || ($PHPDateArray['error_count'] > 0)) {
549
- return PHPExcel_Calculation_Functions::VALUE();
550
- }
551
- }
552
- }
553
-
554
- if (($PHPDateArray !== false) && ($PHPDateArray['error_count'] == 0)) {
555
- // Execute function
556
- if ($PHPDateArray['year'] == '') {
557
- $PHPDateArray['year'] = strftime('%Y');
558
- }
559
- if ($PHPDateArray['year'] < 1900) {
560
- return PHPExcel_Calculation_Functions::VALUE();
561
- }
562
- if ($PHPDateArray['month'] == '') {
563
- $PHPDateArray['month'] = strftime('%m');
564
- }
565
- if ($PHPDateArray['day'] == '') {
566
- $PHPDateArray['day'] = strftime('%d');
567
- }
568
- $excelDateValue = floor(
569
- PHPExcel_Shared_Date::FormattedPHPToExcel(
570
- $PHPDateArray['year'],
571
- $PHPDateArray['month'],
572
- $PHPDateArray['day'],
573
- $PHPDateArray['hour'],
574
- $PHPDateArray['minute'],
575
- $PHPDateArray['second']
576
- )
577
- );
578
-
579
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
580
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
581
- return (float) $excelDateValue;
582
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
583
- return (integer) PHPExcel_Shared_Date::ExcelToPHP($excelDateValue);
584
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
585
- return new DateTime($PHPDateArray['year'].'-'.$PHPDateArray['month'].'-'.$PHPDateArray['day'].' 00:00:00');
586
- }
587
- }
588
- return PHPExcel_Calculation_Functions::VALUE();
589
- }
590
-
591
-
592
- /**
593
- * TIMEVALUE
594
- *
595
- * Returns a value that represents a particular time.
596
- * Use TIMEVALUE to convert a time represented by a text string to an Excel or PHP date/time stamp
597
- * value.
598
- *
599
- * NOTE: When used in a Cell Formula, MS Excel changes the cell format so that it matches the time
600
- * format of your regional settings. PHPExcel does not change cell formatting in this way.
601
- *
602
- * Excel Function:
603
- * TIMEVALUE(timeValue)
604
- *
605
- * @access public
606
- * @category Date/Time Functions
607
- * @param string $timeValue A text string that represents a time in any one of the Microsoft
608
- * Excel time formats; for example, "6:45 PM" and "18:45" text strings
609
- * within quotation marks that represent time.
610
- * Date information in time_text is ignored.
611
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
612
- * depending on the value of the ReturnDateType flag
613
- */
614
- public static function TIMEVALUE($timeValue)
615
- {
616
- $timeValue = trim(PHPExcel_Calculation_Functions::flattenSingleValue($timeValue), '"');
617
- $timeValue = str_replace(array('/', '.'), array('-', '-'), $timeValue);
618
-
619
- $PHPDateArray = date_parse($timeValue);
620
- if (($PHPDateArray !== false) && ($PHPDateArray['error_count'] == 0)) {
621
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
622
- $excelDateValue = PHPExcel_Shared_Date::FormattedPHPToExcel(
623
- $PHPDateArray['year'],
624
- $PHPDateArray['month'],
625
- $PHPDateArray['day'],
626
- $PHPDateArray['hour'],
627
- $PHPDateArray['minute'],
628
- $PHPDateArray['second']
629
- );
630
- } else {
631
- $excelDateValue = PHPExcel_Shared_Date::FormattedPHPToExcel(1900, 1, 1, $PHPDateArray['hour'], $PHPDateArray['minute'], $PHPDateArray['second']) - 1;
632
- }
633
-
634
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
635
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
636
- return (float) $excelDateValue;
637
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
638
- return (integer) $phpDateValue = PHPExcel_Shared_Date::ExcelToPHP($excelDateValue+25569) - 3600;
639
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
640
- return new DateTime('1900-01-01 '.$PHPDateArray['hour'].':'.$PHPDateArray['minute'].':'.$PHPDateArray['second']);
641
- }
642
- }
643
- return PHPExcel_Calculation_Functions::VALUE();
644
- }
645
-
646
-
647
- /**
648
- * DATEDIF
649
- *
650
- * @param mixed $startDate Excel date serial value, PHP date/time stamp, PHP DateTime object
651
- * or a standard date string
652
- * @param mixed $endDate Excel date serial value, PHP date/time stamp, PHP DateTime object
653
- * or a standard date string
654
- * @param string $unit
655
- * @return integer Interval between the dates
656
- */
657
- public static function DATEDIF($startDate = 0, $endDate = 0, $unit = 'D')
658
- {
659
- $startDate = PHPExcel_Calculation_Functions::flattenSingleValue($startDate);
660
- $endDate = PHPExcel_Calculation_Functions::flattenSingleValue($endDate);
661
- $unit = strtoupper(PHPExcel_Calculation_Functions::flattenSingleValue($unit));
662
-
663
- if (is_string($startDate = self::getDateValue($startDate))) {
664
- return PHPExcel_Calculation_Functions::VALUE();
665
- }
666
- if (is_string($endDate = self::getDateValue($endDate))) {
667
- return PHPExcel_Calculation_Functions::VALUE();
668
- }
669
-
670
- // Validate parameters
671
- if ($startDate >= $endDate) {
672
- return PHPExcel_Calculation_Functions::NaN();
673
- }
674
-
675
- // Execute function
676
- $difference = $endDate - $startDate;
677
-
678
- $PHPStartDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($startDate);
679
- $startDays = $PHPStartDateObject->format('j');
680
- $startMonths = $PHPStartDateObject->format('n');
681
- $startYears = $PHPStartDateObject->format('Y');
682
-
683
- $PHPEndDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($endDate);
684
- $endDays = $PHPEndDateObject->format('j');
685
- $endMonths = $PHPEndDateObject->format('n');
686
- $endYears = $PHPEndDateObject->format('Y');
687
-
688
- $retVal = PHPExcel_Calculation_Functions::NaN();
689
- switch ($unit) {
690
- case 'D':
691
- $retVal = intval($difference);
692
- break;
693
- case 'M':
694
- $retVal = intval($endMonths - $startMonths) + (intval($endYears - $startYears) * 12);
695
- // We're only interested in full months
696
- if ($endDays < $startDays) {
697
- --$retVal;
698
- }
699
- break;
700
- case 'Y':
701
- $retVal = intval($endYears - $startYears);
702
- // We're only interested in full months
703
- if ($endMonths < $startMonths) {
704
- --$retVal;
705
- } elseif (($endMonths == $startMonths) && ($endDays < $startDays)) {
706
- --$retVal;
707
- }
708
- break;
709
- case 'MD':
710
- if ($endDays < $startDays) {
711
- $retVal = $endDays;
712
- $PHPEndDateObject->modify('-'.$endDays.' days');
713
- $adjustDays = $PHPEndDateObject->format('j');
714
- if ($adjustDays > $startDays) {
715
- $retVal += ($adjustDays - $startDays);
716
- }
717
- } else {
718
- $retVal = $endDays - $startDays;
719
- }
720
- break;
721
- case 'YM':
722
- $retVal = intval($endMonths - $startMonths);
723
- if ($retVal < 0) {
724
- $retVal += 12;
725
- }
726
- // We're only interested in full months
727
- if ($endDays < $startDays) {
728
- --$retVal;
729
- }
730
- break;
731
- case 'YD':
732
- $retVal = intval($difference);
733
- if ($endYears > $startYears) {
734
- while ($endYears > $startYears) {
735
- $PHPEndDateObject->modify('-1 year');
736
- $endYears = $PHPEndDateObject->format('Y');
737
- }
738
- $retVal = $PHPEndDateObject->format('z') - $PHPStartDateObject->format('z');
739
- if ($retVal < 0) {
740
- $retVal += 365;
741
- }
742
- }
743
- break;
744
- default:
745
- $retVal = PHPExcel_Calculation_Functions::NaN();
746
- }
747
- return $retVal;
748
- }
749
-
750
-
751
- /**
752
- * DAYS360
753
- *
754
- * Returns the number of days between two dates based on a 360-day year (twelve 30-day months),
755
- * which is used in some accounting calculations. Use this function to help compute payments if
756
- * your accounting system is based on twelve 30-day months.
757
- *
758
- * Excel Function:
759
- * DAYS360(startDate,endDate[,method])
760
- *
761
- * @access public
762
- * @category Date/Time Functions
763
- * @param mixed $startDate Excel date serial value (float), PHP date timestamp (integer),
764
- * PHP DateTime object, or a standard date string
765
- * @param mixed $endDate Excel date serial value (float), PHP date timestamp (integer),
766
- * PHP DateTime object, or a standard date string
767
- * @param boolean $method US or European Method
768
- * FALSE or omitted: U.S. (NASD) method. If the starting date is
769
- * the last day of a month, it becomes equal to the 30th of the
770
- * same month. If the ending date is the last day of a month and
771
- * the starting date is earlier than the 30th of a month, the
772
- * ending date becomes equal to the 1st of the next month;
773
- * otherwise the ending date becomes equal to the 30th of the
774
- * same month.
775
- * TRUE: European method. Starting dates and ending dates that
776
- * occur on the 31st of a month become equal to the 30th of the
777
- * same month.
778
- * @return integer Number of days between start date and end date
779
- */
780
- public static function DAYS360($startDate = 0, $endDate = 0, $method = false)
781
- {
782
- $startDate = PHPExcel_Calculation_Functions::flattenSingleValue($startDate);
783
- $endDate = PHPExcel_Calculation_Functions::flattenSingleValue($endDate);
784
-
785
- if (is_string($startDate = self::getDateValue($startDate))) {
786
- return PHPExcel_Calculation_Functions::VALUE();
787
- }
788
- if (is_string($endDate = self::getDateValue($endDate))) {
789
- return PHPExcel_Calculation_Functions::VALUE();
790
- }
791
-
792
- if (!is_bool($method)) {
793
- return PHPExcel_Calculation_Functions::VALUE();
794
- }
795
-
796
- // Execute function
797
- $PHPStartDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($startDate);
798
- $startDay = $PHPStartDateObject->format('j');
799
- $startMonth = $PHPStartDateObject->format('n');
800
- $startYear = $PHPStartDateObject->format('Y');
801
-
802
- $PHPEndDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($endDate);
803
- $endDay = $PHPEndDateObject->format('j');
804
- $endMonth = $PHPEndDateObject->format('n');
805
- $endYear = $PHPEndDateObject->format('Y');
806
-
807
- return self::dateDiff360($startDay, $startMonth, $startYear, $endDay, $endMonth, $endYear, !$method);
808
- }
809
-
810
-
811
- /**
812
- * YEARFRAC
813
- *
814
- * Calculates the fraction of the year represented by the number of whole days between two dates
815
- * (the start_date and the end_date).
816
- * Use the YEARFRAC worksheet function to identify the proportion of a whole year's benefits or
817
- * obligations to assign to a specific term.
818
- *
819
- * Excel Function:
820
- * YEARFRAC(startDate,endDate[,method])
821
- *
822
- * @access public
823
- * @category Date/Time Functions
824
- * @param mixed $startDate Excel date serial value (float), PHP date timestamp (integer),
825
- * PHP DateTime object, or a standard date string
826
- * @param mixed $endDate Excel date serial value (float), PHP date timestamp (integer),
827
- * PHP DateTime object, or a standard date string
828
- * @param integer $method Method used for the calculation
829
- * 0 or omitted US (NASD) 30/360
830
- * 1 Actual/actual
831
- * 2 Actual/360
832
- * 3 Actual/365
833
- * 4 European 30/360
834
- * @return float fraction of the year
835
- */
836
- public static function YEARFRAC($startDate = 0, $endDate = 0, $method = 0)
837
- {
838
- $startDate = PHPExcel_Calculation_Functions::flattenSingleValue($startDate);
839
- $endDate = PHPExcel_Calculation_Functions::flattenSingleValue($endDate);
840
- $method = PHPExcel_Calculation_Functions::flattenSingleValue($method);
841
-
842
- if (is_string($startDate = self::getDateValue($startDate))) {
843
- return PHPExcel_Calculation_Functions::VALUE();
844
- }
845
- if (is_string($endDate = self::getDateValue($endDate))) {
846
- return PHPExcel_Calculation_Functions::VALUE();
847
- }
848
-
849
- if (((is_numeric($method)) && (!is_string($method))) || ($method == '')) {
850
- switch ($method) {
851
- case 0:
852
- return self::DAYS360($startDate, $endDate) / 360;
853
- case 1:
854
- $days = self::DATEDIF($startDate, $endDate);
855
- $startYear = self::YEAR($startDate);
856
- $endYear = self::YEAR($endDate);
857
- $years = $endYear - $startYear + 1;
858
- $leapDays = 0;
859
- if ($years == 1) {
860
- if (self::isLeapYear($endYear)) {
861
- $startMonth = self::MONTHOFYEAR($startDate);
862
- $endMonth = self::MONTHOFYEAR($endDate);
863
- $endDay = self::DAYOFMONTH($endDate);
864
- if (($startMonth < 3) ||
865
- (($endMonth * 100 + $endDay) >= (2 * 100 + 29))) {
866
- $leapDays += 1;
867
- }
868
- }
869
- } else {
870
- for ($year = $startYear; $year <= $endYear; ++$year) {
871
- if ($year == $startYear) {
872
- $startMonth = self::MONTHOFYEAR($startDate);
873
- $startDay = self::DAYOFMONTH($startDate);
874
- if ($startMonth < 3) {
875
- $leapDays += (self::isLeapYear($year)) ? 1 : 0;
876
- }
877
- } elseif ($year == $endYear) {
878
- $endMonth = self::MONTHOFYEAR($endDate);
879
- $endDay = self::DAYOFMONTH($endDate);
880
- if (($endMonth * 100 + $endDay) >= (2 * 100 + 29)) {
881
- $leapDays += (self::isLeapYear($year)) ? 1 : 0;
882
- }
883
- } else {
884
- $leapDays += (self::isLeapYear($year)) ? 1 : 0;
885
- }
886
- }
887
- if ($years == 2) {
888
- if (($leapDays == 0) && (self::isLeapYear($startYear)) && ($days > 365)) {
889
- $leapDays = 1;
890
- } elseif ($days < 366) {
891
- $years = 1;
892
- }
893
- }
894
- $leapDays /= $years;
895
- }
896
- return $days / (365 + $leapDays);
897
- case 2:
898
- return self::DATEDIF($startDate, $endDate) / 360;
899
- case 3:
900
- return self::DATEDIF($startDate, $endDate) / 365;
901
- case 4:
902
- return self::DAYS360($startDate, $endDate, true) / 360;
903
- }
904
- }
905
- return PHPExcel_Calculation_Functions::VALUE();
906
- }
907
-
908
-
909
- /**
910
- * NETWORKDAYS
911
- *
912
- * Returns the number of whole working days between start_date and end_date. Working days
913
- * exclude weekends and any dates identified in holidays.
914
- * Use NETWORKDAYS to calculate employee benefits that accrue based on the number of days
915
- * worked during a specific term.
916
- *
917
- * Excel Function:
918
- * NETWORKDAYS(startDate,endDate[,holidays[,holiday[,...]]])
919
- *
920
- * @access public
921
- * @category Date/Time Functions
922
- * @param mixed $startDate Excel date serial value (float), PHP date timestamp (integer),
923
- * PHP DateTime object, or a standard date string
924
- * @param mixed $endDate Excel date serial value (float), PHP date timestamp (integer),
925
- * PHP DateTime object, or a standard date string
926
- * @param mixed $holidays,... Optional series of Excel date serial value (float), PHP date
927
- * timestamp (integer), PHP DateTime object, or a standard date
928
- * strings that will be excluded from the working calendar, such
929
- * as state and federal holidays and floating holidays.
930
- * @return integer Interval between the dates
931
- */
932
- public static function NETWORKDAYS($startDate, $endDate)
933
- {
934
- // Retrieve the mandatory start and end date that are referenced in the function definition
935
- $startDate = PHPExcel_Calculation_Functions::flattenSingleValue($startDate);
936
- $endDate = PHPExcel_Calculation_Functions::flattenSingleValue($endDate);
937
- // Flush the mandatory start and end date that are referenced in the function definition, and get the optional days
938
- $dateArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
939
- array_shift($dateArgs);
940
- array_shift($dateArgs);
941
-
942
- // Validate the start and end dates
943
- if (is_string($startDate = $sDate = self::getDateValue($startDate))) {
944
- return PHPExcel_Calculation_Functions::VALUE();
945
- }
946
- $startDate = (float) floor($startDate);
947
- if (is_string($endDate = $eDate = self::getDateValue($endDate))) {
948
- return PHPExcel_Calculation_Functions::VALUE();
949
- }
950
- $endDate = (float) floor($endDate);
951
-
952
- if ($sDate > $eDate) {
953
- $startDate = $eDate;
954
- $endDate = $sDate;
955
- }
956
-
957
- // Execute function
958
- $startDoW = 6 - self::DAYOFWEEK($startDate, 2);
959
- if ($startDoW < 0) {
960
- $startDoW = 0;
961
- }
962
- $endDoW = self::DAYOFWEEK($endDate, 2);
963
- if ($endDoW >= 6) {
964
- $endDoW = 0;
965
- }
966
-
967
- $wholeWeekDays = floor(($endDate - $startDate) / 7) * 5;
968
- $partWeekDays = $endDoW + $startDoW;
969
- if ($partWeekDays > 5) {
970
- $partWeekDays -= 5;
971
- }
972
-
973
- // Test any extra holiday parameters
974
- $holidayCountedArray = array();
975
- foreach ($dateArgs as $holidayDate) {
976
- if (is_string($holidayDate = self::getDateValue($holidayDate))) {
977
- return PHPExcel_Calculation_Functions::VALUE();
978
- }
979
- if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {
980
- if ((self::DAYOFWEEK($holidayDate, 2) < 6) && (!in_array($holidayDate, $holidayCountedArray))) {
981
- --$partWeekDays;
982
- $holidayCountedArray[] = $holidayDate;
983
- }
984
- }
985
- }
986
-
987
- if ($sDate > $eDate) {
988
- return 0 - ($wholeWeekDays + $partWeekDays);
989
- }
990
- return $wholeWeekDays + $partWeekDays;
991
- }
992
-
993
-
994
- /**
995
- * WORKDAY
996
- *
997
- * Returns the date that is the indicated number of working days before or after a date (the
998
- * starting date). Working days exclude weekends and any dates identified as holidays.
999
- * Use WORKDAY to exclude weekends or holidays when you calculate invoice due dates, expected
1000
- * delivery times, or the number of days of work performed.
1001
- *
1002
- * Excel Function:
1003
- * WORKDAY(startDate,endDays[,holidays[,holiday[,...]]])
1004
- *
1005
- * @access public
1006
- * @category Date/Time Functions
1007
- * @param mixed $startDate Excel date serial value (float), PHP date timestamp (integer),
1008
- * PHP DateTime object, or a standard date string
1009
- * @param integer $endDays The number of nonweekend and nonholiday days before or after
1010
- * startDate. A positive value for days yields a future date; a
1011
- * negative value yields a past date.
1012
- * @param mixed $holidays,... Optional series of Excel date serial value (float), PHP date
1013
- * timestamp (integer), PHP DateTime object, or a standard date
1014
- * strings that will be excluded from the working calendar, such
1015
- * as state and federal holidays and floating holidays.
1016
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
1017
- * depending on the value of the ReturnDateType flag
1018
- */
1019
- public static function WORKDAY($startDate, $endDays)
1020
- {
1021
- // Retrieve the mandatory start date and days that are referenced in the function definition
1022
- $startDate = PHPExcel_Calculation_Functions::flattenSingleValue($startDate);
1023
- $endDays = PHPExcel_Calculation_Functions::flattenSingleValue($endDays);
1024
- // Flush the mandatory start date and days that are referenced in the function definition, and get the optional days
1025
- $dateArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
1026
- array_shift($dateArgs);
1027
- array_shift($dateArgs);
1028
-
1029
- if ((is_string($startDate = self::getDateValue($startDate))) || (!is_numeric($endDays))) {
1030
- return PHPExcel_Calculation_Functions::VALUE();
1031
- }
1032
- $startDate = (float) floor($startDate);
1033
- $endDays = (int) floor($endDays);
1034
- // If endDays is 0, we always return startDate
1035
- if ($endDays == 0) {
1036
- return $startDate;
1037
- }
1038
-
1039
- $decrementing = ($endDays < 0) ? true : false;
1040
-
1041
- // Adjust the start date if it falls over a weekend
1042
-
1043
- $startDoW = self::DAYOFWEEK($startDate, 3);
1044
- if (self::DAYOFWEEK($startDate, 3) >= 5) {
1045
- $startDate += ($decrementing) ? -$startDoW + 4: 7 - $startDoW;
1046
- ($decrementing) ? $endDays++ : $endDays--;
1047
- }
1048
-
1049
- // Add endDays
1050
- $endDate = (float) $startDate + (intval($endDays / 5) * 7) + ($endDays % 5);
1051
-
1052
- // Adjust the calculated end date if it falls over a weekend
1053
- $endDoW = self::DAYOFWEEK($endDate, 3);
1054
- if ($endDoW >= 5) {
1055
- $endDate += ($decrementing) ? -$endDoW + 4: 7 - $endDoW;
1056
- }
1057
-
1058
- // Test any extra holiday parameters
1059
- if (!empty($dateArgs)) {
1060
- $holidayCountedArray = $holidayDates = array();
1061
- foreach ($dateArgs as $holidayDate) {
1062
- if (($holidayDate !== null) && (trim($holidayDate) > '')) {
1063
- if (is_string($holidayDate = self::getDateValue($holidayDate))) {
1064
- return PHPExcel_Calculation_Functions::VALUE();
1065
- }
1066
- if (self::DAYOFWEEK($holidayDate, 3) < 5) {
1067
- $holidayDates[] = $holidayDate;
1068
- }
1069
- }
1070
- }
1071
- if ($decrementing) {
1072
- rsort($holidayDates, SORT_NUMERIC);
1073
- } else {
1074
- sort($holidayDates, SORT_NUMERIC);
1075
- }
1076
- foreach ($holidayDates as $holidayDate) {
1077
- if ($decrementing) {
1078
- if (($holidayDate <= $startDate) && ($holidayDate >= $endDate)) {
1079
- if (!in_array($holidayDate, $holidayCountedArray)) {
1080
- --$endDate;
1081
- $holidayCountedArray[] = $holidayDate;
1082
- }
1083
- }
1084
- } else {
1085
- if (($holidayDate >= $startDate) && ($holidayDate <= $endDate)) {
1086
- if (!in_array($holidayDate, $holidayCountedArray)) {
1087
- ++$endDate;
1088
- $holidayCountedArray[] = $holidayDate;
1089
- }
1090
- }
1091
- }
1092
- // Adjust the calculated end date if it falls over a weekend
1093
- $endDoW = self::DAYOFWEEK($endDate, 3);
1094
- if ($endDoW >= 5) {
1095
- $endDate += ($decrementing) ? -$endDoW + 4 : 7 - $endDoW;
1096
- }
1097
- }
1098
- }
1099
-
1100
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
1101
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
1102
- return (float) $endDate;
1103
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
1104
- return (integer) PHPExcel_Shared_Date::ExcelToPHP($endDate);
1105
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
1106
- return PHPExcel_Shared_Date::ExcelToPHPObject($endDate);
1107
- }
1108
- }
1109
-
1110
-
1111
- /**
1112
- * DAYOFMONTH
1113
- *
1114
- * Returns the day of the month, for a specified date. The day is given as an integer
1115
- * ranging from 1 to 31.
1116
- *
1117
- * Excel Function:
1118
- * DAY(dateValue)
1119
- *
1120
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1121
- * PHP DateTime object, or a standard date string
1122
- * @return int Day of the month
1123
- */
1124
- public static function DAYOFMONTH($dateValue = 1)
1125
- {
1126
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1127
-
1128
- if ($dateValue === null) {
1129
- $dateValue = 1;
1130
- } elseif (is_string($dateValue = self::getDateValue($dateValue))) {
1131
- return PHPExcel_Calculation_Functions::VALUE();
1132
- } elseif ($dateValue == 0.0) {
1133
- return 0;
1134
- } elseif ($dateValue < 0.0) {
1135
- return PHPExcel_Calculation_Functions::NaN();
1136
- }
1137
-
1138
- // Execute function
1139
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
1140
-
1141
- return (int) $PHPDateObject->format('j');
1142
- }
1143
-
1144
-
1145
- /**
1146
- * DAYOFWEEK
1147
- *
1148
- * Returns the day of the week for a specified date. The day is given as an integer
1149
- * ranging from 0 to 7 (dependent on the requested style).
1150
- *
1151
- * Excel Function:
1152
- * WEEKDAY(dateValue[,style])
1153
- *
1154
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1155
- * PHP DateTime object, or a standard date string
1156
- * @param int $style A number that determines the type of return value
1157
- * 1 or omitted Numbers 1 (Sunday) through 7 (Saturday).
1158
- * 2 Numbers 1 (Monday) through 7 (Sunday).
1159
- * 3 Numbers 0 (Monday) through 6 (Sunday).
1160
- * @return int Day of the week value
1161
- */
1162
- public static function DAYOFWEEK($dateValue = 1, $style = 1)
1163
- {
1164
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1165
- $style = PHPExcel_Calculation_Functions::flattenSingleValue($style);
1166
-
1167
- if (!is_numeric($style)) {
1168
- return PHPExcel_Calculation_Functions::VALUE();
1169
- } elseif (($style < 1) || ($style > 3)) {
1170
- return PHPExcel_Calculation_Functions::NaN();
1171
- }
1172
- $style = floor($style);
1173
-
1174
- if ($dateValue === null) {
1175
- $dateValue = 1;
1176
- } elseif (is_string($dateValue = self::getDateValue($dateValue))) {
1177
- return PHPExcel_Calculation_Functions::VALUE();
1178
- } elseif ($dateValue < 0.0) {
1179
- return PHPExcel_Calculation_Functions::NaN();
1180
- }
1181
-
1182
- // Execute function
1183
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
1184
- $DoW = $PHPDateObject->format('w');
1185
-
1186
- $firstDay = 1;
1187
- switch ($style) {
1188
- case 1:
1189
- ++$DoW;
1190
- break;
1191
- case 2:
1192
- if ($DoW == 0) {
1193
- $DoW = 7;
1194
- }
1195
- break;
1196
- case 3:
1197
- if ($DoW == 0) {
1198
- $DoW = 7;
1199
- }
1200
- $firstDay = 0;
1201
- --$DoW;
1202
- break;
1203
- }
1204
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_EXCEL) {
1205
- // Test for Excel's 1900 leap year, and introduce the error as required
1206
- if (($PHPDateObject->format('Y') == 1900) && ($PHPDateObject->format('n') <= 2)) {
1207
- --$DoW;
1208
- if ($DoW < $firstDay) {
1209
- $DoW += 7;
1210
- }
1211
- }
1212
- }
1213
-
1214
- return (int) $DoW;
1215
- }
1216
-
1217
-
1218
- /**
1219
- * WEEKOFYEAR
1220
- *
1221
- * Returns the week of the year for a specified date.
1222
- * The WEEKNUM function considers the week containing January 1 to be the first week of the year.
1223
- * However, there is a European standard that defines the first week as the one with the majority
1224
- * of days (four or more) falling in the new year. This means that for years in which there are
1225
- * three days or less in the first week of January, the WEEKNUM function returns week numbers
1226
- * that are incorrect according to the European standard.
1227
- *
1228
- * Excel Function:
1229
- * WEEKNUM(dateValue[,style])
1230
- *
1231
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1232
- * PHP DateTime object, or a standard date string
1233
- * @param boolean $method Week begins on Sunday or Monday
1234
- * 1 or omitted Week begins on Sunday.
1235
- * 2 Week begins on Monday.
1236
- * @return int Week Number
1237
- */
1238
- public static function WEEKOFYEAR($dateValue = 1, $method = 1)
1239
- {
1240
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1241
- $method = PHPExcel_Calculation_Functions::flattenSingleValue($method);
1242
-
1243
- if (!is_numeric($method)) {
1244
- return PHPExcel_Calculation_Functions::VALUE();
1245
- } elseif (($method < 1) || ($method > 2)) {
1246
- return PHPExcel_Calculation_Functions::NaN();
1247
- }
1248
- $method = floor($method);
1249
-
1250
- if ($dateValue === null) {
1251
- $dateValue = 1;
1252
- } elseif (is_string($dateValue = self::getDateValue($dateValue))) {
1253
- return PHPExcel_Calculation_Functions::VALUE();
1254
- } elseif ($dateValue < 0.0) {
1255
- return PHPExcel_Calculation_Functions::NaN();
1256
- }
1257
-
1258
- // Execute function
1259
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
1260
- $dayOfYear = $PHPDateObject->format('z');
1261
- $dow = $PHPDateObject->format('w');
1262
- $PHPDateObject->modify('-' . $dayOfYear . ' days');
1263
- $dow = $PHPDateObject->format('w');
1264
- $daysInFirstWeek = 7 - (($dow + (2 - $method)) % 7);
1265
- $dayOfYear -= $daysInFirstWeek;
1266
- $weekOfYear = ceil($dayOfYear / 7) + 1;
1267
-
1268
- return (int) $weekOfYear;
1269
- }
1270
-
1271
-
1272
- /**
1273
- * MONTHOFYEAR
1274
- *
1275
- * Returns the month of a date represented by a serial number.
1276
- * The month is given as an integer, ranging from 1 (January) to 12 (December).
1277
- *
1278
- * Excel Function:
1279
- * MONTH(dateValue)
1280
- *
1281
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1282
- * PHP DateTime object, or a standard date string
1283
- * @return int Month of the year
1284
- */
1285
- public static function MONTHOFYEAR($dateValue = 1)
1286
- {
1287
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1288
-
1289
- if ($dateValue === null) {
1290
- $dateValue = 1;
1291
- } elseif (is_string($dateValue = self::getDateValue($dateValue))) {
1292
- return PHPExcel_Calculation_Functions::VALUE();
1293
- } elseif ($dateValue < 0.0) {
1294
- return PHPExcel_Calculation_Functions::NaN();
1295
- }
1296
-
1297
- // Execute function
1298
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
1299
-
1300
- return (int) $PHPDateObject->format('n');
1301
- }
1302
-
1303
-
1304
- /**
1305
- * YEAR
1306
- *
1307
- * Returns the year corresponding to a date.
1308
- * The year is returned as an integer in the range 1900-9999.
1309
- *
1310
- * Excel Function:
1311
- * YEAR(dateValue)
1312
- *
1313
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1314
- * PHP DateTime object, or a standard date string
1315
- * @return int Year
1316
- */
1317
- public static function YEAR($dateValue = 1)
1318
- {
1319
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1320
-
1321
- if ($dateValue === null) {
1322
- $dateValue = 1;
1323
- } elseif (is_string($dateValue = self::getDateValue($dateValue))) {
1324
- return PHPExcel_Calculation_Functions::VALUE();
1325
- } elseif ($dateValue < 0.0) {
1326
- return PHPExcel_Calculation_Functions::NaN();
1327
- }
1328
-
1329
- // Execute function
1330
- $PHPDateObject = PHPExcel_Shared_Date::ExcelToPHPObject($dateValue);
1331
-
1332
- return (int) $PHPDateObject->format('Y');
1333
- }
1334
-
1335
-
1336
- /**
1337
- * HOUROFDAY
1338
- *
1339
- * Returns the hour of a time value.
1340
- * The hour is given as an integer, ranging from 0 (12:00 A.M.) to 23 (11:00 P.M.).
1341
- *
1342
- * Excel Function:
1343
- * HOUR(timeValue)
1344
- *
1345
- * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),
1346
- * PHP DateTime object, or a standard time string
1347
- * @return int Hour
1348
- */
1349
- public static function HOUROFDAY($timeValue = 0)
1350
- {
1351
- $timeValue = PHPExcel_Calculation_Functions::flattenSingleValue($timeValue);
1352
-
1353
- if (!is_numeric($timeValue)) {
1354
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1355
- $testVal = strtok($timeValue, '/-: ');
1356
- if (strlen($testVal) < strlen($timeValue)) {
1357
- return PHPExcel_Calculation_Functions::VALUE();
1358
- }
1359
- }
1360
- $timeValue = self::getTimeValue($timeValue);
1361
- if (is_string($timeValue)) {
1362
- return PHPExcel_Calculation_Functions::VALUE();
1363
- }
1364
- }
1365
- // Execute function
1366
- if ($timeValue >= 1) {
1367
- $timeValue = fmod($timeValue, 1);
1368
- } elseif ($timeValue < 0.0) {
1369
- return PHPExcel_Calculation_Functions::NaN();
1370
- }
1371
- $timeValue = PHPExcel_Shared_Date::ExcelToPHP($timeValue);
1372
-
1373
- return (int) gmdate('G', $timeValue);
1374
- }
1375
-
1376
-
1377
- /**
1378
- * MINUTEOFHOUR
1379
- *
1380
- * Returns the minutes of a time value.
1381
- * The minute is given as an integer, ranging from 0 to 59.
1382
- *
1383
- * Excel Function:
1384
- * MINUTE(timeValue)
1385
- *
1386
- * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),
1387
- * PHP DateTime object, or a standard time string
1388
- * @return int Minute
1389
- */
1390
- public static function MINUTEOFHOUR($timeValue = 0)
1391
- {
1392
- $timeValue = $timeTester = PHPExcel_Calculation_Functions::flattenSingleValue($timeValue);
1393
-
1394
- if (!is_numeric($timeValue)) {
1395
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1396
- $testVal = strtok($timeValue, '/-: ');
1397
- if (strlen($testVal) < strlen($timeValue)) {
1398
- return PHPExcel_Calculation_Functions::VALUE();
1399
- }
1400
- }
1401
- $timeValue = self::getTimeValue($timeValue);
1402
- if (is_string($timeValue)) {
1403
- return PHPExcel_Calculation_Functions::VALUE();
1404
- }
1405
- }
1406
- // Execute function
1407
- if ($timeValue >= 1) {
1408
- $timeValue = fmod($timeValue, 1);
1409
- } elseif ($timeValue < 0.0) {
1410
- return PHPExcel_Calculation_Functions::NaN();
1411
- }
1412
- $timeValue = PHPExcel_Shared_Date::ExcelToPHP($timeValue);
1413
-
1414
- return (int) gmdate('i', $timeValue);
1415
- }
1416
-
1417
-
1418
- /**
1419
- * SECONDOFMINUTE
1420
- *
1421
- * Returns the seconds of a time value.
1422
- * The second is given as an integer in the range 0 (zero) to 59.
1423
- *
1424
- * Excel Function:
1425
- * SECOND(timeValue)
1426
- *
1427
- * @param mixed $timeValue Excel date serial value (float), PHP date timestamp (integer),
1428
- * PHP DateTime object, or a standard time string
1429
- * @return int Second
1430
- */
1431
- public static function SECONDOFMINUTE($timeValue = 0)
1432
- {
1433
- $timeValue = PHPExcel_Calculation_Functions::flattenSingleValue($timeValue);
1434
-
1435
- if (!is_numeric($timeValue)) {
1436
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1437
- $testVal = strtok($timeValue, '/-: ');
1438
- if (strlen($testVal) < strlen($timeValue)) {
1439
- return PHPExcel_Calculation_Functions::VALUE();
1440
- }
1441
- }
1442
- $timeValue = self::getTimeValue($timeValue);
1443
- if (is_string($timeValue)) {
1444
- return PHPExcel_Calculation_Functions::VALUE();
1445
- }
1446
- }
1447
- // Execute function
1448
- if ($timeValue >= 1) {
1449
- $timeValue = fmod($timeValue, 1);
1450
- } elseif ($timeValue < 0.0) {
1451
- return PHPExcel_Calculation_Functions::NaN();
1452
- }
1453
- $timeValue = PHPExcel_Shared_Date::ExcelToPHP($timeValue);
1454
-
1455
- return (int) gmdate('s', $timeValue);
1456
- }
1457
-
1458
-
1459
- /**
1460
- * EDATE
1461
- *
1462
- * Returns the serial number that represents the date that is the indicated number of months
1463
- * before or after a specified date (the start_date).
1464
- * Use EDATE to calculate maturity dates or due dates that fall on the same day of the month
1465
- * as the date of issue.
1466
- *
1467
- * Excel Function:
1468
- * EDATE(dateValue,adjustmentMonths)
1469
- *
1470
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1471
- * PHP DateTime object, or a standard date string
1472
- * @param int $adjustmentMonths The number of months before or after start_date.
1473
- * A positive value for months yields a future date;
1474
- * a negative value yields a past date.
1475
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
1476
- * depending on the value of the ReturnDateType flag
1477
- */
1478
- public static function EDATE($dateValue = 1, $adjustmentMonths = 0)
1479
- {
1480
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1481
- $adjustmentMonths = PHPExcel_Calculation_Functions::flattenSingleValue($adjustmentMonths);
1482
-
1483
- if (!is_numeric($adjustmentMonths)) {
1484
- return PHPExcel_Calculation_Functions::VALUE();
1485
- }
1486
- $adjustmentMonths = floor($adjustmentMonths);
1487
-
1488
- if (is_string($dateValue = self::getDateValue($dateValue))) {
1489
- return PHPExcel_Calculation_Functions::VALUE();
1490
- }
1491
-
1492
- // Execute function
1493
- $PHPDateObject = self::adjustDateByMonths($dateValue, $adjustmentMonths);
1494
-
1495
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
1496
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
1497
- return (float) PHPExcel_Shared_Date::PHPToExcel($PHPDateObject);
1498
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
1499
- return (integer) PHPExcel_Shared_Date::ExcelToPHP(PHPExcel_Shared_Date::PHPToExcel($PHPDateObject));
1500
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
1501
- return $PHPDateObject;
1502
- }
1503
- }
1504
-
1505
-
1506
- /**
1507
- * EOMONTH
1508
- *
1509
- * Returns the date value for the last day of the month that is the indicated number of months
1510
- * before or after start_date.
1511
- * Use EOMONTH to calculate maturity dates or due dates that fall on the last day of the month.
1512
- *
1513
- * Excel Function:
1514
- * EOMONTH(dateValue,adjustmentMonths)
1515
- *
1516
- * @param mixed $dateValue Excel date serial value (float), PHP date timestamp (integer),
1517
- * PHP DateTime object, or a standard date string
1518
- * @param int $adjustmentMonths The number of months before or after start_date.
1519
- * A positive value for months yields a future date;
1520
- * a negative value yields a past date.
1521
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
1522
- * depending on the value of the ReturnDateType flag
1523
- */
1524
- public static function EOMONTH($dateValue = 1, $adjustmentMonths = 0)
1525
- {
1526
- $dateValue = PHPExcel_Calculation_Functions::flattenSingleValue($dateValue);
1527
- $adjustmentMonths = PHPExcel_Calculation_Functions::flattenSingleValue($adjustmentMonths);
1528
-
1529
- if (!is_numeric($adjustmentMonths)) {
1530
- return PHPExcel_Calculation_Functions::VALUE();
1531
- }
1532
- $adjustmentMonths = floor($adjustmentMonths);
1533
-
1534
- if (is_string($dateValue = self::getDateValue($dateValue))) {
1535
- return PHPExcel_Calculation_Functions::VALUE();
1536
- }
1537
-
1538
- // Execute function
1539
- $PHPDateObject = self::adjustDateByMonths($dateValue, $adjustmentMonths+1);
1540
- $adjustDays = (int) $PHPDateObject->format('d');
1541
- $adjustDaysString = '-' . $adjustDays . ' days';
1542
- $PHPDateObject->modify($adjustDaysString);
1543
-
1544
- switch (PHPExcel_Calculation_Functions::getReturnDateType()) {
1545
- case PHPExcel_Calculation_Functions::RETURNDATE_EXCEL:
1546
- return (float) PHPExcel_Shared_Date::PHPToExcel($PHPDateObject);
1547
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC:
1548
- return (integer) PHPExcel_Shared_Date::ExcelToPHP(PHPExcel_Shared_Date::PHPToExcel($PHPDateObject));
1549
- case PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT:
1550
- return $PHPDateObject;
1551
- }
1552
- }
1553
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Engineering.php DELETED
@@ -1,2650 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
- /** EULER */
13
- define('EULER', 2.71828182845904523536);
14
-
15
- /**
16
- * PHPExcel_Calculation_Engineering
17
- *
18
- * Copyright (c) 2006 - 2015 PHPExcel
19
- *
20
- * This library is free software; you can redistribute it and/or
21
- * modify it under the terms of the GNU Lesser General Public
22
- * License as published by the Free Software Foundation; either
23
- * version 2.1 of the License, or (at your option) any later version.
24
- *
25
- * This library is distributed in the hope that it will be useful,
26
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
27
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
28
- * Lesser General Public License for more details.
29
- *
30
- * You should have received a copy of the GNU Lesser General Public
31
- * License along with this library; if not, write to the Free Software
32
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
33
- *
34
- * @category PHPExcel
35
- * @package PHPExcel_Calculation
36
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
37
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
38
- * @version ##VERSION##, ##DATE##
39
- */
40
- class PHPExcel_Calculation_Engineering
41
- {
42
- /**
43
- * Details of the Units of measure that can be used in CONVERTUOM()
44
- *
45
- * @var mixed[]
46
- */
47
- private static $conversionUnits = array(
48
- 'g' => array('Group' => 'Mass', 'Unit Name' => 'Gram', 'AllowPrefix' => true),
49
- 'sg' => array('Group' => 'Mass', 'Unit Name' => 'Slug', 'AllowPrefix' => false),
50
- 'lbm' => array('Group' => 'Mass', 'Unit Name' => 'Pound mass (avoirdupois)', 'AllowPrefix' => false),
51
- 'u' => array('Group' => 'Mass', 'Unit Name' => 'U (atomic mass unit)', 'AllowPrefix' => true),
52
- 'ozm' => array('Group' => 'Mass', 'Unit Name' => 'Ounce mass (avoirdupois)', 'AllowPrefix' => false),
53
- 'm' => array('Group' => 'Distance', 'Unit Name' => 'Meter', 'AllowPrefix' => true),
54
- 'mi' => array('Group' => 'Distance', 'Unit Name' => 'Statute mile', 'AllowPrefix' => false),
55
- 'Nmi' => array('Group' => 'Distance', 'Unit Name' => 'Nautical mile', 'AllowPrefix' => false),
56
- 'in' => array('Group' => 'Distance', 'Unit Name' => 'Inch', 'AllowPrefix' => false),
57
- 'ft' => array('Group' => 'Distance', 'Unit Name' => 'Foot', 'AllowPrefix' => false),
58
- 'yd' => array('Group' => 'Distance', 'Unit Name' => 'Yard', 'AllowPrefix' => false),
59
- 'ang' => array('Group' => 'Distance', 'Unit Name' => 'Angstrom', 'AllowPrefix' => true),
60
- 'Pica' => array('Group' => 'Distance', 'Unit Name' => 'Pica (1/72 in)', 'AllowPrefix' => false),
61
- 'yr' => array('Group' => 'Time', 'Unit Name' => 'Year', 'AllowPrefix' => false),
62
- 'day' => array('Group' => 'Time', 'Unit Name' => 'Day', 'AllowPrefix' => false),
63
- 'hr' => array('Group' => 'Time', 'Unit Name' => 'Hour', 'AllowPrefix' => false),
64
- 'mn' => array('Group' => 'Time', 'Unit Name' => 'Minute', 'AllowPrefix' => false),
65
- 'sec' => array('Group' => 'Time', 'Unit Name' => 'Second', 'AllowPrefix' => true),
66
- 'Pa' => array('Group' => 'Pressure', 'Unit Name' => 'Pascal', 'AllowPrefix' => true),
67
- 'p' => array('Group' => 'Pressure', 'Unit Name' => 'Pascal', 'AllowPrefix' => true),
68
- 'atm' => array('Group' => 'Pressure', 'Unit Name' => 'Atmosphere', 'AllowPrefix' => true),
69
- 'at' => array('Group' => 'Pressure', 'Unit Name' => 'Atmosphere', 'AllowPrefix' => true),
70
- 'mmHg' => array('Group' => 'Pressure', 'Unit Name' => 'mm of Mercury', 'AllowPrefix' => true),
71
- 'N' => array('Group' => 'Force', 'Unit Name' => 'Newton', 'AllowPrefix' => true),
72
- 'dyn' => array('Group' => 'Force', 'Unit Name' => 'Dyne', 'AllowPrefix' => true),
73
- 'dy' => array('Group' => 'Force', 'Unit Name' => 'Dyne', 'AllowPrefix' => true),
74
- 'lbf' => array('Group' => 'Force', 'Unit Name' => 'Pound force', 'AllowPrefix' => false),
75
- 'J' => array('Group' => 'Energy', 'Unit Name' => 'Joule', 'AllowPrefix' => true),
76
- 'e' => array('Group' => 'Energy', 'Unit Name' => 'Erg', 'AllowPrefix' => true),
77
- 'c' => array('Group' => 'Energy', 'Unit Name' => 'Thermodynamic calorie', 'AllowPrefix' => true),
78
- 'cal' => array('Group' => 'Energy', 'Unit Name' => 'IT calorie', 'AllowPrefix' => true),
79
- 'eV' => array('Group' => 'Energy', 'Unit Name' => 'Electron volt', 'AllowPrefix' => true),
80
- 'ev' => array('Group' => 'Energy', 'Unit Name' => 'Electron volt', 'AllowPrefix' => true),
81
- 'HPh' => array('Group' => 'Energy', 'Unit Name' => 'Horsepower-hour', 'AllowPrefix' => false),
82
- 'hh' => array('Group' => 'Energy', 'Unit Name' => 'Horsepower-hour', 'AllowPrefix' => false),
83
- 'Wh' => array('Group' => 'Energy', 'Unit Name' => 'Watt-hour', 'AllowPrefix' => true),
84
- 'wh' => array('Group' => 'Energy', 'Unit Name' => 'Watt-hour', 'AllowPrefix' => true),
85
- 'flb' => array('Group' => 'Energy', 'Unit Name' => 'Foot-pound', 'AllowPrefix' => false),
86
- 'BTU' => array('Group' => 'Energy', 'Unit Name' => 'BTU', 'AllowPrefix' => false),
87
- 'btu' => array('Group' => 'Energy', 'Unit Name' => 'BTU', 'AllowPrefix' => false),
88
- 'HP' => array('Group' => 'Power', 'Unit Name' => 'Horsepower', 'AllowPrefix' => false),
89
- 'h' => array('Group' => 'Power', 'Unit Name' => 'Horsepower', 'AllowPrefix' => false),
90
- 'W' => array('Group' => 'Power', 'Unit Name' => 'Watt', 'AllowPrefix' => true),
91
- 'w' => array('Group' => 'Power', 'Unit Name' => 'Watt', 'AllowPrefix' => true),
92
- 'T' => array('Group' => 'Magnetism', 'Unit Name' => 'Tesla', 'AllowPrefix' => true),
93
- 'ga' => array('Group' => 'Magnetism', 'Unit Name' => 'Gauss', 'AllowPrefix' => true),
94
- 'C' => array('Group' => 'Temperature', 'Unit Name' => 'Celsius', 'AllowPrefix' => false),
95
- 'cel' => array('Group' => 'Temperature', 'Unit Name' => 'Celsius', 'AllowPrefix' => false),
96
- 'F' => array('Group' => 'Temperature', 'Unit Name' => 'Fahrenheit', 'AllowPrefix' => false),
97
- 'fah' => array('Group' => 'Temperature', 'Unit Name' => 'Fahrenheit', 'AllowPrefix' => false),
98
- 'K' => array('Group' => 'Temperature', 'Unit Name' => 'Kelvin', 'AllowPrefix' => false),
99
- 'kel' => array('Group' => 'Temperature', 'Unit Name' => 'Kelvin', 'AllowPrefix' => false),
100
- 'tsp' => array('Group' => 'Liquid', 'Unit Name' => 'Teaspoon', 'AllowPrefix' => false),
101
- 'tbs' => array('Group' => 'Liquid', 'Unit Name' => 'Tablespoon', 'AllowPrefix' => false),
102
- 'oz' => array('Group' => 'Liquid', 'Unit Name' => 'Fluid Ounce', 'AllowPrefix' => false),
103
- 'cup' => array('Group' => 'Liquid', 'Unit Name' => 'Cup', 'AllowPrefix' => false),
104
- 'pt' => array('Group' => 'Liquid', 'Unit Name' => 'U.S. Pint', 'AllowPrefix' => false),
105
- 'us_pt' => array('Group' => 'Liquid', 'Unit Name' => 'U.S. Pint', 'AllowPrefix' => false),
106
- 'uk_pt' => array('Group' => 'Liquid', 'Unit Name' => 'U.K. Pint', 'AllowPrefix' => false),
107
- 'qt' => array('Group' => 'Liquid', 'Unit Name' => 'Quart', 'AllowPrefix' => false),
108
- 'gal' => array('Group' => 'Liquid', 'Unit Name' => 'Gallon', 'AllowPrefix' => false),
109
- 'l' => array('Group' => 'Liquid', 'Unit Name' => 'Litre', 'AllowPrefix' => true),
110
- 'lt' => array('Group' => 'Liquid', 'Unit Name' => 'Litre', 'AllowPrefix' => true),
111
- );
112
-
113
- /**
114
- * Details of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM()
115
- *
116
- * @var mixed[]
117
- */
118
- private static $conversionMultipliers = array(
119
- 'Y' => array('multiplier' => 1E24, 'name' => 'yotta'),
120
- 'Z' => array('multiplier' => 1E21, 'name' => 'zetta'),
121
- 'E' => array('multiplier' => 1E18, 'name' => 'exa'),
122
- 'P' => array('multiplier' => 1E15, 'name' => 'peta'),
123
- 'T' => array('multiplier' => 1E12, 'name' => 'tera'),
124
- 'G' => array('multiplier' => 1E9, 'name' => 'giga'),
125
- 'M' => array('multiplier' => 1E6, 'name' => 'mega'),
126
- 'k' => array('multiplier' => 1E3, 'name' => 'kilo'),
127
- 'h' => array('multiplier' => 1E2, 'name' => 'hecto'),
128
- 'e' => array('multiplier' => 1E1, 'name' => 'deka'),
129
- 'd' => array('multiplier' => 1E-1, 'name' => 'deci'),
130
- 'c' => array('multiplier' => 1E-2, 'name' => 'centi'),
131
- 'm' => array('multiplier' => 1E-3, 'name' => 'milli'),
132
- 'u' => array('multiplier' => 1E-6, 'name' => 'micro'),
133
- 'n' => array('multiplier' => 1E-9, 'name' => 'nano'),
134
- 'p' => array('multiplier' => 1E-12, 'name' => 'pico'),
135
- 'f' => array('multiplier' => 1E-15, 'name' => 'femto'),
136
- 'a' => array('multiplier' => 1E-18, 'name' => 'atto'),
137
- 'z' => array('multiplier' => 1E-21, 'name' => 'zepto'),
138
- 'y' => array('multiplier' => 1E-24, 'name' => 'yocto'),
139
- );
140
-
141
- /**
142
- * Details of the Units of measure conversion factors, organised by group
143
- *
144
- * @var mixed[]
145
- */
146
- private static $unitConversions = array(
147
- 'Mass' => array(
148
- 'g' => array(
149
- 'g' => 1.0,
150
- 'sg' => 6.85220500053478E-05,
151
- 'lbm' => 2.20462291469134E-03,
152
- 'u' => 6.02217000000000E+23,
153
- 'ozm' => 3.52739718003627E-02,
154
- ),
155
- 'sg' => array(
156
- 'g' => 1.45938424189287E+04,
157
- 'sg' => 1.0,
158
- 'lbm' => 3.21739194101647E+01,
159
- 'u' => 8.78866000000000E+27,
160
- 'ozm' => 5.14782785944229E+02,
161
- ),
162
- 'lbm' => array(
163
- 'g' => 4.5359230974881148E+02,
164
- 'sg' => 3.10810749306493E-02,
165
- 'lbm' => 1.0,
166
- 'u' => 2.73161000000000E+26,
167
- 'ozm' => 1.60000023429410E+01,
168
- ),
169
- 'u' => array(
170
- 'g' => 1.66053100460465E-24,
171
- 'sg' => 1.13782988532950E-28,
172
- 'lbm' => 3.66084470330684E-27,
173
- 'u' => 1.0,
174
- 'ozm' => 5.85735238300524E-26,
175
- ),
176
- 'ozm' => array(
177
- 'g' => 2.83495152079732E+01,
178
- 'sg' => 1.94256689870811E-03,
179
- 'lbm' => 6.24999908478882E-02,
180
- 'u' => 1.70725600000000E+25,
181
- 'ozm' => 1.0,
182
- ),
183
- ),
184
- 'Distance' => array(
185
- 'm' => array(
186
- 'm' => 1.0,
187
- 'mi' => 6.21371192237334E-04,
188
- 'Nmi' => 5.39956803455724E-04,
189
- 'in' => 3.93700787401575E+01,
190
- 'ft' => 3.28083989501312E+00,
191
- 'yd' => 1.09361329797891E+00,
192
- 'ang' => 1.00000000000000E+10,
193
- 'Pica' => 2.83464566929116E+03,
194
- ),
195
- 'mi' => array(
196
- 'm' => 1.60934400000000E+03,
197
- 'mi' => 1.0,
198
- 'Nmi' => 8.68976241900648E-01,
199
- 'in' => 6.33600000000000E+04,
200
- 'ft' => 5.28000000000000E+03,
201
- 'yd' => 1.76000000000000E+03,
202
- 'ang' => 1.60934400000000E+13,
203
- 'Pica' => 4.56191999999971E+06,
204
- ),
205
- 'Nmi' => array(
206
- 'm' => 1.85200000000000E+03,
207
- 'mi' => 1.15077944802354E+00,
208
- 'Nmi' => 1.0,
209
- 'in' => 7.29133858267717E+04,
210
- 'ft' => 6.07611548556430E+03,
211
- 'yd' => 2.02537182785694E+03,
212
- 'ang' => 1.85200000000000E+13,
213
- 'Pica' => 5.24976377952723E+06,
214
- ),
215
- 'in' => array(
216
- 'm' => 2.54000000000000E-02,
217
- 'mi' => 1.57828282828283E-05,
218
- 'Nmi' => 1.37149028077754E-05,
219
- 'in' => 1.0,
220
- 'ft' => 8.33333333333333E-02,
221
- 'yd' => 2.77777777686643E-02,
222
- 'ang' => 2.54000000000000E+08,
223
- 'Pica' => 7.19999999999955E+01,
224
- ),
225
- 'ft' => array(
226
- 'm' => 3.04800000000000E-01,
227
- 'mi' => 1.89393939393939E-04,
228
- 'Nmi' => 1.64578833693305E-04,
229
- 'in' => 1.20000000000000E+01,
230
- 'ft' => 1.0,
231
- 'yd' => 3.33333333223972E-01,
232
- 'ang' => 3.04800000000000E+09,
233
- 'Pica' => 8.63999999999946E+02,
234
- ),
235
- 'yd' => array(
236
- 'm' => 9.14400000300000E-01,
237
- 'mi' => 5.68181818368230E-04,
238
- 'Nmi' => 4.93736501241901E-04,
239
- 'in' => 3.60000000118110E+01,
240
- 'ft' => 3.00000000000000E+00,
241
- 'yd' => 1.0,
242
- 'ang' => 9.14400000300000E+09,
243
- 'Pica' => 2.59200000085023E+03,
244
- ),
245
- 'ang' => array(
246
- 'm' => 1.00000000000000E-10,
247
- 'mi' => 6.21371192237334E-14,
248
- 'Nmi' => 5.39956803455724E-14,
249
- 'in' => 3.93700787401575E-09,
250
- 'ft' => 3.28083989501312E-10,
251
- 'yd' => 1.09361329797891E-10,
252
- 'ang' => 1.0,
253
- 'Pica' => 2.83464566929116E-07,
254
- ),
255
- 'Pica' => array(
256
- 'm' => 3.52777777777800E-04,
257
- 'mi' => 2.19205948372629E-07,
258
- 'Nmi' => 1.90484761219114E-07,
259
- 'in' => 1.38888888888898E-02,
260
- 'ft' => 1.15740740740748E-03,
261
- 'yd' => 3.85802469009251E-04,
262
- 'ang' => 3.52777777777800E+06,
263
- 'Pica' => 1.0,
264
- ),
265
- ),
266
- 'Time' => array(
267
- 'yr' => array(
268
- 'yr' => 1.0,
269
- 'day' => 365.25,
270
- 'hr' => 8766.0,
271
- 'mn' => 525960.0,
272
- 'sec' => 31557600.0,
273
- ),
274
- 'day' => array(
275
- 'yr' => 2.73785078713210E-03,
276
- 'day' => 1.0,
277
- 'hr' => 24.0,
278
- 'mn' => 1440.0,
279
- 'sec' => 86400.0,
280
- ),
281
- 'hr' => array(
282
- 'yr' => 1.14077116130504E-04,
283
- 'day' => 4.16666666666667E-02,
284
- 'hr' => 1.0,
285
- 'mn' => 60.0,
286
- 'sec' => 3600.0,
287
- ),
288
- 'mn' => array(
289
- 'yr' => 1.90128526884174E-06,
290
- 'day' => 6.94444444444444E-04,
291
- 'hr' => 1.66666666666667E-02,
292
- 'mn' => 1.0,
293
- 'sec' => 60.0,
294
- ),
295
- 'sec' => array(
296
- 'yr' => 3.16880878140289E-08,
297
- 'day' => 1.15740740740741E-05,
298
- 'hr' => 2.77777777777778E-04,
299
- 'mn' => 1.66666666666667E-02,
300
- 'sec' => 1.0,
301
- ),
302
- ),
303
- 'Pressure' => array(
304
- 'Pa' => array(
305
- 'Pa' => 1.0,
306
- 'p' => 1.0,
307
- 'atm' => 9.86923299998193E-06,
308
- 'at' => 9.86923299998193E-06,
309
- 'mmHg' => 7.50061707998627E-03,
310
- ),
311
- 'p' => array(
312
- 'Pa' => 1.0,
313
- 'p' => 1.0,
314
- 'atm' => 9.86923299998193E-06,
315
- 'at' => 9.86923299998193E-06,
316
- 'mmHg' => 7.50061707998627E-03,
317
- ),
318
- 'atm' => array(
319
- 'Pa' => 1.01324996583000E+05,
320
- 'p' => 1.01324996583000E+05,
321
- 'atm' => 1.0,
322
- 'at' => 1.0,
323
- 'mmHg' => 760.0,
324
- ),
325
- 'at' => array(
326
- 'Pa' => 1.01324996583000E+05,
327
- 'p' => 1.01324996583000E+05,
328
- 'atm' => 1.0,
329
- 'at' => 1.0,
330
- 'mmHg' => 760.0,
331
- ),
332
- 'mmHg' => array(
333
- 'Pa' => 1.33322363925000E+02,
334
- 'p' => 1.33322363925000E+02,
335
- 'atm' => 1.31578947368421E-03,
336
- 'at' => 1.31578947368421E-03,
337
- 'mmHg' => 1.0,
338
- ),
339
- ),
340
- 'Force' => array(
341
- 'N' => array(
342
- 'N' => 1.0,
343
- 'dyn' => 1.0E+5,
344
- 'dy' => 1.0E+5,
345
- 'lbf' => 2.24808923655339E-01,
346
- ),
347
- 'dyn' => array(
348
- 'N' => 1.0E-5,
349
- 'dyn' => 1.0,
350
- 'dy' => 1.0,
351
- 'lbf' => 2.24808923655339E-06,
352
- ),
353
- 'dy' => array(
354
- 'N' => 1.0E-5,
355
- 'dyn' => 1.0,
356
- 'dy' => 1.0,
357
- 'lbf' => 2.24808923655339E-06,
358
- ),
359
- 'lbf' => array(
360
- 'N' => 4.448222,
361
- 'dyn' => 4.448222E+5,
362
- 'dy' => 4.448222E+5,
363
- 'lbf' => 1.0,
364
- ),
365
- ),
366
- 'Energy' => array(
367
- 'J' => array(
368
- 'J' => 1.0,
369
- 'e' => 9.99999519343231E+06,
370
- 'c' => 2.39006249473467E-01,
371
- 'cal' => 2.38846190642017E-01,
372
- 'eV' => 6.24145700000000E+18,
373
- 'ev' => 6.24145700000000E+18,
374
- 'HPh' => 3.72506430801000E-07,
375
- 'hh' => 3.72506430801000E-07,
376
- 'Wh' => 2.77777916238711E-04,
377
- 'wh' => 2.77777916238711E-04,
378
- 'flb' => 2.37304222192651E+01,
379
- 'BTU' => 9.47815067349015E-04,
380
- 'btu' => 9.47815067349015E-04,
381
- ),
382
- 'e' => array(
383
- 'J' => 1.00000048065700E-07,
384
- 'e' => 1.0,
385
- 'c' => 2.39006364353494E-08,
386
- 'cal' => 2.38846305445111E-08,
387
- 'eV' => 6.24146000000000E+11,
388
- 'ev' => 6.24146000000000E+11,
389
- 'HPh' => 3.72506609848824E-14,
390
- 'hh' => 3.72506609848824E-14,
391
- 'Wh' => 2.77778049754611E-11,
392
- 'wh' => 2.77778049754611E-11,
393
- 'flb' => 2.37304336254586E-06,
394
- 'BTU' => 9.47815522922962E-11,
395
- 'btu' => 9.47815522922962E-11,
396
- ),
397
- 'c' => array(
398
- 'J' => 4.18399101363672E+00,
399
- 'e' => 4.18398900257312E+07,
400
- 'c' => 1.0,
401
- 'cal' => 9.99330315287563E-01,
402
- 'eV' => 2.61142000000000E+19,
403
- 'ev' => 2.61142000000000E+19,
404
- 'HPh' => 1.55856355899327E-06,
405
- 'hh' => 1.55856355899327E-06,
406
- 'Wh' => 1.16222030532950E-03,
407
- 'wh' => 1.16222030532950E-03,
408
- 'flb' => 9.92878733152102E+01,
409
- 'BTU' => 3.96564972437776E-03,
410
- 'btu' => 3.96564972437776E-03,
411
- ),
412
- 'cal' => array(
413
- 'J' => 4.18679484613929E+00,
414
- 'e' => 4.18679283372801E+07,
415
- 'c' => 1.00067013349059E+00,
416
- 'cal' => 1.0,
417
- 'eV' => 2.61317000000000E+19,
418
- 'ev' => 2.61317000000000E+19,
419
- 'HPh' => 1.55960800463137E-06,
420
- 'hh' => 1.55960800463137E-06,
421
- 'Wh' => 1.16299914807955E-03,
422
- 'wh' => 1.16299914807955E-03,
423
- 'flb' => 9.93544094443283E+01,
424
- 'BTU' => 3.96830723907002E-03,
425
- 'btu' => 3.96830723907002E-03,
426
- ),
427
- 'eV' => array(
428
- 'J' => 1.60219000146921E-19,
429
- 'e' => 1.60218923136574E-12,
430
- 'c' => 3.82933423195043E-20,
431
- 'cal' => 3.82676978535648E-20,
432
- 'eV' => 1.0,
433
- 'ev' => 1.0,
434
- 'HPh' => 5.96826078912344E-26,
435
- 'hh' => 5.96826078912344E-26,
436
- 'Wh' => 4.45053000026614E-23,
437
- 'wh' => 4.45053000026614E-23,
438
- 'flb' => 3.80206452103492E-18,
439
- 'BTU' => 1.51857982414846E-22,
440
- 'btu' => 1.51857982414846E-22,
441
- ),
442
- 'ev' => array(
443
- 'J' => 1.60219000146921E-19,
444
- 'e' => 1.60218923136574E-12,
445
- 'c' => 3.82933423195043E-20,
446
- 'cal' => 3.82676978535648E-20,
447
- 'eV' => 1.0,
448
- 'ev' => 1.0,
449
- 'HPh' => 5.96826078912344E-26,
450
- 'hh' => 5.96826078912344E-26,
451
- 'Wh' => 4.45053000026614E-23,
452
- 'wh' => 4.45053000026614E-23,
453
- 'flb' => 3.80206452103492E-18,
454
- 'BTU' => 1.51857982414846E-22,
455
- 'btu' => 1.51857982414846E-22,
456
- ),
457
- 'HPh' => array(
458
- 'J' => 2.68451741316170E+06,
459
- 'e' => 2.68451612283024E+13,
460
- 'c' => 6.41616438565991E+05,
461
- 'cal' => 6.41186757845835E+05,
462
- 'eV' => 1.67553000000000E+25,
463
- 'ev' => 1.67553000000000E+25,
464
- 'HPh' => 1.0,
465
- 'hh' => 1.0,
466
- 'Wh' => 7.45699653134593E+02,
467
- 'wh' => 7.45699653134593E+02,
468
- 'flb' => 6.37047316692964E+07,
469
- 'BTU' => 2.54442605275546E+03,
470
- 'btu' => 2.54442605275546E+03,
471
- ),
472
- 'hh' => array(
473
- 'J' => 2.68451741316170E+06,
474
- 'e' => 2.68451612283024E+13,
475
- 'c' => 6.41616438565991E+05,
476
- 'cal' => 6.41186757845835E+05,
477
- 'eV' => 1.67553000000000E+25,
478
- 'ev' => 1.67553000000000E+25,
479
- 'HPh' => 1.0,
480
- 'hh' => 1.0,
481
- 'Wh' => 7.45699653134593E+02,
482
- 'wh' => 7.45699653134593E+02,
483
- 'flb' => 6.37047316692964E+07,
484
- 'BTU' => 2.54442605275546E+03,
485
- 'btu' => 2.54442605275546E+03,
486
- ),
487
- 'Wh' => array(
488
- 'J' => 3.59999820554720E+03,
489
- 'e' => 3.59999647518369E+10,
490
- 'c' => 8.60422069219046E+02,
491
- 'cal' => 8.59845857713046E+02,
492
- 'eV' => 2.24692340000000E+22,
493
- 'ev' => 2.24692340000000E+22,
494
- 'HPh' => 1.34102248243839E-03,
495
- 'hh' => 1.34102248243839E-03,
496
- 'Wh' => 1.0,
497
- 'wh' => 1.0,
498
- 'flb' => 8.54294774062316E+04,
499
- 'BTU' => 3.41213254164705E+00,
500
- 'btu' => 3.41213254164705E+00,
501
- ),
502
- 'wh' => array(
503
- 'J' => 3.59999820554720E+03,
504
- 'e' => 3.59999647518369E+10,
505
- 'c' => 8.60422069219046E+02,
506
- 'cal' => 8.59845857713046E+02,
507
- 'eV' => 2.24692340000000E+22,
508
- 'ev' => 2.24692340000000E+22,
509
- 'HPh' => 1.34102248243839E-03,
510
- 'hh' => 1.34102248243839E-03,
511
- 'Wh' => 1.0,
512
- 'wh' => 1.0,
513
- 'flb' => 8.54294774062316E+04,
514
- 'BTU' => 3.41213254164705E+00,
515
- 'btu' => 3.41213254164705E+00,
516
- ),
517
- 'flb' => array(
518
- 'J' => 4.21400003236424E-02,
519
- 'e' => 4.21399800687660E+05,
520
- 'c' => 1.00717234301644E-02,
521
- 'cal' => 1.00649785509554E-02,
522
- 'eV' => 2.63015000000000E+17,
523
- 'ev' => 2.63015000000000E+17,
524
- 'HPh' => 1.56974211145130E-08,
525
- 'hh' => 1.56974211145130E-08,
526
- 'Wh' => 1.17055614802000E-05,
527
- 'wh' => 1.17055614802000E-05,
528
- 'flb' => 1.0,
529
- 'BTU' => 3.99409272448406E-05,
530
- 'btu' => 3.99409272448406E-05,
531
- ),
532
- 'BTU' => array(
533
- 'J' => 1.05505813786749E+03,
534
- 'e' => 1.05505763074665E+10,
535
- 'c' => 2.52165488508168E+02,
536
- 'cal' => 2.51996617135510E+02,
537
- 'eV' => 6.58510000000000E+21,
538
- 'ev' => 6.58510000000000E+21,
539
- 'HPh' => 3.93015941224568E-04,
540
- 'hh' => 3.93015941224568E-04,
541
- 'Wh' => 2.93071851047526E-01,
542
- 'wh' => 2.93071851047526E-01,
543
- 'flb' => 2.50369750774671E+04,
544
- 'BTU' => 1.0,
545
- 'btu' => 1.0,
546
- ),
547
- 'btu' => array(
548
- 'J' => 1.05505813786749E+03,
549
- 'e' => 1.05505763074665E+10,
550
- 'c' => 2.52165488508168E+02,
551
- 'cal' => 2.51996617135510E+02,
552
- 'eV' => 6.58510000000000E+21,
553
- 'ev' => 6.58510000000000E+21,
554
- 'HPh' => 3.93015941224568E-04,
555
- 'hh' => 3.93015941224568E-04,
556
- 'Wh' => 2.93071851047526E-01,
557
- 'wh' => 2.93071851047526E-01,
558
- 'flb' => 2.50369750774671E+04,
559
- 'BTU' => 1.0,
560
- 'btu' => 1.0,
561
- ),
562
- ),
563
- 'Power' => array(
564
- 'HP' => array(
565
- 'HP' => 1.0,
566
- 'h' => 1.0,
567
- 'W' => 7.45701000000000E+02,
568
- 'w' => 7.45701000000000E+02,
569
- ),
570
- 'h' => array(
571
- 'HP' => 1.0,
572
- 'h' => 1.0,
573
- 'W' => 7.45701000000000E+02,
574
- 'w' => 7.45701000000000E+02,
575
- ),
576
- 'W' => array(
577
- 'HP' => 1.34102006031908E-03,
578
- 'h' => 1.34102006031908E-03,
579
- 'W' => 1.0,
580
- 'w' => 1.0,
581
- ),
582
- 'w' => array(
583
- 'HP' => 1.34102006031908E-03,
584
- 'h' => 1.34102006031908E-03,
585
- 'W' => 1.0,
586
- 'w' => 1.0,
587
- ),
588
- ),
589
- 'Magnetism' => array(
590
- 'T' => array(
591
- 'T' => 1.0,
592
- 'ga' => 10000.0,
593
- ),
594
- 'ga' => array(
595
- 'T' => 0.0001,
596
- 'ga' => 1.0,
597
- ),
598
- ),
599
- 'Liquid' => array(
600
- 'tsp' => array(
601
- 'tsp' => 1.0,
602
- 'tbs' => 3.33333333333333E-01,
603
- 'oz' => 1.66666666666667E-01,
604
- 'cup' => 2.08333333333333E-02,
605
- 'pt' => 1.04166666666667E-02,
606
- 'us_pt' => 1.04166666666667E-02,
607
- 'uk_pt' => 8.67558516821960E-03,
608
- 'qt' => 5.20833333333333E-03,
609
- 'gal' => 1.30208333333333E-03,
610
- 'l' => 4.92999408400710E-03,
611
- 'lt' => 4.92999408400710E-03,
612
- ),
613
- 'tbs' => array(
614
- 'tsp' => 3.00000000000000E+00,
615
- 'tbs' => 1.0,
616
- 'oz' => 5.00000000000000E-01,
617
- 'cup' => 6.25000000000000E-02,
618
- 'pt' => 3.12500000000000E-02,
619
- 'us_pt' => 3.12500000000000E-02,
620
- 'uk_pt' => 2.60267555046588E-02,
621
- 'qt' => 1.56250000000000E-02,
622
- 'gal' => 3.90625000000000E-03,
623
- 'l' => 1.47899822520213E-02,
624
- 'lt' => 1.47899822520213E-02,
625
- ),
626
- 'oz' => array(
627
- 'tsp' => 6.00000000000000E+00,
628
- 'tbs' => 2.00000000000000E+00,
629
- 'oz' => 1.0,
630
- 'cup' => 1.25000000000000E-01,
631
- 'pt' => 6.25000000000000E-02,
632
- 'us_pt' => 6.25000000000000E-02,
633
- 'uk_pt' => 5.20535110093176E-02,
634
- 'qt' => 3.12500000000000E-02,
635
- 'gal' => 7.81250000000000E-03,
636
- 'l' => 2.95799645040426E-02,
637
- 'lt' => 2.95799645040426E-02,
638
- ),
639
- 'cup' => array(
640
- 'tsp' => 4.80000000000000E+01,
641
- 'tbs' => 1.60000000000000E+01,
642
- 'oz' => 8.00000000000000E+00,
643
- 'cup' => 1.0,
644
- 'pt' => 5.00000000000000E-01,
645
- 'us_pt' => 5.00000000000000E-01,
646
- 'uk_pt' => 4.16428088074541E-01,
647
- 'qt' => 2.50000000000000E-01,
648
- 'gal' => 6.25000000000000E-02,
649
- 'l' => 2.36639716032341E-01,
650
- 'lt' => 2.36639716032341E-01,
651
- ),
652
- 'pt' => array(
653
- 'tsp' => 9.60000000000000E+01,
654
- 'tbs' => 3.20000000000000E+01,
655
- 'oz' => 1.60000000000000E+01,
656
- 'cup' => 2.00000000000000E+00,
657
- 'pt' => 1.0,
658
- 'us_pt' => 1.0,
659
- 'uk_pt' => 8.32856176149081E-01,
660
- 'qt' => 5.00000000000000E-01,
661
- 'gal' => 1.25000000000000E-01,
662
- 'l' => 4.73279432064682E-01,
663
- 'lt' => 4.73279432064682E-01,
664
- ),
665
- 'us_pt' => array(
666
- 'tsp' => 9.60000000000000E+01,
667
- 'tbs' => 3.20000000000000E+01,
668
- 'oz' => 1.60000000000000E+01,
669
- 'cup' => 2.00000000000000E+00,
670
- 'pt' => 1.0,
671
- 'us_pt' => 1.0,
672
- 'uk_pt' => 8.32856176149081E-01,
673
- 'qt' => 5.00000000000000E-01,
674
- 'gal' => 1.25000000000000E-01,
675
- 'l' => 4.73279432064682E-01,
676
- 'lt' => 4.73279432064682E-01,
677
- ),
678
- 'uk_pt' => array(
679
- 'tsp' => 1.15266000000000E+02,
680
- 'tbs' => 3.84220000000000E+01,
681
- 'oz' => 1.92110000000000E+01,
682
- 'cup' => 2.40137500000000E+00,
683
- 'pt' => 1.20068750000000E+00,
684
- 'us_pt' => 1.20068750000000E+00,
685
- 'uk_pt' => 1.0,
686
- 'qt' => 6.00343750000000E-01,
687
- 'gal' => 1.50085937500000E-01,
688
- 'l' => 5.68260698087162E-01,
689
- 'lt' => 5.68260698087162E-01,
690
- ),
691
- 'qt' => array(
692
- 'tsp' => 1.92000000000000E+02,
693
- 'tbs' => 6.40000000000000E+01,
694
- 'oz' => 3.20000000000000E+01,
695
- 'cup' => 4.00000000000000E+00,
696
- 'pt' => 2.00000000000000E+00,
697
- 'us_pt' => 2.00000000000000E+00,
698
- 'uk_pt' => 1.66571235229816E+00,
699
- 'qt' => 1.0,
700
- 'gal' => 2.50000000000000E-01,
701
- 'l' => 9.46558864129363E-01,
702
- 'lt' => 9.46558864129363E-01,
703
- ),
704
- 'gal' => array(
705
- 'tsp' => 7.68000000000000E+02,
706
- 'tbs' => 2.56000000000000E+02,
707
- 'oz' => 1.28000000000000E+02,
708
- 'cup' => 1.60000000000000E+01,
709
- 'pt' => 8.00000000000000E+00,
710
- 'us_pt' => 8.00000000000000E+00,
711
- 'uk_pt' => 6.66284940919265E+00,
712
- 'qt' => 4.00000000000000E+00,
713
- 'gal' => 1.0,
714
- 'l' => 3.78623545651745E+00,
715
- 'lt' => 3.78623545651745E+00,
716
- ),
717
- 'l' => array(
718
- 'tsp' => 2.02840000000000E+02,
719
- 'tbs' => 6.76133333333333E+01,
720
- 'oz' => 3.38066666666667E+01,
721
- 'cup' => 4.22583333333333E+00,
722
- 'pt' => 2.11291666666667E+00,
723
- 'us_pt' => 2.11291666666667E+00,
724
- 'uk_pt' => 1.75975569552166E+00,
725
- 'qt' => 1.05645833333333E+00,
726
- 'gal' => 2.64114583333333E-01,
727
- 'l' => 1.0,
728
- 'lt' => 1.0,
729
- ),
730
- 'lt' => array(
731
- 'tsp' => 2.02840000000000E+02,
732
- 'tbs' => 6.76133333333333E+01,
733
- 'oz' => 3.38066666666667E+01,
734
- 'cup' => 4.22583333333333E+00,
735
- 'pt' => 2.11291666666667E+00,
736
- 'us_pt' => 2.11291666666667E+00,
737
- 'uk_pt' => 1.75975569552166E+00,
738
- 'qt' => 1.05645833333333E+00,
739
- 'gal' => 2.64114583333333E-01,
740
- 'l' => 1.0,
741
- 'lt' => 1.0,
742
- ),
743
- ),
744
- );
745
-
746
-
747
- /**
748
- * parseComplex
749
- *
750
- * Parses a complex number into its real and imaginary parts, and an I or J suffix
751
- *
752
- * @param string $complexNumber The complex number
753
- * @return string[] Indexed on "real", "imaginary" and "suffix"
754
- */
755
- public static function parseComplex($complexNumber)
756
- {
757
- $workString = (string) $complexNumber;
758
-
759
- $realNumber = $imaginary = 0;
760
- // Extract the suffix, if there is one
761
- $suffix = substr($workString, -1);
762
- if (!is_numeric($suffix)) {
763
- $workString = substr($workString, 0, -1);
764
- } else {
765
- $suffix = '';
766
- }
767
-
768
- // Split the input into its Real and Imaginary components
769
- $leadingSign = 0;
770
- if (strlen($workString) > 0) {
771
- $leadingSign = (($workString{0} == '+') || ($workString{0} == '-')) ? 1 : 0;
772
- }
773
- $power = '';
774
- $realNumber = strtok($workString, '+-');
775
- if (strtoupper(substr($realNumber, -1)) == 'E') {
776
- $power = strtok('+-');
777
- ++$leadingSign;
778
- }
779
-
780
- $realNumber = substr($workString, 0, strlen($realNumber)+strlen($power)+$leadingSign);
781
-
782
- if ($suffix != '') {
783
- $imaginary = substr($workString, strlen($realNumber));
784
-
785
- if (($imaginary == '') && (($realNumber == '') || ($realNumber == '+') || ($realNumber == '-'))) {
786
- $imaginary = $realNumber.'1';
787
- $realNumber = '0';
788
- } elseif ($imaginary == '') {
789
- $imaginary = $realNumber;
790
- $realNumber = '0';
791
- } elseif (($imaginary == '+') || ($imaginary == '-')) {
792
- $imaginary .= '1';
793
- }
794
- }
795
-
796
- return array(
797
- 'real' => $realNumber,
798
- 'imaginary' => $imaginary,
799
- 'suffix' => $suffix
800
- );
801
- }
802
-
803
-
804
- /**
805
- * Cleans the leading characters in a complex number string
806
- *
807
- * @param string $complexNumber The complex number to clean
808
- * @return string The "cleaned" complex number
809
- */
810
- private static function cleanComplex($complexNumber)
811
- {
812
- if ($complexNumber{0} == '+') {
813
- $complexNumber = substr($complexNumber, 1);
814
- }
815
- if ($complexNumber{0} == '0') {
816
- $complexNumber = substr($complexNumber, 1);
817
- }
818
- if ($complexNumber{0} == '.') {
819
- $complexNumber = '0'.$complexNumber;
820
- }
821
- if ($complexNumber{0} == '+') {
822
- $complexNumber = substr($complexNumber, 1);
823
- }
824
- return $complexNumber;
825
- }
826
-
827
- /**
828
- * Formats a number base string value with leading zeroes
829
- *
830
- * @param string $xVal The "number" to pad
831
- * @param integer $places The length that we want to pad this value
832
- * @return string The padded "number"
833
- */
834
- private static function nbrConversionFormat($xVal, $places)
835
- {
836
- if (!is_null($places)) {
837
- if (strlen($xVal) <= $places) {
838
- return substr(str_pad($xVal, $places, '0', STR_PAD_LEFT), -10);
839
- } else {
840
- return PHPExcel_Calculation_Functions::NaN();
841
- }
842
- }
843
-
844
- return substr($xVal, -10);
845
- }
846
-
847
- /**
848
- * BESSELI
849
- *
850
- * Returns the modified Bessel function In(x), which is equivalent to the Bessel function evaluated
851
- * for purely imaginary arguments
852
- *
853
- * Excel Function:
854
- * BESSELI(x,ord)
855
- *
856
- * @access public
857
- * @category Engineering Functions
858
- * @param float $x The value at which to evaluate the function.
859
- * If x is nonnumeric, BESSELI returns the #VALUE! error value.
860
- * @param integer $ord The order of the Bessel function.
861
- * If ord is not an integer, it is truncated.
862
- * If $ord is nonnumeric, BESSELI returns the #VALUE! error value.
863
- * If $ord < 0, BESSELI returns the #NUM! error value.
864
- * @return float
865
- *
866
- */
867
- public static function BESSELI($x, $ord)
868
- {
869
- $x = (is_null($x)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($x);
870
- $ord = (is_null($ord)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($ord);
871
-
872
- if ((is_numeric($x)) && (is_numeric($ord))) {
873
- $ord = floor($ord);
874
- if ($ord < 0) {
875
- return PHPExcel_Calculation_Functions::NaN();
876
- }
877
-
878
- if (abs($x) <= 30) {
879
- $fResult = $fTerm = pow($x / 2, $ord) / PHPExcel_Calculation_MathTrig::FACT($ord);
880
- $ordK = 1;
881
- $fSqrX = ($x * $x) / 4;
882
- do {
883
- $fTerm *= $fSqrX;
884
- $fTerm /= ($ordK * ($ordK + $ord));
885
- $fResult += $fTerm;
886
- } while ((abs($fTerm) > 1e-12) && (++$ordK < 100));
887
- } else {
888
- $f_2_PI = 2 * M_PI;
889
-
890
- $fXAbs = abs($x);
891
- $fResult = exp($fXAbs) / sqrt($f_2_PI * $fXAbs);
892
- if (($ord & 1) && ($x < 0)) {
893
- $fResult = -$fResult;
894
- }
895
- }
896
- return (is_nan($fResult)) ? PHPExcel_Calculation_Functions::NaN() : $fResult;
897
- }
898
- return PHPExcel_Calculation_Functions::VALUE();
899
- }
900
-
901
-
902
- /**
903
- * BESSELJ
904
- *
905
- * Returns the Bessel function
906
- *
907
- * Excel Function:
908
- * BESSELJ(x,ord)
909
- *
910
- * @access public
911
- * @category Engineering Functions
912
- * @param float $x The value at which to evaluate the function.
913
- * If x is nonnumeric, BESSELJ returns the #VALUE! error value.
914
- * @param integer $ord The order of the Bessel function. If n is not an integer, it is truncated.
915
- * If $ord is nonnumeric, BESSELJ returns the #VALUE! error value.
916
- * If $ord < 0, BESSELJ returns the #NUM! error value.
917
- * @return float
918
- *
919
- */
920
- public static function BESSELJ($x, $ord)
921
- {
922
- $x = (is_null($x)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($x);
923
- $ord = (is_null($ord)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($ord);
924
-
925
- if ((is_numeric($x)) && (is_numeric($ord))) {
926
- $ord = floor($ord);
927
- if ($ord < 0) {
928
- return PHPExcel_Calculation_Functions::NaN();
929
- }
930
-
931
- $fResult = 0;
932
- if (abs($x) <= 30) {
933
- $fResult = $fTerm = pow($x / 2, $ord) / PHPExcel_Calculation_MathTrig::FACT($ord);
934
- $ordK = 1;
935
- $fSqrX = ($x * $x) / -4;
936
- do {
937
- $fTerm *= $fSqrX;
938
- $fTerm /= ($ordK * ($ordK + $ord));
939
- $fResult += $fTerm;
940
- } while ((abs($fTerm) > 1e-12) && (++$ordK < 100));
941
- } else {
942
- $f_PI_DIV_2 = M_PI / 2;
943
- $f_PI_DIV_4 = M_PI / 4;
944
-
945
- $fXAbs = abs($x);
946
- $fResult = sqrt(M_2DIVPI / $fXAbs) * cos($fXAbs - $ord * $f_PI_DIV_2 - $f_PI_DIV_4);
947
- if (($ord & 1) && ($x < 0)) {
948
- $fResult = -$fResult;
949
- }
950
- }
951
- return (is_nan($fResult)) ? PHPExcel_Calculation_Functions::NaN() : $fResult;
952
- }
953
- return PHPExcel_Calculation_Functions::VALUE();
954
- }
955
-
956
-
957
- private static function besselK0($fNum)
958
- {
959
- if ($fNum <= 2) {
960
- $fNum2 = $fNum * 0.5;
961
- $y = ($fNum2 * $fNum2);
962
- $fRet = -log($fNum2) * self::BESSELI($fNum, 0) +
963
- (-0.57721566 + $y * (0.42278420 + $y * (0.23069756 + $y * (0.3488590e-1 + $y * (0.262698e-2 + $y *
964
- (0.10750e-3 + $y * 0.74e-5))))));
965
- } else {
966
- $y = 2 / $fNum;
967
- $fRet = exp(-$fNum) / sqrt($fNum) *
968
- (1.25331414 + $y * (-0.7832358e-1 + $y * (0.2189568e-1 + $y * (-0.1062446e-1 + $y *
969
- (0.587872e-2 + $y * (-0.251540e-2 + $y * 0.53208e-3))))));
970
- }
971
- return $fRet;
972
- }
973
-
974
-
975
- private static function besselK1($fNum)
976
- {
977
- if ($fNum <= 2) {
978
- $fNum2 = $fNum * 0.5;
979
- $y = ($fNum2 * $fNum2);
980
- $fRet = log($fNum2) * self::BESSELI($fNum, 1) +
981
- (1 + $y * (0.15443144 + $y * (-0.67278579 + $y * (-0.18156897 + $y * (-0.1919402e-1 + $y *
982
- (-0.110404e-2 + $y * (-0.4686e-4))))))) / $fNum;
983
- } else {
984
- $y = 2 / $fNum;
985
- $fRet = exp(-$fNum) / sqrt($fNum) *
986
- (1.25331414 + $y * (0.23498619 + $y * (-0.3655620e-1 + $y * (0.1504268e-1 + $y * (-0.780353e-2 + $y *
987
- (0.325614e-2 + $y * (-0.68245e-3)))))));
988
- }
989
- return $fRet;
990
- }
991
-
992
-
993
- /**
994
- * BESSELK
995
- *
996
- * Returns the modified Bessel function Kn(x), which is equivalent to the Bessel functions evaluated
997
- * for purely imaginary arguments.
998
- *
999
- * Excel Function:
1000
- * BESSELK(x,ord)
1001
- *
1002
- * @access public
1003
- * @category Engineering Functions
1004
- * @param float $x The value at which to evaluate the function.
1005
- * If x is nonnumeric, BESSELK returns the #VALUE! error value.
1006
- * @param integer $ord The order of the Bessel function. If n is not an integer, it is truncated.
1007
- * If $ord is nonnumeric, BESSELK returns the #VALUE! error value.
1008
- * If $ord < 0, BESSELK returns the #NUM! error value.
1009
- * @return float
1010
- *
1011
- */
1012
- public static function BESSELK($x, $ord)
1013
- {
1014
- $x = (is_null($x)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($x);
1015
- $ord = (is_null($ord)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($ord);
1016
-
1017
- if ((is_numeric($x)) && (is_numeric($ord))) {
1018
- if (($ord < 0) || ($x == 0.0)) {
1019
- return PHPExcel_Calculation_Functions::NaN();
1020
- }
1021
-
1022
- switch (floor($ord)) {
1023
- case 0:
1024
- return self::besselK0($x);
1025
- case 1:
1026
- return self::besselK1($x);
1027
- default:
1028
- $fTox = 2 / $x;
1029
- $fBkm = self::besselK0($x);
1030
- $fBk = self::besselK1($x);
1031
- for ($n = 1; $n < $ord; ++$n) {
1032
- $fBkp = $fBkm + $n * $fTox * $fBk;
1033
- $fBkm = $fBk;
1034
- $fBk = $fBkp;
1035
- }
1036
- }
1037
- return (is_nan($fBk)) ? PHPExcel_Calculation_Functions::NaN() : $fBk;
1038
- }
1039
- return PHPExcel_Calculation_Functions::VALUE();
1040
- }
1041
-
1042
-
1043
- private static function besselY0($fNum)
1044
- {
1045
- if ($fNum < 8.0) {
1046
- $y = ($fNum * $fNum);
1047
- $f1 = -2957821389.0 + $y * (7062834065.0 + $y * (-512359803.6 + $y * (10879881.29 + $y * (-86327.92757 + $y * 228.4622733))));
1048
- $f2 = 40076544269.0 + $y * (745249964.8 + $y * (7189466.438 + $y * (47447.26470 + $y * (226.1030244 + $y))));
1049
- $fRet = $f1 / $f2 + 0.636619772 * self::BESSELJ($fNum, 0) * log($fNum);
1050
- } else {
1051
- $z = 8.0 / $fNum;
1052
- $y = ($z * $z);
1053
- $xx = $fNum - 0.785398164;
1054
- $f1 = 1 + $y * (-0.1098628627e-2 + $y * (0.2734510407e-4 + $y * (-0.2073370639e-5 + $y * 0.2093887211e-6)));
1055
- $f2 = -0.1562499995e-1 + $y * (0.1430488765e-3 + $y * (-0.6911147651e-5 + $y * (0.7621095161e-6 + $y * (-0.934945152e-7))));
1056
- $fRet = sqrt(0.636619772 / $fNum) * (sin($xx) * $f1 + $z * cos($xx) * $f2);
1057
- }
1058
- return $fRet;
1059
- }
1060
-
1061
-
1062
- private static function besselY1($fNum)
1063
- {
1064
- if ($fNum < 8.0) {
1065
- $y = ($fNum * $fNum);
1066
- $f1 = $fNum * (-0.4900604943e13 + $y * (0.1275274390e13 + $y * (-0.5153438139e11 + $y * (0.7349264551e9 + $y *
1067
- (-0.4237922726e7 + $y * 0.8511937935e4)))));
1068
- $f2 = 0.2499580570e14 + $y * (0.4244419664e12 + $y * (0.3733650367e10 + $y * (0.2245904002e8 + $y *
1069
- (0.1020426050e6 + $y * (0.3549632885e3 + $y)))));
1070
- $fRet = $f1 / $f2 + 0.636619772 * ( self::BESSELJ($fNum, 1) * log($fNum) - 1 / $fNum);
1071
- } else {
1072
- $fRet = sqrt(0.636619772 / $fNum) * sin($fNum - 2.356194491);
1073
- }
1074
- return $fRet;
1075
- }
1076
-
1077
-
1078
- /**
1079
- * BESSELY
1080
- *
1081
- * Returns the Bessel function, which is also called the Weber function or the Neumann function.
1082
- *
1083
- * Excel Function:
1084
- * BESSELY(x,ord)
1085
- *
1086
- * @access public
1087
- * @category Engineering Functions
1088
- * @param float $x The value at which to evaluate the function.
1089
- * If x is nonnumeric, BESSELK returns the #VALUE! error value.
1090
- * @param integer $ord The order of the Bessel function. If n is not an integer, it is truncated.
1091
- * If $ord is nonnumeric, BESSELK returns the #VALUE! error value.
1092
- * If $ord < 0, BESSELK returns the #NUM! error value.
1093
- *
1094
- * @return float
1095
- */
1096
- public static function BESSELY($x, $ord)
1097
- {
1098
- $x = (is_null($x)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($x);
1099
- $ord = (is_null($ord)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($ord);
1100
-
1101
- if ((is_numeric($x)) && (is_numeric($ord))) {
1102
- if (($ord < 0) || ($x == 0.0)) {
1103
- return PHPExcel_Calculation_Functions::NaN();
1104
- }
1105
-
1106
- switch (floor($ord)) {
1107
- case 0:
1108
- return self::besselY0($x);
1109
- case 1:
1110
- return self::besselY1($x);
1111
- default:
1112
- $fTox = 2 / $x;
1113
- $fBym = self::besselY0($x);
1114
- $fBy = self::besselY1($x);
1115
- for ($n = 1; $n < $ord; ++$n) {
1116
- $fByp = $n * $fTox * $fBy - $fBym;
1117
- $fBym = $fBy;
1118
- $fBy = $fByp;
1119
- }
1120
- }
1121
- return (is_nan($fBy)) ? PHPExcel_Calculation_Functions::NaN() : $fBy;
1122
- }
1123
- return PHPExcel_Calculation_Functions::VALUE();
1124
- }
1125
-
1126
-
1127
- /**
1128
- * BINTODEC
1129
- *
1130
- * Return a binary value as decimal.
1131
- *
1132
- * Excel Function:
1133
- * BIN2DEC(x)
1134
- *
1135
- * @access public
1136
- * @category Engineering Functions
1137
- * @param string $x The binary number (as a string) that you want to convert. The number
1138
- * cannot contain more than 10 characters (10 bits). The most significant
1139
- * bit of number is the sign bit. The remaining 9 bits are magnitude bits.
1140
- * Negative numbers are represented using two's-complement notation.
1141
- * If number is not a valid binary number, or if number contains more than
1142
- * 10 characters (10 bits), BIN2DEC returns the #NUM! error value.
1143
- * @return string
1144
- */
1145
- public static function BINTODEC($x)
1146
- {
1147
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1148
-
1149
- if (is_bool($x)) {
1150
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1151
- $x = (int) $x;
1152
- } else {
1153
- return PHPExcel_Calculation_Functions::VALUE();
1154
- }
1155
- }
1156
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1157
- $x = floor($x);
1158
- }
1159
- $x = (string) $x;
1160
- if (strlen($x) > preg_match_all('/[01]/', $x, $out)) {
1161
- return PHPExcel_Calculation_Functions::NaN();
1162
- }
1163
- if (strlen($x) > 10) {
1164
- return PHPExcel_Calculation_Functions::NaN();
1165
- } elseif (strlen($x) == 10) {
1166
- // Two's Complement
1167
- $x = substr($x, -9);
1168
- return '-'.(512-bindec($x));
1169
- }
1170
- return bindec($x);
1171
- }
1172
-
1173
-
1174
- /**
1175
- * BINTOHEX
1176
- *
1177
- * Return a binary value as hex.
1178
- *
1179
- * Excel Function:
1180
- * BIN2HEX(x[,places])
1181
- *
1182
- * @access public
1183
- * @category Engineering Functions
1184
- * @param string $x The binary number (as a string) that you want to convert. The number
1185
- * cannot contain more than 10 characters (10 bits). The most significant
1186
- * bit of number is the sign bit. The remaining 9 bits are magnitude bits.
1187
- * Negative numbers are represented using two's-complement notation.
1188
- * If number is not a valid binary number, or if number contains more than
1189
- * 10 characters (10 bits), BIN2HEX returns the #NUM! error value.
1190
- * @param integer $places The number of characters to use. If places is omitted, BIN2HEX uses the
1191
- * minimum number of characters necessary. Places is useful for padding the
1192
- * return value with leading 0s (zeros).
1193
- * If places is not an integer, it is truncated.
1194
- * If places is nonnumeric, BIN2HEX returns the #VALUE! error value.
1195
- * If places is negative, BIN2HEX returns the #NUM! error value.
1196
- * @return string
1197
- */
1198
- public static function BINTOHEX($x, $places = null)
1199
- {
1200
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1201
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1202
-
1203
- if (is_bool($x)) {
1204
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1205
- $x = (int) $x;
1206
- } else {
1207
- return PHPExcel_Calculation_Functions::VALUE();
1208
- }
1209
- }
1210
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1211
- $x = floor($x);
1212
- }
1213
- $x = (string) $x;
1214
- if (strlen($x) > preg_match_all('/[01]/', $x, $out)) {
1215
- return PHPExcel_Calculation_Functions::NaN();
1216
- }
1217
- if (strlen($x) > 10) {
1218
- return PHPExcel_Calculation_Functions::NaN();
1219
- } elseif (strlen($x) == 10) {
1220
- // Two's Complement
1221
- return str_repeat('F', 8).substr(strtoupper(dechex(bindec(substr($x, -9)))), -2);
1222
- }
1223
- $hexVal = (string) strtoupper(dechex(bindec($x)));
1224
-
1225
- return self::nbrConversionFormat($hexVal, $places);
1226
- }
1227
-
1228
-
1229
- /**
1230
- * BINTOOCT
1231
- *
1232
- * Return a binary value as octal.
1233
- *
1234
- * Excel Function:
1235
- * BIN2OCT(x[,places])
1236
- *
1237
- * @access public
1238
- * @category Engineering Functions
1239
- * @param string $x The binary number (as a string) that you want to convert. The number
1240
- * cannot contain more than 10 characters (10 bits). The most significant
1241
- * bit of number is the sign bit. The remaining 9 bits are magnitude bits.
1242
- * Negative numbers are represented using two's-complement notation.
1243
- * If number is not a valid binary number, or if number contains more than
1244
- * 10 characters (10 bits), BIN2OCT returns the #NUM! error value.
1245
- * @param integer $places The number of characters to use. If places is omitted, BIN2OCT uses the
1246
- * minimum number of characters necessary. Places is useful for padding the
1247
- * return value with leading 0s (zeros).
1248
- * If places is not an integer, it is truncated.
1249
- * If places is nonnumeric, BIN2OCT returns the #VALUE! error value.
1250
- * If places is negative, BIN2OCT returns the #NUM! error value.
1251
- * @return string
1252
- */
1253
- public static function BINTOOCT($x, $places = null)
1254
- {
1255
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1256
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1257
-
1258
- if (is_bool($x)) {
1259
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1260
- $x = (int) $x;
1261
- } else {
1262
- return PHPExcel_Calculation_Functions::VALUE();
1263
- }
1264
- }
1265
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1266
- $x = floor($x);
1267
- }
1268
- $x = (string) $x;
1269
- if (strlen($x) > preg_match_all('/[01]/', $x, $out)) {
1270
- return PHPExcel_Calculation_Functions::NaN();
1271
- }
1272
- if (strlen($x) > 10) {
1273
- return PHPExcel_Calculation_Functions::NaN();
1274
- } elseif (strlen($x) == 10) {
1275
- // Two's Complement
1276
- return str_repeat('7', 7).substr(strtoupper(decoct(bindec(substr($x, -9)))), -3);
1277
- }
1278
- $octVal = (string) decoct(bindec($x));
1279
-
1280
- return self::nbrConversionFormat($octVal, $places);
1281
- }
1282
-
1283
-
1284
- /**
1285
- * DECTOBIN
1286
- *
1287
- * Return a decimal value as binary.
1288
- *
1289
- * Excel Function:
1290
- * DEC2BIN(x[,places])
1291
- *
1292
- * @access public
1293
- * @category Engineering Functions
1294
- * @param string $x The decimal integer you want to convert. If number is negative,
1295
- * valid place values are ignored and DEC2BIN returns a 10-character
1296
- * (10-bit) binary number in which the most significant bit is the sign
1297
- * bit. The remaining 9 bits are magnitude bits. Negative numbers are
1298
- * represented using two's-complement notation.
1299
- * If number < -512 or if number > 511, DEC2BIN returns the #NUM! error
1300
- * value.
1301
- * If number is nonnumeric, DEC2BIN returns the #VALUE! error value.
1302
- * If DEC2BIN requires more than places characters, it returns the #NUM!
1303
- * error value.
1304
- * @param integer $places The number of characters to use. If places is omitted, DEC2BIN uses
1305
- * the minimum number of characters necessary. Places is useful for
1306
- * padding the return value with leading 0s (zeros).
1307
- * If places is not an integer, it is truncated.
1308
- * If places is nonnumeric, DEC2BIN returns the #VALUE! error value.
1309
- * If places is zero or negative, DEC2BIN returns the #NUM! error value.
1310
- * @return string
1311
- */
1312
- public static function DECTOBIN($x, $places = null)
1313
- {
1314
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1315
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1316
-
1317
- if (is_bool($x)) {
1318
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1319
- $x = (int) $x;
1320
- } else {
1321
- return PHPExcel_Calculation_Functions::VALUE();
1322
- }
1323
- }
1324
- $x = (string) $x;
1325
- if (strlen($x) > preg_match_all('/[-0123456789.]/', $x, $out)) {
1326
- return PHPExcel_Calculation_Functions::VALUE();
1327
- }
1328
- $x = (string) floor($x);
1329
- $r = decbin($x);
1330
- if (strlen($r) == 32) {
1331
- // Two's Complement
1332
- $r = substr($r, -10);
1333
- } elseif (strlen($r) > 11) {
1334
- return PHPExcel_Calculation_Functions::NaN();
1335
- }
1336
-
1337
- return self::nbrConversionFormat($r, $places);
1338
- }
1339
-
1340
-
1341
- /**
1342
- * DECTOHEX
1343
- *
1344
- * Return a decimal value as hex.
1345
- *
1346
- * Excel Function:
1347
- * DEC2HEX(x[,places])
1348
- *
1349
- * @access public
1350
- * @category Engineering Functions
1351
- * @param string $x The decimal integer you want to convert. If number is negative,
1352
- * places is ignored and DEC2HEX returns a 10-character (40-bit)
1353
- * hexadecimal number in which the most significant bit is the sign
1354
- * bit. The remaining 39 bits are magnitude bits. Negative numbers
1355
- * are represented using two's-complement notation.
1356
- * If number < -549,755,813,888 or if number > 549,755,813,887,
1357
- * DEC2HEX returns the #NUM! error value.
1358
- * If number is nonnumeric, DEC2HEX returns the #VALUE! error value.
1359
- * If DEC2HEX requires more than places characters, it returns the
1360
- * #NUM! error value.
1361
- * @param integer $places The number of characters to use. If places is omitted, DEC2HEX uses
1362
- * the minimum number of characters necessary. Places is useful for
1363
- * padding the return value with leading 0s (zeros).
1364
- * If places is not an integer, it is truncated.
1365
- * If places is nonnumeric, DEC2HEX returns the #VALUE! error value.
1366
- * If places is zero or negative, DEC2HEX returns the #NUM! error value.
1367
- * @return string
1368
- */
1369
- public static function DECTOHEX($x, $places = null)
1370
- {
1371
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1372
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1373
-
1374
- if (is_bool($x)) {
1375
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1376
- $x = (int) $x;
1377
- } else {
1378
- return PHPExcel_Calculation_Functions::VALUE();
1379
- }
1380
- }
1381
- $x = (string) $x;
1382
- if (strlen($x) > preg_match_all('/[-0123456789.]/', $x, $out)) {
1383
- return PHPExcel_Calculation_Functions::VALUE();
1384
- }
1385
- $x = (string) floor($x);
1386
- $r = strtoupper(dechex($x));
1387
- if (strlen($r) == 8) {
1388
- // Two's Complement
1389
- $r = 'FF'.$r;
1390
- }
1391
-
1392
- return self::nbrConversionFormat($r, $places);
1393
- }
1394
-
1395
-
1396
- /**
1397
- * DECTOOCT
1398
- *
1399
- * Return an decimal value as octal.
1400
- *
1401
- * Excel Function:
1402
- * DEC2OCT(x[,places])
1403
- *
1404
- * @access public
1405
- * @category Engineering Functions
1406
- * @param string $x The decimal integer you want to convert. If number is negative,
1407
- * places is ignored and DEC2OCT returns a 10-character (30-bit)
1408
- * octal number in which the most significant bit is the sign bit.
1409
- * The remaining 29 bits are magnitude bits. Negative numbers are
1410
- * represented using two's-complement notation.
1411
- * If number < -536,870,912 or if number > 536,870,911, DEC2OCT
1412
- * returns the #NUM! error value.
1413
- * If number is nonnumeric, DEC2OCT returns the #VALUE! error value.
1414
- * If DEC2OCT requires more than places characters, it returns the
1415
- * #NUM! error value.
1416
- * @param integer $places The number of characters to use. If places is omitted, DEC2OCT uses
1417
- * the minimum number of characters necessary. Places is useful for
1418
- * padding the return value with leading 0s (zeros).
1419
- * If places is not an integer, it is truncated.
1420
- * If places is nonnumeric, DEC2OCT returns the #VALUE! error value.
1421
- * If places is zero or negative, DEC2OCT returns the #NUM! error value.
1422
- * @return string
1423
- */
1424
- public static function DECTOOCT($x, $places = null)
1425
- {
1426
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1427
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1428
-
1429
- if (is_bool($x)) {
1430
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
1431
- $x = (int) $x;
1432
- } else {
1433
- return PHPExcel_Calculation_Functions::VALUE();
1434
- }
1435
- }
1436
- $x = (string) $x;
1437
- if (strlen($x) > preg_match_all('/[-0123456789.]/', $x, $out)) {
1438
- return PHPExcel_Calculation_Functions::VALUE();
1439
- }
1440
- $x = (string) floor($x);
1441
- $r = decoct($x);
1442
- if (strlen($r) == 11) {
1443
- // Two's Complement
1444
- $r = substr($r, -10);
1445
- }
1446
-
1447
- return self::nbrConversionFormat($r, $places);
1448
- }
1449
-
1450
-
1451
- /**
1452
- * HEXTOBIN
1453
- *
1454
- * Return a hex value as binary.
1455
- *
1456
- * Excel Function:
1457
- * HEX2BIN(x[,places])
1458
- *
1459
- * @access public
1460
- * @category Engineering Functions
1461
- * @param string $x the hexadecimal number you want to convert. Number cannot
1462
- * contain more than 10 characters. The most significant bit of
1463
- * number is the sign bit (40th bit from the right). The remaining
1464
- * 9 bits are magnitude bits. Negative numbers are represented
1465
- * using two's-complement notation.
1466
- * If number is negative, HEX2BIN ignores places and returns a
1467
- * 10-character binary number.
1468
- * If number is negative, it cannot be less than FFFFFFFE00, and
1469
- * if number is positive, it cannot be greater than 1FF.
1470
- * If number is not a valid hexadecimal number, HEX2BIN returns
1471
- * the #NUM! error value.
1472
- * If HEX2BIN requires more than places characters, it returns
1473
- * the #NUM! error value.
1474
- * @param integer $places The number of characters to use. If places is omitted,
1475
- * HEX2BIN uses the minimum number of characters necessary. Places
1476
- * is useful for padding the return value with leading 0s (zeros).
1477
- * If places is not an integer, it is truncated.
1478
- * If places is nonnumeric, HEX2BIN returns the #VALUE! error value.
1479
- * If places is negative, HEX2BIN returns the #NUM! error value.
1480
- * @return string
1481
- */
1482
- public static function HEXTOBIN($x, $places = null)
1483
- {
1484
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1485
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1486
-
1487
- if (is_bool($x)) {
1488
- return PHPExcel_Calculation_Functions::VALUE();
1489
- }
1490
- $x = (string) $x;
1491
- if (strlen($x) > preg_match_all('/[0123456789ABCDEF]/', strtoupper($x), $out)) {
1492
- return PHPExcel_Calculation_Functions::NaN();
1493
- }
1494
- $binVal = decbin(hexdec($x));
1495
-
1496
- return substr(self::nbrConversionFormat($binVal, $places), -10);
1497
- }
1498
-
1499
-
1500
- /**
1501
- * HEXTODEC
1502
- *
1503
- * Return a hex value as decimal.
1504
- *
1505
- * Excel Function:
1506
- * HEX2DEC(x)
1507
- *
1508
- * @access public
1509
- * @category Engineering Functions
1510
- * @param string $x The hexadecimal number you want to convert. This number cannot
1511
- * contain more than 10 characters (40 bits). The most significant
1512
- * bit of number is the sign bit. The remaining 39 bits are magnitude
1513
- * bits. Negative numbers are represented using two's-complement
1514
- * notation.
1515
- * If number is not a valid hexadecimal number, HEX2DEC returns the
1516
- * #NUM! error value.
1517
- * @return string
1518
- */
1519
- public static function HEXTODEC($x)
1520
- {
1521
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1522
-
1523
- if (is_bool($x)) {
1524
- return PHPExcel_Calculation_Functions::VALUE();
1525
- }
1526
- $x = (string) $x;
1527
- if (strlen($x) > preg_match_all('/[0123456789ABCDEF]/', strtoupper($x), $out)) {
1528
- return PHPExcel_Calculation_Functions::NaN();
1529
- }
1530
- return hexdec($x);
1531
- }
1532
-
1533
-
1534
- /**
1535
- * HEXTOOCT
1536
- *
1537
- * Return a hex value as octal.
1538
- *
1539
- * Excel Function:
1540
- * HEX2OCT(x[,places])
1541
- *
1542
- * @access public
1543
- * @category Engineering Functions
1544
- * @param string $x The hexadecimal number you want to convert. Number cannot
1545
- * contain more than 10 characters. The most significant bit of
1546
- * number is the sign bit. The remaining 39 bits are magnitude
1547
- * bits. Negative numbers are represented using two's-complement
1548
- * notation.
1549
- * If number is negative, HEX2OCT ignores places and returns a
1550
- * 10-character octal number.
1551
- * If number is negative, it cannot be less than FFE0000000, and
1552
- * if number is positive, it cannot be greater than 1FFFFFFF.
1553
- * If number is not a valid hexadecimal number, HEX2OCT returns
1554
- * the #NUM! error value.
1555
- * If HEX2OCT requires more than places characters, it returns
1556
- * the #NUM! error value.
1557
- * @param integer $places The number of characters to use. If places is omitted, HEX2OCT
1558
- * uses the minimum number of characters necessary. Places is
1559
- * useful for padding the return value with leading 0s (zeros).
1560
- * If places is not an integer, it is truncated.
1561
- * If places is nonnumeric, HEX2OCT returns the #VALUE! error
1562
- * value.
1563
- * If places is negative, HEX2OCT returns the #NUM! error value.
1564
- * @return string
1565
- */
1566
- public static function HEXTOOCT($x, $places = null)
1567
- {
1568
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1569
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1570
-
1571
- if (is_bool($x)) {
1572
- return PHPExcel_Calculation_Functions::VALUE();
1573
- }
1574
- $x = (string) $x;
1575
- if (strlen($x) > preg_match_all('/[0123456789ABCDEF]/', strtoupper($x), $out)) {
1576
- return PHPExcel_Calculation_Functions::NaN();
1577
- }
1578
- $octVal = decoct(hexdec($x));
1579
-
1580
- return self::nbrConversionFormat($octVal, $places);
1581
- } // function HEXTOOCT()
1582
-
1583
-
1584
- /**
1585
- * OCTTOBIN
1586
- *
1587
- * Return an octal value as binary.
1588
- *
1589
- * Excel Function:
1590
- * OCT2BIN(x[,places])
1591
- *
1592
- * @access public
1593
- * @category Engineering Functions
1594
- * @param string $x The octal number you want to convert. Number may not
1595
- * contain more than 10 characters. The most significant
1596
- * bit of number is the sign bit. The remaining 29 bits
1597
- * are magnitude bits. Negative numbers are represented
1598
- * using two's-complement notation.
1599
- * If number is negative, OCT2BIN ignores places and returns
1600
- * a 10-character binary number.
1601
- * If number is negative, it cannot be less than 7777777000,
1602
- * and if number is positive, it cannot be greater than 777.
1603
- * If number is not a valid octal number, OCT2BIN returns
1604
- * the #NUM! error value.
1605
- * If OCT2BIN requires more than places characters, it
1606
- * returns the #NUM! error value.
1607
- * @param integer $places The number of characters to use. If places is omitted,
1608
- * OCT2BIN uses the minimum number of characters necessary.
1609
- * Places is useful for padding the return value with
1610
- * leading 0s (zeros).
1611
- * If places is not an integer, it is truncated.
1612
- * If places is nonnumeric, OCT2BIN returns the #VALUE!
1613
- * error value.
1614
- * If places is negative, OCT2BIN returns the #NUM! error
1615
- * value.
1616
- * @return string
1617
- */
1618
- public static function OCTTOBIN($x, $places = null)
1619
- {
1620
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1621
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1622
-
1623
- if (is_bool($x)) {
1624
- return PHPExcel_Calculation_Functions::VALUE();
1625
- }
1626
- $x = (string) $x;
1627
- if (preg_match_all('/[01234567]/', $x, $out) != strlen($x)) {
1628
- return PHPExcel_Calculation_Functions::NaN();
1629
- }
1630
- $r = decbin(octdec($x));
1631
-
1632
- return self::nbrConversionFormat($r, $places);
1633
- }
1634
-
1635
-
1636
- /**
1637
- * OCTTODEC
1638
- *
1639
- * Return an octal value as decimal.
1640
- *
1641
- * Excel Function:
1642
- * OCT2DEC(x)
1643
- *
1644
- * @access public
1645
- * @category Engineering Functions
1646
- * @param string $x The octal number you want to convert. Number may not contain
1647
- * more than 10 octal characters (30 bits). The most significant
1648
- * bit of number is the sign bit. The remaining 29 bits are
1649
- * magnitude bits. Negative numbers are represented using
1650
- * two's-complement notation.
1651
- * If number is not a valid octal number, OCT2DEC returns the
1652
- * #NUM! error value.
1653
- * @return string
1654
- */
1655
- public static function OCTTODEC($x)
1656
- {
1657
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1658
-
1659
- if (is_bool($x)) {
1660
- return PHPExcel_Calculation_Functions::VALUE();
1661
- }
1662
- $x = (string) $x;
1663
- if (preg_match_all('/[01234567]/', $x, $out) != strlen($x)) {
1664
- return PHPExcel_Calculation_Functions::NaN();
1665
- }
1666
- return octdec($x);
1667
- }
1668
-
1669
-
1670
- /**
1671
- * OCTTOHEX
1672
- *
1673
- * Return an octal value as hex.
1674
- *
1675
- * Excel Function:
1676
- * OCT2HEX(x[,places])
1677
- *
1678
- * @access public
1679
- * @category Engineering Functions
1680
- * @param string $x The octal number you want to convert. Number may not contain
1681
- * more than 10 octal characters (30 bits). The most significant
1682
- * bit of number is the sign bit. The remaining 29 bits are
1683
- * magnitude bits. Negative numbers are represented using
1684
- * two's-complement notation.
1685
- * If number is negative, OCT2HEX ignores places and returns a
1686
- * 10-character hexadecimal number.
1687
- * If number is not a valid octal number, OCT2HEX returns the
1688
- * #NUM! error value.
1689
- * If OCT2HEX requires more than places characters, it returns
1690
- * the #NUM! error value.
1691
- * @param integer $places The number of characters to use. If places is omitted, OCT2HEX
1692
- * uses the minimum number of characters necessary. Places is useful
1693
- * for padding the return value with leading 0s (zeros).
1694
- * If places is not an integer, it is truncated.
1695
- * If places is nonnumeric, OCT2HEX returns the #VALUE! error value.
1696
- * If places is negative, OCT2HEX returns the #NUM! error value.
1697
- * @return string
1698
- */
1699
- public static function OCTTOHEX($x, $places = null)
1700
- {
1701
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
1702
- $places = PHPExcel_Calculation_Functions::flattenSingleValue($places);
1703
-
1704
- if (is_bool($x)) {
1705
- return PHPExcel_Calculation_Functions::VALUE();
1706
- }
1707
- $x = (string) $x;
1708
- if (preg_match_all('/[01234567]/', $x, $out) != strlen($x)) {
1709
- return PHPExcel_Calculation_Functions::NaN();
1710
- }
1711
- $hexVal = strtoupper(dechex(octdec($x)));
1712
-
1713
- return self::nbrConversionFormat($hexVal, $places);
1714
- }
1715
-
1716
-
1717
- /**
1718
- * COMPLEX
1719
- *
1720
- * Converts real and imaginary coefficients into a complex number of the form x + yi or x + yj.
1721
- *
1722
- * Excel Function:
1723
- * COMPLEX(realNumber,imaginary[,places])
1724
- *
1725
- * @access public
1726
- * @category Engineering Functions
1727
- * @param float $realNumber The real coefficient of the complex number.
1728
- * @param float $imaginary The imaginary coefficient of the complex number.
1729
- * @param string $suffix The suffix for the imaginary component of the complex number.
1730
- * If omitted, the suffix is assumed to be "i".
1731
- * @return string
1732
- */
1733
- public static function COMPLEX($realNumber = 0.0, $imaginary = 0.0, $suffix = 'i')
1734
- {
1735
- $realNumber = (is_null($realNumber)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($realNumber);
1736
- $imaginary = (is_null($imaginary)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($imaginary);
1737
- $suffix = (is_null($suffix)) ? 'i' : PHPExcel_Calculation_Functions::flattenSingleValue($suffix);
1738
-
1739
- if (((is_numeric($realNumber)) && (is_numeric($imaginary))) &&
1740
- (($suffix == 'i') || ($suffix == 'j') || ($suffix == ''))) {
1741
- $realNumber = (float) $realNumber;
1742
- $imaginary = (float) $imaginary;
1743
-
1744
- if ($suffix == '') {
1745
- $suffix = 'i';
1746
- }
1747
- if ($realNumber == 0.0) {
1748
- if ($imaginary == 0.0) {
1749
- return (string) '0';
1750
- } elseif ($imaginary == 1.0) {
1751
- return (string) $suffix;
1752
- } elseif ($imaginary == -1.0) {
1753
- return (string) '-'.$suffix;
1754
- }
1755
- return (string) $imaginary.$suffix;
1756
- } elseif ($imaginary == 0.0) {
1757
- return (string) $realNumber;
1758
- } elseif ($imaginary == 1.0) {
1759
- return (string) $realNumber.'+'.$suffix;
1760
- } elseif ($imaginary == -1.0) {
1761
- return (string) $realNumber.'-'.$suffix;
1762
- }
1763
- if ($imaginary > 0) {
1764
- $imaginary = (string) '+'.$imaginary;
1765
- }
1766
- return (string) $realNumber.$imaginary.$suffix;
1767
- }
1768
-
1769
- return PHPExcel_Calculation_Functions::VALUE();
1770
- }
1771
-
1772
-
1773
- /**
1774
- * IMAGINARY
1775
- *
1776
- * Returns the imaginary coefficient of a complex number in x + yi or x + yj text format.
1777
- *
1778
- * Excel Function:
1779
- * IMAGINARY(complexNumber)
1780
- *
1781
- * @access public
1782
- * @category Engineering Functions
1783
- * @param string $complexNumber The complex number for which you want the imaginary
1784
- * coefficient.
1785
- * @return float
1786
- */
1787
- public static function IMAGINARY($complexNumber)
1788
- {
1789
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1790
-
1791
- $parsedComplex = self::parseComplex($complexNumber);
1792
- return $parsedComplex['imaginary'];
1793
- }
1794
-
1795
-
1796
- /**
1797
- * IMREAL
1798
- *
1799
- * Returns the real coefficient of a complex number in x + yi or x + yj text format.
1800
- *
1801
- * Excel Function:
1802
- * IMREAL(complexNumber)
1803
- *
1804
- * @access public
1805
- * @category Engineering Functions
1806
- * @param string $complexNumber The complex number for which you want the real coefficient.
1807
- * @return float
1808
- */
1809
- public static function IMREAL($complexNumber)
1810
- {
1811
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1812
-
1813
- $parsedComplex = self::parseComplex($complexNumber);
1814
- return $parsedComplex['real'];
1815
- }
1816
-
1817
-
1818
- /**
1819
- * IMABS
1820
- *
1821
- * Returns the absolute value (modulus) of a complex number in x + yi or x + yj text format.
1822
- *
1823
- * Excel Function:
1824
- * IMABS(complexNumber)
1825
- *
1826
- * @param string $complexNumber The complex number for which you want the absolute value.
1827
- * @return float
1828
- */
1829
- public static function IMABS($complexNumber)
1830
- {
1831
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1832
-
1833
- $parsedComplex = self::parseComplex($complexNumber);
1834
-
1835
- return sqrt(
1836
- ($parsedComplex['real'] * $parsedComplex['real']) +
1837
- ($parsedComplex['imaginary'] * $parsedComplex['imaginary'])
1838
- );
1839
- }
1840
-
1841
-
1842
- /**
1843
- * IMARGUMENT
1844
- *
1845
- * Returns the argument theta of a complex number, i.e. the angle in radians from the real
1846
- * axis to the representation of the number in polar coordinates.
1847
- *
1848
- * Excel Function:
1849
- * IMARGUMENT(complexNumber)
1850
- *
1851
- * @param string $complexNumber The complex number for which you want the argument theta.
1852
- * @return float
1853
- */
1854
- public static function IMARGUMENT($complexNumber)
1855
- {
1856
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1857
-
1858
- $parsedComplex = self::parseComplex($complexNumber);
1859
-
1860
- if ($parsedComplex['real'] == 0.0) {
1861
- if ($parsedComplex['imaginary'] == 0.0) {
1862
- return 0.0;
1863
- } elseif ($parsedComplex['imaginary'] < 0.0) {
1864
- return M_PI / -2;
1865
- } else {
1866
- return M_PI / 2;
1867
- }
1868
- } elseif ($parsedComplex['real'] > 0.0) {
1869
- return atan($parsedComplex['imaginary'] / $parsedComplex['real']);
1870
- } elseif ($parsedComplex['imaginary'] < 0.0) {
1871
- return 0 - (M_PI - atan(abs($parsedComplex['imaginary']) / abs($parsedComplex['real'])));
1872
- } else {
1873
- return M_PI - atan($parsedComplex['imaginary'] / abs($parsedComplex['real']));
1874
- }
1875
- }
1876
-
1877
-
1878
- /**
1879
- * IMCONJUGATE
1880
- *
1881
- * Returns the complex conjugate of a complex number in x + yi or x + yj text format.
1882
- *
1883
- * Excel Function:
1884
- * IMCONJUGATE(complexNumber)
1885
- *
1886
- * @param string $complexNumber The complex number for which you want the conjugate.
1887
- * @return string
1888
- */
1889
- public static function IMCONJUGATE($complexNumber)
1890
- {
1891
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1892
-
1893
- $parsedComplex = self::parseComplex($complexNumber);
1894
-
1895
- if ($parsedComplex['imaginary'] == 0.0) {
1896
- return $parsedComplex['real'];
1897
- } else {
1898
- return self::cleanComplex(
1899
- self::COMPLEX(
1900
- $parsedComplex['real'],
1901
- 0 - $parsedComplex['imaginary'],
1902
- $parsedComplex['suffix']
1903
- )
1904
- );
1905
- }
1906
- }
1907
-
1908
-
1909
- /**
1910
- * IMCOS
1911
- *
1912
- * Returns the cosine of a complex number in x + yi or x + yj text format.
1913
- *
1914
- * Excel Function:
1915
- * IMCOS(complexNumber)
1916
- *
1917
- * @param string $complexNumber The complex number for which you want the cosine.
1918
- * @return string|float
1919
- */
1920
- public static function IMCOS($complexNumber)
1921
- {
1922
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1923
-
1924
- $parsedComplex = self::parseComplex($complexNumber);
1925
-
1926
- if ($parsedComplex['imaginary'] == 0.0) {
1927
- return cos($parsedComplex['real']);
1928
- } else {
1929
- return self::IMCONJUGATE(
1930
- self::COMPLEX(
1931
- cos($parsedComplex['real']) * cosh($parsedComplex['imaginary']),
1932
- sin($parsedComplex['real']) * sinh($parsedComplex['imaginary']),
1933
- $parsedComplex['suffix']
1934
- )
1935
- );
1936
- }
1937
- }
1938
-
1939
-
1940
- /**
1941
- * IMSIN
1942
- *
1943
- * Returns the sine of a complex number in x + yi or x + yj text format.
1944
- *
1945
- * Excel Function:
1946
- * IMSIN(complexNumber)
1947
- *
1948
- * @param string $complexNumber The complex number for which you want the sine.
1949
- * @return string|float
1950
- */
1951
- public static function IMSIN($complexNumber)
1952
- {
1953
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1954
-
1955
- $parsedComplex = self::parseComplex($complexNumber);
1956
-
1957
- if ($parsedComplex['imaginary'] == 0.0) {
1958
- return sin($parsedComplex['real']);
1959
- } else {
1960
- return self::COMPLEX(
1961
- sin($parsedComplex['real']) * cosh($parsedComplex['imaginary']),
1962
- cos($parsedComplex['real']) * sinh($parsedComplex['imaginary']),
1963
- $parsedComplex['suffix']
1964
- );
1965
- }
1966
- }
1967
-
1968
-
1969
- /**
1970
- * IMSQRT
1971
- *
1972
- * Returns the square root of a complex number in x + yi or x + yj text format.
1973
- *
1974
- * Excel Function:
1975
- * IMSQRT(complexNumber)
1976
- *
1977
- * @param string $complexNumber The complex number for which you want the square root.
1978
- * @return string
1979
- */
1980
- public static function IMSQRT($complexNumber)
1981
- {
1982
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
1983
-
1984
- $parsedComplex = self::parseComplex($complexNumber);
1985
-
1986
- $theta = self::IMARGUMENT($complexNumber);
1987
- $d1 = cos($theta / 2);
1988
- $d2 = sin($theta / 2);
1989
- $r = sqrt(sqrt(($parsedComplex['real'] * $parsedComplex['real']) + ($parsedComplex['imaginary'] * $parsedComplex['imaginary'])));
1990
-
1991
- if ($parsedComplex['suffix'] == '') {
1992
- return self::COMPLEX($d1 * $r, $d2 * $r);
1993
- } else {
1994
- return self::COMPLEX($d1 * $r, $d2 * $r, $parsedComplex['suffix']);
1995
- }
1996
- }
1997
-
1998
-
1999
- /**
2000
- * IMLN
2001
- *
2002
- * Returns the natural logarithm of a complex number in x + yi or x + yj text format.
2003
- *
2004
- * Excel Function:
2005
- * IMLN(complexNumber)
2006
- *
2007
- * @param string $complexNumber The complex number for which you want the natural logarithm.
2008
- * @return string
2009
- */
2010
- public static function IMLN($complexNumber)
2011
- {
2012
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
2013
-
2014
- $parsedComplex = self::parseComplex($complexNumber);
2015
-
2016
- if (($parsedComplex['real'] == 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2017
- return PHPExcel_Calculation_Functions::NaN();
2018
- }
2019
-
2020
- $logR = log(sqrt(($parsedComplex['real'] * $parsedComplex['real']) + ($parsedComplex['imaginary'] * $parsedComplex['imaginary'])));
2021
- $t = self::IMARGUMENT($complexNumber);
2022
-
2023
- if ($parsedComplex['suffix'] == '') {
2024
- return self::COMPLEX($logR, $t);
2025
- } else {
2026
- return self::COMPLEX($logR, $t, $parsedComplex['suffix']);
2027
- }
2028
- }
2029
-
2030
-
2031
- /**
2032
- * IMLOG10
2033
- *
2034
- * Returns the common logarithm (base 10) of a complex number in x + yi or x + yj text format.
2035
- *
2036
- * Excel Function:
2037
- * IMLOG10(complexNumber)
2038
- *
2039
- * @param string $complexNumber The complex number for which you want the common logarithm.
2040
- * @return string
2041
- */
2042
- public static function IMLOG10($complexNumber)
2043
- {
2044
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
2045
-
2046
- $parsedComplex = self::parseComplex($complexNumber);
2047
-
2048
- if (($parsedComplex['real'] == 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2049
- return PHPExcel_Calculation_Functions::NaN();
2050
- } elseif (($parsedComplex['real'] > 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2051
- return log10($parsedComplex['real']);
2052
- }
2053
-
2054
- return self::IMPRODUCT(log10(EULER), self::IMLN($complexNumber));
2055
- }
2056
-
2057
-
2058
- /**
2059
- * IMLOG2
2060
- *
2061
- * Returns the base-2 logarithm of a complex number in x + yi or x + yj text format.
2062
- *
2063
- * Excel Function:
2064
- * IMLOG2(complexNumber)
2065
- *
2066
- * @param string $complexNumber The complex number for which you want the base-2 logarithm.
2067
- * @return string
2068
- */
2069
- public static function IMLOG2($complexNumber)
2070
- {
2071
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
2072
-
2073
- $parsedComplex = self::parseComplex($complexNumber);
2074
-
2075
- if (($parsedComplex['real'] == 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2076
- return PHPExcel_Calculation_Functions::NaN();
2077
- } elseif (($parsedComplex['real'] > 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2078
- return log($parsedComplex['real'], 2);
2079
- }
2080
-
2081
- return self::IMPRODUCT(log(EULER, 2), self::IMLN($complexNumber));
2082
- }
2083
-
2084
-
2085
- /**
2086
- * IMEXP
2087
- *
2088
- * Returns the exponential of a complex number in x + yi or x + yj text format.
2089
- *
2090
- * Excel Function:
2091
- * IMEXP(complexNumber)
2092
- *
2093
- * @param string $complexNumber The complex number for which you want the exponential.
2094
- * @return string
2095
- */
2096
- public static function IMEXP($complexNumber)
2097
- {
2098
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
2099
-
2100
- $parsedComplex = self::parseComplex($complexNumber);
2101
-
2102
- if (($parsedComplex['real'] == 0.0) && ($parsedComplex['imaginary'] == 0.0)) {
2103
- return '1';
2104
- }
2105
-
2106
- $e = exp($parsedComplex['real']);
2107
- $eX = $e * cos($parsedComplex['imaginary']);
2108
- $eY = $e * sin($parsedComplex['imaginary']);
2109
-
2110
- if ($parsedComplex['suffix'] == '') {
2111
- return self::COMPLEX($eX, $eY);
2112
- } else {
2113
- return self::COMPLEX($eX, $eY, $parsedComplex['suffix']);
2114
- }
2115
- }
2116
-
2117
-
2118
- /**
2119
- * IMPOWER
2120
- *
2121
- * Returns a complex number in x + yi or x + yj text format raised to a power.
2122
- *
2123
- * Excel Function:
2124
- * IMPOWER(complexNumber,realNumber)
2125
- *
2126
- * @param string $complexNumber The complex number you want to raise to a power.
2127
- * @param float $realNumber The power to which you want to raise the complex number.
2128
- * @return string
2129
- */
2130
- public static function IMPOWER($complexNumber, $realNumber)
2131
- {
2132
- $complexNumber = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber);
2133
- $realNumber = PHPExcel_Calculation_Functions::flattenSingleValue($realNumber);
2134
-
2135
- if (!is_numeric($realNumber)) {
2136
- return PHPExcel_Calculation_Functions::VALUE();
2137
- }
2138
-
2139
- $parsedComplex = self::parseComplex($complexNumber);
2140
-
2141
- $r = sqrt(($parsedComplex['real'] * $parsedComplex['real']) + ($parsedComplex['imaginary'] * $parsedComplex['imaginary']));
2142
- $rPower = pow($r, $realNumber);
2143
- $theta = self::IMARGUMENT($complexNumber) * $realNumber;
2144
- if ($theta == 0) {
2145
- return 1;
2146
- } elseif ($parsedComplex['imaginary'] == 0.0) {
2147
- return self::COMPLEX($rPower * cos($theta), $rPower * sin($theta), $parsedComplex['suffix']);
2148
- } else {
2149
- return self::COMPLEX($rPower * cos($theta), $rPower * sin($theta), $parsedComplex['suffix']);
2150
- }
2151
- }
2152
-
2153
-
2154
- /**
2155
- * IMDIV
2156
- *
2157
- * Returns the quotient of two complex numbers in x + yi or x + yj text format.
2158
- *
2159
- * Excel Function:
2160
- * IMDIV(complexDividend,complexDivisor)
2161
- *
2162
- * @param string $complexDividend The complex numerator or dividend.
2163
- * @param string $complexDivisor The complex denominator or divisor.
2164
- * @return string
2165
- */
2166
- public static function IMDIV($complexDividend, $complexDivisor)
2167
- {
2168
- $complexDividend = PHPExcel_Calculation_Functions::flattenSingleValue($complexDividend);
2169
- $complexDivisor = PHPExcel_Calculation_Functions::flattenSingleValue($complexDivisor);
2170
-
2171
- $parsedComplexDividend = self::parseComplex($complexDividend);
2172
- $parsedComplexDivisor = self::parseComplex($complexDivisor);
2173
-
2174
- if (($parsedComplexDividend['suffix'] != '') && ($parsedComplexDivisor['suffix'] != '') &&
2175
- ($parsedComplexDividend['suffix'] != $parsedComplexDivisor['suffix'])) {
2176
- return PHPExcel_Calculation_Functions::NaN();
2177
- }
2178
- if (($parsedComplexDividend['suffix'] != '') && ($parsedComplexDivisor['suffix'] == '')) {
2179
- $parsedComplexDivisor['suffix'] = $parsedComplexDividend['suffix'];
2180
- }
2181
-
2182
- $d1 = ($parsedComplexDividend['real'] * $parsedComplexDivisor['real']) + ($parsedComplexDividend['imaginary'] * $parsedComplexDivisor['imaginary']);
2183
- $d2 = ($parsedComplexDividend['imaginary'] * $parsedComplexDivisor['real']) - ($parsedComplexDividend['real'] * $parsedComplexDivisor['imaginary']);
2184
- $d3 = ($parsedComplexDivisor['real'] * $parsedComplexDivisor['real']) + ($parsedComplexDivisor['imaginary'] * $parsedComplexDivisor['imaginary']);
2185
-
2186
- $r = $d1 / $d3;
2187
- $i = $d2 / $d3;
2188
-
2189
- if ($i > 0.0) {
2190
- return self::cleanComplex($r.'+'.$i.$parsedComplexDivisor['suffix']);
2191
- } elseif ($i < 0.0) {
2192
- return self::cleanComplex($r.$i.$parsedComplexDivisor['suffix']);
2193
- } else {
2194
- return $r;
2195
- }
2196
- }
2197
-
2198
-
2199
- /**
2200
- * IMSUB
2201
- *
2202
- * Returns the difference of two complex numbers in x + yi or x + yj text format.
2203
- *
2204
- * Excel Function:
2205
- * IMSUB(complexNumber1,complexNumber2)
2206
- *
2207
- * @param string $complexNumber1 The complex number from which to subtract complexNumber2.
2208
- * @param string $complexNumber2 The complex number to subtract from complexNumber1.
2209
- * @return string
2210
- */
2211
- public static function IMSUB($complexNumber1, $complexNumber2)
2212
- {
2213
- $complexNumber1 = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber1);
2214
- $complexNumber2 = PHPExcel_Calculation_Functions::flattenSingleValue($complexNumber2);
2215
-
2216
- $parsedComplex1 = self::parseComplex($complexNumber1);
2217
- $parsedComplex2 = self::parseComplex($complexNumber2);
2218
-
2219
- if ((($parsedComplex1['suffix'] != '') && ($parsedComplex2['suffix'] != '')) &&
2220
- ($parsedComplex1['suffix'] != $parsedComplex2['suffix'])) {
2221
- return PHPExcel_Calculation_Functions::NaN();
2222
- } elseif (($parsedComplex1['suffix'] == '') && ($parsedComplex2['suffix'] != '')) {
2223
- $parsedComplex1['suffix'] = $parsedComplex2['suffix'];
2224
- }
2225
-
2226
- $d1 = $parsedComplex1['real'] - $parsedComplex2['real'];
2227
- $d2 = $parsedComplex1['imaginary'] - $parsedComplex2['imaginary'];
2228
-
2229
- return self::COMPLEX($d1, $d2, $parsedComplex1['suffix']);
2230
- }
2231
-
2232
-
2233
- /**
2234
- * IMSUM
2235
- *
2236
- * Returns the sum of two or more complex numbers in x + yi or x + yj text format.
2237
- *
2238
- * Excel Function:
2239
- * IMSUM(complexNumber[,complexNumber[,...]])
2240
- *
2241
- * @param string $complexNumber,... Series of complex numbers to add
2242
- * @return string
2243
- */
2244
- public static function IMSUM()
2245
- {
2246
- // Return value
2247
- $returnValue = self::parseComplex('0');
2248
- $activeSuffix = '';
2249
-
2250
- // Loop through the arguments
2251
- $aArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
2252
- foreach ($aArgs as $arg) {
2253
- $parsedComplex = self::parseComplex($arg);
2254
-
2255
- if ($activeSuffix == '') {
2256
- $activeSuffix = $parsedComplex['suffix'];
2257
- } elseif (($parsedComplex['suffix'] != '') && ($activeSuffix != $parsedComplex['suffix'])) {
2258
- return PHPExcel_Calculation_Functions::VALUE();
2259
- }
2260
-
2261
- $returnValue['real'] += $parsedComplex['real'];
2262
- $returnValue['imaginary'] += $parsedComplex['imaginary'];
2263
- }
2264
-
2265
- if ($returnValue['imaginary'] == 0.0) {
2266
- $activeSuffix = '';
2267
- }
2268
- return self::COMPLEX($returnValue['real'], $returnValue['imaginary'], $activeSuffix);
2269
- }
2270
-
2271
-
2272
- /**
2273
- * IMPRODUCT
2274
- *
2275
- * Returns the product of two or more complex numbers in x + yi or x + yj text format.
2276
- *
2277
- * Excel Function:
2278
- * IMPRODUCT(complexNumber[,complexNumber[,...]])
2279
- *
2280
- * @param string $complexNumber,... Series of complex numbers to multiply
2281
- * @return string
2282
- */
2283
- public static function IMPRODUCT()
2284
- {
2285
- // Return value
2286
- $returnValue = self::parseComplex('1');
2287
- $activeSuffix = '';
2288
-
2289
- // Loop through the arguments
2290
- $aArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
2291
- foreach ($aArgs as $arg) {
2292
- $parsedComplex = self::parseComplex($arg);
2293
-
2294
- $workValue = $returnValue;
2295
- if (($parsedComplex['suffix'] != '') && ($activeSuffix == '')) {
2296
- $activeSuffix = $parsedComplex['suffix'];
2297
- } elseif (($parsedComplex['suffix'] != '') && ($activeSuffix != $parsedComplex['suffix'])) {
2298
- return PHPExcel_Calculation_Functions::NaN();
2299
- }
2300
- $returnValue['real'] = ($workValue['real'] * $parsedComplex['real']) - ($workValue['imaginary'] * $parsedComplex['imaginary']);
2301
- $returnValue['imaginary'] = ($workValue['real'] * $parsedComplex['imaginary']) + ($workValue['imaginary'] * $parsedComplex['real']);
2302
- }
2303
-
2304
- if ($returnValue['imaginary'] == 0.0) {
2305
- $activeSuffix = '';
2306
- }
2307
- return self::COMPLEX($returnValue['real'], $returnValue['imaginary'], $activeSuffix);
2308
- }
2309
-
2310
-
2311
- /**
2312
- * DELTA
2313
- *
2314
- * Tests whether two values are equal. Returns 1 if number1 = number2; returns 0 otherwise.
2315
- * Use this function to filter a set of values. For example, by summing several DELTA
2316
- * functions you calculate the count of equal pairs. This function is also known as the
2317
- * Kronecker Delta function.
2318
- *
2319
- * Excel Function:
2320
- * DELTA(a[,b])
2321
- *
2322
- * @param float $a The first number.
2323
- * @param float $b The second number. If omitted, b is assumed to be zero.
2324
- * @return int
2325
- */
2326
- public static function DELTA($a, $b = 0)
2327
- {
2328
- $a = PHPExcel_Calculation_Functions::flattenSingleValue($a);
2329
- $b = PHPExcel_Calculation_Functions::flattenSingleValue($b);
2330
-
2331
- return (int) ($a == $b);
2332
- }
2333
-
2334
-
2335
- /**
2336
- * GESTEP
2337
- *
2338
- * Excel Function:
2339
- * GESTEP(number[,step])
2340
- *
2341
- * Returns 1 if number >= step; returns 0 (zero) otherwise
2342
- * Use this function to filter a set of values. For example, by summing several GESTEP
2343
- * functions you calculate the count of values that exceed a threshold.
2344
- *
2345
- * @param float $number The value to test against step.
2346
- * @param float $step The threshold value.
2347
- * If you omit a value for step, GESTEP uses zero.
2348
- * @return int
2349
- */
2350
- public static function GESTEP($number, $step = 0)
2351
- {
2352
- $number = PHPExcel_Calculation_Functions::flattenSingleValue($number);
2353
- $step = PHPExcel_Calculation_Functions::flattenSingleValue($step);
2354
-
2355
- return (int) ($number >= $step);
2356
- }
2357
-
2358
-
2359
- //
2360
- // Private method to calculate the erf value
2361
- //
2362
- private static $twoSqrtPi = 1.128379167095512574;
2363
-
2364
- public static function erfVal($x)
2365
- {
2366
- if (abs($x) > 2.2) {
2367
- return 1 - self::erfcVal($x);
2368
- }
2369
- $sum = $term = $x;
2370
- $xsqr = ($x * $x);
2371
- $j = 1;
2372
- do {
2373
- $term *= $xsqr / $j;
2374
- $sum -= $term / (2 * $j + 1);
2375
- ++$j;
2376
- $term *= $xsqr / $j;
2377
- $sum += $term / (2 * $j + 1);
2378
- ++$j;
2379
- if ($sum == 0.0) {
2380
- break;
2381
- }
2382
- } while (abs($term / $sum) > PRECISION);
2383
- return self::$twoSqrtPi * $sum;
2384
- }
2385
-
2386
-
2387
- /**
2388
- * ERF
2389
- *
2390
- * Returns the error function integrated between the lower and upper bound arguments.
2391
- *
2392
- * Note: In Excel 2007 or earlier, if you input a negative value for the upper or lower bound arguments,
2393
- * the function would return a #NUM! error. However, in Excel 2010, the function algorithm was
2394
- * improved, so that it can now calculate the function for both positive and negative ranges.
2395
- * PHPExcel follows Excel 2010 behaviour, and accepts nagative arguments.
2396
- *
2397
- * Excel Function:
2398
- * ERF(lower[,upper])
2399
- *
2400
- * @param float $lower lower bound for integrating ERF
2401
- * @param float $upper upper bound for integrating ERF.
2402
- * If omitted, ERF integrates between zero and lower_limit
2403
- * @return float
2404
- */
2405
- public static function ERF($lower, $upper = null)
2406
- {
2407
- $lower = PHPExcel_Calculation_Functions::flattenSingleValue($lower);
2408
- $upper = PHPExcel_Calculation_Functions::flattenSingleValue($upper);
2409
-
2410
- if (is_numeric($lower)) {
2411
- if (is_null($upper)) {
2412
- return self::erfVal($lower);
2413
- }
2414
- if (is_numeric($upper)) {
2415
- return self::erfVal($upper) - self::erfVal($lower);
2416
- }
2417
- }
2418
- return PHPExcel_Calculation_Functions::VALUE();
2419
- }
2420
-
2421
-
2422
- //
2423
- // Private method to calculate the erfc value
2424
- //
2425
- private static $oneSqrtPi = 0.564189583547756287;
2426
-
2427
- private static function erfcVal($x)
2428
- {
2429
- if (abs($x) < 2.2) {
2430
- return 1 - self::erfVal($x);
2431
- }
2432
- if ($x < 0) {
2433
- return 2 - self::ERFC(-$x);
2434
- }
2435
- $a = $n = 1;
2436
- $b = $c = $x;
2437
- $d = ($x * $x) + 0.5;
2438
- $q1 = $q2 = $b / $d;
2439
- $t = 0;
2440
- do {
2441
- $t = $a * $n + $b * $x;
2442
- $a = $b;
2443
- $b = $t;
2444
- $t = $c * $n + $d * $x;
2445
- $c = $d;
2446
- $d = $t;
2447
- $n += 0.5;
2448
- $q1 = $q2;
2449
- $q2 = $b / $d;
2450
- } while ((abs($q1 - $q2) / $q2) > PRECISION);
2451
- return self::$oneSqrtPi * exp(-$x * $x) * $q2;
2452
- }
2453
-
2454
-
2455
- /**
2456
- * ERFC
2457
- *
2458
- * Returns the complementary ERF function integrated between x and infinity
2459
- *
2460
- * Note: In Excel 2007 or earlier, if you input a negative value for the lower bound argument,
2461
- * the function would return a #NUM! error. However, in Excel 2010, the function algorithm was
2462
- * improved, so that it can now calculate the function for both positive and negative x values.
2463
- * PHPExcel follows Excel 2010 behaviour, and accepts nagative arguments.
2464
- *
2465
- * Excel Function:
2466
- * ERFC(x)
2467
- *
2468
- * @param float $x The lower bound for integrating ERFC
2469
- * @return float
2470
- */
2471
- public static function ERFC($x)
2472
- {
2473
- $x = PHPExcel_Calculation_Functions::flattenSingleValue($x);
2474
-
2475
- if (is_numeric($x)) {
2476
- return self::erfcVal($x);
2477
- }
2478
- return PHPExcel_Calculation_Functions::VALUE();
2479
- }
2480
-
2481
-
2482
- /**
2483
- * getConversionGroups
2484
- * Returns a list of the different conversion groups for UOM conversions
2485
- *
2486
- * @return array
2487
- */
2488
- public static function getConversionGroups()
2489
- {
2490
- $conversionGroups = array();
2491
- foreach (self::$conversionUnits as $conversionUnit) {
2492
- $conversionGroups[] = $conversionUnit['Group'];
2493
- }
2494
- return array_merge(array_unique($conversionGroups));
2495
- }
2496
-
2497
-
2498
- /**
2499
- * getConversionGroupUnits
2500
- * Returns an array of units of measure, for a specified conversion group, or for all groups
2501
- *
2502
- * @param string $group The group whose units of measure you want to retrieve
2503
- * @return array
2504
- */
2505
- public static function getConversionGroupUnits($group = null)
2506
- {
2507
- $conversionGroups = array();
2508
- foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {
2509
- if ((is_null($group)) || ($conversionGroup['Group'] == $group)) {
2510
- $conversionGroups[$conversionGroup['Group']][] = $conversionUnit;
2511
- }
2512
- }
2513
- return $conversionGroups;
2514
- }
2515
-
2516
-
2517
- /**
2518
- * getConversionGroupUnitDetails
2519
- *
2520
- * @param string $group The group whose units of measure you want to retrieve
2521
- * @return array
2522
- */
2523
- public static function getConversionGroupUnitDetails($group = null)
2524
- {
2525
- $conversionGroups = array();
2526
- foreach (self::$conversionUnits as $conversionUnit => $conversionGroup) {
2527
- if ((is_null($group)) || ($conversionGroup['Group'] == $group)) {
2528
- $conversionGroups[$conversionGroup['Group']][] = array(
2529
- 'unit' => $conversionUnit,
2530
- 'description' => $conversionGroup['Unit Name']
2531
- );
2532
- }
2533
- }
2534
- return $conversionGroups;
2535
- }
2536
-
2537
-
2538
- /**
2539
- * getConversionMultipliers
2540
- * Returns an array of the Multiplier prefixes that can be used with Units of Measure in CONVERTUOM()
2541
- *
2542
- * @return array of mixed
2543
- */
2544
- public static function getConversionMultipliers()
2545
- {
2546
- return self::$conversionMultipliers;
2547
- }
2548
-
2549
-
2550
- /**
2551
- * CONVERTUOM
2552
- *
2553
- * Converts a number from one measurement system to another.
2554
- * For example, CONVERT can translate a table of distances in miles to a table of distances
2555
- * in kilometers.
2556
- *
2557
- * Excel Function:
2558
- * CONVERT(value,fromUOM,toUOM)
2559
- *
2560
- * @param float $value The value in fromUOM to convert.
2561
- * @param string $fromUOM The units for value.
2562
- * @param string $toUOM The units for the result.
2563
- *
2564
- * @return float
2565
- */
2566
- public static function CONVERTUOM($value, $fromUOM, $toUOM)
2567
- {
2568
- $value = PHPExcel_Calculation_Functions::flattenSingleValue($value);
2569
- $fromUOM = PHPExcel_Calculation_Functions::flattenSingleValue($fromUOM);
2570
- $toUOM = PHPExcel_Calculation_Functions::flattenSingleValue($toUOM);
2571
-
2572
- if (!is_numeric($value)) {
2573
- return PHPExcel_Calculation_Functions::VALUE();
2574
- }
2575
- $fromMultiplier = 1.0;
2576
- if (isset(self::$conversionUnits[$fromUOM])) {
2577
- $unitGroup1 = self::$conversionUnits[$fromUOM]['Group'];
2578
- } else {
2579
- $fromMultiplier = substr($fromUOM, 0, 1);
2580
- $fromUOM = substr($fromUOM, 1);
2581
- if (isset(self::$conversionMultipliers[$fromMultiplier])) {
2582
- $fromMultiplier = self::$conversionMultipliers[$fromMultiplier]['multiplier'];
2583
- } else {
2584
- return PHPExcel_Calculation_Functions::NA();
2585
- }
2586
- if ((isset(self::$conversionUnits[$fromUOM])) && (self::$conversionUnits[$fromUOM]['AllowPrefix'])) {
2587
- $unitGroup1 = self::$conversionUnits[$fromUOM]['Group'];
2588
- } else {
2589
- return PHPExcel_Calculation_Functions::NA();
2590
- }
2591
- }
2592
- $value *= $fromMultiplier;
2593
-
2594
- $toMultiplier = 1.0;
2595
- if (isset(self::$conversionUnits[$toUOM])) {
2596
- $unitGroup2 = self::$conversionUnits[$toUOM]['Group'];
2597
- } else {
2598
- $toMultiplier = substr($toUOM, 0, 1);
2599
- $toUOM = substr($toUOM, 1);
2600
- if (isset(self::$conversionMultipliers[$toMultiplier])) {
2601
- $toMultiplier = self::$conversionMultipliers[$toMultiplier]['multiplier'];
2602
- } else {
2603
- return PHPExcel_Calculation_Functions::NA();
2604
- }
2605
- if ((isset(self::$conversionUnits[$toUOM])) && (self::$conversionUnits[$toUOM]['AllowPrefix'])) {
2606
- $unitGroup2 = self::$conversionUnits[$toUOM]['Group'];
2607
- } else {
2608
- return PHPExcel_Calculation_Functions::NA();
2609
- }
2610
- }
2611
- if ($unitGroup1 != $unitGroup2) {
2612
- return PHPExcel_Calculation_Functions::NA();
2613
- }
2614
-
2615
- if (($fromUOM == $toUOM) && ($fromMultiplier == $toMultiplier)) {
2616
- // We've already factored $fromMultiplier into the value, so we need
2617
- // to reverse it again
2618
- return $value / $fromMultiplier;
2619
- } elseif ($unitGroup1 == 'Temperature') {
2620
- if (($fromUOM == 'F') || ($fromUOM == 'fah')) {
2621
- if (($toUOM == 'F') || ($toUOM == 'fah')) {
2622
- return $value;
2623
- } else {
2624
- $value = (($value - 32) / 1.8);
2625
- if (($toUOM == 'K') || ($toUOM == 'kel')) {
2626
- $value += 273.15;
2627
- }
2628
- return $value;
2629
- }
2630
- } elseif ((($fromUOM == 'K') || ($fromUOM == 'kel')) &&
2631
- (($toUOM == 'K') || ($toUOM == 'kel'))) {
2632
- return $value;
2633
- } elseif ((($fromUOM == 'C') || ($fromUOM == 'cel')) &&
2634
- (($toUOM == 'C') || ($toUOM == 'cel'))) {
2635
- return $value;
2636
- }
2637
- if (($toUOM == 'F') || ($toUOM == 'fah')) {
2638
- if (($fromUOM == 'K') || ($fromUOM == 'kel')) {
2639
- $value -= 273.15;
2640
- }
2641
- return ($value * 1.8) + 32;
2642
- }
2643
- if (($toUOM == 'C') || ($toUOM == 'cel')) {
2644
- return $value - 273.15;
2645
- }
2646
- return $value + 273.15;
2647
- }
2648
- return ($value * self::$unitConversions[$unitGroup1][$fromUOM][$toUOM]) / $toMultiplier;
2649
- }
2650
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Exception.php DELETED
@@ -1,46 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_Calculation_Exception
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_Calculation
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_Calculation_Exception extends PHPExcel_Exception
29
- {
30
- /**
31
- * Error handler callback
32
- *
33
- * @param mixed $code
34
- * @param mixed $string
35
- * @param mixed $file
36
- * @param mixed $line
37
- * @param mixed $context
38
- */
39
- public static function errorHandlerCallback($code, $string, $file, $line, $context)
40
- {
41
- $e = new self($string, $code);
42
- $e->line = $line;
43
- $e->file = $file;
44
- throw $e;
45
- }
46
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/ExceptionHandler.php DELETED
@@ -1,45 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_Calculation_ExceptionHandler
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_Calculation
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_Calculation_ExceptionHandler
29
- {
30
- /**
31
- * Register errorhandler
32
- */
33
- public function __construct()
34
- {
35
- set_error_handler(array('PHPExcel_Calculation_Exception', 'errorHandlerCallback'), E_ALL);
36
- }
37
-
38
- /**
39
- * Unregister errorhandler
40
- */
41
- public function __destruct()
42
- {
43
- restore_error_handler();
44
- }
45
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Financial.php DELETED
@@ -1,2359 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
- /** FINANCIAL_MAX_ITERATIONS */
13
- define('FINANCIAL_MAX_ITERATIONS', 128);
14
-
15
- /** FINANCIAL_PRECISION */
16
- define('FINANCIAL_PRECISION', 1.0e-08);
17
-
18
- /**
19
- * PHPExcel_Calculation_Financial
20
- *
21
- * Copyright (c) 2006 - 2015 PHPExcel
22
- *
23
- * This library is free software; you can redistribute it and/or
24
- * modify it under the terms of the GNU Lesser General Public
25
- * License as published by the Free Software Foundation; either
26
- * version 2.1 of the License, or (at your option) any later version.
27
- *
28
- * This library is distributed in the hope that it will be useful,
29
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
30
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
31
- * Lesser General Public License for more details.
32
- *
33
- * You should have received a copy of the GNU Lesser General Public
34
- * License along with this library; if not, write to the Free Software
35
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
36
- *
37
- * @category PHPExcel
38
- * @package PHPExcel_Calculation
39
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
40
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
41
- * @version ##VERSION##, ##DATE##
42
- */
43
- class PHPExcel_Calculation_Financial
44
- {
45
- /**
46
- * isLastDayOfMonth
47
- *
48
- * Returns a boolean TRUE/FALSE indicating if this date is the last date of the month
49
- *
50
- * @param DateTime $testDate The date for testing
51
- * @return boolean
52
- */
53
- private static function isLastDayOfMonth($testDate)
54
- {
55
- return ($testDate->format('d') == $testDate->format('t'));
56
- }
57
-
58
-
59
- /**
60
- * isFirstDayOfMonth
61
- *
62
- * Returns a boolean TRUE/FALSE indicating if this date is the first date of the month
63
- *
64
- * @param DateTime $testDate The date for testing
65
- * @return boolean
66
- */
67
- private static function isFirstDayOfMonth($testDate)
68
- {
69
- return ($testDate->format('d') == 1);
70
- }
71
-
72
-
73
- private static function couponFirstPeriodDate($settlement, $maturity, $frequency, $next)
74
- {
75
- $months = 12 / $frequency;
76
-
77
- $result = PHPExcel_Shared_Date::ExcelToPHPObject($maturity);
78
- $eom = self::isLastDayOfMonth($result);
79
-
80
- while ($settlement < PHPExcel_Shared_Date::PHPToExcel($result)) {
81
- $result->modify('-'.$months.' months');
82
- }
83
- if ($next) {
84
- $result->modify('+'.$months.' months');
85
- }
86
-
87
- if ($eom) {
88
- $result->modify('-1 day');
89
- }
90
-
91
- return PHPExcel_Shared_Date::PHPToExcel($result);
92
- }
93
-
94
-
95
- private static function isValidFrequency($frequency)
96
- {
97
- if (($frequency == 1) || ($frequency == 2) || ($frequency == 4)) {
98
- return true;
99
- }
100
- if ((PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) &&
101
- (($frequency == 6) || ($frequency == 12))) {
102
- return true;
103
- }
104
- return false;
105
- }
106
-
107
-
108
- /**
109
- * daysPerYear
110
- *
111
- * Returns the number of days in a specified year, as defined by the "basis" value
112
- *
113
- * @param integer $year The year against which we're testing
114
- * @param integer $basis The type of day count:
115
- * 0 or omitted US (NASD) 360
116
- * 1 Actual (365 or 366 in a leap year)
117
- * 2 360
118
- * 3 365
119
- * 4 European 360
120
- * @return integer
121
- */
122
- private static function daysPerYear($year, $basis = 0)
123
- {
124
- switch ($basis) {
125
- case 0:
126
- case 2:
127
- case 4:
128
- $daysPerYear = 360;
129
- break;
130
- case 3:
131
- $daysPerYear = 365;
132
- break;
133
- case 1:
134
- $daysPerYear = (PHPExcel_Calculation_DateTime::isLeapYear($year)) ? 366 : 365;
135
- break;
136
- default:
137
- return PHPExcel_Calculation_Functions::NaN();
138
- }
139
- return $daysPerYear;
140
- }
141
-
142
-
143
- private static function interestAndPrincipal($rate = 0, $per = 0, $nper = 0, $pv = 0, $fv = 0, $type = 0)
144
- {
145
- $pmt = self::PMT($rate, $nper, $pv, $fv, $type);
146
- $capital = $pv;
147
- for ($i = 1; $i<= $per; ++$i) {
148
- $interest = ($type && $i == 1) ? 0 : -$capital * $rate;
149
- $principal = $pmt - $interest;
150
- $capital += $principal;
151
- }
152
- return array($interest, $principal);
153
- }
154
-
155
-
156
- /**
157
- * ACCRINT
158
- *
159
- * Returns the accrued interest for a security that pays periodic interest.
160
- *
161
- * Excel Function:
162
- * ACCRINT(issue,firstinterest,settlement,rate,par,frequency[,basis])
163
- *
164
- * @access public
165
- * @category Financial Functions
166
- * @param mixed $issue The security's issue date.
167
- * @param mixed $firstinterest The security's first interest date.
168
- * @param mixed $settlement The security's settlement date.
169
- * The security settlement date is the date after the issue date
170
- * when the security is traded to the buyer.
171
- * @param float $rate The security's annual coupon rate.
172
- * @param float $par The security's par value.
173
- * If you omit par, ACCRINT uses $1,000.
174
- * @param integer $frequency the number of coupon payments per year.
175
- * Valid frequency values are:
176
- * 1 Annual
177
- * 2 Semi-Annual
178
- * 4 Quarterly
179
- * If working in Gnumeric Mode, the following frequency options are
180
- * also available
181
- * 6 Bimonthly
182
- * 12 Monthly
183
- * @param integer $basis The type of day count to use.
184
- * 0 or omitted US (NASD) 30/360
185
- * 1 Actual/actual
186
- * 2 Actual/360
187
- * 3 Actual/365
188
- * 4 European 30/360
189
- * @return float
190
- */
191
- public static function ACCRINT($issue, $firstinterest, $settlement, $rate, $par = 1000, $frequency = 1, $basis = 0)
192
- {
193
- $issue = PHPExcel_Calculation_Functions::flattenSingleValue($issue);
194
- $firstinterest = PHPExcel_Calculation_Functions::flattenSingleValue($firstinterest);
195
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
196
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
197
- $par = (is_null($par)) ? 1000 : PHPExcel_Calculation_Functions::flattenSingleValue($par);
198
- $frequency = (is_null($frequency)) ? 1 : PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
199
- $basis = (is_null($basis)) ? 0 : PHPExcel_Calculation_Functions::flattenSingleValue($basis);
200
-
201
- // Validate
202
- if ((is_numeric($rate)) && (is_numeric($par))) {
203
- $rate = (float) $rate;
204
- $par = (float) $par;
205
- if (($rate <= 0) || ($par <= 0)) {
206
- return PHPExcel_Calculation_Functions::NaN();
207
- }
208
- $daysBetweenIssueAndSettlement = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $settlement, $basis);
209
- if (!is_numeric($daysBetweenIssueAndSettlement)) {
210
- // return date error
211
- return $daysBetweenIssueAndSettlement;
212
- }
213
-
214
- return $par * $rate * $daysBetweenIssueAndSettlement;
215
- }
216
- return PHPExcel_Calculation_Functions::VALUE();
217
- }
218
-
219
-
220
- /**
221
- * ACCRINTM
222
- *
223
- * Returns the accrued interest for a security that pays interest at maturity.
224
- *
225
- * Excel Function:
226
- * ACCRINTM(issue,settlement,rate[,par[,basis]])
227
- *
228
- * @access public
229
- * @category Financial Functions
230
- * @param mixed issue The security's issue date.
231
- * @param mixed settlement The security's settlement (or maturity) date.
232
- * @param float rate The security's annual coupon rate.
233
- * @param float par The security's par value.
234
- * If you omit par, ACCRINT uses $1,000.
235
- * @param integer basis The type of day count to use.
236
- * 0 or omitted US (NASD) 30/360
237
- * 1 Actual/actual
238
- * 2 Actual/360
239
- * 3 Actual/365
240
- * 4 European 30/360
241
- * @return float
242
- */
243
- public static function ACCRINTM($issue, $settlement, $rate, $par = 1000, $basis = 0)
244
- {
245
- $issue = PHPExcel_Calculation_Functions::flattenSingleValue($issue);
246
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
247
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
248
- $par = (is_null($par)) ? 1000 : PHPExcel_Calculation_Functions::flattenSingleValue($par);
249
- $basis = (is_null($basis)) ? 0 : PHPExcel_Calculation_Functions::flattenSingleValue($basis);
250
-
251
- // Validate
252
- if ((is_numeric($rate)) && (is_numeric($par))) {
253
- $rate = (float) $rate;
254
- $par = (float) $par;
255
- if (($rate <= 0) || ($par <= 0)) {
256
- return PHPExcel_Calculation_Functions::NaN();
257
- }
258
- $daysBetweenIssueAndSettlement = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $settlement, $basis);
259
- if (!is_numeric($daysBetweenIssueAndSettlement)) {
260
- // return date error
261
- return $daysBetweenIssueAndSettlement;
262
- }
263
- return $par * $rate * $daysBetweenIssueAndSettlement;
264
- }
265
- return PHPExcel_Calculation_Functions::VALUE();
266
- }
267
-
268
-
269
- /**
270
- * AMORDEGRC
271
- *
272
- * Returns the depreciation for each accounting period.
273
- * This function is provided for the French accounting system. If an asset is purchased in
274
- * the middle of the accounting period, the prorated depreciation is taken into account.
275
- * The function is similar to AMORLINC, except that a depreciation coefficient is applied in
276
- * the calculation depending on the life of the assets.
277
- * This function will return the depreciation until the last period of the life of the assets
278
- * or until the cumulated value of depreciation is greater than the cost of the assets minus
279
- * the salvage value.
280
- *
281
- * Excel Function:
282
- * AMORDEGRC(cost,purchased,firstPeriod,salvage,period,rate[,basis])
283
- *
284
- * @access public
285
- * @category Financial Functions
286
- * @param float cost The cost of the asset.
287
- * @param mixed purchased Date of the purchase of the asset.
288
- * @param mixed firstPeriod Date of the end of the first period.
289
- * @param mixed salvage The salvage value at the end of the life of the asset.
290
- * @param float period The period.
291
- * @param float rate Rate of depreciation.
292
- * @param integer basis The type of day count to use.
293
- * 0 or omitted US (NASD) 30/360
294
- * 1 Actual/actual
295
- * 2 Actual/360
296
- * 3 Actual/365
297
- * 4 European 30/360
298
- * @return float
299
- */
300
- public static function AMORDEGRC($cost, $purchased, $firstPeriod, $salvage, $period, $rate, $basis = 0)
301
- {
302
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
303
- $purchased = PHPExcel_Calculation_Functions::flattenSingleValue($purchased);
304
- $firstPeriod = PHPExcel_Calculation_Functions::flattenSingleValue($firstPeriod);
305
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
306
- $period = floor(PHPExcel_Calculation_Functions::flattenSingleValue($period));
307
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
308
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
309
-
310
- // The depreciation coefficients are:
311
- // Life of assets (1/rate) Depreciation coefficient
312
- // Less than 3 years 1
313
- // Between 3 and 4 years 1.5
314
- // Between 5 and 6 years 2
315
- // More than 6 years 2.5
316
- $fUsePer = 1.0 / $rate;
317
- if ($fUsePer < 3.0) {
318
- $amortiseCoeff = 1.0;
319
- } elseif ($fUsePer < 5.0) {
320
- $amortiseCoeff = 1.5;
321
- } elseif ($fUsePer <= 6.0) {
322
- $amortiseCoeff = 2.0;
323
- } else {
324
- $amortiseCoeff = 2.5;
325
- }
326
-
327
- $rate *= $amortiseCoeff;
328
- $fNRate = round(PHPExcel_Calculation_DateTime::YEARFRAC($purchased, $firstPeriod, $basis) * $rate * $cost, 0);
329
- $cost -= $fNRate;
330
- $fRest = $cost - $salvage;
331
-
332
- for ($n = 0; $n < $period; ++$n) {
333
- $fNRate = round($rate * $cost, 0);
334
- $fRest -= $fNRate;
335
-
336
- if ($fRest < 0.0) {
337
- switch ($period - $n) {
338
- case 0:
339
- case 1:
340
- return round($cost * 0.5, 0);
341
- default:
342
- return 0.0;
343
- }
344
- }
345
- $cost -= $fNRate;
346
- }
347
- return $fNRate;
348
- }
349
-
350
-
351
- /**
352
- * AMORLINC
353
- *
354
- * Returns the depreciation for each accounting period.
355
- * This function is provided for the French accounting system. If an asset is purchased in
356
- * the middle of the accounting period, the prorated depreciation is taken into account.
357
- *
358
- * Excel Function:
359
- * AMORLINC(cost,purchased,firstPeriod,salvage,period,rate[,basis])
360
- *
361
- * @access public
362
- * @category Financial Functions
363
- * @param float cost The cost of the asset.
364
- * @param mixed purchased Date of the purchase of the asset.
365
- * @param mixed firstPeriod Date of the end of the first period.
366
- * @param mixed salvage The salvage value at the end of the life of the asset.
367
- * @param float period The period.
368
- * @param float rate Rate of depreciation.
369
- * @param integer basis The type of day count to use.
370
- * 0 or omitted US (NASD) 30/360
371
- * 1 Actual/actual
372
- * 2 Actual/360
373
- * 3 Actual/365
374
- * 4 European 30/360
375
- * @return float
376
- */
377
- public static function AMORLINC($cost, $purchased, $firstPeriod, $salvage, $period, $rate, $basis = 0)
378
- {
379
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
380
- $purchased = PHPExcel_Calculation_Functions::flattenSingleValue($purchased);
381
- $firstPeriod = PHPExcel_Calculation_Functions::flattenSingleValue($firstPeriod);
382
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
383
- $period = PHPExcel_Calculation_Functions::flattenSingleValue($period);
384
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
385
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
386
-
387
- $fOneRate = $cost * $rate;
388
- $fCostDelta = $cost - $salvage;
389
- // Note, quirky variation for leap years on the YEARFRAC for this function
390
- $purchasedYear = PHPExcel_Calculation_DateTime::YEAR($purchased);
391
- $yearFrac = PHPExcel_Calculation_DateTime::YEARFRAC($purchased, $firstPeriod, $basis);
392
-
393
- if (($basis == 1) && ($yearFrac < 1) && (PHPExcel_Calculation_DateTime::isLeapYear($purchasedYear))) {
394
- $yearFrac *= 365 / 366;
395
- }
396
-
397
- $f0Rate = $yearFrac * $rate * $cost;
398
- $nNumOfFullPeriods = intval(($cost - $salvage - $f0Rate) / $fOneRate);
399
-
400
- if ($period == 0) {
401
- return $f0Rate;
402
- } elseif ($period <= $nNumOfFullPeriods) {
403
- return $fOneRate;
404
- } elseif ($period == ($nNumOfFullPeriods + 1)) {
405
- return ($fCostDelta - $fOneRate * $nNumOfFullPeriods - $f0Rate);
406
- } else {
407
- return 0.0;
408
- }
409
- }
410
-
411
-
412
- /**
413
- * COUPDAYBS
414
- *
415
- * Returns the number of days from the beginning of the coupon period to the settlement date.
416
- *
417
- * Excel Function:
418
- * COUPDAYBS(settlement,maturity,frequency[,basis])
419
- *
420
- * @access public
421
- * @category Financial Functions
422
- * @param mixed settlement The security's settlement date.
423
- * The security settlement date is the date after the issue
424
- * date when the security is traded to the buyer.
425
- * @param mixed maturity The security's maturity date.
426
- * The maturity date is the date when the security expires.
427
- * @param mixed frequency the number of coupon payments per year.
428
- * Valid frequency values are:
429
- * 1 Annual
430
- * 2 Semi-Annual
431
- * 4 Quarterly
432
- * If working in Gnumeric Mode, the following frequency options are
433
- * also available
434
- * 6 Bimonthly
435
- * 12 Monthly
436
- * @param integer basis The type of day count to use.
437
- * 0 or omitted US (NASD) 30/360
438
- * 1 Actual/actual
439
- * 2 Actual/360
440
- * 3 Actual/365
441
- * 4 European 30/360
442
- * @return float
443
- */
444
- public static function COUPDAYBS($settlement, $maturity, $frequency, $basis = 0)
445
- {
446
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
447
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
448
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
449
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
450
-
451
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
452
- return PHPExcel_Calculation_Functions::VALUE();
453
- }
454
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
455
- return PHPExcel_Calculation_Functions::VALUE();
456
- }
457
-
458
- if (($settlement > $maturity) ||
459
- (!self::isValidFrequency($frequency)) ||
460
- (($basis < 0) || ($basis > 4))) {
461
- return PHPExcel_Calculation_Functions::NaN();
462
- }
463
-
464
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($settlement), $basis);
465
- $prev = self::couponFirstPeriodDate($settlement, $maturity, $frequency, false);
466
-
467
- return PHPExcel_Calculation_DateTime::YEARFRAC($prev, $settlement, $basis) * $daysPerYear;
468
- }
469
-
470
-
471
- /**
472
- * COUPDAYS
473
- *
474
- * Returns the number of days in the coupon period that contains the settlement date.
475
- *
476
- * Excel Function:
477
- * COUPDAYS(settlement,maturity,frequency[,basis])
478
- *
479
- * @access public
480
- * @category Financial Functions
481
- * @param mixed settlement The security's settlement date.
482
- * The security settlement date is the date after the issue
483
- * date when the security is traded to the buyer.
484
- * @param mixed maturity The security's maturity date.
485
- * The maturity date is the date when the security expires.
486
- * @param mixed frequency the number of coupon payments per year.
487
- * Valid frequency values are:
488
- * 1 Annual
489
- * 2 Semi-Annual
490
- * 4 Quarterly
491
- * If working in Gnumeric Mode, the following frequency options are
492
- * also available
493
- * 6 Bimonthly
494
- * 12 Monthly
495
- * @param integer basis The type of day count to use.
496
- * 0 or omitted US (NASD) 30/360
497
- * 1 Actual/actual
498
- * 2 Actual/360
499
- * 3 Actual/365
500
- * 4 European 30/360
501
- * @return float
502
- */
503
- public static function COUPDAYS($settlement, $maturity, $frequency, $basis = 0)
504
- {
505
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
506
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
507
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
508
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
509
-
510
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
511
- return PHPExcel_Calculation_Functions::VALUE();
512
- }
513
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
514
- return PHPExcel_Calculation_Functions::VALUE();
515
- }
516
-
517
- if (($settlement > $maturity) ||
518
- (!self::isValidFrequency($frequency)) ||
519
- (($basis < 0) || ($basis > 4))) {
520
- return PHPExcel_Calculation_Functions::NaN();
521
- }
522
-
523
- switch ($basis) {
524
- case 3:
525
- // Actual/365
526
- return 365 / $frequency;
527
- case 1:
528
- // Actual/actual
529
- if ($frequency == 1) {
530
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($maturity), $basis);
531
- return ($daysPerYear / $frequency);
532
- }
533
- $prev = self::couponFirstPeriodDate($settlement, $maturity, $frequency, false);
534
- $next = self::couponFirstPeriodDate($settlement, $maturity, $frequency, true);
535
- return ($next - $prev);
536
- default:
537
- // US (NASD) 30/360, Actual/360 or European 30/360
538
- return 360 / $frequency;
539
- }
540
- return PHPExcel_Calculation_Functions::VALUE();
541
- }
542
-
543
-
544
- /**
545
- * COUPDAYSNC
546
- *
547
- * Returns the number of days from the settlement date to the next coupon date.
548
- *
549
- * Excel Function:
550
- * COUPDAYSNC(settlement,maturity,frequency[,basis])
551
- *
552
- * @access public
553
- * @category Financial Functions
554
- * @param mixed settlement The security's settlement date.
555
- * The security settlement date is the date after the issue
556
- * date when the security is traded to the buyer.
557
- * @param mixed maturity The security's maturity date.
558
- * The maturity date is the date when the security expires.
559
- * @param mixed frequency the number of coupon payments per year.
560
- * Valid frequency values are:
561
- * 1 Annual
562
- * 2 Semi-Annual
563
- * 4 Quarterly
564
- * If working in Gnumeric Mode, the following frequency options are
565
- * also available
566
- * 6 Bimonthly
567
- * 12 Monthly
568
- * @param integer basis The type of day count to use.
569
- * 0 or omitted US (NASD) 30/360
570
- * 1 Actual/actual
571
- * 2 Actual/360
572
- * 3 Actual/365
573
- * 4 European 30/360
574
- * @return float
575
- */
576
- public static function COUPDAYSNC($settlement, $maturity, $frequency, $basis = 0)
577
- {
578
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
579
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
580
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
581
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
582
-
583
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
584
- return PHPExcel_Calculation_Functions::VALUE();
585
- }
586
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
587
- return PHPExcel_Calculation_Functions::VALUE();
588
- }
589
-
590
- if (($settlement > $maturity) ||
591
- (!self::isValidFrequency($frequency)) ||
592
- (($basis < 0) || ($basis > 4))) {
593
- return PHPExcel_Calculation_Functions::NaN();
594
- }
595
-
596
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($settlement), $basis);
597
- $next = self::couponFirstPeriodDate($settlement, $maturity, $frequency, true);
598
-
599
- return PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $next, $basis) * $daysPerYear;
600
- }
601
-
602
-
603
- /**
604
- * COUPNCD
605
- *
606
- * Returns the next coupon date after the settlement date.
607
- *
608
- * Excel Function:
609
- * COUPNCD(settlement,maturity,frequency[,basis])
610
- *
611
- * @access public
612
- * @category Financial Functions
613
- * @param mixed settlement The security's settlement date.
614
- * The security settlement date is the date after the issue
615
- * date when the security is traded to the buyer.
616
- * @param mixed maturity The security's maturity date.
617
- * The maturity date is the date when the security expires.
618
- * @param mixed frequency the number of coupon payments per year.
619
- * Valid frequency values are:
620
- * 1 Annual
621
- * 2 Semi-Annual
622
- * 4 Quarterly
623
- * If working in Gnumeric Mode, the following frequency options are
624
- * also available
625
- * 6 Bimonthly
626
- * 12 Monthly
627
- * @param integer basis The type of day count to use.
628
- * 0 or omitted US (NASD) 30/360
629
- * 1 Actual/actual
630
- * 2 Actual/360
631
- * 3 Actual/365
632
- * 4 European 30/360
633
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
634
- * depending on the value of the ReturnDateType flag
635
- */
636
- public static function COUPNCD($settlement, $maturity, $frequency, $basis = 0)
637
- {
638
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
639
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
640
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
641
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
642
-
643
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
644
- return PHPExcel_Calculation_Functions::VALUE();
645
- }
646
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
647
- return PHPExcel_Calculation_Functions::VALUE();
648
- }
649
-
650
- if (($settlement > $maturity) ||
651
- (!self::isValidFrequency($frequency)) ||
652
- (($basis < 0) || ($basis > 4))) {
653
- return PHPExcel_Calculation_Functions::NaN();
654
- }
655
-
656
- return self::couponFirstPeriodDate($settlement, $maturity, $frequency, true);
657
- }
658
-
659
-
660
- /**
661
- * COUPNUM
662
- *
663
- * Returns the number of coupons payable between the settlement date and maturity date,
664
- * rounded up to the nearest whole coupon.
665
- *
666
- * Excel Function:
667
- * COUPNUM(settlement,maturity,frequency[,basis])
668
- *
669
- * @access public
670
- * @category Financial Functions
671
- * @param mixed settlement The security's settlement date.
672
- * The security settlement date is the date after the issue
673
- * date when the security is traded to the buyer.
674
- * @param mixed maturity The security's maturity date.
675
- * The maturity date is the date when the security expires.
676
- * @param mixed frequency the number of coupon payments per year.
677
- * Valid frequency values are:
678
- * 1 Annual
679
- * 2 Semi-Annual
680
- * 4 Quarterly
681
- * If working in Gnumeric Mode, the following frequency options are
682
- * also available
683
- * 6 Bimonthly
684
- * 12 Monthly
685
- * @param integer basis The type of day count to use.
686
- * 0 or omitted US (NASD) 30/360
687
- * 1 Actual/actual
688
- * 2 Actual/360
689
- * 3 Actual/365
690
- * 4 European 30/360
691
- * @return integer
692
- */
693
- public static function COUPNUM($settlement, $maturity, $frequency, $basis = 0)
694
- {
695
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
696
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
697
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
698
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
699
-
700
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
701
- return PHPExcel_Calculation_Functions::VALUE();
702
- }
703
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
704
- return PHPExcel_Calculation_Functions::VALUE();
705
- }
706
-
707
- if (($settlement > $maturity) ||
708
- (!self::isValidFrequency($frequency)) ||
709
- (($basis < 0) || ($basis > 4))) {
710
- return PHPExcel_Calculation_Functions::NaN();
711
- }
712
-
713
- $settlement = self::couponFirstPeriodDate($settlement, $maturity, $frequency, true);
714
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis) * 365;
715
-
716
- switch ($frequency) {
717
- case 1: // annual payments
718
- return ceil($daysBetweenSettlementAndMaturity / 360);
719
- case 2: // half-yearly
720
- return ceil($daysBetweenSettlementAndMaturity / 180);
721
- case 4: // quarterly
722
- return ceil($daysBetweenSettlementAndMaturity / 90);
723
- case 6: // bimonthly
724
- return ceil($daysBetweenSettlementAndMaturity / 60);
725
- case 12: // monthly
726
- return ceil($daysBetweenSettlementAndMaturity / 30);
727
- }
728
- return PHPExcel_Calculation_Functions::VALUE();
729
- }
730
-
731
-
732
- /**
733
- * COUPPCD
734
- *
735
- * Returns the previous coupon date before the settlement date.
736
- *
737
- * Excel Function:
738
- * COUPPCD(settlement,maturity,frequency[,basis])
739
- *
740
- * @access public
741
- * @category Financial Functions
742
- * @param mixed settlement The security's settlement date.
743
- * The security settlement date is the date after the issue
744
- * date when the security is traded to the buyer.
745
- * @param mixed maturity The security's maturity date.
746
- * The maturity date is the date when the security expires.
747
- * @param mixed frequency the number of coupon payments per year.
748
- * Valid frequency values are:
749
- * 1 Annual
750
- * 2 Semi-Annual
751
- * 4 Quarterly
752
- * If working in Gnumeric Mode, the following frequency options are
753
- * also available
754
- * 6 Bimonthly
755
- * 12 Monthly
756
- * @param integer basis The type of day count to use.
757
- * 0 or omitted US (NASD) 30/360
758
- * 1 Actual/actual
759
- * 2 Actual/360
760
- * 3 Actual/365
761
- * 4 European 30/360
762
- * @return mixed Excel date/time serial value, PHP date/time serial value or PHP date/time object,
763
- * depending on the value of the ReturnDateType flag
764
- */
765
- public static function COUPPCD($settlement, $maturity, $frequency, $basis = 0)
766
- {
767
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
768
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
769
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
770
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
771
-
772
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
773
- return PHPExcel_Calculation_Functions::VALUE();
774
- }
775
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
776
- return PHPExcel_Calculation_Functions::VALUE();
777
- }
778
-
779
- if (($settlement > $maturity) ||
780
- (!self::isValidFrequency($frequency)) ||
781
- (($basis < 0) || ($basis > 4))) {
782
- return PHPExcel_Calculation_Functions::NaN();
783
- }
784
-
785
- return self::couponFirstPeriodDate($settlement, $maturity, $frequency, false);
786
- }
787
-
788
-
789
- /**
790
- * CUMIPMT
791
- *
792
- * Returns the cumulative interest paid on a loan between the start and end periods.
793
- *
794
- * Excel Function:
795
- * CUMIPMT(rate,nper,pv,start,end[,type])
796
- *
797
- * @access public
798
- * @category Financial Functions
799
- * @param float $rate The Interest rate
800
- * @param integer $nper The total number of payment periods
801
- * @param float $pv Present Value
802
- * @param integer $start The first period in the calculation.
803
- * Payment periods are numbered beginning with 1.
804
- * @param integer $end The last period in the calculation.
805
- * @param integer $type A number 0 or 1 and indicates when payments are due:
806
- * 0 or omitted At the end of the period.
807
- * 1 At the beginning of the period.
808
- * @return float
809
- */
810
- public static function CUMIPMT($rate, $nper, $pv, $start, $end, $type = 0)
811
- {
812
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
813
- $nper = (int) PHPExcel_Calculation_Functions::flattenSingleValue($nper);
814
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
815
- $start = (int) PHPExcel_Calculation_Functions::flattenSingleValue($start);
816
- $end = (int) PHPExcel_Calculation_Functions::flattenSingleValue($end);
817
- $type = (int) PHPExcel_Calculation_Functions::flattenSingleValue($type);
818
-
819
- // Validate parameters
820
- if ($type != 0 && $type != 1) {
821
- return PHPExcel_Calculation_Functions::NaN();
822
- }
823
- if ($start < 1 || $start > $end) {
824
- return PHPExcel_Calculation_Functions::VALUE();
825
- }
826
-
827
- // Calculate
828
- $interest = 0;
829
- for ($per = $start; $per <= $end; ++$per) {
830
- $interest += self::IPMT($rate, $per, $nper, $pv, 0, $type);
831
- }
832
-
833
- return $interest;
834
- }
835
-
836
-
837
- /**
838
- * CUMPRINC
839
- *
840
- * Returns the cumulative principal paid on a loan between the start and end periods.
841
- *
842
- * Excel Function:
843
- * CUMPRINC(rate,nper,pv,start,end[,type])
844
- *
845
- * @access public
846
- * @category Financial Functions
847
- * @param float $rate The Interest rate
848
- * @param integer $nper The total number of payment periods
849
- * @param float $pv Present Value
850
- * @param integer $start The first period in the calculation.
851
- * Payment periods are numbered beginning with 1.
852
- * @param integer $end The last period in the calculation.
853
- * @param integer $type A number 0 or 1 and indicates when payments are due:
854
- * 0 or omitted At the end of the period.
855
- * 1 At the beginning of the period.
856
- * @return float
857
- */
858
- public static function CUMPRINC($rate, $nper, $pv, $start, $end, $type = 0)
859
- {
860
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
861
- $nper = (int) PHPExcel_Calculation_Functions::flattenSingleValue($nper);
862
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
863
- $start = (int) PHPExcel_Calculation_Functions::flattenSingleValue($start);
864
- $end = (int) PHPExcel_Calculation_Functions::flattenSingleValue($end);
865
- $type = (int) PHPExcel_Calculation_Functions::flattenSingleValue($type);
866
-
867
- // Validate parameters
868
- if ($type != 0 && $type != 1) {
869
- return PHPExcel_Calculation_Functions::NaN();
870
- }
871
- if ($start < 1 || $start > $end) {
872
- return PHPExcel_Calculation_Functions::VALUE();
873
- }
874
-
875
- // Calculate
876
- $principal = 0;
877
- for ($per = $start; $per <= $end; ++$per) {
878
- $principal += self::PPMT($rate, $per, $nper, $pv, 0, $type);
879
- }
880
-
881
- return $principal;
882
- }
883
-
884
-
885
- /**
886
- * DB
887
- *
888
- * Returns the depreciation of an asset for a specified period using the
889
- * fixed-declining balance method.
890
- * This form of depreciation is used if you want to get a higher depreciation value
891
- * at the beginning of the depreciation (as opposed to linear depreciation). The
892
- * depreciation value is reduced with every depreciation period by the depreciation
893
- * already deducted from the initial cost.
894
- *
895
- * Excel Function:
896
- * DB(cost,salvage,life,period[,month])
897
- *
898
- * @access public
899
- * @category Financial Functions
900
- * @param float cost Initial cost of the asset.
901
- * @param float salvage Value at the end of the depreciation.
902
- * (Sometimes called the salvage value of the asset)
903
- * @param integer life Number of periods over which the asset is depreciated.
904
- * (Sometimes called the useful life of the asset)
905
- * @param integer period The period for which you want to calculate the
906
- * depreciation. Period must use the same units as life.
907
- * @param integer month Number of months in the first year. If month is omitted,
908
- * it defaults to 12.
909
- * @return float
910
- */
911
- public static function DB($cost, $salvage, $life, $period, $month = 12)
912
- {
913
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
914
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
915
- $life = PHPExcel_Calculation_Functions::flattenSingleValue($life);
916
- $period = PHPExcel_Calculation_Functions::flattenSingleValue($period);
917
- $month = PHPExcel_Calculation_Functions::flattenSingleValue($month);
918
-
919
- // Validate
920
- if ((is_numeric($cost)) && (is_numeric($salvage)) && (is_numeric($life)) && (is_numeric($period)) && (is_numeric($month))) {
921
- $cost = (float) $cost;
922
- $salvage = (float) $salvage;
923
- $life = (int) $life;
924
- $period = (int) $period;
925
- $month = (int) $month;
926
- if ($cost == 0) {
927
- return 0.0;
928
- } elseif (($cost < 0) || (($salvage / $cost) < 0) || ($life <= 0) || ($period < 1) || ($month < 1)) {
929
- return PHPExcel_Calculation_Functions::NaN();
930
- }
931
- // Set Fixed Depreciation Rate
932
- $fixedDepreciationRate = 1 - pow(($salvage / $cost), (1 / $life));
933
- $fixedDepreciationRate = round($fixedDepreciationRate, 3);
934
-
935
- // Loop through each period calculating the depreciation
936
- $previousDepreciation = 0;
937
- for ($per = 1; $per <= $period; ++$per) {
938
- if ($per == 1) {
939
- $depreciation = $cost * $fixedDepreciationRate * $month / 12;
940
- } elseif ($per == ($life + 1)) {
941
- $depreciation = ($cost - $previousDepreciation) * $fixedDepreciationRate * (12 - $month) / 12;
942
- } else {
943
- $depreciation = ($cost - $previousDepreciation) * $fixedDepreciationRate;
944
- }
945
- $previousDepreciation += $depreciation;
946
- }
947
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
948
- $depreciation = round($depreciation, 2);
949
- }
950
- return $depreciation;
951
- }
952
- return PHPExcel_Calculation_Functions::VALUE();
953
- }
954
-
955
-
956
- /**
957
- * DDB
958
- *
959
- * Returns the depreciation of an asset for a specified period using the
960
- * double-declining balance method or some other method you specify.
961
- *
962
- * Excel Function:
963
- * DDB(cost,salvage,life,period[,factor])
964
- *
965
- * @access public
966
- * @category Financial Functions
967
- * @param float cost Initial cost of the asset.
968
- * @param float salvage Value at the end of the depreciation.
969
- * (Sometimes called the salvage value of the asset)
970
- * @param integer life Number of periods over which the asset is depreciated.
971
- * (Sometimes called the useful life of the asset)
972
- * @param integer period The period for which you want to calculate the
973
- * depreciation. Period must use the same units as life.
974
- * @param float factor The rate at which the balance declines.
975
- * If factor is omitted, it is assumed to be 2 (the
976
- * double-declining balance method).
977
- * @return float
978
- */
979
- public static function DDB($cost, $salvage, $life, $period, $factor = 2.0)
980
- {
981
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
982
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
983
- $life = PHPExcel_Calculation_Functions::flattenSingleValue($life);
984
- $period = PHPExcel_Calculation_Functions::flattenSingleValue($period);
985
- $factor = PHPExcel_Calculation_Functions::flattenSingleValue($factor);
986
-
987
- // Validate
988
- if ((is_numeric($cost)) && (is_numeric($salvage)) && (is_numeric($life)) && (is_numeric($period)) && (is_numeric($factor))) {
989
- $cost = (float) $cost;
990
- $salvage = (float) $salvage;
991
- $life = (int) $life;
992
- $period = (int) $period;
993
- $factor = (float) $factor;
994
- if (($cost <= 0) || (($salvage / $cost) < 0) || ($life <= 0) || ($period < 1) || ($factor <= 0.0) || ($period > $life)) {
995
- return PHPExcel_Calculation_Functions::NaN();
996
- }
997
- // Set Fixed Depreciation Rate
998
- $fixedDepreciationRate = 1 - pow(($salvage / $cost), (1 / $life));
999
- $fixedDepreciationRate = round($fixedDepreciationRate, 3);
1000
-
1001
- // Loop through each period calculating the depreciation
1002
- $previousDepreciation = 0;
1003
- for ($per = 1; $per <= $period; ++$per) {
1004
- $depreciation = min(($cost - $previousDepreciation) * ($factor / $life), ($cost - $salvage - $previousDepreciation));
1005
- $previousDepreciation += $depreciation;
1006
- }
1007
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC) {
1008
- $depreciation = round($depreciation, 2);
1009
- }
1010
- return $depreciation;
1011
- }
1012
- return PHPExcel_Calculation_Functions::VALUE();
1013
- }
1014
-
1015
-
1016
- /**
1017
- * DISC
1018
- *
1019
- * Returns the discount rate for a security.
1020
- *
1021
- * Excel Function:
1022
- * DISC(settlement,maturity,price,redemption[,basis])
1023
- *
1024
- * @access public
1025
- * @category Financial Functions
1026
- * @param mixed settlement The security's settlement date.
1027
- * The security settlement date is the date after the issue
1028
- * date when the security is traded to the buyer.
1029
- * @param mixed maturity The security's maturity date.
1030
- * The maturity date is the date when the security expires.
1031
- * @param integer price The security's price per $100 face value.
1032
- * @param integer redemption The security's redemption value per $100 face value.
1033
- * @param integer basis The type of day count to use.
1034
- * 0 or omitted US (NASD) 30/360
1035
- * 1 Actual/actual
1036
- * 2 Actual/360
1037
- * 3 Actual/365
1038
- * 4 European 30/360
1039
- * @return float
1040
- */
1041
- public static function DISC($settlement, $maturity, $price, $redemption, $basis = 0)
1042
- {
1043
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1044
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1045
- $price = PHPExcel_Calculation_Functions::flattenSingleValue($price);
1046
- $redemption = PHPExcel_Calculation_Functions::flattenSingleValue($redemption);
1047
- $basis = PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1048
-
1049
- // Validate
1050
- if ((is_numeric($price)) && (is_numeric($redemption)) && (is_numeric($basis))) {
1051
- $price = (float) $price;
1052
- $redemption = (float) $redemption;
1053
- $basis = (int) $basis;
1054
- if (($price <= 0) || ($redemption <= 0)) {
1055
- return PHPExcel_Calculation_Functions::NaN();
1056
- }
1057
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
1058
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
1059
- // return date error
1060
- return $daysBetweenSettlementAndMaturity;
1061
- }
1062
-
1063
- return ((1 - $price / $redemption) / $daysBetweenSettlementAndMaturity);
1064
- }
1065
- return PHPExcel_Calculation_Functions::VALUE();
1066
- }
1067
-
1068
-
1069
- /**
1070
- * DOLLARDE
1071
- *
1072
- * Converts a dollar price expressed as an integer part and a fraction
1073
- * part into a dollar price expressed as a decimal number.
1074
- * Fractional dollar numbers are sometimes used for security prices.
1075
- *
1076
- * Excel Function:
1077
- * DOLLARDE(fractional_dollar,fraction)
1078
- *
1079
- * @access public
1080
- * @category Financial Functions
1081
- * @param float $fractional_dollar Fractional Dollar
1082
- * @param integer $fraction Fraction
1083
- * @return float
1084
- */
1085
- public static function DOLLARDE($fractional_dollar = null, $fraction = 0)
1086
- {
1087
- $fractional_dollar = PHPExcel_Calculation_Functions::flattenSingleValue($fractional_dollar);
1088
- $fraction = (int)PHPExcel_Calculation_Functions::flattenSingleValue($fraction);
1089
-
1090
- // Validate parameters
1091
- if (is_null($fractional_dollar) || $fraction < 0) {
1092
- return PHPExcel_Calculation_Functions::NaN();
1093
- }
1094
- if ($fraction == 0) {
1095
- return PHPExcel_Calculation_Functions::DIV0();
1096
- }
1097
-
1098
- $dollars = floor($fractional_dollar);
1099
- $cents = fmod($fractional_dollar, 1);
1100
- $cents /= $fraction;
1101
- $cents *= pow(10, ceil(log10($fraction)));
1102
- return $dollars + $cents;
1103
- }
1104
-
1105
-
1106
- /**
1107
- * DOLLARFR
1108
- *
1109
- * Converts a dollar price expressed as a decimal number into a dollar price
1110
- * expressed as a fraction.
1111
- * Fractional dollar numbers are sometimes used for security prices.
1112
- *
1113
- * Excel Function:
1114
- * DOLLARFR(decimal_dollar,fraction)
1115
- *
1116
- * @access public
1117
- * @category Financial Functions
1118
- * @param float $decimal_dollar Decimal Dollar
1119
- * @param integer $fraction Fraction
1120
- * @return float
1121
- */
1122
- public static function DOLLARFR($decimal_dollar = null, $fraction = 0)
1123
- {
1124
- $decimal_dollar = PHPExcel_Calculation_Functions::flattenSingleValue($decimal_dollar);
1125
- $fraction = (int)PHPExcel_Calculation_Functions::flattenSingleValue($fraction);
1126
-
1127
- // Validate parameters
1128
- if (is_null($decimal_dollar) || $fraction < 0) {
1129
- return PHPExcel_Calculation_Functions::NaN();
1130
- }
1131
- if ($fraction == 0) {
1132
- return PHPExcel_Calculation_Functions::DIV0();
1133
- }
1134
-
1135
- $dollars = floor($decimal_dollar);
1136
- $cents = fmod($decimal_dollar, 1);
1137
- $cents *= $fraction;
1138
- $cents *= pow(10, -ceil(log10($fraction)));
1139
- return $dollars + $cents;
1140
- }
1141
-
1142
-
1143
- /**
1144
- * EFFECT
1145
- *
1146
- * Returns the effective interest rate given the nominal rate and the number of
1147
- * compounding payments per year.
1148
- *
1149
- * Excel Function:
1150
- * EFFECT(nominal_rate,npery)
1151
- *
1152
- * @access public
1153
- * @category Financial Functions
1154
- * @param float $nominal_rate Nominal interest rate
1155
- * @param integer $npery Number of compounding payments per year
1156
- * @return float
1157
- */
1158
- public static function EFFECT($nominal_rate = 0, $npery = 0)
1159
- {
1160
- $nominal_rate = PHPExcel_Calculation_Functions::flattenSingleValue($nominal_rate);
1161
- $npery = (int)PHPExcel_Calculation_Functions::flattenSingleValue($npery);
1162
-
1163
- // Validate parameters
1164
- if ($nominal_rate <= 0 || $npery < 1) {
1165
- return PHPExcel_Calculation_Functions::NaN();
1166
- }
1167
-
1168
- return pow((1 + $nominal_rate / $npery), $npery) - 1;
1169
- }
1170
-
1171
-
1172
- /**
1173
- * FV
1174
- *
1175
- * Returns the Future Value of a cash flow with constant payments and interest rate (annuities).
1176
- *
1177
- * Excel Function:
1178
- * FV(rate,nper,pmt[,pv[,type]])
1179
- *
1180
- * @access public
1181
- * @category Financial Functions
1182
- * @param float $rate The interest rate per period
1183
- * @param int $nper Total number of payment periods in an annuity
1184
- * @param float $pmt The payment made each period: it cannot change over the
1185
- * life of the annuity. Typically, pmt contains principal
1186
- * and interest but no other fees or taxes.
1187
- * @param float $pv Present Value, or the lump-sum amount that a series of
1188
- * future payments is worth right now.
1189
- * @param integer $type A number 0 or 1 and indicates when payments are due:
1190
- * 0 or omitted At the end of the period.
1191
- * 1 At the beginning of the period.
1192
- * @return float
1193
- */
1194
- public static function FV($rate = 0, $nper = 0, $pmt = 0, $pv = 0, $type = 0)
1195
- {
1196
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1197
- $nper = PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1198
- $pmt = PHPExcel_Calculation_Functions::flattenSingleValue($pmt);
1199
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1200
- $type = PHPExcel_Calculation_Functions::flattenSingleValue($type);
1201
-
1202
- // Validate parameters
1203
- if ($type != 0 && $type != 1) {
1204
- return PHPExcel_Calculation_Functions::NaN();
1205
- }
1206
-
1207
- // Calculate
1208
- if (!is_null($rate) && $rate != 0) {
1209
- return -$pv * pow(1 + $rate, $nper) - $pmt * (1 + $rate * $type) * (pow(1 + $rate, $nper) - 1) / $rate;
1210
- }
1211
- return -$pv - $pmt * $nper;
1212
- }
1213
-
1214
-
1215
- /**
1216
- * FVSCHEDULE
1217
- *
1218
- * Returns the future value of an initial principal after applying a series of compound interest rates.
1219
- * Use FVSCHEDULE to calculate the future value of an investment with a variable or adjustable rate.
1220
- *
1221
- * Excel Function:
1222
- * FVSCHEDULE(principal,schedule)
1223
- *
1224
- * @param float $principal The present value.
1225
- * @param float[] $schedule An array of interest rates to apply.
1226
- * @return float
1227
- */
1228
- public static function FVSCHEDULE($principal, $schedule)
1229
- {
1230
- $principal = PHPExcel_Calculation_Functions::flattenSingleValue($principal);
1231
- $schedule = PHPExcel_Calculation_Functions::flattenArray($schedule);
1232
-
1233
- foreach ($schedule as $rate) {
1234
- $principal *= 1 + $rate;
1235
- }
1236
-
1237
- return $principal;
1238
- }
1239
-
1240
-
1241
- /**
1242
- * INTRATE
1243
- *
1244
- * Returns the interest rate for a fully invested security.
1245
- *
1246
- * Excel Function:
1247
- * INTRATE(settlement,maturity,investment,redemption[,basis])
1248
- *
1249
- * @param mixed $settlement The security's settlement date.
1250
- * The security settlement date is the date after the issue date when the security is traded to the buyer.
1251
- * @param mixed $maturity The security's maturity date.
1252
- * The maturity date is the date when the security expires.
1253
- * @param integer $investment The amount invested in the security.
1254
- * @param integer $redemption The amount to be received at maturity.
1255
- * @param integer $basis The type of day count to use.
1256
- * 0 or omitted US (NASD) 30/360
1257
- * 1 Actual/actual
1258
- * 2 Actual/360
1259
- * 3 Actual/365
1260
- * 4 European 30/360
1261
- * @return float
1262
- */
1263
- public static function INTRATE($settlement, $maturity, $investment, $redemption, $basis = 0)
1264
- {
1265
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1266
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1267
- $investment = PHPExcel_Calculation_Functions::flattenSingleValue($investment);
1268
- $redemption = PHPExcel_Calculation_Functions::flattenSingleValue($redemption);
1269
- $basis = PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1270
-
1271
- // Validate
1272
- if ((is_numeric($investment)) && (is_numeric($redemption)) && (is_numeric($basis))) {
1273
- $investment = (float) $investment;
1274
- $redemption = (float) $redemption;
1275
- $basis = (int) $basis;
1276
- if (($investment <= 0) || ($redemption <= 0)) {
1277
- return PHPExcel_Calculation_Functions::NaN();
1278
- }
1279
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
1280
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
1281
- // return date error
1282
- return $daysBetweenSettlementAndMaturity;
1283
- }
1284
-
1285
- return (($redemption / $investment) - 1) / ($daysBetweenSettlementAndMaturity);
1286
- }
1287
- return PHPExcel_Calculation_Functions::VALUE();
1288
- }
1289
-
1290
-
1291
- /**
1292
- * IPMT
1293
- *
1294
- * Returns the interest payment for a given period for an investment based on periodic, constant payments and a constant interest rate.
1295
- *
1296
- * Excel Function:
1297
- * IPMT(rate,per,nper,pv[,fv][,type])
1298
- *
1299
- * @param float $rate Interest rate per period
1300
- * @param int $per Period for which we want to find the interest
1301
- * @param int $nper Number of periods
1302
- * @param float $pv Present Value
1303
- * @param float $fv Future Value
1304
- * @param int $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
1305
- * @return float
1306
- */
1307
- public static function IPMT($rate, $per, $nper, $pv, $fv = 0, $type = 0)
1308
- {
1309
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1310
- $per = (int) PHPExcel_Calculation_Functions::flattenSingleValue($per);
1311
- $nper = (int) PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1312
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1313
- $fv = PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1314
- $type = (int) PHPExcel_Calculation_Functions::flattenSingleValue($type);
1315
-
1316
- // Validate parameters
1317
- if ($type != 0 && $type != 1) {
1318
- return PHPExcel_Calculation_Functions::NaN();
1319
- }
1320
- if ($per <= 0 || $per > $nper) {
1321
- return PHPExcel_Calculation_Functions::VALUE();
1322
- }
1323
-
1324
- // Calculate
1325
- $interestAndPrincipal = self::interestAndPrincipal($rate, $per, $nper, $pv, $fv, $type);
1326
- return $interestAndPrincipal[0];
1327
- }
1328
-
1329
- /**
1330
- * IRR
1331
- *
1332
- * Returns the internal rate of return for a series of cash flows represented by the numbers in values.
1333
- * These cash flows do not have to be even, as they would be for an annuity. However, the cash flows must occur
1334
- * at regular intervals, such as monthly or annually. The internal rate of return is the interest rate received
1335
- * for an investment consisting of payments (negative values) and income (positive values) that occur at regular
1336
- * periods.
1337
- *
1338
- * Excel Function:
1339
- * IRR(values[,guess])
1340
- *
1341
- * @param float[] $values An array or a reference to cells that contain numbers for which you want
1342
- * to calculate the internal rate of return.
1343
- * Values must contain at least one positive value and one negative value to
1344
- * calculate the internal rate of return.
1345
- * @param float $guess A number that you guess is close to the result of IRR
1346
- * @return float
1347
- */
1348
- public static function IRR($values, $guess = 0.1)
1349
- {
1350
- if (!is_array($values)) {
1351
- return PHPExcel_Calculation_Functions::VALUE();
1352
- }
1353
- $values = PHPExcel_Calculation_Functions::flattenArray($values);
1354
- $guess = PHPExcel_Calculation_Functions::flattenSingleValue($guess);
1355
-
1356
- // create an initial range, with a root somewhere between 0 and guess
1357
- $x1 = 0.0;
1358
- $x2 = $guess;
1359
- $f1 = self::NPV($x1, $values);
1360
- $f2 = self::NPV($x2, $values);
1361
- for ($i = 0; $i < FINANCIAL_MAX_ITERATIONS; ++$i) {
1362
- if (($f1 * $f2) < 0.0) {
1363
- break;
1364
- }
1365
- if (abs($f1) < abs($f2)) {
1366
- $f1 = self::NPV($x1 += 1.6 * ($x1 - $x2), $values);
1367
- } else {
1368
- $f2 = self::NPV($x2 += 1.6 * ($x2 - $x1), $values);
1369
- }
1370
- }
1371
- if (($f1 * $f2) > 0.0) {
1372
- return PHPExcel_Calculation_Functions::VALUE();
1373
- }
1374
-
1375
- $f = self::NPV($x1, $values);
1376
- if ($f < 0.0) {
1377
- $rtb = $x1;
1378
- $dx = $x2 - $x1;
1379
- } else {
1380
- $rtb = $x2;
1381
- $dx = $x1 - $x2;
1382
- }
1383
-
1384
- for ($i = 0; $i < FINANCIAL_MAX_ITERATIONS; ++$i) {
1385
- $dx *= 0.5;
1386
- $x_mid = $rtb + $dx;
1387
- $f_mid = self::NPV($x_mid, $values);
1388
- if ($f_mid <= 0.0) {
1389
- $rtb = $x_mid;
1390
- }
1391
- if ((abs($f_mid) < FINANCIAL_PRECISION) || (abs($dx) < FINANCIAL_PRECISION)) {
1392
- return $x_mid;
1393
- }
1394
- }
1395
- return PHPExcel_Calculation_Functions::VALUE();
1396
- }
1397
-
1398
-
1399
- /**
1400
- * ISPMT
1401
- *
1402
- * Returns the interest payment for an investment based on an interest rate and a constant payment schedule.
1403
- *
1404
- * Excel Function:
1405
- * =ISPMT(interest_rate, period, number_payments, PV)
1406
- *
1407
- * interest_rate is the interest rate for the investment
1408
- *
1409
- * period is the period to calculate the interest rate. It must be betweeen 1 and number_payments.
1410
- *
1411
- * number_payments is the number of payments for the annuity
1412
- *
1413
- * PV is the loan amount or present value of the payments
1414
- */
1415
- public static function ISPMT()
1416
- {
1417
- // Return value
1418
- $returnValue = 0;
1419
-
1420
- // Get the parameters
1421
- $aArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
1422
- $interestRate = array_shift($aArgs);
1423
- $period = array_shift($aArgs);
1424
- $numberPeriods = array_shift($aArgs);
1425
- $principleRemaining = array_shift($aArgs);
1426
-
1427
- // Calculate
1428
- $principlePayment = ($principleRemaining * 1.0) / ($numberPeriods * 1.0);
1429
- for ($i=0; $i <= $period; ++$i) {
1430
- $returnValue = $interestRate * $principleRemaining * -1;
1431
- $principleRemaining -= $principlePayment;
1432
- // principle needs to be 0 after the last payment, don't let floating point screw it up
1433
- if ($i == $numberPeriods) {
1434
- $returnValue = 0;
1435
- }
1436
- }
1437
- return($returnValue);
1438
- }
1439
-
1440
-
1441
- /**
1442
- * MIRR
1443
- *
1444
- * Returns the modified internal rate of return for a series of periodic cash flows. MIRR considers both
1445
- * the cost of the investment and the interest received on reinvestment of cash.
1446
- *
1447
- * Excel Function:
1448
- * MIRR(values,finance_rate, reinvestment_rate)
1449
- *
1450
- * @param float[] $values An array or a reference to cells that contain a series of payments and
1451
- * income occurring at regular intervals.
1452
- * Payments are negative value, income is positive values.
1453
- * @param float $finance_rate The interest rate you pay on the money used in the cash flows
1454
- * @param float $reinvestment_rate The interest rate you receive on the cash flows as you reinvest them
1455
- * @return float
1456
- */
1457
- public static function MIRR($values, $finance_rate, $reinvestment_rate)
1458
- {
1459
- if (!is_array($values)) {
1460
- return PHPExcel_Calculation_Functions::VALUE();
1461
- }
1462
- $values = PHPExcel_Calculation_Functions::flattenArray($values);
1463
- $finance_rate = PHPExcel_Calculation_Functions::flattenSingleValue($finance_rate);
1464
- $reinvestment_rate = PHPExcel_Calculation_Functions::flattenSingleValue($reinvestment_rate);
1465
- $n = count($values);
1466
-
1467
- $rr = 1.0 + $reinvestment_rate;
1468
- $fr = 1.0 + $finance_rate;
1469
-
1470
- $npv_pos = $npv_neg = 0.0;
1471
- foreach ($values as $i => $v) {
1472
- if ($v >= 0) {
1473
- $npv_pos += $v / pow($rr, $i);
1474
- } else {
1475
- $npv_neg += $v / pow($fr, $i);
1476
- }
1477
- }
1478
-
1479
- if (($npv_neg == 0) || ($npv_pos == 0) || ($reinvestment_rate <= -1)) {
1480
- return PHPExcel_Calculation_Functions::VALUE();
1481
- }
1482
-
1483
- $mirr = pow((-$npv_pos * pow($rr, $n))
1484
- / ($npv_neg * ($rr)), (1.0 / ($n - 1))) - 1.0;
1485
-
1486
- return (is_finite($mirr) ? $mirr : PHPExcel_Calculation_Functions::VALUE());
1487
- }
1488
-
1489
-
1490
- /**
1491
- * NOMINAL
1492
- *
1493
- * Returns the nominal interest rate given the effective rate and the number of compounding payments per year.
1494
- *
1495
- * @param float $effect_rate Effective interest rate
1496
- * @param int $npery Number of compounding payments per year
1497
- * @return float
1498
- */
1499
- public static function NOMINAL($effect_rate = 0, $npery = 0)
1500
- {
1501
- $effect_rate = PHPExcel_Calculation_Functions::flattenSingleValue($effect_rate);
1502
- $npery = (int)PHPExcel_Calculation_Functions::flattenSingleValue($npery);
1503
-
1504
- // Validate parameters
1505
- if ($effect_rate <= 0 || $npery < 1) {
1506
- return PHPExcel_Calculation_Functions::NaN();
1507
- }
1508
-
1509
- // Calculate
1510
- return $npery * (pow($effect_rate + 1, 1 / $npery) - 1);
1511
- }
1512
-
1513
-
1514
- /**
1515
- * NPER
1516
- *
1517
- * Returns the number of periods for a cash flow with constant periodic payments (annuities), and interest rate.
1518
- *
1519
- * @param float $rate Interest rate per period
1520
- * @param int $pmt Periodic payment (annuity)
1521
- * @param float $pv Present Value
1522
- * @param float $fv Future Value
1523
- * @param int $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
1524
- * @return float
1525
- */
1526
- public static function NPER($rate = 0, $pmt = 0, $pv = 0, $fv = 0, $type = 0)
1527
- {
1528
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1529
- $pmt = PHPExcel_Calculation_Functions::flattenSingleValue($pmt);
1530
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1531
- $fv = PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1532
- $type = PHPExcel_Calculation_Functions::flattenSingleValue($type);
1533
-
1534
- // Validate parameters
1535
- if ($type != 0 && $type != 1) {
1536
- return PHPExcel_Calculation_Functions::NaN();
1537
- }
1538
-
1539
- // Calculate
1540
- if (!is_null($rate) && $rate != 0) {
1541
- if ($pmt == 0 && $pv == 0) {
1542
- return PHPExcel_Calculation_Functions::NaN();
1543
- }
1544
- return log(($pmt * (1 + $rate * $type) / $rate - $fv) / ($pv + $pmt * (1 + $rate * $type) / $rate)) / log(1 + $rate);
1545
- }
1546
- if ($pmt == 0) {
1547
- return PHPExcel_Calculation_Functions::NaN();
1548
- }
1549
- return (-$pv -$fv) / $pmt;
1550
- }
1551
-
1552
- /**
1553
- * NPV
1554
- *
1555
- * Returns the Net Present Value of a cash flow series given a discount rate.
1556
- *
1557
- * @return float
1558
- */
1559
- public static function NPV()
1560
- {
1561
- // Return value
1562
- $returnValue = 0;
1563
-
1564
- // Loop through arguments
1565
- $aArgs = PHPExcel_Calculation_Functions::flattenArray(func_get_args());
1566
-
1567
- // Calculate
1568
- $rate = array_shift($aArgs);
1569
- for ($i = 1; $i <= count($aArgs); ++$i) {
1570
- // Is it a numeric value?
1571
- if (is_numeric($aArgs[$i - 1])) {
1572
- $returnValue += $aArgs[$i - 1] / pow(1 + $rate, $i);
1573
- }
1574
- }
1575
-
1576
- // Return
1577
- return $returnValue;
1578
- }
1579
-
1580
- /**
1581
- * PMT
1582
- *
1583
- * Returns the constant payment (annuity) for a cash flow with a constant interest rate.
1584
- *
1585
- * @param float $rate Interest rate per period
1586
- * @param int $nper Number of periods
1587
- * @param float $pv Present Value
1588
- * @param float $fv Future Value
1589
- * @param int $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
1590
- * @return float
1591
- */
1592
- public static function PMT($rate = 0, $nper = 0, $pv = 0, $fv = 0, $type = 0)
1593
- {
1594
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1595
- $nper = PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1596
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1597
- $fv = PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1598
- $type = PHPExcel_Calculation_Functions::flattenSingleValue($type);
1599
-
1600
- // Validate parameters
1601
- if ($type != 0 && $type != 1) {
1602
- return PHPExcel_Calculation_Functions::NaN();
1603
- }
1604
-
1605
- // Calculate
1606
- if (!is_null($rate) && $rate != 0) {
1607
- return (-$fv - $pv * pow(1 + $rate, $nper)) / (1 + $rate * $type) / ((pow(1 + $rate, $nper) - 1) / $rate);
1608
- }
1609
- return (-$pv - $fv) / $nper;
1610
- }
1611
-
1612
-
1613
- /**
1614
- * PPMT
1615
- *
1616
- * Returns the interest payment for a given period for an investment based on periodic, constant payments and a constant interest rate.
1617
- *
1618
- * @param float $rate Interest rate per period
1619
- * @param int $per Period for which we want to find the interest
1620
- * @param int $nper Number of periods
1621
- * @param float $pv Present Value
1622
- * @param float $fv Future Value
1623
- * @param int $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
1624
- * @return float
1625
- */
1626
- public static function PPMT($rate, $per, $nper, $pv, $fv = 0, $type = 0)
1627
- {
1628
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1629
- $per = (int) PHPExcel_Calculation_Functions::flattenSingleValue($per);
1630
- $nper = (int) PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1631
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1632
- $fv = PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1633
- $type = (int) PHPExcel_Calculation_Functions::flattenSingleValue($type);
1634
-
1635
- // Validate parameters
1636
- if ($type != 0 && $type != 1) {
1637
- return PHPExcel_Calculation_Functions::NaN();
1638
- }
1639
- if ($per <= 0 || $per > $nper) {
1640
- return PHPExcel_Calculation_Functions::VALUE();
1641
- }
1642
-
1643
- // Calculate
1644
- $interestAndPrincipal = self::interestAndPrincipal($rate, $per, $nper, $pv, $fv, $type);
1645
- return $interestAndPrincipal[1];
1646
- }
1647
-
1648
-
1649
- public static function PRICE($settlement, $maturity, $rate, $yield, $redemption, $frequency, $basis = 0)
1650
- {
1651
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1652
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1653
- $rate = (float) PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1654
- $yield = (float) PHPExcel_Calculation_Functions::flattenSingleValue($yield);
1655
- $redemption = (float) PHPExcel_Calculation_Functions::flattenSingleValue($redemption);
1656
- $frequency = (int) PHPExcel_Calculation_Functions::flattenSingleValue($frequency);
1657
- $basis = (is_null($basis)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1658
-
1659
- if (is_string($settlement = PHPExcel_Calculation_DateTime::getDateValue($settlement))) {
1660
- return PHPExcel_Calculation_Functions::VALUE();
1661
- }
1662
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
1663
- return PHPExcel_Calculation_Functions::VALUE();
1664
- }
1665
-
1666
- if (($settlement > $maturity) ||
1667
- (!self::isValidFrequency($frequency)) ||
1668
- (($basis < 0) || ($basis > 4))) {
1669
- return PHPExcel_Calculation_Functions::NaN();
1670
- }
1671
-
1672
- $dsc = self::COUPDAYSNC($settlement, $maturity, $frequency, $basis);
1673
- $e = self::COUPDAYS($settlement, $maturity, $frequency, $basis);
1674
- $n = self::COUPNUM($settlement, $maturity, $frequency, $basis);
1675
- $a = self::COUPDAYBS($settlement, $maturity, $frequency, $basis);
1676
-
1677
- $baseYF = 1.0 + ($yield / $frequency);
1678
- $rfp = 100 * ($rate / $frequency);
1679
- $de = $dsc / $e;
1680
-
1681
- $result = $redemption / pow($baseYF, (--$n + $de));
1682
- for ($k = 0; $k <= $n; ++$k) {
1683
- $result += $rfp / (pow($baseYF, ($k + $de)));
1684
- }
1685
- $result -= $rfp * ($a / $e);
1686
-
1687
- return $result;
1688
- }
1689
-
1690
-
1691
- /**
1692
- * PRICEDISC
1693
- *
1694
- * Returns the price per $100 face value of a discounted security.
1695
- *
1696
- * @param mixed settlement The security's settlement date.
1697
- * The security settlement date is the date after the issue date when the security is traded to the buyer.
1698
- * @param mixed maturity The security's maturity date.
1699
- * The maturity date is the date when the security expires.
1700
- * @param int discount The security's discount rate.
1701
- * @param int redemption The security's redemption value per $100 face value.
1702
- * @param int basis The type of day count to use.
1703
- * 0 or omitted US (NASD) 30/360
1704
- * 1 Actual/actual
1705
- * 2 Actual/360
1706
- * 3 Actual/365
1707
- * 4 European 30/360
1708
- * @return float
1709
- */
1710
- public static function PRICEDISC($settlement, $maturity, $discount, $redemption, $basis = 0)
1711
- {
1712
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1713
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1714
- $discount = (float) PHPExcel_Calculation_Functions::flattenSingleValue($discount);
1715
- $redemption = (float) PHPExcel_Calculation_Functions::flattenSingleValue($redemption);
1716
- $basis = (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1717
-
1718
- // Validate
1719
- if ((is_numeric($discount)) && (is_numeric($redemption)) && (is_numeric($basis))) {
1720
- if (($discount <= 0) || ($redemption <= 0)) {
1721
- return PHPExcel_Calculation_Functions::NaN();
1722
- }
1723
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
1724
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
1725
- // return date error
1726
- return $daysBetweenSettlementAndMaturity;
1727
- }
1728
-
1729
- return $redemption * (1 - $discount * $daysBetweenSettlementAndMaturity);
1730
- }
1731
- return PHPExcel_Calculation_Functions::VALUE();
1732
- }
1733
-
1734
-
1735
- /**
1736
- * PRICEMAT
1737
- *
1738
- * Returns the price per $100 face value of a security that pays interest at maturity.
1739
- *
1740
- * @param mixed settlement The security's settlement date.
1741
- * The security's settlement date is the date after the issue date when the security is traded to the buyer.
1742
- * @param mixed maturity The security's maturity date.
1743
- * The maturity date is the date when the security expires.
1744
- * @param mixed issue The security's issue date.
1745
- * @param int rate The security's interest rate at date of issue.
1746
- * @param int yield The security's annual yield.
1747
- * @param int basis The type of day count to use.
1748
- * 0 or omitted US (NASD) 30/360
1749
- * 1 Actual/actual
1750
- * 2 Actual/360
1751
- * 3 Actual/365
1752
- * 4 European 30/360
1753
- * @return float
1754
- */
1755
- public static function PRICEMAT($settlement, $maturity, $issue, $rate, $yield, $basis = 0)
1756
- {
1757
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1758
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1759
- $issue = PHPExcel_Calculation_Functions::flattenSingleValue($issue);
1760
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1761
- $yield = PHPExcel_Calculation_Functions::flattenSingleValue($yield);
1762
- $basis = (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1763
-
1764
- // Validate
1765
- if (is_numeric($rate) && is_numeric($yield)) {
1766
- if (($rate <= 0) || ($yield <= 0)) {
1767
- return PHPExcel_Calculation_Functions::NaN();
1768
- }
1769
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($settlement), $basis);
1770
- if (!is_numeric($daysPerYear)) {
1771
- return $daysPerYear;
1772
- }
1773
- $daysBetweenIssueAndSettlement = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $settlement, $basis);
1774
- if (!is_numeric($daysBetweenIssueAndSettlement)) {
1775
- // return date error
1776
- return $daysBetweenIssueAndSettlement;
1777
- }
1778
- $daysBetweenIssueAndSettlement *= $daysPerYear;
1779
- $daysBetweenIssueAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $maturity, $basis);
1780
- if (!is_numeric($daysBetweenIssueAndMaturity)) {
1781
- // return date error
1782
- return $daysBetweenIssueAndMaturity;
1783
- }
1784
- $daysBetweenIssueAndMaturity *= $daysPerYear;
1785
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
1786
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
1787
- // return date error
1788
- return $daysBetweenSettlementAndMaturity;
1789
- }
1790
- $daysBetweenSettlementAndMaturity *= $daysPerYear;
1791
-
1792
- return ((100 + (($daysBetweenIssueAndMaturity / $daysPerYear) * $rate * 100)) /
1793
- (1 + (($daysBetweenSettlementAndMaturity / $daysPerYear) * $yield)) -
1794
- (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate * 100));
1795
- }
1796
- return PHPExcel_Calculation_Functions::VALUE();
1797
- }
1798
-
1799
-
1800
- /**
1801
- * PV
1802
- *
1803
- * Returns the Present Value of a cash flow with constant payments and interest rate (annuities).
1804
- *
1805
- * @param float $rate Interest rate per period
1806
- * @param int $nper Number of periods
1807
- * @param float $pmt Periodic payment (annuity)
1808
- * @param float $fv Future Value
1809
- * @param int $type Payment type: 0 = at the end of each period, 1 = at the beginning of each period
1810
- * @return float
1811
- */
1812
- public static function PV($rate = 0, $nper = 0, $pmt = 0, $fv = 0, $type = 0)
1813
- {
1814
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
1815
- $nper = PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1816
- $pmt = PHPExcel_Calculation_Functions::flattenSingleValue($pmt);
1817
- $fv = PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1818
- $type = PHPExcel_Calculation_Functions::flattenSingleValue($type);
1819
-
1820
- // Validate parameters
1821
- if ($type != 0 && $type != 1) {
1822
- return PHPExcel_Calculation_Functions::NaN();
1823
- }
1824
-
1825
- // Calculate
1826
- if (!is_null($rate) && $rate != 0) {
1827
- return (-$pmt * (1 + $rate * $type) * ((pow(1 + $rate, $nper) - 1) / $rate) - $fv) / pow(1 + $rate, $nper);
1828
- }
1829
- return -$fv - $pmt * $nper;
1830
- }
1831
-
1832
-
1833
- /**
1834
- * RATE
1835
- *
1836
- * Returns the interest rate per period of an annuity.
1837
- * RATE is calculated by iteration and can have zero or more solutions.
1838
- * If the successive results of RATE do not converge to within 0.0000001 after 20 iterations,
1839
- * RATE returns the #NUM! error value.
1840
- *
1841
- * Excel Function:
1842
- * RATE(nper,pmt,pv[,fv[,type[,guess]]])
1843
- *
1844
- * @access public
1845
- * @category Financial Functions
1846
- * @param float nper The total number of payment periods in an annuity.
1847
- * @param float pmt The payment made each period and cannot change over the life
1848
- * of the annuity.
1849
- * Typically, pmt includes principal and interest but no other
1850
- * fees or taxes.
1851
- * @param float pv The present value - the total amount that a series of future
1852
- * payments is worth now.
1853
- * @param float fv The future value, or a cash balance you want to attain after
1854
- * the last payment is made. If fv is omitted, it is assumed
1855
- * to be 0 (the future value of a loan, for example, is 0).
1856
- * @param integer type A number 0 or 1 and indicates when payments are due:
1857
- * 0 or omitted At the end of the period.
1858
- * 1 At the beginning of the period.
1859
- * @param float guess Your guess for what the rate will be.
1860
- * If you omit guess, it is assumed to be 10 percent.
1861
- * @return float
1862
- **/
1863
- public static function RATE($nper, $pmt, $pv, $fv = 0.0, $type = 0, $guess = 0.1)
1864
- {
1865
- $nper = (int) PHPExcel_Calculation_Functions::flattenSingleValue($nper);
1866
- $pmt = PHPExcel_Calculation_Functions::flattenSingleValue($pmt);
1867
- $pv = PHPExcel_Calculation_Functions::flattenSingleValue($pv);
1868
- $fv = (is_null($fv)) ? 0.0 : PHPExcel_Calculation_Functions::flattenSingleValue($fv);
1869
- $type = (is_null($type)) ? 0 : (int) PHPExcel_Calculation_Functions::flattenSingleValue($type);
1870
- $guess = (is_null($guess)) ? 0.1 : PHPExcel_Calculation_Functions::flattenSingleValue($guess);
1871
-
1872
- $rate = $guess;
1873
- if (abs($rate) < FINANCIAL_PRECISION) {
1874
- $y = $pv * (1 + $nper * $rate) + $pmt * (1 + $rate * $type) * $nper + $fv;
1875
- } else {
1876
- $f = exp($nper * log(1 + $rate));
1877
- $y = $pv * $f + $pmt * (1 / $rate + $type) * ($f - 1) + $fv;
1878
- }
1879
- $y0 = $pv + $pmt * $nper + $fv;
1880
- $y1 = $pv * $f + $pmt * (1 / $rate + $type) * ($f - 1) + $fv;
1881
-
1882
- // find root by secant method
1883
- $i = $x0 = 0.0;
1884
- $x1 = $rate;
1885
- while ((abs($y0 - $y1) > FINANCIAL_PRECISION) && ($i < FINANCIAL_MAX_ITERATIONS)) {
1886
- $rate = ($y1 * $x0 - $y0 * $x1) / ($y1 - $y0);
1887
- $x0 = $x1;
1888
- $x1 = $rate;
1889
- if (($nper * abs($pmt)) > ($pv - $fv)) {
1890
- $x1 = abs($x1);
1891
- }
1892
- if (abs($rate) < FINANCIAL_PRECISION) {
1893
- $y = $pv * (1 + $nper * $rate) + $pmt * (1 + $rate * $type) * $nper + $fv;
1894
- } else {
1895
- $f = exp($nper * log(1 + $rate));
1896
- $y = $pv * $f + $pmt * (1 / $rate + $type) * ($f - 1) + $fv;
1897
- }
1898
-
1899
- $y0 = $y1;
1900
- $y1 = $y;
1901
- ++$i;
1902
- }
1903
- return $rate;
1904
- }
1905
-
1906
-
1907
- /**
1908
- * RECEIVED
1909
- *
1910
- * Returns the price per $100 face value of a discounted security.
1911
- *
1912
- * @param mixed settlement The security's settlement date.
1913
- * The security settlement date is the date after the issue date when the security is traded to the buyer.
1914
- * @param mixed maturity The security's maturity date.
1915
- * The maturity date is the date when the security expires.
1916
- * @param int investment The amount invested in the security.
1917
- * @param int discount The security's discount rate.
1918
- * @param int basis The type of day count to use.
1919
- * 0 or omitted US (NASD) 30/360
1920
- * 1 Actual/actual
1921
- * 2 Actual/360
1922
- * 3 Actual/365
1923
- * 4 European 30/360
1924
- * @return float
1925
- */
1926
- public static function RECEIVED($settlement, $maturity, $investment, $discount, $basis = 0)
1927
- {
1928
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
1929
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
1930
- $investment = (float) PHPExcel_Calculation_Functions::flattenSingleValue($investment);
1931
- $discount = (float) PHPExcel_Calculation_Functions::flattenSingleValue($discount);
1932
- $basis = (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
1933
-
1934
- // Validate
1935
- if ((is_numeric($investment)) && (is_numeric($discount)) && (is_numeric($basis))) {
1936
- if (($investment <= 0) || ($discount <= 0)) {
1937
- return PHPExcel_Calculation_Functions::NaN();
1938
- }
1939
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
1940
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
1941
- // return date error
1942
- return $daysBetweenSettlementAndMaturity;
1943
- }
1944
-
1945
- return $investment / ( 1 - ($discount * $daysBetweenSettlementAndMaturity));
1946
- }
1947
- return PHPExcel_Calculation_Functions::VALUE();
1948
- }
1949
-
1950
-
1951
- /**
1952
- * SLN
1953
- *
1954
- * Returns the straight-line depreciation of an asset for one period
1955
- *
1956
- * @param cost Initial cost of the asset
1957
- * @param salvage Value at the end of the depreciation
1958
- * @param life Number of periods over which the asset is depreciated
1959
- * @return float
1960
- */
1961
- public static function SLN($cost, $salvage, $life)
1962
- {
1963
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
1964
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
1965
- $life = PHPExcel_Calculation_Functions::flattenSingleValue($life);
1966
-
1967
- // Calculate
1968
- if ((is_numeric($cost)) && (is_numeric($salvage)) && (is_numeric($life))) {
1969
- if ($life < 0) {
1970
- return PHPExcel_Calculation_Functions::NaN();
1971
- }
1972
- return ($cost - $salvage) / $life;
1973
- }
1974
- return PHPExcel_Calculation_Functions::VALUE();
1975
- }
1976
-
1977
-
1978
- /**
1979
- * SYD
1980
- *
1981
- * Returns the sum-of-years' digits depreciation of an asset for a specified period.
1982
- *
1983
- * @param cost Initial cost of the asset
1984
- * @param salvage Value at the end of the depreciation
1985
- * @param life Number of periods over which the asset is depreciated
1986
- * @param period Period
1987
- * @return float
1988
- */
1989
- public static function SYD($cost, $salvage, $life, $period)
1990
- {
1991
- $cost = PHPExcel_Calculation_Functions::flattenSingleValue($cost);
1992
- $salvage = PHPExcel_Calculation_Functions::flattenSingleValue($salvage);
1993
- $life = PHPExcel_Calculation_Functions::flattenSingleValue($life);
1994
- $period = PHPExcel_Calculation_Functions::flattenSingleValue($period);
1995
-
1996
- // Calculate
1997
- if ((is_numeric($cost)) && (is_numeric($salvage)) && (is_numeric($life)) && (is_numeric($period))) {
1998
- if (($life < 1) || ($period > $life)) {
1999
- return PHPExcel_Calculation_Functions::NaN();
2000
- }
2001
- return (($cost - $salvage) * ($life - $period + 1) * 2) / ($life * ($life + 1));
2002
- }
2003
- return PHPExcel_Calculation_Functions::VALUE();
2004
- }
2005
-
2006
-
2007
- /**
2008
- * TBILLEQ
2009
- *
2010
- * Returns the bond-equivalent yield for a Treasury bill.
2011
- *
2012
- * @param mixed settlement The Treasury bill's settlement date.
2013
- * The Treasury bill's settlement date is the date after the issue date when the Treasury bill is traded to the buyer.
2014
- * @param mixed maturity The Treasury bill's maturity date.
2015
- * The maturity date is the date when the Treasury bill expires.
2016
- * @param int discount The Treasury bill's discount rate.
2017
- * @return float
2018
- */
2019
- public static function TBILLEQ($settlement, $maturity, $discount)
2020
- {
2021
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
2022
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
2023
- $discount = PHPExcel_Calculation_Functions::flattenSingleValue($discount);
2024
-
2025
- // Use TBILLPRICE for validation
2026
- $testValue = self::TBILLPRICE($settlement, $maturity, $discount);
2027
- if (is_string($testValue)) {
2028
- return $testValue;
2029
- }
2030
-
2031
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
2032
- return PHPExcel_Calculation_Functions::VALUE();
2033
- }
2034
-
2035
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
2036
- ++$maturity;
2037
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity) * 360;
2038
- } else {
2039
- $daysBetweenSettlementAndMaturity = (PHPExcel_Calculation_DateTime::getDateValue($maturity) - PHPExcel_Calculation_DateTime::getDateValue($settlement));
2040
- }
2041
-
2042
- return (365 * $discount) / (360 - $discount * $daysBetweenSettlementAndMaturity);
2043
- }
2044
-
2045
-
2046
- /**
2047
- * TBILLPRICE
2048
- *
2049
- * Returns the yield for a Treasury bill.
2050
- *
2051
- * @param mixed settlement The Treasury bill's settlement date.
2052
- * The Treasury bill's settlement date is the date after the issue date when the Treasury bill is traded to the buyer.
2053
- * @param mixed maturity The Treasury bill's maturity date.
2054
- * The maturity date is the date when the Treasury bill expires.
2055
- * @param int discount The Treasury bill's discount rate.
2056
- * @return float
2057
- */
2058
- public static function TBILLPRICE($settlement, $maturity, $discount)
2059
- {
2060
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
2061
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
2062
- $discount = PHPExcel_Calculation_Functions::flattenSingleValue($discount);
2063
-
2064
- if (is_string($maturity = PHPExcel_Calculation_DateTime::getDateValue($maturity))) {
2065
- return PHPExcel_Calculation_Functions::VALUE();
2066
- }
2067
-
2068
- // Validate
2069
- if (is_numeric($discount)) {
2070
- if ($discount <= 0) {
2071
- return PHPExcel_Calculation_Functions::NaN();
2072
- }
2073
-
2074
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
2075
- ++$maturity;
2076
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity) * 360;
2077
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
2078
- // return date error
2079
- return $daysBetweenSettlementAndMaturity;
2080
- }
2081
- } else {
2082
- $daysBetweenSettlementAndMaturity = (PHPExcel_Calculation_DateTime::getDateValue($maturity) - PHPExcel_Calculation_DateTime::getDateValue($settlement));
2083
- }
2084
-
2085
- if ($daysBetweenSettlementAndMaturity > 360) {
2086
- return PHPExcel_Calculation_Functions::NaN();
2087
- }
2088
-
2089
- $price = 100 * (1 - (($discount * $daysBetweenSettlementAndMaturity) / 360));
2090
- if ($price <= 0) {
2091
- return PHPExcel_Calculation_Functions::NaN();
2092
- }
2093
- return $price;
2094
- }
2095
- return PHPExcel_Calculation_Functions::VALUE();
2096
- }
2097
-
2098
-
2099
- /**
2100
- * TBILLYIELD
2101
- *
2102
- * Returns the yield for a Treasury bill.
2103
- *
2104
- * @param mixed settlement The Treasury bill's settlement date.
2105
- * The Treasury bill's settlement date is the date after the issue date when the Treasury bill is traded to the buyer.
2106
- * @param mixed maturity The Treasury bill's maturity date.
2107
- * The maturity date is the date when the Treasury bill expires.
2108
- * @param int price The Treasury bill's price per $100 face value.
2109
- * @return float
2110
- */
2111
- public static function TBILLYIELD($settlement, $maturity, $price)
2112
- {
2113
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
2114
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
2115
- $price = PHPExcel_Calculation_Functions::flattenSingleValue($price);
2116
-
2117
- // Validate
2118
- if (is_numeric($price)) {
2119
- if ($price <= 0) {
2120
- return PHPExcel_Calculation_Functions::NaN();
2121
- }
2122
-
2123
- if (PHPExcel_Calculation_Functions::getCompatibilityMode() == PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE) {
2124
- ++$maturity;
2125
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity) * 360;
2126
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
2127
- // return date error
2128
- return $daysBetweenSettlementAndMaturity;
2129
- }
2130
- } else {
2131
- $daysBetweenSettlementAndMaturity = (PHPExcel_Calculation_DateTime::getDateValue($maturity) - PHPExcel_Calculation_DateTime::getDateValue($settlement));
2132
- }
2133
-
2134
- if ($daysBetweenSettlementAndMaturity > 360) {
2135
- return PHPExcel_Calculation_Functions::NaN();
2136
- }
2137
-
2138
- return ((100 - $price) / $price) * (360 / $daysBetweenSettlementAndMaturity);
2139
- }
2140
- return PHPExcel_Calculation_Functions::VALUE();
2141
- }
2142
-
2143
-
2144
- public static function XIRR($values, $dates, $guess = 0.1)
2145
- {
2146
- if ((!is_array($values)) && (!is_array($dates))) {
2147
- return PHPExcel_Calculation_Functions::VALUE();
2148
- }
2149
- $values = PHPExcel_Calculation_Functions::flattenArray($values);
2150
- $dates = PHPExcel_Calculation_Functions::flattenArray($dates);
2151
- $guess = PHPExcel_Calculation_Functions::flattenSingleValue($guess);
2152
- if (count($values) != count($dates)) {
2153
- return PHPExcel_Calculation_Functions::NaN();
2154
- }
2155
-
2156
- // create an initial range, with a root somewhere between 0 and guess
2157
- $x1 = 0.0;
2158
- $x2 = $guess;
2159
- $f1 = self::XNPV($x1, $values, $dates);
2160
- $f2 = self::XNPV($x2, $values, $dates);
2161
- for ($i = 0; $i < FINANCIAL_MAX_ITERATIONS; ++$i) {
2162
- if (($f1 * $f2) < 0.0) {
2163
- break;
2164
- } elseif (abs($f1) < abs($f2)) {
2165
- $f1 = self::XNPV($x1 += 1.6 * ($x1 - $x2), $values, $dates);
2166
- } else {
2167
- $f2 = self::XNPV($x2 += 1.6 * ($x2 - $x1), $values, $dates);
2168
- }
2169
- }
2170
- if (($f1 * $f2) > 0.0) {
2171
- return PHPExcel_Calculation_Functions::VALUE();
2172
- }
2173
-
2174
- $f = self::XNPV($x1, $values, $dates);
2175
- if ($f < 0.0) {
2176
- $rtb = $x1;
2177
- $dx = $x2 - $x1;
2178
- } else {
2179
- $rtb = $x2;
2180
- $dx = $x1 - $x2;
2181
- }
2182
-
2183
- for ($i = 0; $i < FINANCIAL_MAX_ITERATIONS; ++$i) {
2184
- $dx *= 0.5;
2185
- $x_mid = $rtb + $dx;
2186
- $f_mid = self::XNPV($x_mid, $values, $dates);
2187
- if ($f_mid <= 0.0) {
2188
- $rtb = $x_mid;
2189
- }
2190
- if ((abs($f_mid) < FINANCIAL_PRECISION) || (abs($dx) < FINANCIAL_PRECISION)) {
2191
- return $x_mid;
2192
- }
2193
- }
2194
- return PHPExcel_Calculation_Functions::VALUE();
2195
- }
2196
-
2197
-
2198
- /**
2199
- * XNPV
2200
- *
2201
- * Returns the net present value for a schedule of cash flows that is not necessarily periodic.
2202
- * To calculate the net present value for a series of cash flows that is periodic, use the NPV function.
2203
- *
2204
- * Excel Function:
2205
- * =XNPV(rate,values,dates)
2206
- *
2207
- * @param float $rate The discount rate to apply to the cash flows.
2208
- * @param array of float $values A series of cash flows that corresponds to a schedule of payments in dates.
2209
- * The first payment is optional and corresponds to a cost or payment that occurs at the beginning of the investment.
2210
- * If the first value is a cost or payment, it must be a negative value. All succeeding payments are discounted based on a 365-day year.
2211
- * The series of values must contain at least one positive value and one negative value.
2212
- * @param array of mixed $dates A schedule of payment dates that corresponds to the cash flow payments.
2213
- * The first payment date indicates the beginning of the schedule of payments.
2214
- * All other dates must be later than this date, but they may occur in any order.
2215
- * @return float
2216
- */
2217
- public static function XNPV($rate, $values, $dates)
2218
- {
2219
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
2220
- if (!is_numeric($rate)) {
2221
- return PHPExcel_Calculation_Functions::VALUE();
2222
- }
2223
- if ((!is_array($values)) || (!is_array($dates))) {
2224
- return PHPExcel_Calculation_Functions::VALUE();
2225
- }
2226
- $values = PHPExcel_Calculation_Functions::flattenArray($values);
2227
- $dates = PHPExcel_Calculation_Functions::flattenArray($dates);
2228
- $valCount = count($values);
2229
- if ($valCount != count($dates)) {
2230
- return PHPExcel_Calculation_Functions::NaN();
2231
- }
2232
- if ((min($values) > 0) || (max($values) < 0)) {
2233
- return PHPExcel_Calculation_Functions::VALUE();
2234
- }
2235
-
2236
- $xnpv = 0.0;
2237
- for ($i = 0; $i < $valCount; ++$i) {
2238
- if (!is_numeric($values[$i])) {
2239
- return PHPExcel_Calculation_Functions::VALUE();
2240
- }
2241
- $xnpv += $values[$i] / pow(1 + $rate, PHPExcel_Calculation_DateTime::DATEDIF($dates[0], $dates[$i], 'd') / 365);
2242
- }
2243
- return (is_finite($xnpv)) ? $xnpv : PHPExcel_Calculation_Functions::VALUE();
2244
- }
2245
-
2246
-
2247
- /**
2248
- * YIELDDISC
2249
- *
2250
- * Returns the annual yield of a security that pays interest at maturity.
2251
- *
2252
- * @param mixed settlement The security's settlement date.
2253
- * The security's settlement date is the date after the issue date when the security is traded to the buyer.
2254
- * @param mixed maturity The security's maturity date.
2255
- * The maturity date is the date when the security expires.
2256
- * @param int price The security's price per $100 face value.
2257
- * @param int redemption The security's redemption value per $100 face value.
2258
- * @param int basis The type of day count to use.
2259
- * 0 or omitted US (NASD) 30/360
2260
- * 1 Actual/actual
2261
- * 2 Actual/360
2262
- * 3 Actual/365
2263
- * 4 European 30/360
2264
- * @return float
2265
- */
2266
- public static function YIELDDISC($settlement, $maturity, $price, $redemption, $basis = 0)
2267
- {
2268
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
2269
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
2270
- $price = PHPExcel_Calculation_Functions::flattenSingleValue($price);
2271
- $redemption = PHPExcel_Calculation_Functions::flattenSingleValue($redemption);
2272
- $basis = (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
2273
-
2274
- // Validate
2275
- if (is_numeric($price) && is_numeric($redemption)) {
2276
- if (($price <= 0) || ($redemption <= 0)) {
2277
- return PHPExcel_Calculation_Functions::NaN();
2278
- }
2279
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($settlement), $basis);
2280
- if (!is_numeric($daysPerYear)) {
2281
- return $daysPerYear;
2282
- }
2283
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
2284
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
2285
- // return date error
2286
- return $daysBetweenSettlementAndMaturity;
2287
- }
2288
- $daysBetweenSettlementAndMaturity *= $daysPerYear;
2289
-
2290
- return (($redemption - $price) / $price) * ($daysPerYear / $daysBetweenSettlementAndMaturity);
2291
- }
2292
- return PHPExcel_Calculation_Functions::VALUE();
2293
- }
2294
-
2295
-
2296
- /**
2297
- * YIELDMAT
2298
- *
2299
- * Returns the annual yield of a security that pays interest at maturity.
2300
- *
2301
- * @param mixed settlement The security's settlement date.
2302
- * The security's settlement date is the date after the issue date when the security is traded to the buyer.
2303
- * @param mixed maturity The security's maturity date.
2304
- * The maturity date is the date when the security expires.
2305
- * @param mixed issue The security's issue date.
2306
- * @param int rate The security's interest rate at date of issue.
2307
- * @param int price The security's price per $100 face value.
2308
- * @param int basis The type of day count to use.
2309
- * 0 or omitted US (NASD) 30/360
2310
- * 1 Actual/actual
2311
- * 2 Actual/360
2312
- * 3 Actual/365
2313
- * 4 European 30/360
2314
- * @return float
2315
- */
2316
- public static function YIELDMAT($settlement, $maturity, $issue, $rate, $price, $basis = 0)
2317
- {
2318
- $settlement = PHPExcel_Calculation_Functions::flattenSingleValue($settlement);
2319
- $maturity = PHPExcel_Calculation_Functions::flattenSingleValue($maturity);
2320
- $issue = PHPExcel_Calculation_Functions::flattenSingleValue($issue);
2321
- $rate = PHPExcel_Calculation_Functions::flattenSingleValue($rate);
2322
- $price = PHPExcel_Calculation_Functions::flattenSingleValue($price);
2323
- $basis = (int) PHPExcel_Calculation_Functions::flattenSingleValue($basis);
2324
-
2325
- // Validate
2326
- if (is_numeric($rate) && is_numeric($price)) {
2327
- if (($rate <= 0) || ($price <= 0)) {
2328
- return PHPExcel_Calculation_Functions::NaN();
2329
- }
2330
- $daysPerYear = self::daysPerYear(PHPExcel_Calculation_DateTime::YEAR($settlement), $basis);
2331
- if (!is_numeric($daysPerYear)) {
2332
- return $daysPerYear;
2333
- }
2334
- $daysBetweenIssueAndSettlement = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $settlement, $basis);
2335
- if (!is_numeric($daysBetweenIssueAndSettlement)) {
2336
- // return date error
2337
- return $daysBetweenIssueAndSettlement;
2338
- }
2339
- $daysBetweenIssueAndSettlement *= $daysPerYear;
2340
- $daysBetweenIssueAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($issue, $maturity, $basis);
2341
- if (!is_numeric($daysBetweenIssueAndMaturity)) {
2342
- // return date error
2343
- return $daysBetweenIssueAndMaturity;
2344
- }
2345
- $daysBetweenIssueAndMaturity *= $daysPerYear;
2346
- $daysBetweenSettlementAndMaturity = PHPExcel_Calculation_DateTime::YEARFRAC($settlement, $maturity, $basis);
2347
- if (!is_numeric($daysBetweenSettlementAndMaturity)) {
2348
- // return date error
2349
- return $daysBetweenSettlementAndMaturity;
2350
- }
2351
- $daysBetweenSettlementAndMaturity *= $daysPerYear;
2352
-
2353
- return ((1 + (($daysBetweenIssueAndMaturity / $daysPerYear) * $rate) - (($price / 100) + (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate))) /
2354
- (($price / 100) + (($daysBetweenIssueAndSettlement / $daysPerYear) * $rate))) *
2355
- ($daysPerYear / $daysBetweenSettlementAndMaturity);
2356
- }
2357
- return PHPExcel_Calculation_Functions::VALUE();
2358
- }
2359
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/FormulaParser.php DELETED
@@ -1,622 +0,0 @@
1
- <?php
2
-
3
- /*
4
- PARTLY BASED ON:
5
- Copyright (c) 2007 E. W. Bachtal, Inc.
6
-
7
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software
8
- and associated documentation files (the "Software"), to deal in the Software without restriction,
9
- including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
10
- and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
11
- subject to the following conditions:
12
-
13
- The above copyright notice and this permission notice shall be included in all copies or substantial
14
- portions of the Software.
15
-
16
- The software is provided "as is", without warranty of any kind, express or implied, including but not
17
- limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In
18
- no event shall the authors or copyright holders be liable for any claim, damages or other liability,
19
- whether in an action of contract, tort or otherwise, arising from, out of or in connection with the
20
- software or the use or other dealings in the software.
21
-
22
- http://ewbi.blogs.com/develops/2007/03/excel_formula_p.html
23
- http://ewbi.blogs.com/develops/2004/12/excel_formula_p.html
24
- */
25
-
26
- /**
27
- * PHPExcel_Calculation_FormulaParser
28
- *
29
- * Copyright (c) 2006 - 2015 PHPExcel
30
- *
31
- * This library is free software; you can redistribute it and/or
32
- * modify it under the terms of the GNU Lesser General Public
33
- * License as published by the Free Software Foundation; either
34
- * version 2.1 of the License, or (at your option) any later version.
35
- *
36
- * This library is distributed in the hope that it will be useful,
37
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
38
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
39
- * Lesser General Public License for more details.
40
- *
41
- * You should have received a copy of the GNU Lesser General Public
42
- * License along with this library; if not, write to the Free Software
43
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
44
- *
45
- * @category PHPExcel
46
- * @package PHPExcel_Calculation
47
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
48
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
49
- * @version ##VERSION##, ##DATE##
50
- */
51
-
52
-
53
- class PHPExcel_Calculation_FormulaParser
54
- {
55
- /* Character constants */
56
- const QUOTE_DOUBLE = '"';
57
- const QUOTE_SINGLE = '\'';
58
- const BRACKET_CLOSE = ']';
59
- const BRACKET_OPEN = '[';
60
- const BRACE_OPEN = '{';
61
- const BRACE_CLOSE = '}';
62
- const PAREN_OPEN = '(';
63
- const PAREN_CLOSE = ')';
64
- const SEMICOLON = ';';
65
- const WHITESPACE = ' ';
66
- const COMMA = ',';
67
- const ERROR_START = '#';
68
-
69
- const OPERATORS_SN = "+-";
70
- const OPERATORS_INFIX = "+-*/^&=><";
71
- const OPERATORS_POSTFIX = "%";
72
-
73
- /**
74
- * Formula
75
- *
76
- * @var string
77
- */
78
- private $formula;
79
-
80
- /**
81
- * Tokens
82
- *
83
- * @var PHPExcel_Calculation_FormulaToken[]
84
- */
85
- private $tokens = array();
86
-
87
- /**
88
- * Create a new PHPExcel_Calculation_FormulaParser
89
- *
90
- * @param string $pFormula Formula to parse
91
- * @throws PHPExcel_Calculation_Exception
92
- */
93
- public function __construct($pFormula = '')
94
- {
95
- // Check parameters
96
- if (is_null($pFormula)) {
97
- throw new PHPExcel_Calculation_Exception("Invalid parameter passed: formula");
98
- }
99
-
100
- // Initialise values
101
- $this->formula = trim($pFormula);
102
- // Parse!
103
- $this->parseToTokens();
104
- }
105
-
106
- /**
107
- * Get Formula
108
- *
109
- * @return string
110
- */
111
- public function getFormula()
112
- {
113
- return $this->formula;
114
- }
115
-
116
- /**
117
- * Get Token
118
- *
119
- * @param int $pId Token id
120
- * @return string
121
- * @throws PHPExcel_Calculation_Exception
122
- */
123
- public function getToken($pId = 0)
124
- {
125
- if (isset($this->tokens[$pId])) {
126
- return $this->tokens[$pId];
127
- } else {
128
- throw new PHPExcel_Calculation_Exception("Token with id $pId does not exist.");
129
- }
130
- }
131
-
132
- /**
133
- * Get Token count
134
- *
135
- * @return string
136
- */
137
- public function getTokenCount()
138
- {
139
- return count($this->tokens);
140
- }
141
-
142
- /**
143
- * Get Tokens
144
- *
145
- * @return PHPExcel_Calculation_FormulaToken[]
146
- */
147
- public function getTokens()
148
- {
149
- return $this->tokens;
150
- }
151
-
152
- /**
153
- * Parse to tokens
154
- */
155
- private function parseToTokens()
156
- {
157
- // No attempt is made to verify formulas; assumes formulas are derived from Excel, where
158
- // they can only exist if valid; stack overflows/underflows sunk as nulls without exceptions.
159
-
160
- // Check if the formula has a valid starting =
161
- $formulaLength = strlen($this->formula);
162
- if ($formulaLength < 2 || $this->formula{0} != '=') {
163
- return;
164
- }
165
-
166
- // Helper variables
167
- $tokens1 = $tokens2 = $stack = array();
168
- $inString = $inPath = $inRange = $inError = false;
169
- $token = $previousToken = $nextToken = null;
170
-
171
- $index = 1;
172
- $value = '';
173
-
174
- $ERRORS = array("#NULL!", "#DIV/0!", "#VALUE!", "#REF!", "#NAME?", "#NUM!", "#N/A");
175
- $COMPARATORS_MULTI = array(">=", "<=", "<>");
176
-
177
- while ($index < $formulaLength) {
178
- // state-dependent character evaluation (order is important)
179
-
180
- // double-quoted strings
181
- // embeds are doubled
182
- // end marks token
183
- if ($inString) {
184
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::QUOTE_DOUBLE) {
185
- if ((($index + 2) <= $formulaLength) && ($this->formula{$index + 1} == PHPExcel_Calculation_FormulaParser::QUOTE_DOUBLE)) {
186
- $value .= PHPExcel_Calculation_FormulaParser::QUOTE_DOUBLE;
187
- ++$index;
188
- } else {
189
- $inString = false;
190
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_TEXT);
191
- $value = "";
192
- }
193
- } else {
194
- $value .= $this->formula{$index};
195
- }
196
- ++$index;
197
- continue;
198
- }
199
-
200
- // single-quoted strings (links)
201
- // embeds are double
202
- // end does not mark a token
203
- if ($inPath) {
204
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::QUOTE_SINGLE) {
205
- if ((($index + 2) <= $formulaLength) && ($this->formula{$index + 1} == PHPExcel_Calculation_FormulaParser::QUOTE_SINGLE)) {
206
- $value .= PHPExcel_Calculation_FormulaParser::QUOTE_SINGLE;
207
- ++$index;
208
- } else {
209
- $inPath = false;
210
- }
211
- } else {
212
- $value .= $this->formula{$index};
213
- }
214
- ++$index;
215
- continue;
216
- }
217
-
218
- // bracked strings (R1C1 range index or linked workbook name)
219
- // no embeds (changed to "()" by Excel)
220
- // end does not mark a token
221
- if ($inRange) {
222
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::BRACKET_CLOSE) {
223
- $inRange = false;
224
- }
225
- $value .= $this->formula{$index};
226
- ++$index;
227
- continue;
228
- }
229
-
230
- // error values
231
- // end marks a token, determined from absolute list of values
232
- if ($inError) {
233
- $value .= $this->formula{$index};
234
- ++$index;
235
- if (in_array($value, $ERRORS)) {
236
- $inError = false;
237
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_ERROR);
238
- $value = "";
239
- }
240
- continue;
241
- }
242
-
243
- // scientific notation check
244
- if (strpos(PHPExcel_Calculation_FormulaParser::OPERATORS_SN, $this->formula{$index}) !== false) {
245
- if (strlen($value) > 1) {
246
- if (preg_match("/^[1-9]{1}(\.[0-9]+)?E{1}$/", $this->formula{$index}) != 0) {
247
- $value .= $this->formula{$index};
248
- ++$index;
249
- continue;
250
- }
251
- }
252
- }
253
-
254
- // independent character evaluation (order not important)
255
-
256
- // establish state-dependent character evaluations
257
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::QUOTE_DOUBLE) {
258
- if (strlen($value > 0)) {
259
- // unexpected
260
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN);
261
- $value = "";
262
- }
263
- $inString = true;
264
- ++$index;
265
- continue;
266
- }
267
-
268
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::QUOTE_SINGLE) {
269
- if (strlen($value) > 0) {
270
- // unexpected
271
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN);
272
- $value = "";
273
- }
274
- $inPath = true;
275
- ++$index;
276
- continue;
277
- }
278
-
279
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::BRACKET_OPEN) {
280
- $inRange = true;
281
- $value .= PHPExcel_Calculation_FormulaParser::BRACKET_OPEN;
282
- ++$index;
283
- continue;
284
- }
285
-
286
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::ERROR_START) {
287
- if (strlen($value) > 0) {
288
- // unexpected
289
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN);
290
- $value = "";
291
- }
292
- $inError = true;
293
- $value .= PHPExcel_Calculation_FormulaParser::ERROR_START;
294
- ++$index;
295
- continue;
296
- }
297
-
298
- // mark start and end of arrays and array rows
299
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::BRACE_OPEN) {
300
- if (strlen($value) > 0) {
301
- // unexpected
302
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN);
303
- $value = "";
304
- }
305
-
306
- $tmp = new PHPExcel_Calculation_FormulaToken("ARRAY", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START);
307
- $tokens1[] = $tmp;
308
- $stack[] = clone $tmp;
309
-
310
- $tmp = new PHPExcel_Calculation_FormulaToken("ARRAYROW", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START);
311
- $tokens1[] = $tmp;
312
- $stack[] = clone $tmp;
313
-
314
- ++$index;
315
- continue;
316
- }
317
-
318
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::SEMICOLON) {
319
- if (strlen($value) > 0) {
320
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
321
- $value = "";
322
- }
323
-
324
- $tmp = array_pop($stack);
325
- $tmp->setValue("");
326
- $tmp->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP);
327
- $tokens1[] = $tmp;
328
-
329
- $tmp = new PHPExcel_Calculation_FormulaToken(",", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_ARGUMENT);
330
- $tokens1[] = $tmp;
331
-
332
- $tmp = new PHPExcel_Calculation_FormulaToken("ARRAYROW", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START);
333
- $tokens1[] = $tmp;
334
- $stack[] = clone $tmp;
335
-
336
- ++$index;
337
- continue;
338
- }
339
-
340
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::BRACE_CLOSE) {
341
- if (strlen($value) > 0) {
342
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
343
- $value = "";
344
- }
345
-
346
- $tmp = array_pop($stack);
347
- $tmp->setValue("");
348
- $tmp->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP);
349
- $tokens1[] = $tmp;
350
-
351
- $tmp = array_pop($stack);
352
- $tmp->setValue("");
353
- $tmp->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP);
354
- $tokens1[] = $tmp;
355
-
356
- ++$index;
357
- continue;
358
- }
359
-
360
- // trim white-space
361
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::WHITESPACE) {
362
- if (strlen($value) > 0) {
363
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
364
- $value = "";
365
- }
366
- $tokens1[] = new PHPExcel_Calculation_FormulaToken("", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_WHITESPACE);
367
- ++$index;
368
- while (($this->formula{$index} == PHPExcel_Calculation_FormulaParser::WHITESPACE) && ($index < $formulaLength)) {
369
- ++$index;
370
- }
371
- continue;
372
- }
373
-
374
- // multi-character comparators
375
- if (($index + 2) <= $formulaLength) {
376
- if (in_array(substr($this->formula, $index, 2), $COMPARATORS_MULTI)) {
377
- if (strlen($value) > 0) {
378
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
379
- $value = "";
380
- }
381
- $tokens1[] = new PHPExcel_Calculation_FormulaToken(substr($this->formula, $index, 2), PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_LOGICAL);
382
- $index += 2;
383
- continue;
384
- }
385
- }
386
-
387
- // standard infix operators
388
- if (strpos(PHPExcel_Calculation_FormulaParser::OPERATORS_INFIX, $this->formula{$index}) !== false) {
389
- if (strlen($value) > 0) {
390
- $tokens1[] =new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
391
- $value = "";
392
- }
393
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($this->formula{$index}, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX);
394
- ++$index;
395
- continue;
396
- }
397
-
398
- // standard postfix operators (only one)
399
- if (strpos(PHPExcel_Calculation_FormulaParser::OPERATORS_POSTFIX, $this->formula{$index}) !== false) {
400
- if (strlen($value) > 0) {
401
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
402
- $value = "";
403
- }
404
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($this->formula{$index}, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX);
405
- ++$index;
406
- continue;
407
- }
408
-
409
- // start subexpression or function
410
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::PAREN_OPEN) {
411
- if (strlen($value) > 0) {
412
- $tmp = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START);
413
- $tokens1[] = $tmp;
414
- $stack[] = clone $tmp;
415
- $value = "";
416
- } else {
417
- $tmp = new PHPExcel_Calculation_FormulaToken("", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_SUBEXPRESSION, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START);
418
- $tokens1[] = $tmp;
419
- $stack[] = clone $tmp;
420
- }
421
- ++$index;
422
- continue;
423
- }
424
-
425
- // function, subexpression, or array parameters, or operand unions
426
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::COMMA) {
427
- if (strlen($value) > 0) {
428
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
429
- $value = "";
430
- }
431
-
432
- $tmp = array_pop($stack);
433
- $tmp->setValue("");
434
- $tmp->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP);
435
- $stack[] = $tmp;
436
-
437
- if ($tmp->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) {
438
- $tokens1[] = new PHPExcel_Calculation_FormulaToken(",", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_UNION);
439
- } else {
440
- $tokens1[] = new PHPExcel_Calculation_FormulaToken(",", PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_ARGUMENT);
441
- }
442
- ++$index;
443
- continue;
444
- }
445
-
446
- // stop subexpression
447
- if ($this->formula{$index} == PHPExcel_Calculation_FormulaParser::PAREN_CLOSE) {
448
- if (strlen($value) > 0) {
449
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
450
- $value = "";
451
- }
452
-
453
- $tmp = array_pop($stack);
454
- $tmp->setValue("");
455
- $tmp->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP);
456
- $tokens1[] = $tmp;
457
-
458
- ++$index;
459
- continue;
460
- }
461
-
462
- // token accumulation
463
- $value .= $this->formula{$index};
464
- ++$index;
465
- }
466
-
467
- // dump remaining accumulation
468
- if (strlen($value) > 0) {
469
- $tokens1[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND);
470
- }
471
-
472
- // move tokenList to new set, excluding unnecessary white-space tokens and converting necessary ones to intersections
473
- $tokenCount = count($tokens1);
474
- for ($i = 0; $i < $tokenCount; ++$i) {
475
- $token = $tokens1[$i];
476
- if (isset($tokens1[$i - 1])) {
477
- $previousToken = $tokens1[$i - 1];
478
- } else {
479
- $previousToken = null;
480
- }
481
- if (isset($tokens1[$i + 1])) {
482
- $nextToken = $tokens1[$i + 1];
483
- } else {
484
- $nextToken = null;
485
- }
486
-
487
- if (is_null($token)) {
488
- continue;
489
- }
490
-
491
- if ($token->getTokenType() != PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_WHITESPACE) {
492
- $tokens2[] = $token;
493
- continue;
494
- }
495
-
496
- if (is_null($previousToken)) {
497
- continue;
498
- }
499
-
500
- if (! (
501
- (($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) && ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
502
- (($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_SUBEXPRESSION) && ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
503
- ($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND)
504
- ) ) {
505
- continue;
506
- }
507
-
508
- if (is_null($nextToken)) {
509
- continue;
510
- }
511
-
512
- if (! (
513
- (($nextToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) && ($nextToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START)) ||
514
- (($nextToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_SUBEXPRESSION) && ($nextToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_START)) ||
515
- ($nextToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND)
516
- ) ) {
517
- continue;
518
- }
519
-
520
- $tokens2[] = new PHPExcel_Calculation_FormulaToken($value, PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX, PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_INTERSECTION);
521
- }
522
-
523
- // move tokens to final list, switching infix "-" operators to prefix when appropriate, switching infix "+" operators
524
- // to noop when appropriate, identifying operand and infix-operator subtypes, and pulling "@" from function names
525
- $this->tokens = array();
526
-
527
- $tokenCount = count($tokens2);
528
- for ($i = 0; $i < $tokenCount; ++$i) {
529
- $token = $tokens2[$i];
530
- if (isset($tokens2[$i - 1])) {
531
- $previousToken = $tokens2[$i - 1];
532
- } else {
533
- $previousToken = null;
534
- }
535
- if (isset($tokens2[$i + 1])) {
536
- $nextToken = $tokens2[$i + 1];
537
- } else {
538
- $nextToken = null;
539
- }
540
-
541
- if (is_null($token)) {
542
- continue;
543
- }
544
-
545
- if ($token->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX && $token->getValue() == "-") {
546
- if ($i == 0) {
547
- $token->setTokenType(PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORPREFIX);
548
- } elseif ((($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) &&
549
- ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
550
- (($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_SUBEXPRESSION) &&
551
- ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
552
- ($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX) ||
553
- ($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND)) {
554
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_MATH);
555
- } else {
556
- $token->setTokenType(PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORPREFIX);
557
- }
558
-
559
- $this->tokens[] = $token;
560
- continue;
561
- }
562
-
563
- if ($token->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX && $token->getValue() == "+") {
564
- if ($i == 0) {
565
- continue;
566
- } elseif ((($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) &&
567
- ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
568
- (($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_SUBEXPRESSION) &&
569
- ($previousToken->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_STOP)) ||
570
- ($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORPOSTFIX) ||
571
- ($previousToken->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND)) {
572
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_MATH);
573
- } else {
574
- continue;
575
- }
576
-
577
- $this->tokens[] = $token;
578
- continue;
579
- }
580
-
581
- if ($token->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERATORINFIX &&
582
- $token->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_NOTHING) {
583
- if (strpos("<>=", substr($token->getValue(), 0, 1)) !== false) {
584
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_LOGICAL);
585
- } elseif ($token->getValue() == "&") {
586
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_CONCATENATION);
587
- } else {
588
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_MATH);
589
- }
590
-
591
- $this->tokens[] = $token;
592
- continue;
593
- }
594
-
595
- if ($token->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_OPERAND &&
596
- $token->getTokenSubType() == PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_NOTHING) {
597
- if (!is_numeric($token->getValue())) {
598
- if (strtoupper($token->getValue()) == "TRUE" || strtoupper($token->getValue() == "FALSE")) {
599
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_LOGICAL);
600
- } else {
601
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_RANGE);
602
- }
603
- } else {
604
- $token->setTokenSubType(PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_NUMBER);
605
- }
606
-
607
- $this->tokens[] = $token;
608
- continue;
609
- }
610
-
611
- if ($token->getTokenType() == PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_FUNCTION) {
612
- if (strlen($token->getValue() > 0)) {
613
- if (substr($token->getValue(), 0, 1) == "@") {
614
- $token->setValue(substr($token->getValue(), 1));
615
- }
616
- }
617
- }
618
-
619
- $this->tokens[] = $token;
620
- }
621
- }
622
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/FormulaToken.php DELETED
@@ -1,176 +0,0 @@
1
- <?php
2
-
3
- /*
4
- PARTLY BASED ON:
5
- Copyright (c) 2007 E. W. Bachtal, Inc.
6
-
7
- Permission is hereby granted, free of charge, to any person obtaining a copy of this software
8
- and associated documentation files (the "Software"), to deal in the Software without restriction,
9
- including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
10
- and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
11
- subject to the following conditions:
12
-
13
- The above copyright notice and this permission notice shall be included in all copies or substantial
14
- portions of the Software.
15
-
16
- The software is provided "as is", without warranty of any kind, express or implied, including but not
17
- limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In
18
- no event shall the authors or copyright holders be liable for any claim, damages or other liability,
19
- whether in an action of contract, tort or otherwise, arising from, out of or in connection with the
20
- software or the use or other dealings in the software.
21
-
22
- http://ewbi.blogs.com/develops/2007/03/excel_formula_p.html
23
- http://ewbi.blogs.com/develops/2004/12/excel_formula_p.html
24
- */
25
-
26
- /**
27
- * PHPExcel_Calculation_FormulaToken
28
- *
29
- * Copyright (c) 2006 - 2015 PHPExcel
30
- *
31
- * This library is free software; you can redistribute it and/or
32
- * modify it under the terms of the GNU Lesser General Public
33
- * License as published by the Free Software Foundation; either
34
- * version 2.1 of the License, or (at your option) any later version.
35
- *
36
- * This library is distributed in the hope that it will be useful,
37
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
38
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
39
- * Lesser General Public License for more details.
40
- *
41
- * You should have received a copy of the GNU Lesser General Public
42
- * License along with this library; if not, write to the Free Software
43
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
44
- *
45
- * @category PHPExcel
46
- * @package PHPExcel_Calculation
47
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
48
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
49
- * @version ##VERSION##, ##DATE##
50
- */
51
-
52
-
53
- class PHPExcel_Calculation_FormulaToken
54
- {
55
- /* Token types */
56
- const TOKEN_TYPE_NOOP = 'Noop';
57
- const TOKEN_TYPE_OPERAND = 'Operand';
58
- const TOKEN_TYPE_FUNCTION = 'Function';
59
- const TOKEN_TYPE_SUBEXPRESSION = 'Subexpression';
60
- const TOKEN_TYPE_ARGUMENT = 'Argument';
61
- const TOKEN_TYPE_OPERATORPREFIX = 'OperatorPrefix';
62
- const TOKEN_TYPE_OPERATORINFIX = 'OperatorInfix';
63
- const TOKEN_TYPE_OPERATORPOSTFIX = 'OperatorPostfix';
64
- const TOKEN_TYPE_WHITESPACE = 'Whitespace';
65
- const TOKEN_TYPE_UNKNOWN = 'Unknown';
66
-
67
- /* Token subtypes */
68
- const TOKEN_SUBTYPE_NOTHING = 'Nothing';
69
- const TOKEN_SUBTYPE_START = 'Start';
70
- const TOKEN_SUBTYPE_STOP = 'Stop';
71
- const TOKEN_SUBTYPE_TEXT = 'Text';
72
- const TOKEN_SUBTYPE_NUMBER = 'Number';
73
- const TOKEN_SUBTYPE_LOGICAL = 'Logical';
74
- const TOKEN_SUBTYPE_ERROR = 'Error';
75
- const TOKEN_SUBTYPE_RANGE = 'Range';
76
- const TOKEN_SUBTYPE_MATH = 'Math';
77
- const TOKEN_SUBTYPE_CONCATENATION = 'Concatenation';
78
- const TOKEN_SUBTYPE_INTERSECTION = 'Intersection';
79
- const TOKEN_SUBTYPE_UNION = 'Union';
80
-
81
- /**
82
- * Value
83
- *
84
- * @var string
85
- */
86
- private $value;
87
-
88
- /**
89
- * Token Type (represented by TOKEN_TYPE_*)
90
- *
91
- * @var string
92
- */
93
- private $tokenType;
94
-
95
- /**
96
- * Token SubType (represented by TOKEN_SUBTYPE_*)
97
- *
98
- * @var string
99
- */
100
- private $tokenSubType;
101
-
102
- /**
103
- * Create a new PHPExcel_Calculation_FormulaToken
104
- *
105
- * @param string $pValue
106
- * @param string $pTokenType Token type (represented by TOKEN_TYPE_*)
107
- * @param string $pTokenSubType Token Subtype (represented by TOKEN_SUBTYPE_*)
108
- */
109
- public function __construct($pValue, $pTokenType = PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN, $pTokenSubType = PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_NOTHING)
110
- {
111
- // Initialise values
112
- $this->value = $pValue;
113
- $this->tokenType = $pTokenType;
114
- $this->tokenSubType = $pTokenSubType;
115
- }
116
-
117
- /**
118
- * Get Value
119
- *
120
- * @return string
121
- */
122
- public function getValue()
123
- {
124
- return $this->value;
125
- }
126
-
127
- /**
128
- * Set Value
129
- *
130
- * @param string $value
131
- */
132
- public function setValue($value)
133
- {
134
- $this->value = $value;
135
- }
136
-
137
- /**
138
- * Get Token Type (represented by TOKEN_TYPE_*)
139
- *
140
- * @return string
141
- */
142
- public function getTokenType()
143
- {
144
- return $this->tokenType;
145
- }
146
-
147
- /**
148
- * Set Token Type
149
- *
150
- * @param string $value
151
- */
152
- public function setTokenType($value = PHPExcel_Calculation_FormulaToken::TOKEN_TYPE_UNKNOWN)
153
- {
154
- $this->tokenType = $value;
155
- }
156
-
157
- /**
158
- * Get Token SubType (represented by TOKEN_SUBTYPE_*)
159
- *
160
- * @return string
161
- */
162
- public function getTokenSubType()
163
- {
164
- return $this->tokenSubType;
165
- }
166
-
167
- /**
168
- * Set Token SubType
169
- *
170
- * @param string $value
171
- */
172
- public function setTokenSubType($value = PHPExcel_Calculation_FormulaToken::TOKEN_SUBTYPE_NOTHING)
173
- {
174
- $this->tokenSubType = $value;
175
- }
176
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Function.php DELETED
@@ -1,148 +0,0 @@
1
- <?php
2
-
3
- /**
4
- * PHPExcel_Calculation_Function
5
- *
6
- * Copyright (c) 2006 - 2015 PHPExcel
7
- *
8
- * This library is free software; you can redistribute it and/or
9
- * modify it under the terms of the GNU Lesser General Public
10
- * License as published by the Free Software Foundation; either
11
- * version 2.1 of the License, or (at your option) any later version.
12
- *
13
- * This library is distributed in the hope that it will be useful,
14
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
15
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16
- * Lesser General Public License for more details.
17
- *
18
- * You should have received a copy of the GNU Lesser General Public
19
- * License along with this library; if not, write to the Free Software
20
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
- *
22
- * @category PHPExcel
23
- * @package PHPExcel_Calculation
24
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
25
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
26
- * @version ##VERSION##, ##DATE##
27
- */
28
- class PHPExcel_Calculation_Function
29
- {
30
- /* Function categories */
31
- const CATEGORY_CUBE = 'Cube';
32
- const CATEGORY_DATABASE = 'Database';
33
- const CATEGORY_DATE_AND_TIME = 'Date and Time';
34
- const CATEGORY_ENGINEERING = 'Engineering';
35
- const CATEGORY_FINANCIAL = 'Financial';
36
- const CATEGORY_INFORMATION = 'Information';
37
- const CATEGORY_LOGICAL = 'Logical';
38
- const CATEGORY_LOOKUP_AND_REFERENCE = 'Lookup and Reference';
39
- const CATEGORY_MATH_AND_TRIG = 'Math and Trig';
40
- const CATEGORY_STATISTICAL = 'Statistical';
41
- const CATEGORY_TEXT_AND_DATA = 'Text and Data';
42
-
43
- /**
44
- * Category (represented by CATEGORY_*)
45
- *
46
- * @var string
47
- */
48
- private $category;
49
-
50
- /**
51
- * Excel name
52
- *
53
- * @var string
54
- */
55
- private $excelName;
56
-
57
- /**
58
- * PHPExcel name
59
- *
60
- * @var string
61
- */
62
- private $phpExcelName;
63
-
64
- /**
65
- * Create a new PHPExcel_Calculation_Function
66
- *
67
- * @param string $pCategory Category (represented by CATEGORY_*)
68
- * @param string $pExcelName Excel function name
69
- * @param string $pPHPExcelName PHPExcel function mapping
70
- * @throws PHPExcel_Calculation_Exception
71
- */
72
- public function __construct($pCategory = null, $pExcelName = null, $pPHPExcelName = null)
73
- {
74
- if (($pCategory !== null) && ($pExcelName !== null) && ($pPHPExcelName !== null)) {
75
- // Initialise values
76
- $this->category = $pCategory;
77
- $this->excelName = $pExcelName;
78
- $this->phpExcelName = $pPHPExcelName;
79
- } else {
80
- throw new PHPExcel_Calculation_Exception("Invalid parameters passed.");
81
- }
82
- }
83
-
84
- /**
85
- * Get Category (represented by CATEGORY_*)
86
- *
87
- * @return string
88
- */
89
- public function getCategory()
90
- {
91
- return $this->category;
92
- }
93
-
94
- /**
95
- * Set Category (represented by CATEGORY_*)
96
- *
97
- * @param string $value
98
- * @throws PHPExcel_Calculation_Exception
99
- */
100
- public function setCategory($value = null)
101
- {
102
- if (!is_null($value)) {
103
- $this->category = $value;
104
- } else {
105
- throw new PHPExcel_Calculation_Exception("Invalid parameter passed.");
106
- }
107
- }
108
-
109
- /**
110
- * Get Excel name
111
- *
112
- * @return string
113
- */
114
- public function getExcelName()
115
- {
116
- return $this->excelName;
117
- }
118
-
119
- /**
120
- * Set Excel name
121
- *
122
- * @param string $value
123
- */
124
- public function setExcelName($value)
125
- {
126
- $this->excelName = $value;
127
- }
128
-
129
- /**
130
- * Get PHPExcel name
131
- *
132
- * @return string
133
- */
134
- public function getPHPExcelName()
135
- {
136
- return $this->phpExcelName;
137
- }
138
-
139
- /**
140
- * Set PHPExcel name
141
- *
142
- * @param string $value
143
- */
144
- public function setPHPExcelName($value)
145
- {
146
- $this->phpExcelName = $value;
147
- }
148
- }
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
lib/phpExcel/PHPExcel/Calculation/Functions.php DELETED
@@ -1,760 +0,0 @@
1
- <?php
2
-
3
- /** PHPExcel root directory */
4
- if (!defined('PHPEXCEL_ROOT')) {
5
- /**
6
- * @ignore
7
- */
8
- define('PHPEXCEL_ROOT', dirname(__FILE__) . '/../../');
9
- require(PHPEXCEL_ROOT . 'PHPExcel/Autoloader.php');
10
- }
11
-
12
-
13
- /** MAX_VALUE */
14
- define('MAX_VALUE', 1.2e308);
15
-
16
- /** 2 / PI */
17
- define('M_2DIVPI', 0.63661977236758134307553505349006);
18
-
19
- /** MAX_ITERATIONS */
20
- define('MAX_ITERATIONS', 256);
21
-
22
- /** PRECISION */
23
- define('PRECISION', 8.88E-016);
24
-
25
-
26
- /**
27
- * PHPExcel_Calculation_Functions
28
- *
29
- * Copyright (c) 2006 - 2015 PHPExcel
30
- *
31
- * This library is free software; you can redistribute it and/or
32
- * modify it under the terms of the GNU Lesser General Public
33
- * License as published by the Free Software Foundation; either
34
- * version 2.1 of the License, or (at your option) any later version.
35
- *
36
- * This library is distributed in the hope that it will be useful,
37
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
38
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
39
- * Lesser General Public License for more details.
40
- *
41
- * You should have received a copy of the GNU Lesser General Public
42
- * License along with this library; if not, write to the Free Software
43
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
44
- *
45
- * @category PHPExcel
46
- * @package PHPExcel_Calculation
47
- * @copyright Copyright (c) 2006 - 2015 PHPExcel (http://www.codeplex.com/PHPExcel)
48
- * @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
49
- * @version ##VERSION##, ##DATE##
50
- */
51
- class PHPExcel_Calculation_Functions
52
- {
53
-
54
- /** constants */
55
- const COMPATIBILITY_EXCEL = 'Excel';
56
- const COMPATIBILITY_GNUMERIC = 'Gnumeric';
57
- const COMPATIBILITY_OPENOFFICE = 'OpenOfficeCalc';
58
-
59
- const RETURNDATE_PHP_NUMERIC = 'P';
60
- const RETURNDATE_PHP_OBJECT = 'O';
61
- const RETURNDATE_EXCEL = 'E';
62
-
63
-
64
- /**
65
- * Compatibility mode to use for error checking and responses
66
- *
67
- * @access private
68
- * @var string
69
- */
70
- protected static $compatibilityMode = self::COMPATIBILITY_EXCEL;
71
-
72
- /**
73
- * Data Type to use when returning date values
74
- *
75
- * @access private
76
- * @var string
77
- */
78
- protected static $returnDateType = self::RETURNDATE_EXCEL;
79
-
80
- /**
81
- * List of error codes
82
- *
83
- * @access private
84
- * @var array
85
- */
86
- protected static $errorCodes = array(
87
- 'null' => '#NULL!',
88
- 'divisionbyzero' => '#DIV/0!',
89
- 'value' => '#VALUE!',
90
- 'reference' => '#REF!',
91
- 'name' => '#NAME?',
92
- 'num' => '#NUM!',
93
- 'na' => '#N/A',
94
- 'gettingdata' => '#GETTING_DATA'
95
- );
96
-
97
-
98
- /**
99
- * Set the Compatibility Mode
100
- *
101
- * @access public
102
- * @category Function Configuration
103
- * @param string $compatibilityMode Compatibility Mode
104
- * Permitted values are:
105
- * PHPExcel_Calculation_Functions::COMPATIBILITY_EXCEL 'Excel'
106
- * PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC 'Gnumeric'
107
- * PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE 'OpenOfficeCalc'
108
- * @return boolean (Success or Failure)
109
- */
110
- public static function setCompatibilityMode($compatibilityMode)
111
- {
112
- if (($compatibilityMode == self::COMPATIBILITY_EXCEL) ||
113
- ($compatibilityMode == self::COMPATIBILITY_GNUMERIC) ||
114
- ($compatibilityMode == self::COMPATIBILITY_OPENOFFICE)) {
115
- self::$compatibilityMode = $compatibilityMode;
116
- return true;
117
- }
118
- return false;
119
- }
120
-
121
-
122
- /**
123
- * Return the current Compatibility Mode
124
- *
125
- * @access public
126
- * @category Function Configuration
127
- * @return string Compatibility Mode
128
- * Possible Return values are:
129
- * PHPExcel_Calculation_Functions::COMPATIBILITY_EXCEL 'Excel'
130
- * PHPExcel_Calculation_Functions::COMPATIBILITY_GNUMERIC 'Gnumeric'
131
- * PHPExcel_Calculation_Functions::COMPATIBILITY_OPENOFFICE 'OpenOfficeCalc'
132
- */
133
- public static function getCompatibilityMode()
134
- {
135
- return self::$compatibilityMode;
136
- }
137
-
138
-
139
- /**
140
- * Set the Return Date Format used by functions that return a date/time (Excel, PHP Serialized Numeric or PHP Object)
141
- *
142
- * @access public
143
- * @category Function Configuration
144
- * @param string $returnDateType Return Date Format
145
- * Permitted values are:
146
- * PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC 'P'
147
- * PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT 'O'
148
- * PHPExcel_Calculation_Functions::RETURNDATE_EXCEL 'E'
149
- * @return boolean Success or failure
150
- */
151
- public static function setReturnDateType($returnDateType)
152
- {
153
- if (($returnDateType == self::RETURNDATE_PHP_NUMERIC) ||
154
- ($returnDateType == self::RETURNDATE_PHP_OBJECT) ||
155
- ($returnDateType == self::RETURNDATE_EXCEL)) {
156
- self::$returnDateType = $returnDateType;
157
- return true;
158
- }
159
- return false;
160
- }
161
-
162
-
163
- /**
164
- * Return the current Return Date Format for functions that return a date/time (Excel, PHP Serialized Numeric or PHP Object)
165
- *
166
- * @access public
167
- * @category Function Configuration
168
- * @return string Return Date Format
169
- * Possible Return values are:
170
- * PHPExcel_Calculation_Functions::RETURNDATE_PHP_NUMERIC 'P'
171
- * PHPExcel_Calculation_Functions::RETURNDATE_PHP_OBJECT 'O'
172
- * PHPExcel_Calculation_Functions::RETURNDATE_EXCEL 'E'
173
- */
174
- public static function getReturnDateType()
175
- {
176
- return self::$returnDateType;
177
- }
178
-
179
-
180
- /**
181
- * DUMMY
182
- *
183
- * @access public
184
- * @category Error Returns
185
- * @return string #Not Yet Implemented
186
- */
187
- public static function DUMMY()
188
- {
189
- return '#Not Yet Implemented';
190
- }
191
-
192
-
193
- /**
194
- * DIV0
195
- *
196
- * @access public
197
- * @category Error Returns
198
- * @return string #Not Yet Implemented
199
- */
200
- public static function DIV0()
201
- {
202
- return self::$errorCodes['divisionbyzero'];
203
- }
204
-
205
-
206
- /**
207
- * NA
208
- *
209
- * Excel Function:
210
- * =NA()
211
- *
212
- * Returns the error value #N/A
213
- * #N/A is the error value that means "no value is available."
214
- *
215
- * @access public
216
- * @category Logical Functions
217
- * @return string #N/A!
218
- */
219
- public static function NA()
220
- {
221
- return self::$errorCodes['na'];
222
- }
223
-
224
-
225
- /**
226
- * NaN
227
- *
228
- * Returns the error value #NUM!
229
- *
230
- * @access public
231
- * @category Error Returns
232
- * @return string #NUM!
233
- */
234
- public static function NaN()
235
- {
236
- return self::$errorCodes['num'];
237
- }
238
-
239
-
240
- /**
241
- * NAME
242
- *
243
- * Returns the error value #NAME?
244
- *
245
- * @access public
246
- * @category Error Returns
247
- * @return string #NAME?
248
- */
249
- public static function NAME()
250
- {
251
- return self::$errorCodes['name'];
252
- }
253
-
254
-
255
- /**
256
- * REF
257
- *
258
- * Returns the error value #REF!
259
- *
260
- * @access public
261
- * @category Error Returns
262
- * @return string #REF!
263
- */
264
- public static function REF()
265
- {
266
- return self::$errorCodes['reference'];
267
- }
268
-
269
-
270
- /**
271
- * NULL
272
- *
273
- * Returns the error value #NULL!
274
- *
275
- * @access public
276
- * @category Error Returns
277
- * @return string #NULL!
278
- */
279
- public static function NULL()
280
- {
281
- return self::$errorCodes['null'];
282
- }
283
-
284
-
285
- /**
286
- * VALUE
287
- *
288
- * Returns the error value #VALUE!
289
- *
290
- * @access public
291
- * @category Error Returns
292
- * @return string #VALUE!
293
- */
294
- public static function VALUE()
295
- {
296
- return self::$errorCodes['value'];
297
- }
298
-
299
-
300
- public static function isMatrixValue($idx)
301
- {
302
- return ((substr_count($idx, '.') <= 1) || (preg_match('/\.[A-Z]/', $idx) > 0));
303
- }
304
-
305
-
306
- public static function isValue($idx)
307
- {
308
- return (substr_count($idx, '.') == 0);
309
- }
310
-
311
-
312
- public static function isCellValue($idx)
313
- {
314
- return (substr_count($idx, '.') > 1);
315
- }
316
-
317
-
318
- public static function ifCondition($condition)
319
- {
320
- $condition = PHPExcel_Calculation_Functions::flattenSingleValue($condition);
321
- if (!isset($condition{0})) {
322
- $condition = '=""';
323
- }
324
- if (!in_array($condition{0}, array('>', '<', '='))) {
325
- if (!is_numeric($condition)) {
326
- $condition = PHPExcel_Calculation::wrapResult(strtoupper($condition));
327
- }
328
- return '=' . $condition;
329
- } else {
330
- preg_match('/([<>=]+)(.*)/', $condition, $matches);
331
- list(, $operator, $operand) = $matches;
332
-
333
- if (!is_numeric($operand)) {
334
- $operand = str_replace('"', '""', $operand);
335
- $operand = PHPExcel_Calculation::wrapResult(strtoupper($operand));
336
- }
337
-
338
- return $operator.$operand;
339
- }
340
- }
341
-
342
- /**
343
- * ERROR_TYPE
344
- *
345
- * @param mixed $value Value to check
346
- * @return boolean
347
- */
348
- public static function ERROR_TYPE($value = '')
349
- {
350
- $value = self::flattenSingleValue($value);
351
-
352
- $i = 1;
353
- foreach (self::$errorCodes as $errorCode) {
354
- if ($value === $errorCode) {
355
- return $i;
356
- }
357
- ++$i;
358
- }
359
- return self::NA();
360
- }
361
-
362
-
363
- /**
364
- * IS_BLANK
365
- *
366
- * @param mixed $value Value to check
367
- * @return boolean
368
- */
369
- public static function IS_BLANK($value = null)
370
- {
371
- if (!is_null($value)) {
372
- $value = self::flattenSingleValue($value);
373
- }
374
-
375
- return is_null($value);
376
- }
377
-
378
-
379
- /**
380
- * IS_ERR
381
- *
382
- * @param mixed $value Value to check
383
- * @return boolean
384
- */
385
- public static function IS_ERR($value = '')
386
- {
387
- $value = self::flattenSingleValue($value);
388
-
389
- return self::IS_ERROR($value) && (!self::IS_NA($value));
390
- }
391
-
392
-
393
- /**
394
- * IS_ERROR
395
- *
396
- * @param mixed $value Value to check
397
- * @return boolean
398
- */
399
- public static function IS_ERROR($value = '')
400
- {
401
- $value = self::flattenSingleValue($value);
402
-
403
- if (!is_string($value)) {
404
- return false;
405
- }
406
- return in_array($value, array_values(self::$errorCodes));
407
- }
408
-
409
-
410
- /**
411
- * IS_NA
412
- *
413
- * @param mixed $value Value to check
414
- * @return boolean
415
- */
416
- public static function IS_NA($value = '')
417
- {
418
- $value = self::flattenSingleValue($value);
419
-
420
- return ($value === self::NA());
421
- }
422
-
423
-
424
- /**
425
- * IS_EVEN
426
- *
427
- * @param mixed $value Value to check
428
- * @return boolean
429
- */
430
- public static function IS_EVEN($value = null)
431
- {
432
- $value = self::flattenSingleValue($value);
433
-
434
- if ($value === null) {
435
- return self::NAME();
436
- } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) {
437
- return self::VALUE();
438
- }
439
-
440
- return ($value % 2 == 0);
441
- }
442
-
443
-
444
- /**
445
- * IS_ODD
446
- *
447
- * @param mixed $value Value to check
448
- * @return boolean
449
- */
450
- public static function IS_ODD($value = null)
451
- {
452
- $value = self::flattenSingleValue($value);
453
-
454
- if ($value === null) {
455
- return self::NAME();
456
- } elseif ((is_bool($value)) || ((is_string($value)) && (!is_numeric($value)))) {
457
- return self::VALUE();
458
- }
459
-
460
- return (abs($value) % 2 == 1);
461
- }
462
-
463
-
464
- /**
465
- * IS_NUMBER
466
- *
467
- * @param mixed $value Value to check
468
- * @return boolean
469
- */
470
- public static function IS_NUMBER($value = null)
471
- {
472
- $value = self::flattenSingleValue($value);
473
-
474
- if (is_string($value)) {
475
- return false;
476
- }
477
- return is_numeric($value);
478
- }
479
-
480
-
481
- /**
482
- * IS_LOGICAL
483
- *
484
- * @param mixed $value Value to check
485
- * @return boolean
486
- */
487
- public static function IS_LOGICAL($value = null)
488
- {
489
- $value = self::flattenSingleValue($value);
490
-
491
- return is_bool($value);
492
- }
493
-
494
-
495
- /**
496
- * IS_TEXT
497
- *
498
- * @param mixed $value Value to check
499
- * @return boolean
500
- */
501
- public static function IS_TEXT($value = null)
502
- {
503
- $value = self::flattenSingleValue($value);
504
-
505
- return (is_string($value) && !self::IS_ERROR($value));
506
- }
507
-
508
-
509
- /**
510
- * IS_NONTEXT
511
- *
512
- * @param mixed $value Value to check
513
- * @return boolean
514
- */
515
- public static function IS_NONTEXT($value = null)
516
- {
517
- return !self::IS_TEXT($value);
518
- }
519
-
520
-
521
- /**
522
- * VERSION
523
- *
524
- * @return string Version information
525
- */
526
- public static function VERSION()
527
- {
528
- return 'PHPExcel ##VERSION##, ##DATE##';
529
- }
530
-
531
-
532
- /**
533
- * N
534
- *
535
- * Returns a value converted to a number
536
- *
537
- * @param value The value you want converted
538
- * @return number N converts values listed in the following table
539
- * If value is or refers to N returns
540
- * A number That number
541
- * A date The serial number of that date
542
- * TRUE 1
543
- * FALSE 0
544
- * An error value The error value
545
- * Anything else 0
546
- */
547
- public static function N($value = null)
548
- {
549
- while (is_array($value)) {
550
- $value = array_shift($value);
551
- }
552
-
553
- switch (gettype($value)) {
554
- case 'double':
555
- case 'float':
556
- case 'integer':
557
- return $value;
558
- case 'boolean':
559
- return (integer) $value;
560
- case 'string':
561
- // Errors
562
- if ((strlen($value) > 0) && ($value{0} == '#')) {
563
- return $value;
564
- }
565
- break;
566
- }
567
- return 0;
568
- }
569
-
570
-
571
- /**
572
- * TYPE
573
- *
574
- * Returns a number that identifies the type of a value
575
- *
576
- * @param value The value you want tested
577
- * @return number N converts values listed in the following table
578
- * If value is or refers to N returns
579
- * A number 1
580
- * Text 2
581
- * Logical Value 4
582
- * An error value 16
583
- * Array or Matrix 64
584
- */
585
- public static function TYPE($value = null)
586
- {
587
- $value = self::flattenArrayIndexed($value);
588
- if (is_array($value) && (count($value) > 1)) {
589
- end($value);
590
- $a = key($value);
591
- // Range of cells is an error
592
- if (self::isCellValue($a)) {
593
- return 16;
594
- // Test for Matrix
595
- } elseif (self::isMatrixValue($a)) {
596
- return 64;
597
- }
598
- } elseif (empty($value)) {
599
- // Empty Cell
600
- return 1;
601
- }
602
- $value = self::flattenSingleValue($value);
603
-
604
- if (($value === null) || (is_float($value)) || (is_int($value))) {
605
- return 1;
606
- } elseif (is_bool($value)) {
607
- return 4;
608
- } elseif (is_array($value)) {
609
- return 64;
610
- } elseif (is_string($value)) {
611
- // Errors
612
- if ((strlen($value) > 0) && ($value{0} == '#')) {
613
- return 16;
614
- }
615
- return 2;
616
- }
617
- return 0;
618
- }
619
-
620
-
621
- /**
622
- * Convert a multi-dimensional array to a simple 1-dimensional array
623
- *
624
- * @param array $array Array to be flattened
625
- * @return array Flattened array
626
- */
627
- public static function flattenArray($array)
628
- {
629
- if (!is_array($array)) {
630
- return (array) $array;
631
- }
632
-
633
- $arrayValues = array();
634
- foreach ($array as $value) {
635
- if (is_array($value)) {
636
- foreach ($value as $val) {
637
- if (is_array($val)) {
638
- foreach ($val as $v) {
639
- $arrayValues[] = $v;
640
- }
641
- } else {
642
- $arrayValues[] = $val;
643
- }
644
- }
645
- } else {
646
- $arrayValues[] = $value;
647
- }
648
- }
649
-
650
- return $arrayValues;
651
- }
652
-
653
-
654
- /**
655
- * Convert a multi-dimensional array to a simple 1-dimensional array, but retain an element of indexing
656
- *
657
- * @param array $array Array to be flattened
658
- * @return array Flattened array
659
- */
660
- public static function flattenArrayIndexed($array)
661
- {
662
- if (!is_array($array)) {
663
- return (array) $array;
664
- }
665
-
666
- $arrayValues = array();
667
- foreach ($array as $k1 => $value) {
668
- if (is_array($value)) {
669
- foreach ($value as $k2 => $val) {
670
- if (is_array($val)) {
671
- foreach ($val as $k3 => $v) {
672
- $arrayValues[$k1.'.'.$k2.'.'.$k3] = $v;
673
- }
674
- } else {
675
- $arrayValues[$k1.'.'.$k2] = $val;
676
- }
677
- }
678
- } else {
679
- $arrayValues[$k1] = $value;
680
- }
681
- }
682
-
683
- return $arrayValues;
684
- }
685
-
686
-
687
- /**
688
- * Convert an array to a single scalar value by extracting the first element
689
- *
690
- * @param mixed $value Array or scalar value
691
- * @return mixed
692
- */
693
- public static function flattenSingleValue($value = '')
694
- {
695
- while (is_array($value)) {
696
- $value = array_pop($value);
697
- }
698
-
699
- return $value;
700
- }
701
- }
702
-
703
-
704
- //
705
- // There are a few mathematical functions that aren't available on all versions of PHP for all platforms
706
- // These functions aren't available in Windows implementations of PHP prior to version 5.3.0
707
- // So we test if they do exist for this version of PHP/operating platform; and if not we create them
708
- //
709
- if (!function_exists('acosh')) {
710
- function acosh($x)
711
- {
712
- return 2 * log(sqrt(($x + 1) / 2) + sqrt(($x - 1) / 2));
713
- } // function acosh()
714
- }
715
-
716
- if (!function_exists('asinh')) {
717
- function asinh($x)
718
- {
719
- return log($x + sqrt(1 + $x * $x));
720
- } // function asinh()
721
- }
722
-
723
- if (!function_exists('atanh')) {
724
- function atanh($x)
725
- {
726
- return (log(1 + $x) - log(1 - $x)) / 2;
727
- } // function atanh()
728
- }
729
-
730
-
731
- //
732
- // Strangely, PHP doesn't have a mb_str_replace multibyte function
733
- // As we'll only ever use this function with UTF-8 characters, we can simply "hard-code" the character set
734
- //
735
- if ((!function_exists('mb_str_replace')) &&
736
- (function_exists('mb_substr')) && (function_exists('mb_strlen')) && (function_exi