Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

endsWith

Determine if string ends with pattern

Syntax

TF = endsWith(str,pattern)
TF = endsWith(str,pattern,'IgnoreCase',true)

Description

example

TF = endsWith(str,pattern) returns 1 (true) if str ends with the specified pattern, and returns 0 (false) otherwise.

If pattern is an array containing multiple patterns, then endsWith returns 1 if it finds that str ends with any element of pattern.

example

TF = endsWith(str,pattern,'IgnoreCase',true) ignores case when determining if str ends with pattern.

Examples

collapse all

Create a string array that contains file names. Determine which file names end with the .gz extension.

Starting in R2017a, you can create strings using double quotes instead of the string function.

str = ["abstract.docx","data.tar.gz","mycode.m"; ...
       "data-analysis.ppt","results.ptx","temp-archive.gz"]
str = 2x3 string array
    "abstract.docx"        "data.tar.gz"    "mycode.m"       
    "data-analysis.ppt"    "results.ptx"    "temp-archive.gz"

Return a logical array where the position of each element equal to 1 corresponds to the position of a string in str that ends with .gz.

pattern = ".gz";
TF = endsWith(str,pattern)
TF = 2x3 logical array
   0   1   0
   0   0   1

Display the file names that end with .gz. Index back into str using TF.

str(TF)
ans = 2x1 string array
    "data.tar.gz"
    "temp-archive.gz"

Create a string array that contains file names. Determine which file names end with the .docx, .xlsx, or .gz extensions.

Starting in R2017a, you can create strings using double quotes instead of the string function.

str = ["data.tar.gz","mycode.m","outputs.xlsx","results.pptx"]
str = 1x4 string array
    "data.tar.gz"    "mycode.m"    "outputs.xlsx"    "results.pptx"

pattern = [".docx",".xlsx",".gz"];
TF = endsWith(str,pattern)
TF = 1x4 logical array
   1   0   1   0

Display the file names that end with .docx, .xlsx, or .gz. Index back into str using TF.

str(TF)
ans = 1x2 string array
    "data.tar.gz"    "outputs.xlsx"

Create a string array that contains file names. Determine which file names end with the .gz extension, ignoring case.

Starting in R2017a, you can create strings using double quotes instead of the string function.

str = ["DATA.TAR.GZ","mycode.m","SUMMARY.PPT","tmp.gz"]
str = 1x4 string array
    "DATA.TAR.GZ"    "mycode.m"    "SUMMARY.PPT"    "tmp.gz"

pattern = ".gz";
TF = endsWith(str,pattern,'IgnoreCase',true)
TF = 1x4 logical array
   1   0   0   1

Display the file names that end with .gz. Index back into str using TF.

str(TF)
ans = 1x2 string array
    "DATA.TAR.GZ"    "tmp.gz"

Create a character vector that contains the name of a file. Determine whether the name ends with specified extensions.

chr = 'MyLatestPaper.docx'
chr = 
'MyLatestPaper.docx'
TF = endsWith(chr,'docx')
TF = logical
   1

TF = endsWith(chr,'gz')
TF = logical
   0

Input Arguments

collapse all

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

Data Types: string | char | cell

Search pattern, specified as a string array, a character vector, or a cell array of character vectors.

Data Types: string | char | cell

Extended Capabilities

Introduced in R2016b

Was this topic helpful?