Differences

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

--- syntax:functions:keepafter [2015/02/02 21:53] – created dmitry
+++ syntax:functions:keepafter [2021/08/02 01:11] – craigt
@@ Line 1: / Line 1: @@
-====== KeepAfter(text, string) ======
+====== KeepAfter(text, after_string) ======
+Category:  Text function
-Returns characters after first occurrence of //string// in //text//. Case-sensitive. Parameter //string// must be not empty.
+\\
+=====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.
+\\
+=====Alternative syntax=====
+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|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') = '/c/d'
+  keepafter('a/b/c/d', '/') = 'b/c/d'
+  keepafter('a/a/b/b/c/d', 'b/') = 'b/c/d'  //Second argument can be multiple characters
+  keepafter('a/b/c/d', '/', 2) = 'c/d'  //Keep text after the second instance of '/'
+  keepafter('a/b/c/d', '/', -1) = 'd'  //Keep text after the second instance of '/', from the end
+  keepafter('a/b/c/d', 'z') = (empty)  //'z' not found within the text value
+\\
+===== See also =====
+  * [[syntax:functions:keepbefore|KeepBefore(text, before_string)]]
+  * [[syntax:functions:removeend|RemoveEnd(text, remove_num)]]
-^  Example  ^  Result  ^
-|  KeepAfter( 'New york', 'y' )  |  ork  |