ToUpper

Syntax

Destination String = ToUpper (Source String)

Overview

Convert the characters from a source string to UPPER case.

Parameters

Destination String can only be a String variable, and should be large enough to hold the correct amount of characters extracted from the Source String. Source String can be a String variable, or a Quoted String of Characters . The Source String can also be a Byte, Word, Dword, Float or Array, variable, in which case the value contained within the variable is used as a pointer to the start of the Source String's address in RAM. A third possibility for Source String is a Label name, in which case a null terminated Quoted String of Characters is read from code memory.

Example 1

' Convert the characters from SourceString to UpperCase and place into
' DestString
  Device = 24HJ128GP502
                                        ' Select the device to compile for
  Declare Xtal = 16
  Dim SourceString as String * 20
                                        ' Create a String of 20 characters
  Dim DestString as String * 20
                                        ' Create another String
  SourceString = "hello world"
                                        ' Load the source string with characters
  DestString = ToUpper(SourceString) ' Convert to uppercase
  Print DestString
                      ' Display the result, which will be "HELLO WORLD"

Example 2

' Convert the chars from a Quoted Character String to UpperCase
' and place into DestString
  Device = 24HJ128GP502
                                        ' Select the device to compile for
  Declare Xtal = 16
  Dim DestString as String * 20
                                        ' Create a String of 20 characters
  DestString = ToUpper("hello world") ' Convert to uppercase
  Print DestString
                           ' Display the result, which will be "HELLO WORLD"

Example 3

' Convert to UpperCase from SourceString into DestString using a pointer to
' SourceString
  Device = 24HJ128GP502
                                     ' Select the device to compile for
  Declare Xtal = 16
  Dim SourceString as String * 20
                                     ' Create a String of 20 characters
  Dim DestString as String * 20
                                     ' Create another String
  Dim StringAddr as Word ' Create a Word variable to hold address
  SourceString = "hello world"
                                     ' Load the source string with characters
  ' Locate the start address of SourceString in RAM
  StringAddr = AddressOf(SourceString)
  DestString = ToUpper(StringAddr) ' Convert to uppercase
  Print DestString
                      ' Display the result, which will be "HELLO WORLD"

Example 4

' Convert chars from a code memory string to uppercase
' and place into DestString
  Device = 24HJ128GP502
                                   ' Select the device to compile for
  Declare Xtal = 16
  Dim DestString as String * 20 ' Create a String of 20 characters
' Create a null terminated string of characters in code memory
  Dim Source as Code = hello world", 0
  DestString = ToUpper(Source) ' Convert to uppercase
  Print DestString
                      ' Display the result, which will be "HELLO WORLD"

See also : Creating and using Strings, Creating and using code memory strings,

Len, Left$, Mid$, Right$, Str$, ToLower, AddressOf .