73 lines
4.3 KiB
XML
73 lines
4.3 KiB
XML
<?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">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"><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>
|
||
</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>
|