Differences

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

--- syntax:functions:lower [2015/04/03 18:02] – elenap
+++ syntax:functions:lower [2021/08/14 22:18] (current) – [Examples] craigt
@@ Line 1: / Line 1: @@
-===== Lower(text) =====
+====== Lower(text) ======
+Category:  Text function
-Returns //text// converted into lowercase letters.
+\\
+=====Description=====
+This function returns //text// converted to lowercase letters.
-^  Example  ^  Result  ^
+\\
-|  lower('Customer Service')  |  customer service  |
+=====Use cases=====
+This function can be used to perform a case-insensitive comparison of text values when the current case of the values are not known.  The [[syntax:functions:Upper|Upper(text)]] function can also be used for this.
-Example using a field name:
+\\
+=====Arguments=====
+^Argument^Type^Description^
+|text|Text|The text value to convert to lowercase.|
-^  Example  ^  Industry  ^  Result  ^
+**Return value type:** Text
-|  lower([Industry])  |  Energy  |  energy  |
-**See also**
+\\
-  * [[syntax:functions:upper]]
+=====Remarks=====
+This function has no effect on numbers, symbols, or non-printing characters.
+\\
+=====Examples=====
+  lower('Customer Service') //Returns 'customer service'
+  lower('IN ALL CAPS') //Returns 'in all caps'
+  lower([Industry]) //Returns 'energy'  (Using a field name; [Industry] = 'Energy')
+  lower([YourIndustry]) = lower([MyIndustry])  (Case insensitive comparison between two fields)
+\\
+===== See also =====
+  * [[syntax:functions:proper|Proper(text)]]
+  * [[syntax:functions:upper|Upper(text)]]