upper

Convert strings to uppercase

Syntax

newStr = upper(str)

Description

newStr = upper(str) converts all lowercase characters in str to the corresponding uppercase characters and leaves all other characters unchanged.

Examples

Convert Character Vector to Uppercase

upper('Hello, World.')

ans = 
'HELLO, WORLD.'

Convert String Array to Uppercase

Convert a string array to contain uppercase characters.

str = ["The SOONER,";"the BETTER."]

str = 2x1 string
    "The SOONER,"
    "the BETTER."

newStr = upper(str)

newStr = 2x1 string
    "THE SOONER,"
    "THE BETTER."

Input Arguments

str — Input array

string array | character array | cell array of character vectors

Input array, specified as a string array, character array, or cell array of character vectors.

Tips

For character arrays, the upper function supports the character sets:

• PC: Windows^® Latin-1

• Other: ISO^® Latin-1 (ISO 8859-1)

For string arrays, the upper function supports Unicode^®.

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The upper function fully supports tall arrays. For more information, see Tall Arrays.

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Input array must be a string scalar or a character array.

• Input values must be in the range 0–127.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a