source/text/sbasic/shared/03120101.xhp | 25 +++++++++++++------------
source/text/sbasic/shared/03120102.xhp | 15 ++++++++-------
source/text/sbasic/shared/03120111.xhp | 18 +++++++++---------
source/text/sbasic/shared/03120112.xhp | 14 +++++++-------
4 files changed, 37 insertions(+), 35 deletions(-)
New commits:
commit eb45e7df8aeeab7791876038c16345d5321e49b1
Author: Alain Romedenne <alain.romede...@libreoffice.org>
AuthorDate: Mon Nov 8 17:13:13 2021 +0200
Commit: Olivier Hallot <olivier.hal...@libreoffice.org>
CommitDate: Tue Nov 16 14:14:59 2021 +0100
tdf#141474 Asc, AscW function signatures
Change-Id: Ia85bf08bb1e5cb0e7db5717caec01e7e50c3b106
Reviewed-on: https://gerrit.libreoffice.org/c/help/+/124853
Tested-by: Jenkins
Reviewed-by: Olivier Hallot <olivier.hal...@libreoffice.org>
diff --git a/source/text/sbasic/shared/03120101.xhp
b/source/text/sbasic/shared/03120101.xhp
index d5e7a7eaf..f2f403e08 100644
--- a/source/text/sbasic/shared/03120101.xhp
+++ b/source/text/sbasic/shared/03120101.xhp
@@ -33,36 +33,37 @@
<bookmark_value>Asc function</bookmark_value>
</bookmark>
-
-<paragraph id="hd_id3150499" role="heading" level="1" xml-lang="en-US"><link
href="text/sbasic/shared/03120101.xhp" name="Asc Function">Asc
Function</link></paragraph>
-<paragraph id="par_id3151384" role="paragraph" xml-lang="en-US">Returns the
ASCII (American Standard Code for Information Interchange) value of the first
character in a string expression.</paragraph>
+<h1 id="hd_id3150499"><variable id="Asc_h1"><link
href="text/sbasic/shared/03120101.xhp" name="Asc Function">Asc
Function</link></variable></h1>
+<paragraph id="par_id3151384" role="paragraph">Returns the ASCII (American
Standard Code for Information Interchange) value of the first character in a
string expression.</paragraph>
</section>
-<paragraph id="hd_id3155555" role="heading" level="2"
xml-lang="en-US">Syntax:</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
<bascode>
-<paragraph id="par_id3143267" role="bascode" xml-lang="en-US">Asc (Text As
String)</paragraph>
+<paragraph id="par_id3143267" role="bascode" xml-lang="en-US">Asc(string) As
Long</paragraph>
</bascode>
-<paragraph id="hd_id3147242" role="heading" level="2" xml-lang="en-US">Return
value:</paragraph>
-<paragraph id="par_id3150669" role="paragraph"
xml-lang="en-US">Integer</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
+<paragraph id="par_id3150669" role="paragraph"
xml-lang="en-US">Long</paragraph>
-<paragraph id="hd_id3148473" role="heading" level="2"
xml-lang="en-US">Parameters:</paragraph>
-<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US">
<emph>Text:</emph> Any valid string expression. Only the first character in the
string is relevant.</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
+<paragraph id="par_id3149415" role="paragraph"
xml-lang="en-US"><emph>string</emph>: Any valid string expression. Only the
first character in the string is relevant.</paragraph>
<paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Use the Asc
function to replace keys with values. If the Asc function encounters a blank
string, $[officename] Basic reports a run-time error. In addition to 7 bit
ASCII characters (Codes 0-127), the ASCII function can also detect
non-printable key codes in ASCII code. This function can also handle 16 bit
unicode characters.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
-<paragraph id="hd_id3159413" role="heading" level="2"
xml-lang="en-US">Example:</paragraph>
+<embed href="text/sbasic/shared/00000003.xhp#functexample"/>
<bascode>
<paragraph id="par_idm1341586960" role="bascode" localize="false"
xml-lang="en-US">Sub ExampleASC</paragraph>
<paragraph id="par_id3150792" role="bascode" xml-lang="en-US"> Print
ASC("A") ' returns 65</paragraph>
-<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print
ASC("Z") ' returns 90</paragraph>
+<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print
ASC(string:="Z") ' returns 90</paragraph>
<paragraph id="par_id3163800" role="bascode" xml-lang="en-US"> Print
ASC("Las Vegas") ' returns 76, since only the first character is taken into
account</paragraph>
<paragraph id="par_idm1341580480" role="bascode" localize="false"
xml-lang="en-US">End Sub</paragraph>
</bascode>
<section id="relatedtopics">
-<paragraph id="par_idN1067B" role="paragraph" xml-lang="en-US"><link
href="text/sbasic/shared/03120102.xhp">CHR</link></paragraph>
+ <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/>
+ <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
+ <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/>
</section>
</body>
diff --git a/source/text/sbasic/shared/03120102.xhp
b/source/text/sbasic/shared/03120102.xhp
index a9d73261e..5f3a8f359 100644
--- a/source/text/sbasic/shared/03120102.xhp
+++ b/source/text/sbasic/shared/03120102.xhp
@@ -30,19 +30,18 @@
<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>
+ <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"/>
-
- <paragraph id="par_id3150669" role="code" xml-lang="en-US">Chr(Expression
As Integer)</paragraph>
+ <paragraph id="par_id3150669" role="code"
xml-lang="en-US">Chr[$](expression As Integer) As String</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(&H8000)</emph> in a
backwards-compatible way, values in the range −32768 to −1 are internally
mapped to the range 32768 to 65535.)</paragraph>
+ <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(&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>
@@ -56,13 +55,15 @@
<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_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>
+ <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>
diff --git a/source/text/sbasic/shared/03120111.xhp
b/source/text/sbasic/shared/03120111.xhp
index 4ee05ef53..96d211f72 100644
--- a/source/text/sbasic/shared/03120111.xhp
+++ b/source/text/sbasic/shared/03120111.xhp
@@ -34,18 +34,18 @@
</bookmark>
-<paragraph id="hd_id3150499" role="heading" level="1" xml-lang="en-US"><link
href="text/sbasic/shared/03120111.xhp" name="AscW Function [VBA]">AscW Function
[VBA]</link></paragraph>
-<paragraph id="par_id3151384" role="paragraph" xml-lang="en-US">Returns the
Unicode value of the first character in a string expression.</paragraph>
+<h1 id="hd_id3150499"><variable id="AscW_h1"><link
href="text/sbasic/shared/03120111.xhp" name="AscW Function [VBA]">AscW Function
[VBA]</link></variable></h1>
+<paragraph id="par_id3151384" role="paragraph">Returns the Unicode value of
the first character in a string expression.</paragraph>
</section>
<embed href="text/sbasic/shared/00000003.xhp#vbasupport"/>
<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
<bascode>
-<paragraph id="par_id3143267" role="bascode" localize="false"
xml-lang="en-US">AscW (Text As String)</paragraph>
+<paragraph id="par_id3143267" role="bascode" localize="false"
xml-lang="en-US">AscW (string) As Long</paragraph>
</bascode>
<embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
-<paragraph id="par_id3150669" role="paragraph"
xml-lang="en-US">Integer</paragraph>
+<paragraph id="par_id3150669" role="paragraph"
xml-lang="en-US">Long</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#functparameters"/>
-<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US">
<emph>Text:</emph> Any valid string expression. Only the first character in the
string is relevant.</paragraph>
+<paragraph id="par_id3149415" role="paragraph" xml-lang="en-US">
<emph>string</emph>: Any valid string expression. Only the first character in
the string is relevant.</paragraph>
<paragraph id="par_id3145609" role="paragraph" xml-lang="en-US">Use the AscW
function to replace keys with Unicode values. If the AscW function encounters a
blank string, %PRODUCTNAME Basic reports a run-time error. Returned values are
between 0 and 65535.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
@@ -53,15 +53,15 @@
<bascode>
<paragraph id="par_idm1341586960" role="bascode" localize="false"
xml-lang="en-US">Sub ExampleAscW</paragraph>
<paragraph id="par_id3150792" role="bascode" xml-lang="en-US"> Print AscW("A")
' returns 65</paragraph>
-<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print AscW("Ω")
' returns 937</paragraph>
+<paragraph id="par_id3148797" role="bascode" xml-lang="en-US"> Print
AscW(string:="Ω") ' returns 937</paragraph>
<paragraph id="par_id3163800" role="bascode" xml-lang="en-US"> Print
AscW("Αθήνα") ' returns 913, since only the first character (Alpha) is taken
into account</paragraph>
<paragraph id="par_idm1341580480" role="bascode" localize="false"
xml-lang="en-US">End Sub</paragraph>
</bascode>
<section id="relatedtopics">
-<paragraph id="par_idN1067B" role="paragraph" xml-lang="en-US"><link
href="text/sbasic/shared/03120102.xhp">Chr</link></paragraph>
-<paragraph id="par_id051920171027053197" role="paragraph"
xml-lang="en-US"><link
href="text/sbasic/shared/03120112.xhp">ChrW</link></paragraph>
-<paragraph id="par_id051920171027051338" role="paragraph"
xml-lang="en-US"><link
href="text/sbasic/shared/03120101.xhp">Asc</link></paragraph>
+ <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/>
+ <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
+ <embed href="text/sbasic/shared/03120112.xhp#ChrW_h1"/>
</section>
</body>
diff --git a/source/text/sbasic/shared/03120112.xhp
b/source/text/sbasic/shared/03120112.xhp
index 39f9cebee..05d2b8297 100644
--- a/source/text/sbasic/shared/03120112.xhp
+++ b/source/text/sbasic/shared/03120112.xhp
@@ -34,13 +34,13 @@
</bookmark>
-<paragraph id="hd_id3149205" role="heading" level="1" xml-lang="en-US"><link
href="text/sbasic/shared/03120112.xhp" name="ChrW Function">ChrW Function
[VBA]</link></paragraph>
-<paragraph id="par_id3153311" role="paragraph" xml-lang="en-US">Returns the
Unicode character that corresponds to the specified character code.</paragraph>
+<h1 id="hd_id3149205"><variable id="ChrW_h1"><link
href="text/sbasic/shared/03120112.xhp" name="ChrW Function">ChrW Function
[VBA]</link></variable></h1>
+<paragraph id="par_id3153311" role="paragraph">Returns the Unicode character
that corresponds to the specified character code.</paragraph>
</section>
<embed href="text/sbasic/shared/00000003.xhp#vbasupport"/>
<embed href="text/sbasic/shared/00000003.xhp#functsyntax"/>
<bascode>
-<paragraph id="par_id3150669" role="bascode" xml-lang="en-US">ChrW(Expression
As Integer)</paragraph>
+<paragraph id="par_id3150669" role="bascode" xml-lang="en-US">ChrW(Expression
As Integer) As String</paragraph>
</bascode>
<embed href="text/sbasic/shared/00000003.xhp#functvalue"/>
<paragraph id="par_id3153824" role="paragraph"
xml-lang="en-US">String</paragraph>
@@ -59,10 +59,10 @@
</bascode>
<section id="relatedtopics">
-<paragraph id="par_id051920171010491586" role="paragraph"
xml-lang="en-US"><link
href="text/sbasic/shared/03120102.xhp">Chr</link></paragraph>
-<paragraph id="par_idN10668" role="paragraph" xml-lang="en-US"><link
href="text/sbasic/shared/03120101.xhp">Asc</link></paragraph>
-<paragraph id="par_id051920171009414669" role="paragraph"
xml-lang="en-US"><link
href="text/sbasic/shared/03120111.xhp">AscW</link></paragraph>
+ <embed href="text/sbasic/shared/03120101.xhp#Asc_h1"/>
+ <embed href="text/sbasic/shared/03120111.xhp#AscW_h1"/>
+ <embed href="text/sbasic/shared/03120102.xhp#Chr_h1"/>
</section>
</body>
-</helpdocument>
+</helpdocument>
\ No newline at end of file
