lower

Convert strings to lowercase

Syntax

newStr = lower(str)

Description

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

Examples

Convert Character Vector to Lowercase

lower('Hello, World.')

ans = 
'hello, world.'

Convert String Array to Lowercase

You can create string arrays using double quotes.

Convert a string array to contain lowercase characters.

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

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

newStr = lower(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 lower function supports only the character sets:

• PC: Windows^® Latin-1

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

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

Extended Capabilities

Tall Arrays

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

The lower 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