containscell

by Tim C. Lueth, SG-Lib Toolbox: SolidGeometry 5.6 - Text/Strs/Chars/Links
Introduced first in SolidGeometry 4.7, Creation date: 2019-06-15, Last change: 2025-09-14

finds a string segment into a cell list of strings

See Also: , stldir

Example Illustration

missing image of containscell(A,sstr,IgnoreCase)

Syntax

ind=containscell(A,sstr,[IgnoreCase])

Input Parameter

`A`:		Cell List of Strings
`sstr`:		string to search
`IgnoreCase`:		if true; case is ignored

Output Parameter

ind: index list

Examples


a={'xedr','ere','tyui'}', containscell(a,'e')

Copyright 2019-2025 Tim C. Lueth. All rights reserved. The code is the property of Tim C. Lueth and may not be redistributed or modified without explicit written permission. This software may be used free of charge for academic research and teaching purposes only. Commercial use, redistribution, modification, or reverse engineering is strictly prohibited. Access to source code is restricted and granted only under specific agreements. For licensing inquiries or commercial use, please contact: Tim C. Lueth

Algorithm (Workflow)

This function, containscell, is designed to search for a specific string segment within a cell array of strings. It is part of the SG-Library and was introduced in SolidGeometry 4.7. The function is now considered obsolete as of November 4, 2021, and users are encouraged to use the built-in contains function instead.

Input Parameters

A: A cell array containing strings. This is the list in which the function will search for the specified string segment.
sstr: The string segment that the function will search for within each element of the cell array A.
IgnoreCase: An optional parameter that determines whether the search should be case-sensitive. If set to true, the search will ignore case differences. This parameter is retrieved using the getfuncparams function, with a default value of true.

Output Results

ind: A logical array of the same size as A. Each element of ind is true if the corresponding element in A contains the string segment sstr, and false otherwise.

Algorithm Steps

Retrieve the IgnoreCase parameter using getfuncparams, with a default value of true.
Determine the number of elements in the cell array A using numel.
Initialize the output logical array ind to be the same size as A, with all elements set to false.
Iterate over each element of the cell array A using a for loop:

Check if the current element is a character array or a string and is not empty.
If IgnoreCase is true, use the contains function with the 'IgnoreCase' option set to true to check if the element contains sstr.
If IgnoreCase is false, use the contains function without the 'IgnoreCase' option.
Set the corresponding element in ind to true if the string segment is found.

The function is straightforward and relies on the built-in contains function to perform the actual string search, with the added flexibility of case sensitivity control.

Algorithm explaination created using ChatGPT on 2025-08-19 00:45. (Please note: No guarantee for the correctness of this explanation)

Last html export of this page out of FM database by TL: 2025-09-21