Difference between revisions of "MC-Basic:ASC"

From SoftMC-Wiki
Jump to: navigation, search
m (typos fixed)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{Languages|MC-Basic:ASC}}
 
{{MC-Basic
 
{{MC-Basic
 
|SHORT FORM=
 
|SHORT FORM=
Line 4: Line 5:
  
 
|SYNTAX=
 
|SYNTAX=
?ASC(''<string>{,<Index>}'')
+
?ASC(<''string''>{,<''Index''>})
  
 
|AVAILABILITY=
 
|AVAILABILITY=
Line 10: Line 11:
  
 
|DESCRIPTION=
 
|DESCRIPTION=
ASC returns an ASCII character value from within an ASCII-8 ''string, ''and the Unicode value from within a UTF-8 ''string.''
+
ASC returns an ASCII character value from within an ASCII-8 ''string, ''and the Unicode value from within a UTF-8 ''string''.
  
''<return value>'': corresponding ASCII character code from a specified  character in an ASCII-8 ''<string>'', or to the Unicode value of a specified  symbol in a UTF-8 ''<string>.''
+
<''return value''>: corresponding ASCII character code from a specified  character in an ASCII-8 <''string''>, or to the Unicode value of a specified  symbol in a UTF-8 <''string''>.
  
 
<''string''>: string expression from which the character is to be picked. If the sting is empty, the function returns the value 0.
 
<''string''>: string expression from which the character is to be picked. If the sting is empty, the function returns the value 0.
Line 19: Line 20:
  
 
|TYPE=
 
|TYPE=
''<return value>'': Double
+
<''return value''>: Double
  
''                             <string>'': String
+
<''string''>: String
  
''                             <index>'': Long
+
<''index''>: Long
  
 
|RANGE=
 
|RANGE=
''<return value>'': 0 to 127 for an ASCII-8 <''string>''
+
<''return value''>: 0 to 127 for an ASCII-8 <''string''>, 0 to MAXLONG for a UTF-8 ''<string>''
  
0 to MAXLONG for a UTF-8 ''<string>''
+
<''string''>: String
  
''                             <string >'': String
+
<''index''>: 0 to MaxLong
 
 
''                             <index>'': 0 to MaxLong
 
  
 
|UNITS=
 
|UNITS=
Line 44: Line 43:
  
 
|LIMITATIONS=
 
|LIMITATIONS=
Read-Only
+
Read only
  
 
|EXAMPLE=
 
|EXAMPLE=
Line 66: Line 65:
  
 
|SEE ALSO=
 
|SEE ALSO=
* [[Axystems:MC-Basic:INSTR|INSTR]]
+
* [[MC-Basic:INSTR|INSTR]]
 
+
* [[MC-Basic:SPACE$|SPACE$]]
[[Category:Axystems:MC-Basic:String_Manipulation|ASC]]
+
* [[MC-Basic:STRING$|STRING$]]
 +
* [[MC-Basic:UTF$|UTF$]]
 +
* [[MC-Basic:CHR$|CHR$]]
 +
[[Category:MC-Basic:String_Manipulation|ASC]]
 
}}
 
}}

Latest revision as of 03:19, 17 April 2017

Language: English  • 中文(简体)‎

ASC returns an ASCII character value from within an ASCII-8 string, and the Unicode value from within a UTF-8 string.

<return value>: corresponding ASCII character code from a specified  character in an ASCII-8 <string>, or to the Unicode value of a specified  symbol in a UTF-8 <string>.

<string>: string expression from which the character is to be picked. If the sting is empty, the function returns the value 0.

<index>: optional real value defining the position in <string> of the ASCII-8 character or UTF-8 symbol to select. The first ASCII-8 character or UTF-8 symbol of the string is selected if the index is omitted or has a value of 0.

Syntax

?ASC(<string>{,<Index>})

Availability

All versions. Available for UTF-8 string since version 4.5.10

Type

<return value>: Double

<string>: String

<index>: Long

Range

<return value>: 0 to 127 for an ASCII-8 <string>, 0 to MAXLONG for a UTF-8 <string>

<string>: String

<index>: 0 to MaxLong

Scope

Configuration, Task or Terminal

Limitations

Read only

Examples

--> ?ASC("example",3)

9.700000000000000e+01              ‘returns the ASCII code for the letter "a"

--> ?ASC("example")

1.010000000000000e+02              ‘returns the ASCII code for the letter "e"

Common Shared UTF8Str as String of UTF8

UTF8Str = UTF$(196) + UTF$(197) + UTF$(198)

?ASC(UTF8str,2)

1.970000000000000e+02

See Also