Skip to main content

AnsiUpperCase

function AnsiUpperCase(S: String): String;

Example​

procedure ScriptEvent(var Value: variant);
begin
  Value := AnsiUpperCase('Velox EDI'); // 'VELOX EDI' in ordinary Latin locales
end;

Usage​

AnsiUpperCase returns a locale-aware uppercase copy after the Velox scripting ANSI value passes through Velox Unicode conversion.

Parameters and result

ItemTypeDescription
SStringANSI Velox scripting string to convert.
ResultStringUppercase ANSI copy. Empty input returns an empty string.

Additional Technical Info​

AnsiUpperCase returns an uppercased copy of a PascalScript String. Conversion follows the current Windows user locale rather than a fixed, invariant rule. The source value is not changed.

The example is fictional and source-reviewed only.

Implementation

This is modified PascalScript standard-function selector 38. The current runtime represents the public String type as AnsiString. It converts the input to Delphi's Unicode string, calls the installed System.SysUtils.AnsiUpperCase, then casts the result back to the ANSI script string.

The installed Windows terminal uses the process's current user locale. This has operational consequences:

  • language-sensitive characters can map differently under the Designer user and the Velox service account;
  • conversion back to ANSI uses the active code page and may be lossy;
  • output is environment-dependent rather than a stable invariant normalisation; and
  • behaviour can differ from UpperCase, which applies simpler casing rules.

Use it for display or human-text comparison only when the execution account's locale is part of the design. Do not use it for cryptographic material, protocol identifiers, persistent keys or machine-independent canonicalisation.

External references

Created 2026-07-15