helpcontent2/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
69
70
71
72
73
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(&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>), <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>