$toUppercase — Convert to Uppercase

$toUppercase transforms all lowercase characters in a string to their uppercase equivalents. It’s commonly used for emphasis, formatting codes, or case-insensitive comparisons.

Syntax

$toUppercase[text]

Parameters

• text (string, required) — The string to convert.

Return Value

• Type: string
• Returns the input text with all letters converted to uppercase.
• Non-alphabetic characters (numbers, symbols, spaces) remain unchanged.

Evaluation Behavior

• Static text (no placeholders): Converted at compile time.
• Contains placeholders (e.g., $message, variables): Evaluated at runtime.

Usage

$toUppercase[hello]     → "HELLO"
$toUppercase[Hello]     → "HELLO"
$toUppercase[123 abc]   → "123 ABC"
$toUppercase[$message]  → user's message in uppercase

Common Patterns

Code Formatting

$toUppercase[$getUserVar[promoCode]]

Ensures promo codes are stored and compared in uppercase.

Emphasis

$sendMessage[$toUppercase[Warning: $message]]

Case-Insensitive Comparisons (Alternative)

$if[$toUppercase[$getUserVar[role]]==ADMIN]
  $sendMessage[Welcome, admin!]
$endif

Important Notes

• Locale-independent: Basic ASCII uppercasing is applied. Behavior with non-ASCII characters may vary.
• Only letters: Digits, punctuation, and whitespace pass through unchanged.
• Often paired with $toLowercase: Choose one convention and stick with it for comparisons.