RunMat
GitHub

View all functions

CategoryStrings: Search

What does the endsWith function do in MATLAB / RunMat?

endsWith(str, pattern) returns a logical result indicating whether each element of str ends with the corresponding text in pattern. The builtin supports string arrays, character vectors/arrays, and cell arrays of character vectors, mirroring MATLAB's implicit expansion semantics.

How does the endsWith function behave in MATLAB / RunMat?

  • 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, displayed as <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.

endsWith Function GPU Execution Behaviour

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.

Examples of using the endsWith function in MATLAB / RunMat

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

GPU residency in RunMat (Do I need gpuArray?)

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.

FAQ

What types can I pass to endsWith?

Use string scalars/arrays, character vectors/arrays, or cell arrays of character vectors for both arguments. Mixed combinations are accepted, and RunMat performs MATLAB-style implicit expansion when the array sizes differ.

How do I ignore letter case?

Supply 'IgnoreCase', true (or 'on') after the pattern argument. The option is case-insensitive, so 'ignorecase' also works. The default is false, matching MATLAB.

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 array, or cell array of character vectors. RunMat applies implicit expansion so that scalar inputs expand across the other argument automatically.

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. The builtin executes on the CPU. If inputs reside on the GPU (for example, after other accelerated operations), RunMat gathers them automatically so behaviour matches MATLAB.

Does endsWith preserve the input shape?

Yes. The output is a logical array whose shape reflects the MATLAB-style implicit expansion result. When that shape contains exactly one element, the builtin returns a logical scalar.

See Also

contains, startsWith, regexp, regexpi

Source & Feedback