endsWith — Test whether text inputs end with patterns in MATLAB and RunMat.
endsWith(str, pattern) returns one logical result for each element of str. When pattern has multiple elements, each element is an alternative and a subject matches if any pattern is a suffix.
Syntax
tf = endsWith(str, pat)
tf = endsWith(str, pat, ignoreCase)
tf = endsWith(str, pat, "IgnoreCase", value)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
str | Any | Yes | — | Text input (string/char/cell/string array). |
pat | Any | Yes | — | Pattern text (string/char/cell/string array). |
ignoreCase | Any | Yes | false | Logical flag controlling case-sensitive matching. |
name | StringScalar | Yes | "IgnoreCase" | Option name (`"IgnoreCase"`). |
value | Any | Yes | — | Option value for `"IgnoreCase"`. |
Returns
| Name | Type | Description |
|---|---|---|
tf | LogicalArray | Logical result indicating whether each text element ends with the pattern. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:endsWith:InvalidInput | Text or pattern input is not a supported text container. | endsWith: text and pattern inputs must be text values |
RunMat:endsWith:InvalidOption | IgnoreCase option arguments are invalid or malformed. | endsWith: invalid option arguments |
RunMat:endsWith:InternalError | Internal logical result assembly failed. | endsWith: internal error |
How endsWith works
- Accepts text inputs as string scalars/arrays, character vectors/arrays, or cell arrays of character vectors.
- Accepts patterns in the same formats. Multiple patterns form an alternatives set rather than an element-wise array paired with
str. - Missing string scalars (
<missing>) never match any pattern. - Empty patterns (
""or'') always match non-missing text elements. - Patterns that are
<missing>never match and therefore returnfalse. - Character arrays treat each row as an independent element; zero-row character arrays yield empty outputs.
- MATLAB-compatible mode accepts the documented
'IgnoreCase', logicalname-value form. RunMat mode additionally supports a positional flag and numeric or textual predicate values behind explicit extension gates. - Returns a logical scalar for a scalar subject and otherwise returns a logical array with the shape of
str.
Does RunMat run endsWith on the GPU?
endsWith performs host-side suffix comparison. It has no numeric GPU data path or fusion hook; only a compatibility-gated resident scalar control can cross the provider boundary.
GPU memory and residency
endsWith executes on host text. Numeric resident subject or pattern values reject before provider access. A resident scalar IgnoreCase control is available only in RunMat mode and is gathered after its extension gate succeeds.
Examples
Check if a filename ends with an extension
tf = endsWith("report.pdf", ".pdf")Expected output:
tf = logical
1Perform a case-insensitive suffix test
tf = endsWith("RunMat", "MAT", 'IgnoreCase', true)Expected output:
tf = logical
1Apply a scalar suffix to every element of a string array
labels = ["alpha" "beta" "gamma"];
tf = endsWith(labels, "ma")Expected output:
tf = 1×3 logical array
0 0 1Test every subject against a set of suffixes
names = ["hydrogen"; "helium"; "lithium"];
suffixes = ["gen"; "ium"];
tf = endsWith(names, suffixes)Expected output:
tf = 3×1 logical array
1
1
1Test suffixes for a cell array of character vectors
C = {'Mercury', 'Venus', 'Mars'};
tf = endsWith(C, 's')Expected output:
tf = 1×3 logical array
0 1 1Provide multiple suffixes
tf = endsWith("saturn", ["n" "x" "r"])Expected output:
tf = logical
1Handle empty patterns and missing values
texts = ["", "<missing>"];
tf = endsWith(texts, "")Expected output:
tf = 1×2 logical array
1 0Using endsWith with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how endsWith changes the result.
Run a small endsWith example, explain the result, then change one input and compare the output.
FAQ
What types can I pass to endsWith?⌄
Use string arrays, character vectors, or cell arrays of character vectors for both arguments. Every pattern is tested as an alternative against each subject element.
How do I ignore letter case?⌄
MATLAB-compatible mode uses 'IgnoreCase', true or false. RunMat mode additionally accepts textual values such as 'on' and a positional flag behind explicit extension gates. The option name is case-insensitive.
What happens with empty patterns?⌄
Empty patterns ("" or '') always match non-missing text elements. When the text element is missing (<missing>), the result is false.
Can I provide multiple suffixes at once?⌄
Yes. Provide pattern as a string array, character vector, cell array of character vectors, or supported pattern object. A subject returns true when any supplied pattern is a suffix.
How are missing strings treated?⌄
Missing string scalars (displayed as <missing>) never match any pattern and produce false in the result. Use ismissing if you need to handle missing values separately.
Does endsWith run on the GPU?⌄
No. Text values are host-resident. Numeric resident subject and pattern values reject before provider access. RunMat mode can gather an explicitly compatibility-gated resident IgnoreCase control.
Does endsWith preserve the input shape?⌄
Yes. The output has the shape of str; pattern-array shape does not change it. A scalar subject produces a logical scalar.
Related Strings functions
Search
contains · matches · startsWith · strfind
Text Analytics
addDependencyDetails · addEntityDetails · addLemmaDetails · addPartOfSpeechDetails · addSentenceDetails · addTypeDetails · bagOfNgrams · bagOfWords · cosineSimilarity · doc2sequence · encode · extractFileText · extractHTMLText · fastTextWordEmbedding · findElement · getAttribute · htmlTree · ind2word · isVocabularyWord · normalizeWords · readWordEmbedding · removeLongWords · removeShortWords · removeStopWords · removeWords · stopWords · tokenDetails · tokenizedDocument · trainWordEmbedding · vaderSentimentScores · vec2word · word2ind · word2vec · wordEncoding · writeWordEmbedding
Transform
append · deblank · erase · eraseBetween · erasePunctuation · eraseURLs · extractAfter · extractBefore · extractBetween · insertAfter · insertBefore · join · lower · pad · replace · replaceBetween · reverse · split · splitlines · strcat · strip · strjoin · strjust · strrep · strsplit · strtrim · upper
Core
blanks · char · compose · convertCharsToStrings · convertContainedStringsToChars · convertStringsToChars · genvarname · int2str · isletter · isspace · isStringScalar · isstrprop · mat2str · native2unicode · newline · num2str · sprintf · sscanf · str2double · str2num · strcmp · strcmpi · string · string.empty · strings · strlength · strncmp · strncmpi · strtok · unicode2native
Pattern
digitsPattern · lettersPattern · pattern · regexpPattern · textBoundary · wildcardPattern
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how endsWith is executed, line by line, in Rust.
- View the source for endsWith in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.