Click or drag to resize

Oem2AnsiA Function (String)

X#
Convert a string of OEM characters to ANSI characters, changing the contents of the argument as well as the return value.

Namespace:  XSharp.Core
Assembly:  XSharp.Core (in XSharp.Core.dll) Version: 2.21
Syntax
Copy
 FUNCTION Oem2AnsiA(
	cOemString REF STRING
) AS STRING
Request Example View Source

Parameters

cOemString
Type: String
A source string of OEM characters.

Return Value

Type: String
A converted string of ANSI characters.
Remarks
Oem2AnsiA() is the same as Oem2Ansi(), except that Oem2AnsiA() also replaces the contents of the original string with OEM characters.
Remarks
Caution note Caution
The Ansi2Oem() and Oem2Ansi() family of functions are compatibility functions. Do not use them unless you really have to. X# is a Unicode language and conversions from Unicode - Ansi - Oem - Unicode will take place if you use these functions.
You should also realize that Ansi2Oem(Oem2Ansi(cSource)) will not always return cSource. Some characters may not be available in the OEM codepage and could be translated to other characters. For example: Windows codepage 1252 has Capital E Umlaut (Ë) on position 203. When translated to OEM codepage 437 this will become capital E without umlaut (69). Converting back to Ansi this will remain a E without umlaut.
Examples
This example uses Oem2AnsiA() to change the contents of a variable by translating each character from OEM to ANSI:
X#
Copy
1LOCAL cString AS STRING
2cString := "ßá"
3Oem2AnsiA(cString)
See Also