Differences

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

--- syntax:functions:keepafter [2015/04/03 18:27] – elenap
+++ syntax:functions:keepafter [2021/08/14 22:06] – [Examples] craigt
@@ Line 1: / Line 1: @@
-====== KeepAfter(text, string) ======
+====== KeepAfter(text, after_string) ======
+Category:  Text function
-Returns characters after the first occurrence of specific //string// in //text//. Parameter //string// must not be empty.
+\\
-This function is case-sensitive.
+=====Description=====
+This function returns characters after the first occurrence of //after_string// in //text//, if found.  If //after_string// is not found within //text// and "empty" value is returned.
-^  Example  ^  Result  ^
+\\
-|  KeepAfter( 'New York', 'Y' )  |  ork  |
+=====Alternative syntax=====
-|  keepafter( 'Food&Beverage', '&' )  |  Beverage  |
+This function can take an optional third numeric parameter to define the instance of //after_string// used in the search.  If //instance_num// is negative, the match starts from the end of //text//.
+  KeepAfter(text, after_string, instance_num)
+\\
+=====Arguments=====
+^Argument^Type^Description^
+|text|Text|The text value to search within for the //after_string// string.|
+|after_string|Text (must //not// be empty)|The text string to search for within //text//.  The characters after this string are returned.|
+|instance_num<sup>*</sup>|Number (non-zero integer)|The occurrence of //after_string// to use as the delimiter to return the text following.|
+<sup>*</sup>Optional argument.
+**Return value type:** Text
+\\
+=====Remarks=====
+This function is case sensitive.
+//text// and //after_string// are implicitly converted to text values if required.
+\\
+=====Examples=====
+  keepafter('a/b/c/d', 'b') //Returns '/c/d'
+  keepafter('a/b/c/d', '/') //Returns 'b/c/d'
+  keepafter('a/a/b/b/c/d', 'b/') //Returns 'b/c/d'  (Second argument can be multiple characters)
+  keepafter('a/b/c/d', '/', 2) //Returns 'c/d'  (Keep text after the second instance of '/')
+  keepafter('a/b/c/d', '/', -1) //Returns 'd'  (Keep text after the second instance of '/', from the end)
+  keepafter('a/b/c/d', 'z') //Returns (empty)  ('z' not found within the text value)
+\\
+===== See also =====
+  * [[syntax:functions:keepbefore|KeepBefore(text, before_string)]]
+  * [[syntax:functions:removeend|RemoveEnd(text, remove_num)]]
-=== See also ===
-  * [[syntax:functions:keepbefore]]
-  * [[syntax:functions:removeend]]