source/text/sbasic/shared/03120102.xhp


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

<?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>
        <paragraph id="hd_id3149205" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03120102.xhp" name="Chr Function">Chr Function</link></paragraph>
        <paragraph id="par_id3153311" role="paragraph" xml-lang="en-US">Returns the character that corresponds to the specified character code.</paragraph>
    </section>

    <embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>

    <paragraph id="par_id3150669" role="code" xml-lang="en-US">Chr(Expression As Integer)</paragraph>

    <embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
    <paragraph id="par_id3153824" role="paragraph" 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>Expression:</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(&amp;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>), <emph>Expression</emph> 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"/>
    <paragraph role="paragraph" id="par_id111552916434071"><embedvar href="text/sbasic/shared/00000003.xhp#err6"/>, when VBA compatibility mode is enabled and expression is greater than 255.</paragraph>

    <embed href="text/sbasic/shared/00000003.xhp#functexample"/>
    <bascode>
        <paragraph id="par_idm1341138080" role="bascode" localize="false" xml-lang="en-US">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 id="par_idm1341131568" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
    </bascode>

    <section id="relatedtopics">
        <paragraph id="par_idN10668" role="paragraph" xml-lang="en-US"><link href="text/sbasic/shared/03120101.xhp">ASC</link></paragraph>
    </section>
</body>

</helpdocument>