diff options
Diffstat (limited to 'helpcontent2/source/text/sbasic/shared/03120102.xhp')
| -rw-r--r-- | helpcontent2/source/text/sbasic/shared/03120102.xhp | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/helpcontent2/source/text/sbasic/shared/03120102.xhp b/helpcontent2/source/text/sbasic/shared/03120102.xhp new file mode 100644 index 000000000..e0329d570 --- /dev/null +++ b/helpcontent2/source/text/sbasic/shared/03120102.xhp @@ -0,0 +1,74 @@ +<?xml version="1.0" encoding="UTF-8"?> +<helpdocument version="1.0"> +<!-- +* This file is part of the LibreOffice project. +* +* This Source Code Form is subject to the terms of the Mozilla Public +* License, v. 2.0. If a copy of the MPL was not distributed with this +* file, You can obtain one at http://mozilla.org/MPL/2.0/. +* +* This file incorporates work covered by the following license notice: +* +* Licensed to the Apache Software Foundation (ASF) under one or more +* contributor license agreements. See the NOTICE file distributed +* with this work for additional information regarding copyright +* ownership. The ASF licenses this file to you under the Apache +* License, Version 2.0 (the "License"); you may not use this file +* except in compliance with the License. You may obtain a copy of +* the License at http://www.apache.org/licenses/LICENSE-2.0 . +--> + +<meta> + <topic id="textsbasicshared03120102xml" indexer="include" status="PUBLISH"> + <title id="tit" xml-lang="en-US">Chr Function</title> + <filename>/text/sbasic/shared/03120102.xhp</filename> + </topic> +</meta> + +<body> + <section id="chr"> + <bookmark xml-lang="en-US" branch="index" id="bm_id3149205"> + <bookmark_value>Chr function</bookmark_value> + </bookmark> + <h1 id="hd_id3149205"><variable id="Chr_h1"><link href="text/sbasic/shared/03120102.xhp" name="Chr Function">Chr Function</link></variable></h1> + <paragraph id="par_id3153311" role="paragraph">Returns the character that corresponds to the specified character code.</paragraph> + </section> + + <embed href="text/sbasic/shared/00000003.xhp#functsyntax"/> + <bascode> + <paragraph role="bascode" id="bas_id91642668171601">Chr[$](charcode As Integer) As String</paragraph> + </bascode> + + <embed href="text/sbasic/shared/00000003.xhp#functvalue"/> + <paragraph id="par_id3153824" role="paragraph" localize="false" xml-lang="en-US">String</paragraph> + + <embed href="text/sbasic/shared/00000003.xhp#functparameters"/> + <paragraph id="par_id3149295" role="paragraph" xml-lang="en-US"><emph>charcode</emph>: a numeric expression that represents a valid 8-bit ASCII value (0-255) or a 16-bit Unicode value. (To support expressions with a nominally negative argument like <emph>Chr(&H8000)</emph> in a backwards-compatible way, values in the range −32768 to −1 are internally mapped to the range 32768 to 65535.)</paragraph> + + <warning id="par_id991552913928635">When VBA compatibility mode is enabled (<link href="text/sbasic/shared/03103350.xhp" name="vbasupport"><literal>Option VBASupport 1</literal></link>), <literal>charcode</literal> is a numeric expression that represents a valid 8-bit ASCII value (0-255) only.</warning> + + <paragraph id="par_id3159414" role="paragraph" xml-lang="en-US">Use the <emph>Chr$</emph> function to send special control sequences to a printer or to another output source. You can also use it to insert quotation marks in a string expression.</paragraph> + <embed href="text/sbasic/shared/00000003.xhp#errorcode"/> + <embed href="text/sbasic/shared/00000003.xhp#err5"/> + <embed href="text/sbasic/shared/00000003.xhp#err6"/> + <note id="par_id81634652871848">An overflow error will occur when VBA compatibility mode is enabled and the expression value is greater than 255.</note> + + <embed href="text/sbasic/shared/00000003.xhp#functexample"/> + <bascode> + <paragraph id="par_idm1341138080" role="bascode" localize="false">Sub ExampleChr</paragraph> + <paragraph id="par_id3154909" role="bascode" xml-lang="en-US"> ' This example inserts quotation marks (ASCII value 34) in a string.</paragraph> + <paragraph id="par_id3151380" role="bascode" xml-lang="en-US"> MsgBox "A " + Chr$(34) + "short" + Chr(34) + " trip."</paragraph> + <paragraph id="par_id3145174" role="bascode" xml-lang="en-US"> ' The printout appears in the dialog as: A "short" trip.</paragraph> + <paragraph role="bascode" id="bas_id481642668824226" xml-lang="en-US"> MsgBox Chr(charcode := 64) ' "@" sign</paragraph> + <paragraph id="par_idm1341131568" role="bascode" localize="false">End Sub</paragraph> + <paragraph role="bascode" id="bas_id661642668825250"></paragraph> + </bascode> + + <section id="relatedtopics"> + <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/> + <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/> + <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/> + </section> +</body> + +</helpdocument> |