Difference between revisions of "MAPUNICODE (function)"

From QB64 Wiki
Jump to navigation Jump to search
imported>Clippy
m
imported>SMcNeill
(style guidelines)
 
Line 1: Line 1:
 
{{DISPLAYTITLE:_MAPUNICODE (function)}}
 
{{DISPLAYTITLE:_MAPUNICODE (function)}}
The '''_MAPUNICODE''' function returns the [[Unicode]](UTF32) code point value of a mapped [[ASCII]] character code.
+
The [[_MAPUNICODE]] function returns the [[Unicode]] (UTF-32) code point value of a mapped [[ASCII]] character code.
 
 
  
  
 
{{PageSyntax}}
 
{{PageSyntax}}
:: UTFvalue& = '''_MAPUNICODE('''''Ascii_code%''''')'''
+
: {{Parameter|utfValue&}} = [[_MAPUNICODE]]({{Parameter|asciiCode%}})
  
  
* The UTF32 values have 4 byte encoding so the return variable should be [[LONG]].
+
{{PageDescription}}
* The ''Ascii_code'' can be any [[INTEGER]] value from 0 to 255.
+
* UTF-32 values have 4-byte encoding so the return variable should be [[LONG]].
 +
* The {{Parameter|asciiCode%}} can be any [[INTEGER]] value from 0 to 255.
 
* Returns can be used to verify or catalog the present Unicode mapping.
 
* Returns can be used to verify or catalog the present Unicode mapping.
* The function will return Unicode values for the control characters, CHR$(127) and extended characters '''without mapping''' them first.
+
* The function returns Unicode values for the control characters, CHR$(127) and extended characters without mapping them first.
  
  
 +
{{PageExamples}}
 
''Example:'' Store function return values in an array for ASCII codes 0 to 255 to restore them later.
 
''Example:'' Store function return values in an array for ASCII codes 0 to 255 to restore them later.
 
{{CodeStart}}
 
{{CodeStart}}
Line 29: Line 30:
  
  
''See also:''
+
{{PageSeeAlso}}
 
* [[_MAPUNICODE]] {{text|(statement)}}
 
* [[_MAPUNICODE]] {{text|(statement)}}
 
* [[Unicode]], [[Code Pages]] {{text|(by region)}}
 
* [[Unicode]], [[Code Pages]] {{text|(by region)}}

Latest revision as of 14:10, 8 September 2017

The _MAPUNICODE function returns the Unicode (UTF-32) code point value of a mapped ASCII character code.


Syntax

utfValue& = _MAPUNICODE(asciiCode%)


Description

  • UTF-32 values have 4-byte encoding so the return variable should be LONG.
  • The asciiCode% can be any INTEGER value from 0 to 255.
  • Returns can be used to verify or catalog the present Unicode mapping.
  • The function returns Unicode values for the control characters, CHR$(127) and extended characters without mapping them first.


Examples

Example: Store function return values in an array for ASCII codes 0 to 255 to restore them later.

DIM Unicode&(255) SCREEN 0 _FONT _LOADFONT("C:\Windows\Fonts\Cour.ttf", 20, "MONOSPACE") 'select monospace font FOR ascii = 0 TO 255 Unicode&(ascii) = _MAPUNICODE(ascii) 'read Unicode values PRINT Unicode&(ascii); 'display values in demo NEXT 'rest of program END


See also



Navigation:
Keyword Reference - Alphabetical
Keyword Reference - By Usage
Main Wiki Page