1<?xml version="1.0" encoding="UTF-8"?> 2<helpdocument version="1.0"> 3 4<!-- 5*********************************************************************** 6 * 7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 8 * 9 * Copyright 2000, 2010 Oracle and/or its affiliates. 10 * 11 * OpenOffice.org - a multi-platform office productivity suite 12 * 13 * This file is part of OpenOffice.org. 14 * 15 * OpenOffice.org is free software: you can redistribute it and/or modify 16 * it under the terms of the GNU Lesser General Public License version 3 17 * only, as published by the Free Software Foundation. 18 * 19 * OpenOffice.org 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 22 * GNU Lesser General Public License version 3 for more details 23 * (a copy is included in the LICENSE file that accompanied this code). 24 * 25 * You should have received a copy of the GNU Lesser General Public License 26 * version 3 along with OpenOffice.org. If not, see 27 * <http://www.openoffice.org/license.html> 28 * for a copy of the LGPLv3 License. 29 * 30 ************************************************************************ 31 --> 32 33 34<meta> 35 <topic id="textscalc0104060110xml" indexer="include"> 36 <title xml-lang="en-US" id="tit">Text Functions</title> 37 <filename>/text/scalc/01/04060110.xhp</filename> 38 </topic> 39 </meta> 40 <body> 41<bookmark xml-lang="en-US" branch="index" id="bm_id3145389"><bookmark_value>text in cells; functions</bookmark_value> 42 <bookmark_value>functions; text functions</bookmark_value> 43 <bookmark_value>Function Wizard;text</bookmark_value> 44</bookmark> 45<paragraph xml-lang="en-US" id="hd_id3145389" role="heading" level="1" l10n="U" oldref="1">Text Functions</paragraph> 46 <paragraph xml-lang="en-US" id="par_id3152986" role="paragraph" l10n="CHG" oldref="2"><variable id="texttext">This section contains descriptions of the <emph>Text</emph> functions. 47</variable></paragraph> 48 <section id="howtoget"> 49 <embed href="text/scalc/00/00000404.xhp#eikatext"/> 50 </section> 51<sort order="asc"> 52<section id="arabic"> 53<bookmark xml-lang="en-US" branch="index" id="bm_id3149384"><bookmark_value>ARABIC function</bookmark_value> 54</bookmark> 55<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARABISCH" id="bm_id3145359" localize="false"/> 56<paragraph xml-lang="en-US" id="hd_id3149384" role="heading" level="2" l10n="U" 57 oldref="239">ARABIC</paragraph> 58 <paragraph xml-lang="en-US" id="par_id3153558" role="paragraph" l10n="U" oldref="240"><ahelp hid="HID_FUNC_ARABISCH">Calculates the value of a Roman number. The value range must be between 0 and 3999.</ahelp></paragraph> 59 <paragraph xml-lang="en-US" id="hd_id3153011" role="heading" level="3" l10n="U" 60 oldref="241">Syntax</paragraph> 61 <paragraph xml-lang="en-US" id="par_id3155523" role="code" l10n="U" oldref="242">ARABIC("Text")</paragraph> 62 <paragraph xml-lang="en-US" id="par_id3151193" role="paragraph" l10n="U" oldref="243"> 63 <emph>Text</emph> is the text that represents a Roman number.</paragraph> 64 <paragraph xml-lang="en-US" id="hd_id3155758" role="heading" level="3" l10n="U" 65 oldref="244">Example</paragraph> 66 <paragraph xml-lang="en-US" id="par_id3154621" role="paragraph" l10n="U" oldref="245"> 67 <item type="input">=ARABIC("MXIV")</item> returns 1014</paragraph> 68 <paragraph xml-lang="en-US" id="par_id3147553" role="paragraph" l10n="U" oldref="246"> 69 <item type="input">=ARABIC("MMII")</item> returns 2002</paragraph> 70 </section> 71 <section id="asc"> 72<bookmark xml-lang="en-US" branch="index" id="bm_id8796349"><bookmark_value>ASC function</bookmark_value> 73</bookmark><comment>i79585</comment> 74<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ASC" id="bm_id3187353" localize="false"/> 75<paragraph xml-lang="en-US" id="hd_id7723929" role="heading" level="2" l10n="NEW">ASC</paragraph> 76 <paragraph xml-lang="en-US" id="par_id8455153" role="paragraph" l10n="NEW"><ahelp hid=".">The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> 77 <paragraph xml-lang="en-US" id="par_id9912411" role="paragraph" l10n="NEW">See <link href="http://wiki.services.openoffice.org/mwiki/index.php?title=Calc/Features/JIS_and_ASC_functions">http://wiki.services.openoffice.org/mwiki/index.php?title=Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</paragraph> 78 <paragraph xml-lang="en-US" id="hd_id9204992" role="heading" level="3" l10n="NEW">Syntax</paragraph> 79 <paragraph xml-lang="en-US" id="par_id1993774" role="code" l10n="NEW">ASC("Text")</paragraph> 80 <paragraph xml-lang="en-US" id="par_id2949919" role="paragraph" l10n="NEW"> 81 <emph>Text</emph> is the text that contains characters to be converted.</paragraph> 82 <paragraph xml-lang="en-US" id="par_id2355113" role="paragraph" l10n="NEW">See also JIS function.</paragraph> 83 </section> 84 <section id="bahttext"> 85<bookmark xml-lang="en-US" branch="index" id="bm_id9323709"><bookmark_value>BAHTTEXT function</bookmark_value> 86</bookmark> 87<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BAHTTEXT" id="bm_id744346" localize="false"/><comment>i66350</comment> 88<paragraph xml-lang="en-US" id="hd_id6695455" role="heading" level="2" l10n="NEW">BAHTTEXT</paragraph> 89 <paragraph xml-lang="en-US" id="par_id354014" role="paragraph" l10n="NEW">Converts a number to Thai text, including the Thai currency names.</paragraph> 90 <paragraph xml-lang="en-US" id="hd_id9942014" role="heading" level="3" l10n="NEW">Syntax</paragraph> 91 <paragraph xml-lang="en-US" id="par_id8780785" role="code" l10n="NEW">BAHTTEXT(Number)</paragraph> 92 <paragraph xml-lang="en-US" id="par_id1539353" role="paragraph" l10n="NEW"> 93 <emph>Number</emph> is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number.</paragraph> 94 <paragraph xml-lang="en-US" id="hd_id9694814" role="heading" level="3" l10n="NEW">Example</paragraph> 95 <paragraph xml-lang="en-US" id="par_id3289284" role="paragraph" l10n="NEW"> 96 <item type="input">=BAHTTEXT(12.65)</item> returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".</paragraph> 97 </section> 98 <section id="base"> 99<bookmark xml-lang="en-US" branch="index" id="bm_id3153072"><bookmark_value>BASE function</bookmark_value> 100</bookmark> 101<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BASIS" id="bm_id3150957" localize="false"/> 102<paragraph xml-lang="en-US" id="hd_id3153072" role="heading" level="2" l10n="U" 103 oldref="213">BASE</paragraph> 104 <paragraph xml-lang="en-US" id="par_id3153289" role="paragraph" l10n="U" oldref="214"><ahelp hid="HID_FUNC_BASIS">Converts a positive integer to a specified base into a text from the <link href="text/shared/00/00000005.xhp#zahlensystem" name="numbering system">numbering system</link>.</ahelp> The digits 0-9 and the letters A-Z are used.</paragraph> 105 <paragraph xml-lang="en-US" id="hd_id3146097" role="heading" level="3" l10n="U" 106 oldref="215">Syntax</paragraph> 107 <paragraph xml-lang="en-US" id="par_id3155743" role="code" l10n="U" oldref="216">BASE(Number; Radix; [MinimumLength])</paragraph> 108 <paragraph xml-lang="en-US" id="par_id3151339" role="paragraph" l10n="U" oldref="217"> 109 <emph>Number</emph> is the positive integer to be converted.</paragraph> 110 <paragraph xml-lang="en-US" id="par_id3159262" role="paragraph" l10n="U" oldref="218"> 111 <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> 112 <paragraph xml-lang="en-US" id="par_id3148746" role="paragraph" l10n="U" oldref="219"> 113 <emph>MinimumLength</emph> (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string.</paragraph> 114 <paragraph xml-lang="en-US" id="hd_id3146323" role="heading" level="3" l10n="U" 115 oldref="220">Example</paragraph> 116<bookmark xml-lang="en-US" branch="index" id="bm_id3156399"><bookmark_value>decimal system; converting to</bookmark_value> 117</bookmark> 118<paragraph xml-lang="en-US" id="par_id3156399" role="paragraph" l10n="U" oldref="221"> 119 <item type="input">=BASE(17;10;4)</item> returns 0017 in the decimal system.</paragraph> 120<bookmark xml-lang="en-US" branch="index" id="bm_id3157871"><bookmark_value>binary system; converting to</bookmark_value> 121</bookmark> 122<paragraph xml-lang="en-US" id="par_id3157871" role="paragraph" l10n="U" oldref="222"> 123 <item type="input">=BASE(17;2)</item> returns 10001 in the binary system.</paragraph> 124<bookmark xml-lang="en-US" branch="index" id="bm_id3145226"><bookmark_value>hexadecimal system; converting to</bookmark_value> 125</bookmark> 126<paragraph xml-lang="en-US" id="par_id3145226" role="paragraph" l10n="U" oldref="223"> 127 <item type="input">=BASE(255;16;4)</item> returns 00FF in the hexadecimal system.</paragraph> 128 </section> 129 <section id="char"> 130<bookmark xml-lang="en-US" branch="index" id="bm_id3149321"><bookmark_value>CHAR function</bookmark_value> 131</bookmark> 132<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEICHEN" id="bm_id3159128" localize="false"/> 133<paragraph xml-lang="en-US" id="hd_id3149321" role="heading" level="2" l10n="U" 134 oldref="201">CHAR</paragraph> 135 <paragraph xml-lang="en-US" id="par_id3149150" role="paragraph" l10n="U" oldref="202"><ahelp hid="HID_FUNC_ZEICHEN">Converts a number into a character according to the current code table.</ahelp> The number can be a two-digit or three-digit integer number.</paragraph> 136 <embed href="text/scalc/00/00000004.xhp#codes"/> 137 <paragraph xml-lang="en-US" id="hd_id3149945" role="heading" level="3" l10n="U" 138 oldref="203">Syntax</paragraph> 139 <paragraph xml-lang="en-US" id="par_id3145634" role="code" l10n="U" oldref="204">CHAR(Number)</paragraph> 140 <paragraph xml-lang="en-US" id="par_id3155906" role="paragraph" l10n="U" oldref="205"> 141 <emph>Number</emph> is a number between 1 and 255 representing the code value for the character.</paragraph> 142 <paragraph xml-lang="en-US" id="hd_id3152982" role="heading" level="3" l10n="U" 143 oldref="207">Example</paragraph> 144 <paragraph xml-lang="en-US" id="par_id3149890" role="paragraph" l10n="CHG" oldref="208"> 145 <item type="input">=CHAR(100)</item> returns the character d.</paragraph> 146 <paragraph xml-lang="en-US" id="par_id0907200910283297" role="paragraph" l10n="NEW">="abc" & CHAR(10) & "def" inserts a newline character into the string.</paragraph> 147 </section> 148 <section id="clean"> 149<bookmark xml-lang="en-US" branch="index" id="bm_id3149009"><bookmark_value>CLEAN function</bookmark_value> 150</bookmark> 151<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SAEUBERN" id="bm_id3148729" localize="false"/> 152<paragraph xml-lang="en-US" id="hd_id3149009" role="heading" level="2" l10n="U" 153 oldref="132">CLEAN</paragraph> 154 <paragraph xml-lang="en-US" id="par_id3150482" role="paragraph" l10n="U" oldref="133"><ahelp hid="HID_FUNC_SAEUBERN">All non-printing characters are removed from the string.</ahelp></paragraph> 155 <paragraph xml-lang="en-US" id="hd_id3146880" role="heading" level="3" l10n="U" 156 oldref="134">Syntax</paragraph> 157 <paragraph xml-lang="en-US" id="par_id3147472" role="code" l10n="U" oldref="135">CLEAN("Text")</paragraph> 158 <paragraph xml-lang="en-US" id="par_id3150695" role="paragraph" l10n="U" oldref="136"> 159 <emph>Text</emph> refers to the text from which to remove all non-printable characters.</paragraph> 160 </section> 161 <section id="code"> 162<bookmark xml-lang="en-US" branch="index" id="bm_id3155498"><bookmark_value>CODE function</bookmark_value> 163</bookmark> 164<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CODE" id="bm_id3159084" localize="false"/> 165<paragraph xml-lang="en-US" id="hd_id3155498" role="heading" level="2" l10n="U" oldref="3">CODE</paragraph> 166 <paragraph xml-lang="en-US" id="par_id3152770" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_FUNC_CODE">Returns a numeric code for the first character in a text string.</ahelp></paragraph> 167 <paragraph xml-lang="en-US" id="hd_id3155830" role="heading" level="3" l10n="U" oldref="5">Syntax</paragraph> 168 <paragraph xml-lang="en-US" id="par_id3149188" role="code" l10n="U" oldref="6">CODE("Text")</paragraph> 169 <paragraph xml-lang="en-US" id="par_id3154383" role="paragraph" l10n="U" oldref="7"> 170 <emph>Text</emph> is the text for which the code of the first character is to be found.</paragraph> 171 <embed href="text/scalc/00/00000004.xhp#codes"/> 172 <paragraph xml-lang="en-US" id="hd_id3154394" role="heading" level="3" l10n="U" oldref="8">Example</paragraph> 173 <paragraph xml-lang="en-US" id="par_id3159209" role="paragraph" l10n="U" oldref="9"> 174 <item type="input">=CODE("Hieronymus")</item> returns 72, <item type="input">=CODE("hieroglyphic")</item> returns 104.</paragraph> 175 <paragraph xml-lang="en-US" id="par_id3150280" role="note" l10n="U" oldref="211">The code used here does not refer to ASCII, but to the code table currently loaded.</paragraph> 176 </section> 177 <section id="concatenate"> 178<bookmark xml-lang="en-US" branch="index" id="bm_id3149688"><bookmark_value>CONCATENATE function</bookmark_value> 179</bookmark> 180<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERKETTEN" id="bm_id3153084" localize="false"/> 181<paragraph xml-lang="en-US" id="hd_id3149688" role="heading" level="2" l10n="U" 182 oldref="167">CONCATENATE</paragraph> 183 <paragraph xml-lang="en-US" id="par_id3154524" role="paragraph" l10n="U" oldref="168"><ahelp hid="HID_FUNC_VERKETTEN">Combines several text strings into one string.</ahelp></paragraph> 184 <paragraph xml-lang="en-US" id="hd_id3149542" role="heading" level="3" l10n="U" 185 oldref="169">Syntax</paragraph> 186 <paragraph xml-lang="en-US" id="par_id3155954" role="code" l10n="U" oldref="170">CONCATENATE("Text1"; ...; "Text30")</paragraph> 187 <paragraph xml-lang="en-US" id="par_id3146847" role="paragraph" l10n="U" oldref="171"> 188 <emph>Text 1; Text 2; ...</emph> represent up to 30 text passages which are to be combined into one string.</paragraph> 189 <paragraph xml-lang="en-US" id="hd_id3153110" role="heading" level="3" l10n="U" 190 oldref="172">Example</paragraph> 191 <paragraph xml-lang="en-US" id="par_id3150008" role="paragraph" l10n="U" oldref="173"> 192 <item type="input">=CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe")</item> returns: Good Morning Mrs. Doe.</paragraph> 193 </section> 194 <section id="decimal"> 195<bookmark xml-lang="en-US" branch="index" id="bm_id3145166"><bookmark_value>DECIMAL function</bookmark_value> 196</bookmark> 197<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEZIMAL" id="bm_id3150338" localize="false"/> 198<paragraph xml-lang="en-US" id="hd_id3145166" role="heading" level="2" l10n="U" 199 oldref="225">DECIMAL</paragraph> 200 <paragraph xml-lang="en-US" id="par_id3156361" role="paragraph" l10n="U" oldref="226"><ahelp hid="HID_FUNC_DEZIMAL">Converts text with characters from a <link href="text/shared/00/00000005.xhp#zahlensystem" name="number system">number system</link> to a positive integer in the base radix given.</ahelp> The radix must be in the range 2 to 36. Spaces and tabs are ignored. The <emph>Text</emph> field is not case-sensitive.</paragraph> 201 <paragraph xml-lang="en-US" id="par_id3157994" role="paragraph" l10n="U" oldref="227">If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, is disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the number system generate an error.</paragraph> 202 <paragraph xml-lang="en-US" id="hd_id3150014" role="heading" level="3" l10n="U" 203 oldref="228">Syntax</paragraph> 204 <paragraph xml-lang="en-US" id="par_id3154328" role="code" l10n="U" oldref="229">DECIMAL("Text"; Radix)</paragraph> 205 <paragraph xml-lang="en-US" id="par_id3150128" role="paragraph" l10n="U" oldref="230"> 206 <emph>Text</emph> is the text to be converted. To differentiate between a hexadecimal number, such as A1 and the reference to cell A1, you must place the number in quotation marks, for example, "A1" or "FACE".</paragraph> 207 <paragraph xml-lang="en-US" id="par_id3145241" role="paragraph" l10n="U" oldref="231"> 208 <emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> 209 <paragraph xml-lang="en-US" id="hd_id3156062" role="heading" level="3" l10n="U" 210 oldref="232">Example</paragraph> 211 <paragraph xml-lang="en-US" id="par_id3145355" role="paragraph" l10n="U" oldref="233"> 212 <item type="input">=DECIMAL("17";10)</item> returns 17.</paragraph> 213 <paragraph xml-lang="en-US" id="par_id3155622" role="paragraph" l10n="U" oldref="234"> 214 <item type="input">=DECIMAL("FACE";16)</item> returns 64206.</paragraph> 215 <paragraph xml-lang="en-US" id="par_id3151015" role="paragraph" l10n="U" oldref="235"> 216 <item type="input">=DECIMAL("0101";2)</item> returns 5.</paragraph> 217 </section> 218 <section id="dollar"> 219<bookmark xml-lang="en-US" branch="index" id="bm_id3148402"><bookmark_value>DOLLAR function</bookmark_value> 220</bookmark> 221<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DM" id="bm_id3149532" localize="false"/> 222<paragraph xml-lang="en-US" id="hd_id3148402" role="heading" level="2" l10n="U" 223 oldref="11">DOLLAR</paragraph> 224 <paragraph xml-lang="en-US" id="par_id3153049" role="paragraph" l10n="U" oldref="12"><ahelp hid="HID_FUNC_DM">Converts a number to an amount in the currency format, rounded to a specified decimal place.</ahelp> In the <item type="literal">Value</item> field enter the number to be converted to currency. Optionally, you may enter the number of decimal places in the <item type="literal">Decimals</item> field. If no value is specified, all numbers in currency format will be displayed with two decimal places. </paragraph> 225 <paragraph xml-lang="en-US" id="par_id3151280" role="paragraph" l10n="U" oldref="263">You set the currency format in your system settings.</paragraph> 226 <paragraph xml-lang="en-US" id="hd_id3150569" role="heading" level="3" l10n="U" 227 oldref="13">Syntax</paragraph> 228 <paragraph xml-lang="en-US" id="par_id3154188" role="code" l10n="U" oldref="14">DOLLAR(Value; Decimals)</paragraph> 229 <paragraph xml-lang="en-US" id="par_id3145299" role="paragraph" l10n="U" oldref="15"> 230 <emph>Value</emph> is a number, a reference to a cell containing a number, or a formula which returns a number.</paragraph> 231 <paragraph xml-lang="en-US" id="par_id3145629" role="paragraph" l10n="CHG" oldref="16"> 232 <emph>Decimals</emph> is the optional number of decimal places.</paragraph> 233 <paragraph xml-lang="en-US" id="hd_id3149030" role="heading" level="3" l10n="U" 234 oldref="17">Example</paragraph> 235 <paragraph xml-lang="en-US" id="par_id3153546" role="paragraph" l10n="U" oldref="18"> 236 <item type="input">=DOLLAR(255)</item> returns $255.00.</paragraph> 237 <paragraph xml-lang="en-US" id="par_id3154635" role="paragraph" l10n="U" oldref="19"> 238 <item type="input">=DOLLAR(367.456;2)</item> returns $367.46. Use the decimal separator that corresponds to the <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link>.</paragraph> 239 </section> 240 <section id="exact"> 241<bookmark xml-lang="en-US" branch="index" id="bm_id3150685"><bookmark_value>EXACT function</bookmark_value> 242</bookmark> 243<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IDENTISCH" id="bm_id3155081" localize="false"/> 244<paragraph xml-lang="en-US" id="hd_id3150685" role="heading" level="2" l10n="U" 245 oldref="78">EXACT</paragraph> 246 <paragraph xml-lang="en-US" id="par_id3158413" role="paragraph" l10n="U" oldref="79"><ahelp hid="HID_FUNC_IDENTISCH">Compares two text strings and returns TRUE if they are identical.</ahelp> This function is case-sensitive.</paragraph> 247 <paragraph xml-lang="en-US" id="hd_id3152817" role="heading" level="3" l10n="U" 248 oldref="80">Syntax</paragraph> 249 <paragraph xml-lang="en-US" id="par_id3148594" role="code" l10n="U" oldref="81">EXACT("Text1"; "Text2")</paragraph> 250 <paragraph xml-lang="en-US" id="par_id3153224" role="paragraph" l10n="U" oldref="82"> 251 <emph>Text1</emph> refers to the first text to compare.</paragraph> 252 <paragraph xml-lang="en-US" id="par_id3148637" role="paragraph" l10n="U" oldref="83"> 253 <emph>Text2</emph> is the second text to compare.</paragraph> 254 <paragraph xml-lang="en-US" id="hd_id3149777" role="heading" level="3" l10n="U" 255 oldref="84">Example</paragraph> 256 <paragraph xml-lang="en-US" id="par_id3156263" role="paragraph" l10n="U" oldref="85"> 257 <item type="input">=EXACT("microsystems";"Microsystems")</item> returns FALSE.</paragraph> 258 </section> 259 <section id="find"> 260<bookmark xml-lang="en-US" branch="index" id="bm_id3152589"><bookmark_value>FIND function</bookmark_value> 261</bookmark> 262<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FINDEN" id="bm_id3147482" localize="false"/> 263<paragraph xml-lang="en-US" id="hd_id3152589" role="heading" level="2" l10n="U" 264 oldref="44">FIND</paragraph> 265 <paragraph xml-lang="en-US" id="par_id3146149" role="paragraph" l10n="U" oldref="45"><ahelp hid="HID_FUNC_FINDEN">Looks for a string of text within another string.</ahelp> You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive.</paragraph> 266 <paragraph xml-lang="en-US" id="hd_id3083284" role="heading" level="3" l10n="U" 267 oldref="46">Syntax</paragraph> 268 <paragraph xml-lang="en-US" id="par_id3083452" role="code" l10n="U" oldref="47">FIND("FindText"; "Text"; Position)</paragraph> 269 <paragraph xml-lang="en-US" id="par_id3150608" role="paragraph" l10n="U" oldref="48"> 270 <emph>FindText</emph> refers to the text to be found.</paragraph> 271 <paragraph xml-lang="en-US" id="par_id3152374" role="paragraph" l10n="U" oldref="49"> 272 <emph>Text</emph> is the text where the search takes place.</paragraph> 273 <paragraph xml-lang="en-US" id="par_id3152475" role="paragraph" l10n="U" oldref="50"> 274 <emph>Position</emph> (optional) is the position in the text from which the search starts.</paragraph> 275 <paragraph xml-lang="en-US" id="hd_id3154812" role="heading" level="3" l10n="U" 276 oldref="51">Example</paragraph> 277 <paragraph xml-lang="en-US" id="par_id3156375" role="paragraph" l10n="U" oldref="52"> 278 <item type="input">=FIND(76;998877665544)</item> returns 6.</paragraph> 279 </section> 280 <section id="fixed"> 281<bookmark xml-lang="en-US" branch="index" id="bm_id3149268"><bookmark_value>FIXED function</bookmark_value> 282</bookmark> 283<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FEST" id="bm_id3149450" localize="false"/> 284<paragraph xml-lang="en-US" id="hd_id3149268" role="heading" level="2" l10n="U" 285 oldref="34">FIXED</paragraph> 286 <paragraph xml-lang="en-US" id="par_id3155833" role="paragraph" l10n="CHG" oldref="35"><ahelp hid="HID_FUNC_FEST">Returns a number as text with a specified number of decimal places and optional thousands separators.</ahelp></paragraph> 287 <paragraph xml-lang="en-US" id="hd_id3152470" role="heading" level="3" l10n="U" 288 oldref="36">Syntax</paragraph> 289 <paragraph xml-lang="en-US" id="par_id3147567" role="code" l10n="U" oldref="37">FIXED(Number; Decimals; NoThousandsSeparators)</paragraph> 290 <paragraph xml-lang="en-US" id="par_id3151272" role="paragraph" l10n="U" oldref="38"> 291 <emph>Number</emph> refers to the number to be formatted.</paragraph> 292 <paragraph xml-lang="en-US" id="par_id3156322" role="paragraph" l10n="U" oldref="39"> 293 <emph>Decimals</emph> refers to the number of decimal places to be displayed.</paragraph> 294 <paragraph xml-lang="en-US" id="par_id3150877" role="paragraph" l10n="U" oldref="40"> 295 <emph>NoThousandsSeparators</emph> (optional) determines whether the thousands separator is used. If the parameter is a number not equal to 0, the thousands separator is suppressed. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link> are displayed.</paragraph> 296 <paragraph xml-lang="en-US" id="hd_id3149040" role="heading" level="3" l10n="U" 297 oldref="41">Example</paragraph> 298 <paragraph xml-lang="en-US" id="par_id3145208" role="paragraph" l10n="CHG" oldref="42"> 299 <item type="input">=FIXED(1234567.89;3)</item> returns 1,234,567.890 as a text string. </paragraph> 300 <paragraph xml-lang="en-US" id="par_id5282143" role="paragraph" l10n="NEW"> 301 <item type="input">=FIXED(1234567.89;3;1)</item> returns 1234567.890 as a text string.</paragraph> 302 </section> 303 <section id="jis"> 304<bookmark xml-lang="en-US" branch="index" id="bm_id7319864"><bookmark_value>JIS function</bookmark_value> 305</bookmark> 306<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JIS" id="bm_id3818475" localize="false"/> 307<paragraph xml-lang="en-US" id="hd_id3666188" role="heading" level="2" l10n="NEW">JIS</paragraph> 308 <paragraph xml-lang="en-US" id="par_id964384" role="paragraph" l10n="NEW"><ahelp hid=".">The JIS function converts half-width to full-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> 309 <paragraph xml-lang="en-US" id="par_id1551561" role="paragraph" l10n="NEW">See <link href="http://wiki.services.openoffice.org/mwiki/index.php?title=Calc/Features/JIS_and_ASC_functions">http://wiki.services.openoffice.org/mwiki/index.php?title=Calc/Features/JIS_and_ASC_functions</link> for a conversion table.</paragraph> 310 <paragraph xml-lang="en-US" id="hd_id2212897" role="heading" level="3" l10n="NEW">Syntax</paragraph> 311 <paragraph xml-lang="en-US" id="par_id2504654" role="code" l10n="NEW">JIS("Text")</paragraph> 312 <paragraph xml-lang="en-US" id="par_id5292519" role="paragraph" l10n="NEW"> 313 <emph>Text</emph> is the text that contains characters to be converted.</paragraph> 314 <paragraph xml-lang="en-US" id="par_id3984496" role="paragraph" l10n="NEW">See also ASC function.</paragraph> 315 </section> 316 <section id="left"> 317<bookmark xml-lang="en-US" branch="index" id="bm_id3147083"><bookmark_value>LEFT function</bookmark_value> 318</bookmark> 319<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LINKS" id="bm_id3154645" localize="false"/> 320<paragraph xml-lang="en-US" id="hd_id3147083" role="heading" level="2" l10n="U" 321 oldref="95">LEFT</paragraph> 322 <paragraph xml-lang="en-US" id="par_id3153622" role="paragraph" l10n="CHG" oldref="96"><ahelp hid="HID_FUNC_LINKS">Returns the first character or characters of a text.</ahelp></paragraph> 323 <paragraph xml-lang="en-US" id="hd_id3156116" role="heading" level="3" l10n="U" 324 oldref="97">Syntax</paragraph> 325 <paragraph xml-lang="en-US" id="par_id3146786" role="code" l10n="U" oldref="98">LEFT("Text"; Number)</paragraph> 326 <paragraph xml-lang="en-US" id="par_id3147274" role="paragraph" l10n="U" oldref="99"> 327 <emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> 328 <paragraph xml-lang="en-US" id="par_id3153152" role="paragraph" l10n="U" oldref="100"> 329 <emph>Number</emph> (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned.</paragraph> 330 <paragraph xml-lang="en-US" id="hd_id3150260" role="heading" level="3" l10n="U" 331 oldref="101">Example</paragraph> 332 <paragraph xml-lang="en-US" id="par_id3149141" role="paragraph" l10n="U" oldref="102"> 333 <item type="input">=LEFT("output";3)</item> returns “out”.</paragraph> 334 </section> 335 <section id="len"> 336<bookmark xml-lang="en-US" branch="index" id="bm_id3156110"><bookmark_value>LEN function</bookmark_value> 337</bookmark> 338<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAENGE" id="bm_id3154050" localize="false"/> 339<paragraph xml-lang="en-US" id="hd_id3156110" role="heading" level="2" l10n="U" 340 oldref="104">LEN</paragraph> 341 <paragraph xml-lang="en-US" id="par_id3150147" role="paragraph" l10n="U" oldref="105"><ahelp hid="HID_FUNC_LAENGE">Returns the length of a string including spaces.</ahelp></paragraph> 342 <paragraph xml-lang="en-US" id="hd_id3155108" role="heading" level="3" l10n="U" 343 oldref="106">Syntax</paragraph> 344 <paragraph xml-lang="en-US" id="par_id3154063" role="code" l10n="U" oldref="107">LEN("Text")</paragraph> 345 <paragraph xml-lang="en-US" id="par_id3146894" role="paragraph" l10n="U" oldref="108"> 346 <emph>Text</emph> is the text whose length is to be determined.</paragraph> 347 <paragraph xml-lang="en-US" id="hd_id3153884" role="heading" level="3" l10n="U" 348 oldref="109">Example</paragraph> 349 <paragraph xml-lang="en-US" id="par_id3156008" role="paragraph" l10n="U" oldref="110"> 350 <item type="input">=LEN("Good Afternoon")</item> returns 14.</paragraph> 351 <paragraph xml-lang="en-US" id="par_id3154300" role="paragraph" l10n="U" oldref="111"> 352 <item type="input">=LEN(12345.67)</item> returns 8.</paragraph> 353 </section> 354 <section id="lower"> 355<bookmark xml-lang="en-US" branch="index" id="bm_id3153983"><bookmark_value>LOWER function</bookmark_value> 356</bookmark> 357<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KLEIN" id="bm_id3151173" localize="false"/> 358<paragraph xml-lang="en-US" id="hd_id3153983" role="heading" level="2" l10n="U" 359 oldref="87">LOWER</paragraph> 360 <paragraph xml-lang="en-US" id="par_id3152791" role="paragraph" l10n="U" oldref="88"><ahelp hid="HID_FUNC_KLEIN">Converts all uppercase letters in a text string to lowercase.</ahelp></paragraph> 361 <paragraph xml-lang="en-US" id="hd_id3155902" role="heading" level="3" l10n="U" 362 oldref="89">Syntax</paragraph> 363 <paragraph xml-lang="en-US" id="par_id3150121" role="code" l10n="U" oldref="90">LOWER("Text")</paragraph> 364 <paragraph xml-lang="en-US" id="par_id3153910" role="paragraph" l10n="U" oldref="91"> 365 <emph>Text</emph> refers to the text to be converted.</paragraph> 366 <paragraph xml-lang="en-US" id="hd_id3159343" role="heading" level="3" l10n="U" 367 oldref="92">Example</paragraph> 368 <paragraph xml-lang="en-US" id="par_id3155329" role="paragraph" l10n="U" oldref="93"> 369 <item type="input">=LOWER("Sun")</item> returns sun.</paragraph> 370 </section> 371 <section id="mid"> 372<bookmark xml-lang="en-US" branch="index" id="bm_id3154589"><bookmark_value>MID function</bookmark_value> 373</bookmark> 374<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEIL" id="bm_id3155392" localize="false"/> 375<paragraph xml-lang="en-US" id="hd_id3154589" role="heading" level="2" l10n="U" 376 oldref="148">MID</paragraph> 377 <paragraph xml-lang="en-US" id="par_id3154938" role="paragraph" l10n="CHG" oldref="149"><ahelp hid="HID_FUNC_TEIL">Returns a text string of a text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> 378 <paragraph xml-lang="en-US" id="hd_id3148829" role="heading" level="3" l10n="U" 379 oldref="150">Syntax</paragraph> 380 <paragraph xml-lang="en-US" id="par_id3150526" role="code" l10n="U" oldref="151">MID("Text"; Start; Number)</paragraph> 381 <paragraph xml-lang="en-US" id="par_id3148820" role="paragraph" l10n="U" oldref="152"> 382 <emph>Text</emph> is the text containing the characters to extract.</paragraph> 383 <paragraph xml-lang="en-US" id="par_id3150774" role="paragraph" l10n="U" oldref="153"> 384 <emph>Start</emph> is the position of the first character in the text to extract.</paragraph> 385 <paragraph xml-lang="en-US" id="par_id3153063" role="paragraph" l10n="U" oldref="154"> 386 <emph>Number</emph> specifies the number of characters in the part of the text.</paragraph> 387 <paragraph xml-lang="en-US" id="hd_id3150509" role="heading" level="3" l10n="U" 388 oldref="155">Example</paragraph> 389 <paragraph xml-lang="en-US" id="par_id3158407" role="paragraph" l10n="U" oldref="156"> 390 <item type="input">=MID("office";2;2)</item> returns ff.</paragraph> 391 </section> 392 <section id="proper"> 393<bookmark xml-lang="en-US" branch="index" id="bm_id3159143"><bookmark_value>PROPER function</bookmark_value> 394</bookmark> 395<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS2" id="bm_id3154897" localize="false"/> 396<paragraph xml-lang="en-US" id="hd_id3159143" role="heading" level="2" l10n="U" 397 oldref="70">PROPER</paragraph> 398 <paragraph xml-lang="en-US" id="par_id3149768" role="paragraph" l10n="U" oldref="71"><ahelp hid="HID_FUNC_GROSS2">Capitalizes the first letter in all words of a text string.</ahelp></paragraph> 399 <paragraph xml-lang="en-US" id="hd_id3153573" role="heading" level="3" l10n="U" 400 oldref="72">Syntax</paragraph> 401 <paragraph xml-lang="en-US" id="par_id3154260" role="code" l10n="U" oldref="73">PROPER("Text")</paragraph> 402 <paragraph xml-lang="en-US" id="par_id3147509" role="paragraph" l10n="U" oldref="74"> 403 <emph>Text</emph> refers to the text to be converted.</paragraph> 404 <paragraph xml-lang="en-US" id="hd_id3147529" role="heading" level="3" l10n="U" 405 oldref="75">Example</paragraph> 406 <paragraph xml-lang="en-US" id="par_id3155364" role="paragraph" l10n="U" oldref="76"> 407 <item type="input">=PROPER("open office")</item> returns Open Office.</paragraph> 408 </section> 409 <section id="replace"> 410<bookmark xml-lang="en-US" branch="index" id="bm_id3149171"><bookmark_value>REPLACE function</bookmark_value> 411</bookmark> 412<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERSETZEN" id="bm_id3149990" localize="false"/> 413<paragraph xml-lang="en-US" id="hd_id3149171" role="heading" level="2" l10n="U" 414 oldref="22">REPLACE</paragraph> 415 <paragraph xml-lang="en-US" id="par_id3148925" role="paragraph" l10n="U" oldref="23"><ahelp hid="HID_FUNC_ERSETZEN">Replaces part of a text string with a different text string.</ahelp> This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the <link href="text/scalc/01/04060110.xhp" name="VALUE">VALUE</link> function.</paragraph> 416 <paragraph xml-lang="en-US" id="par_id3158426" role="paragraph" l10n="U" oldref="24">Any text containing numbers must be enclosed in quotation marks if you do not want it to be interpreted as a number and automatically converted to text.</paragraph> 417 <paragraph xml-lang="en-US" id="hd_id3149159" role="heading" level="3" l10n="U" 418 oldref="25">Syntax</paragraph> 419 <paragraph xml-lang="en-US" id="par_id3147286" role="code" l10n="U" oldref="26">REPLACE("Text"; Position; Length; "NewText")</paragraph> 420 <paragraph xml-lang="en-US" id="par_id3149797" role="paragraph" l10n="U" oldref="27"> 421 <emph>Text</emph> refers to text of which a part will be replaced.</paragraph> 422 <paragraph xml-lang="en-US" id="par_id3166451" role="paragraph" l10n="U" oldref="28"> 423 <emph>Position</emph> refers to the position within the text where the replacement will begin.</paragraph> 424 <paragraph xml-lang="en-US" id="par_id3156040" role="paragraph" l10n="U" oldref="29"> 425 <emph>Length</emph> is the number of characters in <emph>Text</emph> to be replaced.</paragraph> 426 <paragraph xml-lang="en-US" id="par_id3159188" role="paragraph" l10n="U" oldref="30"> 427 <emph>NewText</emph> refers to the text which replaces <emph>Text</emph>.</paragraph> 428 <paragraph xml-lang="en-US" id="hd_id3146958" role="heading" level="3" l10n="U" 429 oldref="31">Example</paragraph> 430 <paragraph xml-lang="en-US" id="par_id3154096" role="paragraph" l10n="U" oldref="32"> 431 <item type="input">=REPLACE("1234567";1;1;"444")</item> returns "444234567". One character at position 1 is replaced by the complete <item type="literal">NewText</item>.</paragraph> 432 </section> 433 <section id="rept"> 434<bookmark xml-lang="en-US" branch="index" id="bm_id3149741"><bookmark_value>REPT function</bookmark_value> 435</bookmark> 436<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WIEDERHOLEN" id="bm_id3155582" localize="false"/> 437<paragraph xml-lang="en-US" id="hd_id3149741" role="heading" level="2" l10n="U" 438 oldref="193">REPT</paragraph> 439 <paragraph xml-lang="en-US" id="par_id3153748" role="paragraph" l10n="U" oldref="194"><ahelp hid="HID_FUNC_WIEDERHOLEN">Repeats a character string by the given <emph>number</emph> of copies.</ahelp></paragraph> 440 <paragraph xml-lang="en-US" id="hd_id3152884" role="heading" level="3" l10n="U" 441 oldref="195">Syntax</paragraph> 442 <paragraph xml-lang="en-US" id="par_id3150494" role="code" l10n="U" oldref="196">REPT("Text"; Number)</paragraph> 443 <paragraph xml-lang="en-US" id="par_id3154859" role="paragraph" l10n="U" oldref="197"> 444 <emph>Text</emph> is the text to be repeated.</paragraph> 445 <paragraph xml-lang="en-US" id="par_id3150638" role="paragraph" l10n="U" oldref="198"> 446 <emph>Number</emph> is the number of repetitions.</paragraph> 447 <paragraph xml-lang="en-US" id="par_id3149922" role="paragraph" l10n="U" oldref="212">The result can be a maximum of 255 characters.</paragraph> 448 <paragraph xml-lang="en-US" id="hd_id3156213" role="heading" level="3" l10n="U" 449 oldref="199">Example</paragraph> 450 <paragraph xml-lang="en-US" id="par_id3148626" role="paragraph" l10n="U" oldref="200"> 451 <item type="input">=REPT("Good morning";2)</item> returns Good morningGood morning.</paragraph> 452 </section> 453 <section id="right"> 454<bookmark xml-lang="en-US" branch="index" id="bm_id3149805"><bookmark_value>RIGHT function</bookmark_value> 455</bookmark> 456<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RECHTS" id="bm_id3154602" localize="false"/> 457<paragraph xml-lang="en-US" id="hd_id3149805" role="heading" level="2" l10n="U" 458 oldref="113">RIGHT</paragraph> 459 <paragraph xml-lang="en-US" id="par_id3145375" role="paragraph" l10n="CHG" oldref="114"><ahelp hid="HID_FUNC_RECHTS">Returns the last character or characters of a text.</ahelp></paragraph> 460 <paragraph xml-lang="en-US" id="hd_id3150837" role="heading" level="3" l10n="U" 461 oldref="115">Syntax</paragraph> 462 <paragraph xml-lang="en-US" id="par_id3154344" role="code" l10n="U" oldref="116">RIGHT("Text"; Number)</paragraph> 463 <paragraph xml-lang="en-US" id="par_id3149426" role="paragraph" l10n="U" oldref="117"> 464 <emph>Text</emph> is the text of which the right part is to be determined.</paragraph> 465 <paragraph xml-lang="en-US" id="par_id3153350" role="paragraph" l10n="U" oldref="118"> 466 <emph>Number</emph> (optional) is the number of characters from the right part of the text.</paragraph> 467 <paragraph xml-lang="en-US" id="hd_id3148661" role="heading" level="3" l10n="U" 468 oldref="119">Example</paragraph> 469 <paragraph xml-lang="en-US" id="par_id3151132" role="paragraph" l10n="U" oldref="120"> 470 <item type="input">=RIGHT("Sun";2)</item> returns un.</paragraph> 471 </section> 472 <section id="roman"> 473<bookmark xml-lang="en-US" branch="index" id="bm_id3153534"><bookmark_value>ROMAN function</bookmark_value> 474</bookmark> 475<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ROEMISCH" id="bm_id3144755" localize="false"/> 476<paragraph xml-lang="en-US" id="hd_id3153534" role="heading" level="2" l10n="U" 477 oldref="248">ROMAN</paragraph> 478 <paragraph xml-lang="en-US" id="par_id3151256" role="paragraph" l10n="U" oldref="249"><ahelp hid="HID_FUNC_ROEMISCH">Converts a number into a Roman numeral. The value range must be between 0 and 3999, the modes can be integers from 0 to 4.</ahelp></paragraph> 479 <paragraph xml-lang="en-US" id="hd_id3149299" role="heading" level="3" l10n="U" 480 oldref="250">Syntax</paragraph> 481 <paragraph xml-lang="en-US" id="par_id3150593" role="code" l10n="U" oldref="251">ROMAN(Number; Mode)</paragraph> 482 <paragraph xml-lang="en-US" id="par_id3156139" role="paragraph" l10n="U" oldref="252"> 483 <emph>Number</emph> is the number that is to be converted into a Roman numeral.</paragraph> 484 <paragraph xml-lang="en-US" id="par_id3153318" role="paragraph" l10n="U" oldref="253"> 485 <emph>Mode</emph> (optional) indicates the degree of simplification. The higher the value, the greater is the simplification of the Roman number.</paragraph> 486 <paragraph xml-lang="en-US" id="hd_id3145306" role="heading" level="3" l10n="U" 487 oldref="254">Example</paragraph> 488 <paragraph xml-lang="en-US" id="par_id3151371" role="paragraph" l10n="U" oldref="255"> 489 <item type="input">=ROMAN(999)</item> returns CMXCIX</paragraph> 490 <paragraph xml-lang="en-US" id="par_id3153938" role="paragraph" l10n="U" oldref="256"> 491 <item type="input">=ROMAN(999;0)</item> returns CMXCIX</paragraph> 492 <paragraph xml-lang="en-US" id="par_id3148412" role="paragraph" l10n="U" oldref="257"> 493 <item type="input">=ROMAN (999;1)</item> returns LMVLIV</paragraph> 494 <paragraph xml-lang="en-US" id="par_id3155421" role="paragraph" l10n="U" oldref="258"> 495 <item type="input">=ROMAN(999;2)</item> returns XMIX</paragraph> 496 <paragraph xml-lang="en-US" id="par_id3149235" role="paragraph" l10n="U" oldref="259"> 497 <item type="input">=ROMAN(999;3)</item> returns VMIV</paragraph> 498 <paragraph xml-lang="en-US" id="par_id3150624" role="paragraph" l10n="U" oldref="260"> 499 <item type="input">=ROMAN(999;4)</item> returns IM</paragraph> 500 </section> 501 <section id="search"> 502<bookmark xml-lang="en-US" branch="index" id="bm_id3151005"><bookmark_value>SEARCH function</bookmark_value> 503</bookmark> 504<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUCHEN" id="bm_id3149484" localize="false"/> 505<paragraph xml-lang="en-US" id="hd_id3151005" role="heading" level="2" l10n="U" 506 oldref="122">SEARCH</paragraph> 507 <paragraph xml-lang="en-US" id="par_id3148692" role="paragraph" l10n="U" oldref="123"><ahelp hid="HID_FUNC_SUCHEN">Returns the position of a text segment within a character string.</ahelp> You can set the start of the search as an option. The search text can be a number or any sequence of characters. The search is not case-sensitive.</paragraph> 508 <embed href="text/shared/00/00000001.xhp#regulaer"/> 509 <paragraph xml-lang="en-US" id="hd_id3152964" role="heading" level="3" l10n="U" 510 oldref="124">Syntax</paragraph> 511 <paragraph xml-lang="en-US" id="par_id3154671" role="code" l10n="U" oldref="125">SEARCH("FindText"; "Text"; Position)</paragraph> 512 <paragraph xml-lang="en-US" id="par_id3146080" role="paragraph" l10n="U" oldref="126"> 513 <emph>FindText</emph> is the text to be searched for.</paragraph> 514 <paragraph xml-lang="en-US" id="par_id3154111" role="paragraph" l10n="U" oldref="127"> 515 <emph>Text</emph> is the text where the search will take place.</paragraph> 516 <paragraph xml-lang="en-US" id="par_id3149559" role="paragraph" l10n="U" oldref="128"> 517 <emph>Position</emph> (optional) is the position in the text where the search is to start.</paragraph> 518 <paragraph xml-lang="en-US" id="hd_id3147322" role="heading" level="3" l10n="U" 519 oldref="129">Example</paragraph> 520 <paragraph xml-lang="en-US" id="par_id3154564" role="paragraph" l10n="U" oldref="130"> 521 <item type="input">=SEARCH(54;998877665544)</item> returns 10.</paragraph> 522 </section> 523 <section id="substitute"> 524<bookmark xml-lang="en-US" branch="index" id="bm_id3154830"><bookmark_value>SUBSTITUTE function</bookmark_value> 525</bookmark> 526<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WECHSELN" id="bm_id3147090" localize="false"/> 527<paragraph xml-lang="en-US" id="hd_id3154830" role="heading" level="2" l10n="U" 528 oldref="174">SUBSTITUTE</paragraph> 529 <paragraph xml-lang="en-US" id="par_id3153698" role="paragraph" l10n="U" oldref="175"><ahelp hid="HID_FUNC_WECHSELN">Substitutes new text for old text in a string.</ahelp></paragraph> 530 <paragraph xml-lang="en-US" id="hd_id3150994" role="heading" level="3" l10n="U" 531 oldref="176">Syntax</paragraph> 532 <paragraph xml-lang="en-US" id="par_id3147582" role="code" l10n="U" oldref="177">SUBSTITUTE("Text"; "SearchText"; "NewText"; Occurrence)</paragraph> 533 <paragraph xml-lang="en-US" id="par_id3153675" role="paragraph" l10n="U" oldref="178"> 534 <emph>Text</emph> is the text in which text segments are to be exchanged.</paragraph> 535 <paragraph xml-lang="en-US" id="par_id3156155" role="paragraph" l10n="U" oldref="179"> 536 <emph>SearchText </emph>is the text segment that is to be replaced (a number of times).</paragraph> 537 <paragraph xml-lang="en-US" id="par_id3145779" role="paragraph" l10n="U" oldref="180"> 538 <emph>NewText</emph> is the text that is to replace the text segment.</paragraph> 539 <paragraph xml-lang="en-US" id="par_id3150348" role="paragraph" l10n="CHG" oldref="181"> 540 <emph>Occurrence</emph> (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout.</paragraph> 541 <paragraph xml-lang="en-US" id="hd_id3150946" role="heading" level="3" l10n="U" 542 oldref="182">Example</paragraph> 543 <paragraph xml-lang="en-US" id="par_id3150412" role="paragraph" l10n="U" oldref="183"> 544 <item type="input">=SUBSTITUTE("123123123";"3";"abc")</item> returns 12abc12abc12abc.</paragraph> 545 <paragraph xml-lang="en-US" id="par_id3154915" role="paragraph" l10n="U" oldref="238"> 546 <item type="input">=SUBSTITUTE("123123123";"3";"abc";2)</item> returns 12312abc123.</paragraph> 547 </section> 548 <section id="t"> 549<bookmark xml-lang="en-US" branch="index" id="bm_id3148977"><bookmark_value>T function</bookmark_value> 550</bookmark> 551<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_T" id="bm_id3156051" localize="false"/> 552<paragraph xml-lang="en-US" id="hd_id3148977" role="heading" level="2" l10n="U" 553 oldref="140">T</paragraph> 554 <paragraph xml-lang="en-US" id="par_id3154359" role="paragraph" l10n="CHG" oldref="141"><ahelp hid="HID_FUNC_T">This function returns the target text, or a blank text string if the target is not text.</ahelp></paragraph> 555 <paragraph xml-lang="en-US" id="hd_id3155858" role="heading" level="3" l10n="U" 556 oldref="142">Syntax</paragraph> 557 <paragraph xml-lang="en-US" id="par_id3155871" role="code" l10n="U" oldref="143">T(Value)</paragraph> 558 <paragraph xml-lang="en-US" id="par_id3154726" role="paragraph" l10n="CHG" oldref="144">If <emph>Value</emph> is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string.</paragraph> 559 <paragraph xml-lang="en-US" id="hd_id3155544" role="heading" level="3" l10n="U" 560 oldref="145">Example</paragraph> 561 <paragraph xml-lang="en-US" id="par_id3151062" role="paragraph" l10n="CHG" oldref="146"> 562 <item type="input">=T(12345)</item> returns an empty string. </paragraph> 563 <paragraph xml-lang="en-US" id="par_id4650105" role="paragraph" l10n="NEW"> 564 <item type="input">=T("12345")</item> returns the string 12345.</paragraph> 565 </section> 566 <section id="text"> 567<bookmark xml-lang="en-US" branch="index" id="bm_id3147132"><bookmark_value>TEXT function</bookmark_value> 568</bookmark> 569<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEXT" id="bm_id3156426" localize="false"/> 570<paragraph xml-lang="en-US" id="hd_id3147132" role="heading" level="2" l10n="U" 571 oldref="158">TEXT</paragraph> 572 <paragraph xml-lang="en-US" id="par_id3147213" role="paragraph" l10n="U" oldref="159"><ahelp hid="HID_FUNC_TEXT">Converts a number into text according to a given format.</ahelp></paragraph> 573 <paragraph xml-lang="en-US" id="hd_id3153129" role="heading" level="3" l10n="U" 574 oldref="160">Syntax</paragraph> 575 <paragraph xml-lang="en-US" id="par_id3147377" role="code" l10n="U" oldref="161">TEXT(Number; Format)</paragraph> 576 <paragraph xml-lang="en-US" id="par_id3147389" role="paragraph" l10n="U" oldref="162"> 577 <emph>Number</emph> is the numerical value to be converted.</paragraph> 578 <paragraph xml-lang="en-US" id="par_id3156167" role="paragraph" l10n="U" oldref="163"> 579 <emph>Format</emph> is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format.</paragraph> 580 <paragraph xml-lang="en-US" id="hd_id1243629" role="heading" level="3" l10n="NEW">Example</paragraph> 581 <paragraph xml-lang="en-US" id="par_id9044770" role="paragraph" l10n="NEW"> 582 <item type="input">=TEXT(12.34567;"###.##")</item> returns the text 12.35</paragraph> 583 <paragraph xml-lang="en-US" id="par_id3674123" role="paragraph" l10n="NEW"> 584 <item type="input">=TEXT(12.34567;"000.00")</item> returns the text 012.35</paragraph> 585 </section> 586 <section id="trim"> 587<bookmark xml-lang="en-US" branch="index" id="bm_id3151039"><bookmark_value>TRIM function</bookmark_value> 588</bookmark> 589<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GLAETTEN" id="bm_id3150584" localize="false"/> 590<paragraph xml-lang="en-US" id="hd_id3151039" role="heading" level="2" l10n="U" 591 oldref="54">TRIM</paragraph> 592 <paragraph xml-lang="en-US" id="par_id3157888" role="paragraph" l10n="CHG" oldref="55"><ahelp hid="HID_FUNC_GLAETTEN">Removes spaces from a string, leaving only a single space character between words.</ahelp></paragraph> 593 <paragraph xml-lang="en-US" id="hd_id3152913" role="heading" level="3" l10n="U" 594 oldref="56">Syntax</paragraph> 595 <paragraph xml-lang="en-US" id="par_id3151349" role="code" l10n="U" oldref="57">TRIM("Text")</paragraph> 596 <paragraph xml-lang="en-US" id="par_id3151362" role="paragraph" l10n="CHG" oldref="58"> 597 <emph>Text</emph> refers to text in which spaces are removed.</paragraph> 598 <paragraph xml-lang="en-US" id="hd_id3146838" role="heading" level="3" l10n="U" 599 oldref="59">Example</paragraph> 600 <paragraph xml-lang="en-US" id="par_id3156074" role="paragraph" l10n="U" oldref="60"> 601 <item type="input">=TRIM("hello")</item> returns hello.</paragraph> 602 </section> 603 <section id="unichar"> 604<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICHAR" id="bm_id0907200904004674" localize="false"/> 605<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904030935"><bookmark_value>UNICHAR function</bookmark_value> 606</bookmark> 607<paragraph xml-lang="en-US" id="hd_id0907200904022525" role="heading" level="2" l10n="NEW">UNICHAR</paragraph> 608 <paragraph xml-lang="en-US" id="par_id0907200904022538" role="paragraph" l10n="NEW"><ahelp hid=".">Converts a code number into a Unicode character or letter.</ahelp></paragraph> 609 <paragraph xml-lang="en-US" id="hd_id0907200904123753" role="heading" level="3" l10n="NEW">Syntax</paragraph> 610 <paragraph xml-lang="en-US" id="par_id0907200904123753" role="paragraph" l10n="NEW">UNICHAR(number)</paragraph> 611 <paragraph xml-lang="en-US" id="hd_id0907200904123720" role="heading" level="3" l10n="NEW">Example</paragraph> 612 <paragraph xml-lang="en-US" id="par_id090720090412378" role="paragraph" l10n="NEW">=UNICHAR(169) returns the Copyright character <emph>©</emph>.</paragraph> 613 </section> 614 <section id="unicode"> 615<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICODE" id="bm_id0907200904011330" localize="false"/> 616<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904033543"><bookmark_value>UNICODE function</bookmark_value> 617</bookmark> 618<paragraph xml-lang="en-US" id="hd_id0907200904022588" role="heading" level="2" l10n="NEW">UNICODE</paragraph> 619 <paragraph xml-lang="en-US" id="par_id0907200904022594" role="paragraph" l10n="NEW"><ahelp hid=".">Returns the numeric code for the first Unicode character in a text string.</ahelp></paragraph> 620 <paragraph xml-lang="en-US" id="hd_id0907200904123874" role="heading" level="3" l10n="NEW">Syntax</paragraph> 621 <paragraph xml-lang="en-US" id="par_id0907200904123846" role="paragraph" l10n="NEW">UNICODE("Text")</paragraph> 622 <paragraph xml-lang="en-US" id="hd_id0907200904123899" role="heading" level="3" l10n="NEW">Example</paragraph> 623 <paragraph xml-lang="en-US" id="par_id0907200904123919" role="paragraph" l10n="NEW">=UNICODE("©") returns the Unicode number 169 for the Copyright character.</paragraph> 624 </section> 625 <section id="upper"> 626<bookmark xml-lang="en-US" branch="index" id="bm_id3145178"><bookmark_value>UPPER function</bookmark_value> 627</bookmark> 628<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS" id="bm_id3145189" localize="false"/> 629<paragraph xml-lang="en-US" id="hd_id3145178" role="heading" level="2" l10n="U" 630 oldref="62">UPPER</paragraph> 631 <paragraph xml-lang="en-US" id="par_id3162905" role="paragraph" l10n="U" oldref="63"><ahelp hid="HID_FUNC_GROSS">Converts the string specified in the <emph>text</emph> field to uppercase.</ahelp></paragraph> 632 <paragraph xml-lang="en-US" id="hd_id3148526" role="heading" level="3" l10n="U" 633 oldref="64">Syntax</paragraph> 634 <paragraph xml-lang="en-US" id="par_id3148539" role="code" l10n="U" oldref="65">UPPER("Text")</paragraph> 635 <paragraph xml-lang="en-US" id="par_id3148496" role="paragraph" l10n="U" oldref="66"> 636 <emph>Text</emph> refers to the lower case letters you want to convert to upper case.</paragraph> 637 <paragraph xml-lang="en-US" id="hd_id3148516" role="heading" level="3" l10n="U" 638 oldref="67">Example</paragraph> 639 <paragraph xml-lang="en-US" id="par_id3146757" role="paragraph" l10n="U" oldref="68"> 640 <item type="input">=UPPER("Good Morning")</item> returns GOOD MORNING.</paragraph> 641 </section> 642 <section id="value"> 643<bookmark xml-lang="en-US" branch="index" id="bm_id3150802"><bookmark_value>VALUE function</bookmark_value> 644</bookmark> 645<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WERT" id="bm_id3150814" localize="false"/> 646<paragraph xml-lang="en-US" id="hd_id3150802" role="heading" level="2" l10n="U" 647 oldref="185">VALUE</paragraph> 648 <paragraph xml-lang="en-US" id="par_id3152551" role="paragraph" l10n="U" oldref="186"><ahelp hid="HID_FUNC_WERT">Converts a text string into a number.</ahelp></paragraph> 649 <paragraph xml-lang="en-US" id="hd_id3152568" role="heading" level="3" l10n="U" 650 oldref="187">Syntax</paragraph> 651 <paragraph xml-lang="en-US" id="par_id3153638" role="code" l10n="U" oldref="188">VALUE("Text")</paragraph> 652 <paragraph xml-lang="en-US" id="par_id3153651" role="paragraph" l10n="U" oldref="189"> 653 <emph>Text</emph> is the text to be converted to a number.</paragraph> 654 <paragraph xml-lang="en-US" id="hd_id3144719" role="heading" level="3" l10n="U" 655 oldref="190">Example</paragraph> 656 <paragraph xml-lang="en-US" id="par_id3144733" role="paragraph" l10n="U" oldref="191"> 657 <item type="input">=VALUE("4321")</item> returns 4321.</paragraph> 658 </section> 659</sort> 660<section id="relatedtopics"> 661 <embed href="text/scalc/01/04060100.xhp#drking"/> 662 </section> 663 </body> 664</helpdocument>