Unit Unicode

Return to Unit Reference

Description

---

This unit implements the WideString and UnicodeString support for Ultibo including the WideStringManager/UnicodeStringManager interface for the RTL.

This unit provides compatible implementations of the following functions:

• CharLower
• CharPrev
• CharUpper
• FoldString
• GetStringTypeEx
• IsCharAlphaNumeric
• IsDBCSLeadByte
• LoadString
• lstrcmpi
• lstrlen
• OemToCharBuff
• wvsprintf
• OemToAnsi
• CharLowerBuff
• CharToOem
• CharUpperBuff
• FormatMessage
• GetStringTypeW
• IsCharLower
• IsTextUnicode
• lstrcat
• lstrcpy
• MultiByteToWideChar
• WideCharToMultiByte
• CompareStringW
• CharNext
• CharToOemBuff
• CompareStringA
• GetStringTypeA
• IsCharAlpha
• IsCharUpper
• LCMapString
• lstrcmp
• lstrcpyn
• OemToChar
• wsprintf
• AnsiToOem

The following function are implemented by the FileSystem unit:

• AreFileApisANSI (AreFileApisANSI is exposed in the Ultibo unit)
• SetFileApisToANSI (SetFileApisToANSI is exposed in the Ultibo unit)
• SetFileApisToOEM (SetFileApisToOEM is exposed in the Ultibo unit)

Most of the above are currently not implemented.

See also: https://msdn.microsoft.com/en-us/library/windows/desktop/dd319081%28v=vs.85%29.aspx

Constants

---

To be documented

Type definitions

---

To be documented

Public variables

---

To be documented

Function declarations

---

Initialization functions

[Expand]

procedure UnicodeInit;

Description: To be documented

Note	To be documented

Unicode functions

[Expand]

function MultiByteToWideChar(CodePage:UINT; dwFlags:DWORD; lpMultiByteStr:LPCSTR; cbMultiByte:Integer; lpWideCharStr:LPWSTR; cchWideChar:Integer):Integer;

Description: SBCS/DBCS OEM or ANSI string to Unicode string

Note	cchWideChar is the size of lpWideCharStr in WideChars (not Bytes). Currently ignores the Flags parameter. Currently only supports SBCS.

[Expand]

function WideCharToMultiByte(CodePage:UINT; dwFlags:DWORD; lpWideCharStr:LPCWSTR; cchWideChar:Integer; lpMultiByteStr:LPSTR; cbMultiByte:Integer; lpDefaultChar:LPCSTR; lpUsedDefaultChar:LPBOOL):Integer;

Description: Unicode string to SBCS/DBCS OEM or ANSI string

Note	cchWideChar is the size of lpWideCharStr in WideChars (not Bytes). Currently ignores the Flags and DefaultChar parameters. Currently only supports SBCS.

[Expand]

function CompareString(Locale:LCID; dwCmpFlags:DWORD; lpString1:LPCSTR; cchCount1:Integer; lpString2:LPCSTR; cchCount2:Integer):Integer; inline;

Description: To be documented

Note	To be documented

[Expand]

function CompareStringA(Locale:LCID; dwCmpFlags:DWORD; lpString1:LPCSTR; cchCount1:Integer; lpString2:LPCSTR; cchCount2:Integer):Integer;

Description: ANSI compare of two strings for equivalence. If both strings are equal returns CSTR_EQUAL, if string 1 is less than string 2 returns CSTR_LESS_THAN and if string 1 is greater than string 2 returns CSTR_GREATER_THAN, on error returns 0

Note	Currently the Locale value is ignored and the ANSI code page is used for comparison. Currently only supports SBCS.

[Expand]

function CompareStringALowercase(lpString:PByte):Byte; inline;

Description: To be documented

Note	To be documented

[Expand]

function CompareStringW(Locale:LCID; dwCmpFlags:DWORD; lpString1:LPCWSTR; cchCount1:Integer; lpString2:LPCWSTR; cchCount2:Integer):Integer;

Description: Unicode compare of two strings for equivalence. If both strings are equal returns CSTR_EQUAL, if string 1 is less than string 2 returns CSTR_LESS_THAN and if string 1 is greater than string 2 returns CSTR_GREATER_THAN, on error returns 0

Note	Currently the Locale value is ignored

[Expand]

function CharUpper(lpsz:LPSTR):LPSTR; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharUpperA(lpsz:LPSTR):LPSTR;

Description: Lower to Upper case conversion in ANSI code page (Char)

Note	Unlike Windows this function does not differentiate a single character by the high order word of the passed pointer. To convert a single character call CharUpperBuffA instead with the length as 1. Currently only supports SBCS.

[Expand]

function CharUpperW(lpsz:LPWSTR):LPWSTR;

Description: Lower to Upper case conversion in Unicode (WideChar)

Note	Unlike Windows this function does not differentiate a single character by the high order word of the passed pointer. To convert a single character call CharUpperBuffW instead with the length as 1.

[Expand]

function CharUpperBuff(lpsz:LPSTR; cchLength:DWORD):DWORD; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharUpperBuffA(lpsz:LPSTR; cchLength:DWORD):DWORD;

Description: Lower to Upper case conversion in ANSI code page (Char)

Note	Currently only supports SBCS

[Expand]

function CharUpperBuffW(lpsz:LPWSTR; cchLength:DWORD):DWORD;

Description: Lower to Upper case conversion in Unicode (WideChar)

Note	To be documented

[Expand]

function CharLower(lpsz:LPSTR):LPSTR; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharLowerA(lpsz:LPSTR):LPSTR;

Description: Upper to Lower case conversion in ANSI code page (Char)

Note	Unlike Windows this function does not differentiate a single character by the high order word of the passed pointer. To convert a single character call CharLowerBuffA instead with the length as 1. Currently only supports SBCS.

[Expand]

function CharLowerW(lpsz:LPWSTR):LPWSTR;

Description: Upper to Lower case conversion in Unicode (WideChar)

Note	Unlike Windows this function does not differentiate a single character by the high order word of the passed pointer. To convert a single character call CharLowerBuffW instead with the length as 1.

[Expand]

function CharLowerBuff(lpsz:LPSTR; cchLength:DWORD):DWORD; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharLowerBuffA(lpsz:LPSTR; cchLength:DWORD):DWORD;

Description: Upper to Lower case conversion in ANSI code page (Char)

Note	Currently only supports SBCS

[Expand]

function CharLowerBuffW(lpsz:LPWSTR; cchLength:DWORD):DWORD;

Description: Upper to Lower case conversion in Unicode (WideChar)

Note	To be documented

[Expand]

function AnsiToOem(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function AnsiToOemBuff(lpszSrc:LPCSTR;lpszDst:LPSTR; cchDstLength:DWORD):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function OemToAnsi(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function OemToAnsiBuff(lpszSrc:LPCSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharToOem(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharToOemA(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL;

Description: ANSI to OEM conversion (Char to Char)

Note	Currently only supports SBCS

[Expand]

function CharToOemW(lpszSrc:LPCWSTR; lpszDst:LPSTR):BOOL;

Description: Unicode to OEM conversion (WideChar to Char)

Note	Currently only supports SBCS

[Expand]

function OemToChar(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function OemToCharA(lpszSrc:LPCSTR; lpszDst:LPSTR):BOOL;

Description: OEM to ANSI conversion (Char to Char)

Note	Currently only supports SBCS

[Expand]

function OemToCharW(lpszSrc:LPCSTR; lpszDst:LPWSTR):BOOL;

Description: OEM to Unicode conversion (Char to WideChar)

Note	Currently only supports SBCS

[Expand]

function CharToOemBuff(lpszSrc:LPCSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function CharToOemBuffA(lpszSrc:LPCSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL;

Description: ANSI to OEM conversion (Char to Char)

Note	Currently only supports SBCS

[Expand]

function CharToOemBuffW(lpszSrc:LPCWSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL;

Description: Unicode to OEM conversion (WideChar to Char)

Note	Currently only supports SBCS

[Expand]

function OemToCharBuff(lpszSrc:LPCSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL; inline;

Description: To be documented

Note	To be documented

[Expand]

function OemToCharBuffA(lpszSrc:LPCSTR; lpszDst:LPSTR; cchDstLength:DWORD):BOOL;

Description: OEM to ANSI conversion (Char to Char)

Note	Currently only supports SBCS

[Expand]

function OemToCharBuffW(lpszSrc:LPCSTR; lpszDst:LPWSTR; cchDstLength:DWORD):BOOL;

Description: OEM to Unicode conversion (Char to WideChar)

Note	Currently only supports SBCS

Return to Unit Reference