<html>
<head>
<title>File Source for String.php</title>
<link rel="stylesheet" type="text/css" href="../media/style.css">
</head>
<body>
<table border="0" cellspacing="0" cellpadding="0" height="48" width="100%">
<tr>
<td class="header_top">PHPPowerPoint_Shared</td>
</tr>
<tr><td class="header_line"><img src="../media/empty.png" width="1" height="1" border="0" alt="" /></td></tr>
<tr>
<td class="header_menu">
[ <a href="../classtrees_PHPPowerPoint_Shared.html" class="menu">class tree: PHPPowerPoint_Shared</a> ]
[ <a href="../elementindex_PHPPowerPoint_Shared.html" class="menu">index: PHPPowerPoint_Shared</a> ]
[ <a href="../elementindex.html" class="menu">all elements</a> ]
</td>
</tr>
<tr><td class="header_line"><img src="../media/empty.png" width="1" height="1" border="0" alt="" /></td></tr>
</table>
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr valign="top">
<td width="200" class="menu">
<b>Packages:</b><br />
<a href="../li_PHPPowerPoint.html">PHPPowerPoint</a><br />
<a href="../li_PHPPowerPoint_Reader.html">PHPPowerPoint_Reader</a><br />
<a href="../li_PHPPowerPoint_RichText.html">PHPPowerPoint_RichText</a><br />
<a href="../li_PHPPowerPoint_Shape.html">PHPPowerPoint_Shape</a><br />
<a href="../li_PHPPowerPoint_Shared.html">PHPPowerPoint_Shared</a><br />
<a href="../li_PHPPowerPoint_Slide.html">PHPPowerPoint_Slide</a><br />
<a href="../li_PHPPowerPoint_Style.html">PHPPowerPoint_Style</a><br />
<a href="../li_PHPPowerPoint_Writer.html">PHPPowerPoint_Writer</a><br />
<a href="../li_PHPPowerPoint_Writer_PowerPoint2007.html">PHPPowerPoint_Writer_PowerPoint2007</a><br />
<br /><br />
</td>
<td>
<table cellpadding="10" cellspacing="0" width="100%" border="0"><tr><td valign="top">
<h1 align="center">Source for file String.php</h1>
<p>Documentation is available at <a href="../PHPPowerPoint_Shared/_PHPPowerpoint---Shared---String.php.html">String.php</a></p>
<div class="src-code">
<ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
<li><div class="src-line"><a name="a2"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a3"></a><span class="src-doc"> * PHPPowerPoint</span></div></li>
<li><div class="src-line"><a name="a4"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a5"></a><span class="src-doc"> * Copyright (c) 2009 - 2010 PHPPowerPoint</span></div></li>
<li><div class="src-line"><a name="a6"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a7"></a><span class="src-doc"> * This library is free software; you can redistribute it and/or</span></div></li>
<li><div class="src-line"><a name="a8"></a><span class="src-doc"> * modify it under the terms of the GNU Lesser General Public</span></div></li>
<li><div class="src-line"><a name="a9"></a><span class="src-doc"> * License as published by the Free Software Foundation; either</span></div></li>
<li><div class="src-line"><a name="a10"></a><span class="src-doc"> * version 2.1 of the License, or (at your option) any later version.</span></div></li>
<li><div class="src-line"><a name="a11"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a12"></a><span class="src-doc"> * This library is distributed in the hope that it will be useful,</span></div></li>
<li><div class="src-line"><a name="a13"></a><span class="src-doc"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div></li>
<li><div class="src-line"><a name="a14"></a><span class="src-doc"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div></li>
<li><div class="src-line"><a name="a15"></a><span class="src-doc"> * Lesser General Public License for more details.</span></div></li>
<li><div class="src-line"><a name="a16"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a17"></a><span class="src-doc"> * You should have received a copy of the GNU Lesser General Public</span></div></li>
<li><div class="src-line"><a name="a18"></a><span class="src-doc"> * License along with this library; if not, write to the Free Software</span></div></li>
<li><div class="src-line"><a name="a19"></a><span class="src-doc"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span></div></li>
<li><div class="src-line"><a name="a20"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a21"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@category</span><span class="src-doc"> PHPPowerPoint</span></div></li>
<li><div class="src-line"><a name="a22"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PHPPowerPoint_Shared</span></div></li>
<li><div class="src-line"><a name="a23"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> Copyright (c) 2009 - 2010 PHPPowerPoint (http://www.codeplex.com/PHPPowerPoint)</span></div></li>
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL</span></div></li>
<li><div class="src-line"><a name="a25"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> 0.1.0, 2009-04-27</span></div></li>
<li><div class="src-line"><a name="a26"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a27"></a> </div></li>
<li><div class="src-line"><a name="a28"></a> </div></li>
<li><div class="src-line"><a name="a29"></a><span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a30"></a><span class="src-doc"> * PHPPowerPoint_Shared_String</span></div></li>
<li><div class="src-line"><a name="a31"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@category</span><span class="src-doc"> PHPPowerPoint</span></div></li>
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> PHPPowerPoint_Shared</span></div></li>
<li><div class="src-line"><a name="a34"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> Copyright (c) 2009 - 2010 PHPPowerPoint (http://www.codeplex.com/PHPPowerPoint)</span></div></li>
<li><div class="src-line"><a name="a35"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a36"></a><span class="src-key">class </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html">PHPPowerPoint_Shared_String</a></div></li>
<li><div class="src-line"><a name="a37"></a><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a38"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a39"></a><span class="src-doc"> * Control characters array</span></div></li>
<li><div class="src-line"><a name="a40"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">string[] </span></div></li>
<li><div class="src-line"><a name="a42"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a43"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-var">$_controlCharacters </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a44"></a> </div></li>
<li><div class="src-line"><a name="a45"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a46"></a><span class="src-doc"> * Is mbstring extension avalable?</span></div></li>
<li><div class="src-line"><a name="a47"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a48"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">boolean </span></div></li>
<li><div class="src-line"><a name="a49"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a50"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-var">$_isMbstringEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a51"></a> </div></li>
<li><div class="src-line"><a name="a52"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a53"></a><span class="src-doc"> * Is iconv extension avalable?</span></div></li>
<li><div class="src-line"><a name="a54"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a55"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">boolean </span></div></li>
<li><div class="src-line"><a name="a56"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a57"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-var">$_isIconvEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a58"></a> </div></li>
<li><div class="src-line"><a name="a59"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a60"></a><span class="src-doc"> * Build control characters array</span></div></li>
<li><div class="src-line"><a name="a61"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a62"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#method_buildControlCharacters">_buildControlCharacters</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a63"></a> <span class="src-key">for </span><span class="src-sym">(</span><span class="src-var">$i </span>= <span class="src-num">0</span><span class="src-sym">; </span><span class="src-var">$i </span><= <span class="src-num">19</span><span class="src-sym">; </span>++<span class="src-var">$i</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a64"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$i </span>!= <span class="src-num">9 </span>&& <span class="src-var">$i </span>!= <span class="src-num">10 </span>&& <span class="src-var">$i </span>!= <span class="src-num">13</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a65"></a> <span class="src-var">$find </span>= <span class="src-str">'_x' </span>. <a href="http://www.php.net/sprintf">sprintf</a><span class="src-sym">(</span><span class="src-str">'%04s' </span><span class="src-sym">, </span><a href="http://www.php.net/strtoupper">strtoupper</a><span class="src-sym">(</span><a href="http://www.php.net/dechex">dechex</a><span class="src-sym">(</span><span class="src-var">$i</span><span class="src-sym">))) </span>. <span class="src-str">'_'</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a66"></a> <span class="src-var">$replace </span>= <a href="http://www.php.net/chr">chr</a><span class="src-sym">(</span><span class="src-var">$i</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a67"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">[</span><span class="src-var">$find</span><span class="src-sym">] </span>= <span class="src-var">$replace</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a68"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a69"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a70"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a71"></a> </div></li>
<li><div class="src-line"><a name="a72"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a73"></a><span class="src-doc"> * Get whether mbstring extension is available</span></div></li>
<li><div class="src-line"><a name="a74"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a75"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">boolean </span></div></li>
<li><div class="src-line"><a name="a76"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a77"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodgetIsMbstringEnabled">getIsMbstringEnabled</a><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a78"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a79"></a> <span class="src-key">if </span><span class="src-sym">(</span>isset<span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isMbstringEnabled</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a80"></a> <span class="src-key">return </span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isMbstringEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a81"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a82"></a> </div></li>
<li><div class="src-line"><a name="a83"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isMbstringEnabled </span>= <span class="src-id">function_exists</span><span class="src-sym">(</span><span class="src-str">'mb_convert_encoding'</span><span class="src-sym">) </span>?</div></li>
<li><div class="src-line"><a name="a84"></a> <span class="src-id">true </span>: <span class="src-id">false</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a85"></a> </div></li>
<li><div class="src-line"><a name="a86"></a> <span class="src-key">return </span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isMbstringEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a87"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a88"></a> </div></li>
<li><div class="src-line"><a name="a89"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a90"></a><span class="src-doc"> * Get whether iconv extension is available</span></div></li>
<li><div class="src-line"><a name="a91"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a92"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">boolean </span></div></li>
<li><div class="src-line"><a name="a93"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a94"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodgetIsIconvEnabled">getIsIconvEnabled</a><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a95"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a96"></a> <span class="src-key">if </span><span class="src-sym">(</span>isset<span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isIconvEnabled</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a97"></a> <span class="src-key">return </span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isIconvEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a98"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a99"></a> </div></li>
<li><div class="src-line"><a name="a100"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isIconvEnabled </span>= <span class="src-id">function_exists</span><span class="src-sym">(</span><span class="src-str">'iconv'</span><span class="src-sym">) </span>?</div></li>
<li><div class="src-line"><a name="a101"></a> <span class="src-id">true </span>: <span class="src-id">false</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a102"></a> </div></li>
<li><div class="src-line"><a name="a103"></a> <span class="src-key">return </span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_isIconvEnabled</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a104"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a105"></a> </div></li>
<li><div class="src-line"><a name="a106"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a107"></a><span class="src-doc"> * Convert from OpenXML escaped control character to PHP control character</span></div></li>
<li><div class="src-line"><a name="a108"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a109"></a><span class="src-doc"> * Excel 2007 team:</span></div></li>
<li><div class="src-line"><a name="a110"></a><span class="src-doc"> * ----------------</span></div></li>
<li><div class="src-line"><a name="a111"></a><span class="src-doc"> * That's correct, control characters are stored directly in the shared-strings table.</span></div></li>
<li><div class="src-line"><a name="a112"></a><span class="src-doc"> * We do encode characters that cannot be represented in XML using the following escape sequence:</span></div></li>
<li><div class="src-line"><a name="a113"></a><span class="src-doc"> * _xHHHH_ where H represents a hexadecimal character in the character's value...</span></div></li>
<li><div class="src-line"><a name="a114"></a><span class="src-doc"> * So you could end up with something like _x0008_ in a string (either in a cell value (<v>)</span></div></li>
<li><div class="src-line"><a name="a115"></a><span class="src-doc"> * element or in the shared string <t> element.</span></div></li>
<li><div class="src-line"><a name="a116"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a117"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">string </span><span class="src-doc"> </span><span class="src-doc-var">$value </span><span class="src-doc"> Value to unescape</span></div></li>
<li><div class="src-line"><a name="a118"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc"> </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a119"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a120"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodControlCharacterOOXML2PHP">ControlCharacterOOXML2PHP</a><span class="src-sym">(</span><span class="src-var">$value </span>= <span class="src-str">''</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a121"></a> <span class="src-key">if</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a122"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">_buildControlCharacters</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a123"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a124"></a> </div></li>
<li><div class="src-line"><a name="a125"></a> <span class="src-key">return </span><a href="http://www.php.net/str_replace">str_replace</a><span class="src-sym">( </span><a href="http://www.php.net/array_keys">array_keys</a><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-id">array_values</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$value </span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a126"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a127"></a> </div></li>
<li><div class="src-line"><a name="a128"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a129"></a><span class="src-doc"> * Convert from PHP control character to OpenXML escaped control character</span></div></li>
<li><div class="src-line"><a name="a130"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a131"></a><span class="src-doc"> * Excel 2007 team:</span></div></li>
<li><div class="src-line"><a name="a132"></a><span class="src-doc"> * ----------------</span></div></li>
<li><div class="src-line"><a name="a133"></a><span class="src-doc"> * That's correct, control characters are stored directly in the shared-strings table.</span></div></li>
<li><div class="src-line"><a name="a134"></a><span class="src-doc"> * We do encode characters that cannot be represented in XML using the following escape sequence:</span></div></li>
<li><div class="src-line"><a name="a135"></a><span class="src-doc"> * _xHHHH_ where H represents a hexadecimal character in the character's value...</span></div></li>
<li><div class="src-line"><a name="a136"></a><span class="src-doc"> * So you could end up with something like _x0008_ in a string (either in a cell value (<v>)</span></div></li>
<li><div class="src-line"><a name="a137"></a><span class="src-doc"> * element or in the shared string <t> element.</span></div></li>
<li><div class="src-line"><a name="a138"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a139"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">string </span><span class="src-doc"> </span><span class="src-doc-var">$value </span><span class="src-doc"> Value to escape</span></div></li>
<li><div class="src-line"><a name="a140"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc"> </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a141"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a142"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodControlCharacterPHP2OOXML">ControlCharacterPHP2OOXML</a><span class="src-sym">(</span><span class="src-var">$value </span>= <span class="src-str">''</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a143"></a> <span class="src-key">if</span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a144"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">_buildControlCharacters</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a145"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a146"></a> </div></li>
<li><div class="src-line"><a name="a147"></a> <span class="src-key">return </span><a href="http://www.php.net/str_replace">str_replace</a><span class="src-sym">( </span><a href="http://www.php.net/array_values">array_values</a><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-id">array_keys</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$_controlCharacters</span><span class="src-sym">)</span><span class="src-sym">, </span><span class="src-var">$value </span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a148"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a149"></a> </div></li>
<li><div class="src-line"><a name="a150"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a151"></a><span class="src-doc"> * Check if a string contains UTF8 data</span></div></li>
<li><div class="src-line"><a name="a152"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a153"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$value </span></div></li>
<li><div class="src-line"><a name="a154"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">boolean </span></div></li>
<li><div class="src-line"><a name="a155"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a156"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodIsUTF8">IsUTF8</a><span class="src-sym">(</span><span class="src-var">$value </span>= <span class="src-str">''</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a157"></a> <span class="src-key">return </span><span class="src-id">utf8_encode</span><span class="src-sym">(</span><a href="http://www.php.net/utf8_decode">utf8_decode</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">)) </span>=== <span class="src-var">$value</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a158"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a159"></a> </div></li>
<li><div class="src-line"><a name="a160"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a161"></a><span class="src-doc"> * Formats a numeric value as a string for output in various output writers</span></div></li>
<li><div class="src-line"><a name="a162"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a163"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">mixed </span><span class="src-doc-var">$value </span></div></li>
<li><div class="src-line"><a name="a164"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a165"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a166"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodFormatNumber">FormatNumber</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a167"></a> <span class="src-key">return </span><a href="http://www.php.net/number_format">number_format</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-num">2</span><span class="src-sym">, </span><span class="src-str">'.'</span><span class="src-sym">, </span><span class="src-str">''</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a168"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a169"></a> </div></li>
<li><div class="src-line"><a name="a170"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a171"></a><span class="src-doc"> * Converts a UTF-8 string into BIFF8 Unicode string data (8-bit string length)</span></div></li>
<li><div class="src-line"><a name="a172"></a><span class="src-doc"> * Writes the string using uncompressed notation, no rich text, no Asian phonetics</span></div></li>
<li><div class="src-line"><a name="a173"></a><span class="src-doc"> * If mbstring extension is not available, ASCII is assumed, and compressed notation is used</span></div></li>
<li><div class="src-line"><a name="a174"></a><span class="src-doc"> * although this will give wrong results for non-ASCII strings</span></div></li>
<li><div class="src-line"><a name="a175"></a><span class="src-doc"> * see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3</span></div></li>
<li><div class="src-line"><a name="a176"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a177"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$value </span><span class="src-doc">UTF-8 encoded string</span></div></li>
<li><div class="src-line"><a name="a178"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a179"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a180"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodUTF8toBIFF8UnicodeShort">UTF8toBIFF8UnicodeShort</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a181"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a182"></a> <span class="src-comm">// character count</span></div></li>
<li><div class="src-line"><a name="a183"></a> <span class="src-var">$ln </span>= <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">CountCharacters</span><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-str">'UTF-8'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a184"></a> </div></li>
<li><div class="src-line"><a name="a185"></a> <span class="src-comm">// option flags</span></div></li>
<li><div class="src-line"><a name="a186"></a> <span class="src-var">$opt </span>= <span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsMbstringEnabled</span><span class="src-sym">(</span><span class="src-sym">) </span>|| <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsIconvEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span>? </div></li>
<li><div class="src-line"><a name="a187"></a> <span class="src-num">0x0001 </span>: <span class="src-num">0x0000</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a188"></a> </div></li>
<li><div class="src-line"><a name="a189"></a> <span class="src-comm">// characters</span></div></li>
<li><div class="src-line"><a name="a190"></a> <span class="src-var">$chars </span>= <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">ConvertEncoding</span><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-str">'UTF-16LE'</span><span class="src-sym">, </span><span class="src-str">'UTF-8'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a191"></a> </div></li>
<li><div class="src-line"><a name="a192"></a> <span class="src-var">$data </span>= <a href="http://www.php.net/pack">pack</a><span class="src-sym">(</span><span class="src-str">'CC'</span><span class="src-sym">, </span><span class="src-var">$ln</span><span class="src-sym">, </span><span class="src-var">$opt</span><span class="src-sym">) </span>. <span class="src-var">$chars</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a193"></a> <span class="src-key">return </span><span class="src-var">$data</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a194"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a195"></a> </div></li>
<li><div class="src-line"><a name="a196"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a197"></a><span class="src-doc"> * Converts a UTF-8 string into BIFF8 Unicode string data (16-bit string length)</span></div></li>
<li><div class="src-line"><a name="a198"></a><span class="src-doc"> * Writes the string using uncompressed notation, no rich text, no Asian phonetics</span></div></li>
<li><div class="src-line"><a name="a199"></a><span class="src-doc"> * If mbstring extension is not available, ASCII is assumed, and compressed notation is used</span></div></li>
<li><div class="src-line"><a name="a200"></a><span class="src-doc"> * although this will give wrong results for non-ASCII strings</span></div></li>
<li><div class="src-line"><a name="a201"></a><span class="src-doc"> * see OpenOffice.org's Documentation of the Microsoft Excel File Format, sect. 2.5.3</span></div></li>
<li><div class="src-line"><a name="a202"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a203"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$value </span><span class="src-doc">UTF-8 encoded string</span></div></li>
<li><div class="src-line"><a name="a204"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a205"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a206"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodUTF8toBIFF8UnicodeLong">UTF8toBIFF8UnicodeLong</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a207"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a208"></a> <span class="src-comm">// character count</span></div></li>
<li><div class="src-line"><a name="a209"></a> <span class="src-var">$ln </span>= <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">CountCharacters</span><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-str">'UTF-8'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a210"></a> </div></li>
<li><div class="src-line"><a name="a211"></a> <span class="src-comm">// option flags</span></div></li>
<li><div class="src-line"><a name="a212"></a> <span class="src-var">$opt </span>= <span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsMbstringEnabled</span><span class="src-sym">(</span><span class="src-sym">) </span>|| <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsIconvEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span>? </div></li>
<li><div class="src-line"><a name="a213"></a> <span class="src-num">0x0001 </span>: <span class="src-num">0x0000</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a214"></a> </div></li>
<li><div class="src-line"><a name="a215"></a> <span class="src-comm">// characters</span></div></li>
<li><div class="src-line"><a name="a216"></a> <span class="src-var">$chars </span>= <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">ConvertEncoding</span><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-str">'UTF-16LE'</span><span class="src-sym">, </span><span class="src-str">'UTF-8'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a217"></a> </div></li>
<li><div class="src-line"><a name="a218"></a> <span class="src-var">$data </span>= <a href="http://www.php.net/pack">pack</a><span class="src-sym">(</span><span class="src-str">'vC'</span><span class="src-sym">, </span><span class="src-var">$ln</span><span class="src-sym">, </span><span class="src-var">$opt</span><span class="src-sym">) </span>. <span class="src-var">$chars</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a219"></a> <span class="src-key">return </span><span class="src-var">$data</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a220"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a221"></a> </div></li>
<li><div class="src-line"><a name="a222"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a223"></a><span class="src-doc"> * Convert string from one encoding to another. First try mbstring, then iconv, or no convertion</span></div></li>
<li><div class="src-line"><a name="a224"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a225"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$value </span></div></li>
<li><div class="src-line"><a name="a226"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$to </span><span class="src-doc">Encoding to convert to, e.g. 'UTF-8'</span></div></li>
<li><div class="src-line"><a name="a227"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$from </span><span class="src-doc">Encoding to convert from, e.g. 'UTF-16LE'</span></div></li>
<li><div class="src-line"><a name="a228"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </span></div></li>
<li><div class="src-line"><a name="a229"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a230"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodConvertEncoding">ConvertEncoding</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-var">$to</span><span class="src-sym">, </span><span class="src-var">$from</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a231"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a232"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsMbstringEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a233"></a> <span class="src-var">$value </span>= <a href="http://www.php.net/mb_convert_encoding">mb_convert_encoding</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-var">$to</span><span class="src-sym">, </span><span class="src-var">$from</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a234"></a> <span class="src-key">return </span><span class="src-var">$value</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a235"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a236"></a> </div></li>
<li><div class="src-line"><a name="a237"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsIconvEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a238"></a> <span class="src-var">$value </span>= <a href="http://www.php.net/iconv">iconv</a><span class="src-sym">(</span><span class="src-var">$from</span><span class="src-sym">, </span><span class="src-var">$to</span><span class="src-sym">, </span><span class="src-var">$value</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a239"></a> <span class="src-key">return </span><span class="src-var">$value</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a240"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a241"></a> </div></li>
<li><div class="src-line"><a name="a242"></a> <span class="src-comm">// else, no conversion</span></div></li>
<li><div class="src-line"><a name="a243"></a> <span class="src-key">return </span><span class="src-var">$value</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a244"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a245"></a> </div></li>
<li><div class="src-line"><a name="a246"></a> <span class="src-doc">/**</span></div></li>
<li><div class="src-line"><a name="a247"></a><span class="src-doc"> * Get character count. First try mbstring, then iconv, finally strlen</span></div></li>
<li><div class="src-line"><a name="a248"></a><span class="src-doc"> *</span></div></li>
<li><div class="src-line"><a name="a249"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$value </span></div></li>
<li><div class="src-line"><a name="a250"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$enc </span><span class="src-doc">Encoding</span></div></li>
<li><div class="src-line"><a name="a251"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">int </span><span class="src-doc">Character count</span></div></li>
<li><div class="src-line"><a name="a252"></a><span class="src-doc"> */</span></div></li>
<li><div class="src-line"><a name="a253"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../PHPPowerPoint_Shared/PHPPowerPoint_Shared_String.html#methodCountCharacters">CountCharacters</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-var">$enc </span>= <span class="src-str">'UTF-8'</span><span class="src-sym">)</span></div></li>
<li><div class="src-line"><a name="a254"></a> <span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a255"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsMbstringEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a256"></a> <span class="src-var">$count </span>= <a href="http://www.php.net/mb_strlen">mb_strlen</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-var">$enc</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a257"></a> <span class="src-key">return </span><span class="src-var">$count</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a258"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a259"></a> </div></li>
<li><div class="src-line"><a name="a260"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getIsIconvEnabled</span><span class="src-sym">(</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
<li><div class="src-line"><a name="a261"></a> <span class="src-var">$count </span>= <a href="http://www.php.net/iconv_strlen">iconv_strlen</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">, </span><span class="src-var">$enc</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a262"></a> <span class="src-key">return </span><span class="src-var">$count</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a263"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a264"></a> </div></li>
<li><div class="src-line"><a name="a265"></a> <span class="src-comm">// else strlen</span></div></li>
<li><div class="src-line"><a name="a266"></a> <span class="src-var">$count </span>= <a href="http://www.php.net/strlen">strlen</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a267"></a> <span class="src-key">return </span><span class="src-var">$count</span><span class="src-sym">;</span></div></li>
<li><div class="src-line"><a name="a268"></a> <span class="src-sym">}</span></div></li>
<li><div class="src-line"><a name="a269"></a> </div></li>
<li><div class="src-line"><a name="a270"></a><span class="src-sym">}</span></div></li>
</ol>
</div>
<div class="credit">
<hr />
Documentation generated on Sat, 25 Apr 2009 11:38:17 +0200 by <a href="http://www.phpdoc.org">phpDocumentor 1.4.1</a>
</div>
</td></tr></table>
</td>
</tr>
</table>
</body>
</html>