Ucase

Home › String Functions › UCase

UCase

Returns an upper-case copy of the string.

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

• str
• mode

Description

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

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

Return Value

Uppercase copy of str.

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

• LCase

Examples

Print UCase("AbCdEfG")
will produce the output:

ABCDEFG

---

Category: String Functions
Kind: function

---

Reproduced from the FreeBASIC Wiki Manual under the GNU Free Documentation License 1.3 — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. Copyright © the FreeBASIC project and wiki contributors. See License.