<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>Strings</title><revhistory><revision><revnumber>44</revnumber><date>2015-02-08 06:30:49</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>43</revnumber><date>2015-02-08 06:30:27</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>42</revnumber><date>2015-02-08 06:29:27</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>41</revnumber><date>2015-02-08 06:18:33</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>40</revnumber><date>2015-01-30 23:47:56</date><authorinitials>LKD70</authorinitials></revision><revision><revnumber>39</revnumber><date>2014-11-17 14:19:09</date><authorinitials>Romulus</authorinitials></revision><revision><revnumber>38</revnumber><date>2014-11-15 04:02:07</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>37</revnumber><date>2014-02-12 17:49:32</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>36</revnumber><date>2014-02-12 17:48:45</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>35</revnumber><date>2014-02-12 17:48:30</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>34</revnumber><date>2014-02-12 01:16:58</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>33</revnumber><date>2014-02-12 01:16:13</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>32</revnumber><date>2014-02-12 01:14:44</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>31</revnumber><date>2014-02-12 01:13:40</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>30</revnumber><date>2014-02-12 00:30:41</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>29</revnumber><date>2014-01-27 11:28:35</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>28</revnumber><date>2013-12-08 20:37:33</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>27</revnumber><date>2012-12-04 18:33:26</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>26</revnumber><date>2012-10-28 19:49:37</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>25</revnumber><date>2012-10-28 14:44:37</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>24</revnumber><date>2012-10-28 05:34:50</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>23</revnumber><date>2012-10-28 05:34:37</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>22</revnumber><date>2012-10-28 05:33:43</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>21</revnumber><date>2012-10-28 05:33:13</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>20</revnumber><date>2012-10-28 05:31:43</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>19</revnumber><date>2012-10-28 05:15:51</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>18</revnumber><date>2012-10-28 05:11:04</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>17</revnumber><date>2012-10-28 05:10:29</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>16</revnumber><date>2012-10-28 05:09:03</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>15</revnumber><date>2012-10-28 05:02:23</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>14</revnumber><date>2012-10-28 04:59:08</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>13</revnumber><date>2012-10-28 04:50:30</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>12</revnumber><date>2012-10-28 04:48:45</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>11</revnumber><date>2012-10-28 04:46:59</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>10</revnumber><date>2012-10-28 04:45:37</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>9</revnumber><date>2012-10-28 04:43:17</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>8</revnumber><date>2012-10-28 04:42:57</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>7</revnumber><date>2012-10-28 04:40:03</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>6</revnumber><date>2012-10-28 02:29:21</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>5</revnumber><date>2012-10-27 05:41:06</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>4</revnumber><date>2012-10-27 05:27:39</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>3</revnumber><date>2012-10-27 05:24:35</date><authorinitials>Inanna</authorinitials></revision><revision><revnumber>2</revnumber><date>2012-10-27 05:23:55</date><authorinitials>Inanna</authorinitials><revremark>Renamed from 'Object Strings'.</revremark></revision><revision><revnumber>1</revnumber><date>2012-10-27 05:20:21</date><authorinitials>Inanna</authorinitials></revision></revhistory></articleinfo><para>The following functions can be used to manipulate and retrieve string details from objects and variables. </para><para>These should be written in the following formats: </para><itemizedlist><listitem override="none"><para><emphasis>variable.function(arguments)</emphasis>, example - <emphasis>myVar.subStr(3,2)</emphasis> if your variable name was &quot;myVar&quot; and you wanted to use subStr() to find the 2 characters that begin 3 from the left. </para></listitem><listitem override="none"><para><emphasis>object.function(arguments)</emphasis>, example - <emphasis>city.coords.split(&quot;,&quot;)</emphasis> if you wanted to split the coordinates of your city into an array to determine the seperate x and y values using the split() function. </para></listitem></itemizedlist><para>Click each function name in the table below for more details of it, with examples. </para><para><emphasis role="strong">Functions</emphasis> </para><informaltable><tgroup cols="6"><colspec colname="col_0"/><colspec colname="col_1"/><colspec colname="col_2"/><colspec colname="col_3"/><colspec colname="col_4"/><colspec colname="col_5"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para><emphasis role="strong">Function </emphasis> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Type</emphasis> </para></entry><entry colsep="1" rowsep="1"><para><emphasis role="strong">Description </emphasis> </para></entry><entry align="center" colsep="1" nameend="col_4" namest="col_3" rowsep="1"/><entry colsep="1" rowsep="1"/></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="CenterPad">CenterPad</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Prepends and appends spaces (or specified character) to a string to form string of the desired length. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="charAt">charAt</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns the character in the position specified by the index parameter. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="charCodeAt">charCodeAt</link> </para></entry><entry colsep="1" rowsep="1"><para>Number </para></entry><entry colsep="1" rowsep="1"><para>Returns the numeric Unicode character code of the character at the specified index. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="concat">concat</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Appends the supplied arguments to the end of the String object, converting them to strings if necessary, and returns the resulting string. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="fromCharCode">fromCharCode</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a string comprising the characters represented by the Unicode character codes in the parameters. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="indexOf">indexOf</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Searches the string and returns the position of the first occurrence of val found at or after startIndex within the calling string. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="lastIndexOf">lastIndexOf</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Searches the string from right to left and returns the index of the last occurrence of val found before startIndex. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="LeftPad">LeftPad</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Prepends spaces (or specified character) to a string to form string of the desired length. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="localeCompare">localeCompare</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Compares the sort order of two or more strings and returns the result of the comparison as an integer. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="match">match</link> </para></entry><entry colsep="1" rowsep="1"><para>Array </para></entry><entry colsep="1" rowsep="1"><para>Matches the specifed pattern against the string. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="Merge">Merge</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Concatenate str1 and str2 together, delim is inserted between strings if both strings are not empty </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="replace">replace</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Matches the specifed pattern against the string and returns a new string in which the first match of pattern is replaced with the content specified by repl. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="RightPad">RightPad</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Appends spaces (or specified character) to a string to form string of the desired length. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="search">search</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Searches for the specifed pattern and returns the index of the first matching substring. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="slice">slice</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a string that includes the startIndex character and all characters up to, but not including, the endIndex character. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="split">split</link> </para></entry><entry colsep="1" rowsep="1"><para>Array </para></entry><entry colsep="1" rowsep="1"><para>Splits a String object into an array of substrings by dividing it wherever the specified delimiter parameter occurs. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="StringRepeat">StringRepeat</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Makes a string consisting of spaces (or of specified string) repeated count times. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="StringToObject">StringToObject</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Parses and converts strings with parameters into object. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="substr">substr</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a substring consisting of the characters that start at the specified startIndex and with a length specified by len. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="substring">substring</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a string consisting of the character specified by startIndex and all characters up to endIndex - 1. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="ToCSV">ToCSV</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Converts arguments to comma-separated string with values enclosed in qouble quotes. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="toLocaleLowerCase">toLocaleLowerCase</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a copy of this string, with all uppercase characters converted to lowercase. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="toLocaleUpperCase">toLocaleUpperCase</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a copy of this string, with all lowercase characters converted to uppercase. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="toLowerCase">toLowerCase</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a copy of this string, with all uppercase characters converted to lowercase. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="toUpperCase">toUpperCase</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns a copy of this string, with all lowercase characters converted to uppercase. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="Upper1">Upper1</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Upper cases the first letter of a string. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="valueOf">valueOf</link> </para></entry><entry colsep="1" rowsep="1"><para>String </para></entry><entry colsep="1" rowsep="1"><para>Returns the primitive value of a String instance. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="FormatMiles">FormatMiles</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Converts number to a string, e.g. &quot;2.34 miles&quot;. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="FormatNumber">FormatNumber</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Formats number with specified precision, e.g. &quot;2,346&quot;. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="FormatNumber2">FormatNumber2</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Formats numbers with 2 decimal places, e.g. &quot;2,345.56&quot;. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para><link linkend="FormatPercent">FormatPercent</link> </para></entry><entry colsep="1" rowsep="1"><para>int </para></entry><entry colsep="1" rowsep="1"><para>Formats number as percentage, e.g. &quot;9.1%&quot;. </para></entry></row></tbody></tgroup></informaltable><section><title>CenterPad</title><para><emphasis role="strong">Usage:</emphasis> CenterPad(str, targetLength, optional padChar = &quot; &quot;) </para><para>Prepends and appends spaces (or specified character) to a string to form string of the desired length. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo CenterPad(&quot;This is a test&quot;, 25, &quot;.&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>.....This is a test...... </para></listitem></itemizedlist></section><section><title>charAt</title><para><emphasis role="strong">Usage:</emphasis> charAt(#) </para><para>Returns the character in the position specified by the index parameter. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>// Don't forget almost all internal &quot;counting&quot; starts at 0, not at 1... </para></listitem><listitem override="none"><para>// so the 5th character would actually be 0, 1, 2, 3, <emphasis role="strong">4</emphasis> &lt;--- 4! </para></listitem><listitem override="none"><para>var=&quot;hello&quot; </para></listitem><listitem override="none"><para>echo &quot;The 5th letter in the word hello is: &quot; + var.charAt(4) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>The 5th letter in the word hello is: o </para></listitem></itemizedlist></section><section><title>charCodeAt</title><para><emphasis role="strong">Usage:</emphasis> charCodeAt(#) </para><para>Returns the numeric Unicode character code of the character at the specified index. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>var=&quot;hello&quot; </para></listitem><listitem override="none"><para>echo &quot;The numeric code of the 5th letter in the word hello is: &quot; + var.charCodeAt(4) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>The numeric code of the 5th letter in the word hello is: 111 </para></listitem></itemizedlist></section><section><title>concat</title><para><emphasis role="strong">Usage:</emphasis> concat(arg1,arg2,...,argN) </para><para>Appends the supplied arguments to the end of the String object, converting them to strings if necessary, and returns the resulting string. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>var=&quot;oompa&quot; </para></listitem><listitem override="none"><para>var2=&quot;loompa&quot; </para></listitem><listitem override="none"><para>var3=&quot;dance&quot; </para></listitem><listitem override="none"><para>echo var.concat(var2,&quot; &quot;,var3) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>oompaloompa dance </para></listitem></itemizedlist></section><section><title>fromCharCode</title><para><emphasis role="strong">Usage:</emphasis> fromCharCode() </para><para>Returns a string comprising the characters represented by the Unicode character codes in the parameters. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo String.fromCharCode(70) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>F </para></listitem></itemizedlist></section><section><title>indexOf</title><para><emphasis role="strong">Usage:</emphasis> <ulink url="http://guide.neatportal.com/wiki/Strings/wiki/IndexOf#">IndexOf</ulink>() </para><para>Searches the string and returns the position of the first occurrence of val found at or after startIndex within the calling string. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;this is a test string.&quot; </para></listitem><listitem override="none"><para>echo string.indexOf(&quot;test&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>10 </para></listitem></itemizedlist></section><section><title>lastIndexOf</title><para><emphasis role="strong">Usage:</emphasis> lastIndexOf() </para><para>Searches the string from right to left and returns the index of the last occurrence of val found before startIndex. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;this is another test string.&quot; </para></listitem><listitem override="none"><para>echo string.lastIndexOf(&quot;test&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>16 </para></listitem></itemizedlist></section><section><title>LeftPad</title><para><emphasis role="strong">Usage:</emphasis> LeftPad(str, targetLength, optional padChar = &quot; &quot;) </para><para>Prepends spaces (or specified character) to a string to form string of the desired length. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo LeftPad(&quot;This is a test&quot;, 25, &quot;.&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>...........This is a test </para></listitem></itemizedlist></section><section><title>localeCompare</title><para><emphasis role="strong">Usage:</emphasis> localeCompare() </para><para>Compares the sort order of two or more strings and returns the result of the comparison as an integer. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;abc&quot; </para></listitem><listitem override="none"><para>echo &quot;def&quot;.localeCompare(string) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>3 </para></listitem></itemizedlist></section><section><title>match</title><para><emphasis role="strong">Usage:</emphasis> match() </para><para>Matches the specified pattern against the string. Usage of &quot;/g&quot; allows global search (returns multiple results if there's multiple instances). </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;This is just a simple test string.&quot; </para></listitem><listitem override="none"><para>echo string.match(/is/g) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>is,is </para></listitem></itemizedlist></section><section><title>Merge</title><para><emphasis role="strong">Usage:</emphasis> Merge(str1, str2, optional delim = &quot; &quot;) </para><para>Concatenate str1 and str2 together, delim is inserted between strings if both strings are not empty. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo Merge(&quot;This is a test&quot;, &quot;of the Emergency Broadcast System&quot;) </para></listitem><listitem override="none"><para>echo Merge(&quot;One plus One&quot;, &quot;Two&quot;, &quot; = &quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>This is a test of the Emergency Broadcast System </para></listitem><listitem override="none"><para>One plus One = Two </para></listitem></itemizedlist></section><section><title>RightPad</title><para><emphasis role="strong">Usage:</emphasis> RightPad(str, targetLength, optional padChar = &quot; &quot;) </para><para>Appends spaces (or specified character) to a string to form string of the desired length. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo RightPad(&quot;This is a test&quot;, 25, &quot;.&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>This is a test........... </para></listitem></itemizedlist></section><section><title>replace</title><para><emphasis role="strong">Usage:</emphasis> replace( , ) </para><para>Matches the specified pattern against the string and returns a new string in which the first match of pattern is replaced with the content specified. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;yet another test string&quot; </para></listitem><listitem override="none"><para>echo string.replace(&quot;test&quot;, &quot;dull test&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>yet another dull test string </para></listitem></itemizedlist></section><section><title>search</title><para><emphasis role="strong">Usage:</emphasis> search() </para><para>Searches for the specified pattern and returns the index of the first matching sub-string. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;yet another test string&quot; </para></listitem><listitem override="none"><para>echo string.search(&quot;another&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>4 </para></listitem></itemizedlist></section><section><title>slice</title><para><emphasis role="strong">Usage:</emphasis> slice( , ) </para><para>Returns a string that includes the startIndex character and all characters up to, but not including, the endIndex character. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;Hello World!&quot; </para></listitem><listitem override="none"><para>echo string.slice(1,5) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>ello </para></listitem></itemizedlist></section><section><title>split</title><para><emphasis role="strong">Usage:</emphasis> split(&quot;delimiter&quot;) </para><para>Splits a String object into an array of substrings by dividing it wherever the specified delimiter parameter occurs. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>mycoords=city.coords.split(&quot;,&quot;) </para></listitem><listitem override="none"><para>echo &quot;x:&quot; + mycoords[0] + &quot; y:&quot; + mycoords[1] </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>x:746 y:34 </para></listitem></itemizedlist></section><section><title>StringRepeat</title><para><emphasis role="strong">Usage:</emphasis> StringRepeat(count, optional str = &quot; &quot;) </para><para>Makes a string consisting of spaces (or of specified string) repeated count times. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo StringRepeat(25, &quot;.&quot;) </para></listitem><listitem override="none"><para>echo StringRepeat(25, &quot;Test&quot;) </para></listitem><listitem override="none"><para>echo StringRepeat(25, &quot;Test &quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>......................... </para></listitem><listitem override="none"><para>TestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTestTest </para></listitem><listitem override="none"><para>Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test Test </para></listitem></itemizedlist></section><section><title>StringToObject</title><para><emphasis role="strong">Usage:</emphasis> StringToObject(str, delim1, delim2, optional result = null) </para><para>Parses and converts strings with parameters into object. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>str = &quot;test1:no1,test2:no2&quot; </para></listitem><listitem override="none"><para>o = StringToObject(str,&quot;,&quot;,&quot;:&quot;) </para></listitem><listitem override="none"><para>echo o.test2 </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>no2 </para></listitem></itemizedlist></section><section><title>substr</title><para><emphasis role="strong">Usage:</emphasis> substr(first, last) </para><para>Returns a substring consisting of the characters that start at the specified startIndex and with a length specified by len. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;Hello World!&quot; </para></listitem><listitem override="none"><para>echo string.substr(1,4) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>ello </para></listitem></itemizedlist></section><section><title>substring</title><para><emphasis role="strong">Usage:</emphasis> substring(first, last) </para><para>Returns a string consisting of the character specified by startIndex and all characters up to endIndex - 1. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;Hello World!&quot; </para></listitem><listitem override="none"><para>echo string.substring(1,4) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>ell </para></listitem></itemizedlist></section><section><title>ToCSV</title><para><emphasis role="strong">Usage:</emphasis> ToCSV(...args) </para><para>Converts arguments to comma-separated string with values enclosedi in qouble quotes. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>who = &quot;Bob&quot; </para></listitem><listitem override="none"><para>what = &quot;Cap his city&quot; </para></listitem><listitem override="none"><para>when = date() </para></listitem><listitem override="none"><para>echo ToCSV(who, what, when) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>&quot;Bob&quot;,&quot;Cap his city&quot;,&quot;Tue Feb 11 19:59:38 GMT-0500 2014&quot; </para></listitem></itemizedlist></section><section><title>toLocaleLowerCase</title><para><emphasis role="strong">Usage:</emphasis> toLocaleLowerCase() </para><para>Returns a copy of this string, with all uppercase characters converted to lowercase. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;tHIs Is a mEssAge.&quot; </para></listitem><listitem override="none"><para>echo string.toLocaleLowerCase() </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>this is a message. </para></listitem></itemizedlist></section><section><title>toLocaleUpperCase</title><para><emphasis role="strong">Usage:</emphasis> toLocaleUpperCase() </para><para>Returns a copy of this string, with all lowercase characters converted to uppercase. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;tHIs Is a mEssAge.&quot; </para></listitem><listitem override="none"><para>echo string.toLocaleUpperCase() </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>THIS IS A MESSAGE. </para></listitem></itemizedlist></section><section><title>toLowerCase</title><para><emphasis role="strong">Usage:</emphasis> toLowerCase() </para><para>Returns a copy of this string, with all uppercase characters converted to lowercase. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;tHIs Is a mEssAge.&quot; </para></listitem><listitem override="none"><para>echo string.toLowerCase() </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>this is a message. </para></listitem></itemizedlist></section><section><title>toUpperCase</title><para><emphasis role="strong">Usage:</emphasis> </para><para>Returns a copy of this string, with all lowercase characters converted to uppercase. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;tHIs Is a mEssAge.&quot; </para></listitem><listitem override="none"><para>echo string.toupperCase() </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>THIS IS A MESSAGE. </para></listitem></itemizedlist></section><section><title>Upper1</title><para><emphasis role="strong">Usage:</emphasis> Upper1(str) </para><para>Upper cases the first letter of a string. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo Upper1(&quot;testing&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>Testing </para></listitem></itemizedlist></section><section><title>valueOf</title><para><emphasis role="strong">Usage:</emphasis> valueOf() </para><para>Returns the primitive value of a String instance. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>string = &quot;this is a message.&quot; </para></listitem><listitem override="none"><para>echo string.valueOf() </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>this is a message. </para></listitem></itemizedlist></section><section><title>FormatMiles</title><para><emphasis role="strong">Usage:</emphasis> FormatMiles(number) </para><para>Converts number to a string like &quot;2.34 miles&quot;. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo FormatMiles(123) </para></listitem><listitem override="none"><para>echo FormatMiles(123.4) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>123.00 miles </para></listitem><listitem override="none"><para>123.40 miles </para></listitem></itemizedlist></section><section><title>FormatNumber</title><para><emphasis role="strong">Usage:</emphasis> FormatNumber(number, optional precision = 0, optional useThousandsSeparator = true) </para><para>Formats number with specified precision. Default has no decimal places, e.g. &quot;2,346&quot; </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo FormatNumber(&quot;1234567&quot;) </para></listitem><listitem override="none"><para>echo FormatNumber(&quot;1234567&quot;,&quot;2&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>1,234,567 </para></listitem><listitem override="none"><para>1,234,567.00 </para></listitem></itemizedlist></section><section><title>FormatNumber2</title><para><emphasis role="strong">Usage:</emphasis> FormatNumber2(number, optional precision = 0, optional useThousandsSeparator = true) </para><para>Formats number with 2 decimal places, e.g. &quot;2,345.56&quot;. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo FormatNumber2(&quot;1234567&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>1,234,567.00 </para></listitem></itemizedlist></section><section><title>FormatPercent</title><para><emphasis role="strong">Usage:</emphasis> FormatPercent(number, optional presision = 1) </para><para>Formats number as percentage. </para><para><emphasis role="strong">Example:</emphasis> </para><itemizedlist><listitem override="none"><para>echo FormatPercent(&quot;1&quot;) </para></listitem><listitem override="none"><para>echo FormatPercent(&quot;0.25&quot;,&quot;0&quot;) </para></listitem><listitem override="none"><para>echo FormatPercent(&quot;0.25&quot;,&quot;2&quot;) </para></listitem></itemizedlist><para><emphasis role="strong">Result:</emphasis> </para><itemizedlist><listitem override="none"><para>100.0% </para></listitem><listitem override="none"><para>25% </para></listitem><listitem override="none"><para>25.00% </para></listitem></itemizedlist><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="http://guide.neatportal.com/wiki/Strings/wiki/CategoryFunctions#">CategoryFunctions</ulink> </para></section></article>