Help Center
/
Help Center›FreeBASIC

UCasefunction

Returns an upper case copy of a string

String Functionsfunctiondocumented

Syntax

Declare Function UCase ( ByRef str As Const String, ByVal mode As Long = 0 ) As String
Declare Function UCase ( ByRef str As Const WString, ByVal mode As Long = 0 ) As WString

Parameters

NameDescription
strString to convert to uppercase.
modeThe conversion mode: 0 = current locale, 1 = ASCII only

Return value


Uppercase copy of str.

Description


Returns a copy of str with all of the letters converted to upper case.

If str is empty, the null string ("") is returned.

Remarks

Usage


result = UCase[$]( str [ , mode ] )

Platform Differences


  • The wide-character string version of UCase is not supported for DOS target.

Dialect Differences


  • The string type suffix "$" is required in the -lang qb dialect.
  • The string type suffix "$" is optional in the -lang fblite dialect.
  • The string type suffix "$" is ignored in the -lang fb dialect, warn only with the -w suffix compile option (or -w pedantic compile option).

Differences from QB


  • QB does not support Unicode.

See also


Example


Print UCase("AbCdEfG")

will produce the output:

ABCDEFG

Reference

  • Documented in KeyPgUcase.html