endsWith — Test whether text inputs end with patterns in MATLAB and RunMat.

endsWith(str, pattern) returns logical results indicating whether each element of str ends with the corresponding pattern. Supported text types and implicit expansion behavior follow MATLAB semantics.

Syntax

tf = endsWith(str, pat)
tf = endsWith(str, pat, ignoreCase)
tf = endsWith(str, pat, "IgnoreCase", value)
tf = endsWith(str, pat, nameValuePairs...)

Inputs

Returns

Errors

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; scalar inputs expand across the other argument following MATLAB broadcast rules.
• 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 return false.
• Character arrays treat each row as an independent element; zero-row character arrays yield empty outputs.
• The optional IgnoreCase flag can be supplied either as a trailing scalar or via the 'IgnoreCase', value name-value pair. It accepts logical/numeric scalars and the strings 'on', 'off', 'true', and 'false' (default is case-sensitive).
• Returns a logical scalar when the broadcasted size is one element, otherwise returns a logical array.

Does RunMat run endsWith on the GPU?

endsWith performs host-side suffix comparison. When inputs currently live on the GPU, RunMat gathers them back to the host before evaluation so the behaviour is identical to MATLAB. No acceleration provider hooks are required for this builtin.

GPU memory and residency

You usually do NOT need to call gpuArray yourself in RunMat (unlike MATLAB).

endsWith always executes on the host, but RunMat's runtime automatically gathers any GPU-resident inputs before evaluating the suffix check. Because the builtin registers a ResidencyPolicy::GatherImmediately, the planner gathers device handles eagerly and computes the logical result on the CPU. You may still call gpuArray manually for compatibility with MATLAB code; the runtime gathers the inputs just in time, so results match MATLAB precisely.

Examples

Check if a filename ends with an extension

tf = endsWith("report.pdf", ".pdf")

Expected output:

tf = logical
   1

Perform a case-insensitive suffix test

tf = endsWith("RunMat", "MAT", 'IgnoreCase', true)

Expected output:

tf = logical
   1

Apply 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   1

Use element-wise suffixes with implicit expansion

names = ["hydrogen"; "helium"; "lithium"];
suffixes = ["gen"; "ium"; "ium"];
tf = endsWith(names, suffixes)

Expected output:

tf = 3×1 logical array
   1
   1
   1

Test 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   1

Provide multiple suffixes as a column vector

tf = endsWith("saturn", ['n'; 'x'; 'r'])

Expected output:

tf = 3×1 logical array
   1
   0
   0

Handle empty patterns and missing values

texts = ["", "<missing>"];
tf = endsWith(texts, "")

Expected output:

tf = 1×2 logical array
   1   0

Using endsWith with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how endsWith changes the result.

FAQ

Related Strings functions

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.

Getting started · Benchmarks · Pricing