Differences

This shows you the differences between two versions of the page.

--- syntax:functions:startswith [2021/08/12 18:19] – dmitry
+++ syntax:functions:startswith [2021/08/14 19:01] (current) – craigt
@@ Line 1: / Line 1: @@
-====== StartsWith(textA, textB) ======
+====== StartsWith(text, start_string) ======
+Category:  Text function
-A search function used to check if the first string of text starts with the specific text.
+\\
+=====Description=====
+This function is a search function used to check if a string (//text//) starts with a specific text value (//start_string//).  If so, this function returns TRUE.  Otherwise, it returns FALSE.
-It returns TRUE if //textA// starts with //textB//, otherwise it returns FALSE. This function is case sensitive.
+\\
+=====Arguments=====
+^Argument^Type^Description^
+|text|Text|Any text, or value that can implicitly converted to text.|
+|start_string|Text|The text string to search for at the beginning of //text//.|
-^  Example  ^  Result  ^
+**Return value type:** Boolean (TRUE/FALSE)
-| startswith( 'Crimea', 'Crime' )  |  True |
-| startswith( 'IBM', 'i' )  |  False |
+\\
+=====Remarks=====
+This function is case sensitive.
-=== Remarks ===
+This function ignores leading whitespace and other non-printing characters when matching //start_string// to the beginning of //text//.
-The function ignores trailing spaces in both arguments. See the example below.
-    startswith( '        Crimea', '  Crime' )  //True.
+\\
+=====Examples=====
-=== See also ===
+  startswith( 'Crimea', 'Crime' ) //Returns TRUE
-  * [[syntax:functions:endswith]]
-  * [[syntax:functions:find]]
+  startswith( 'IBM', 'i' ) //Returns FALSE (unmatched due to case)
-  * [[syntax:functions:contains]]
+  startswith('    Ruthless', ' Ruth') //Returns TRUE (leading whitespace ignored)
+\\
+===== See also =====
+  * [[syntax:functions:contains]|Contains(text, look_for)]]
+  * [[syntax:functions:find]|Find(text, look_for)]]
+  * [[syntax:functions:endswith]|EndsWith(text, end_string)]]