Differences

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

--- syntax:functions:upper [2015/04/03 18:26] – elenap
+++ syntax:functions:upper [2021/08/02 03:16] – craigt
@@ Line 1: / Line 1: @@
-===== Upper(text) =====
+====== Upper(text) ======
+Category:  Text function
-Returns //text// converted into uppercase letters.
+\\
+=====Description=====
+This function returns //text// converted to uppercase letters.
-^  Example  ^  Result  ^
+\\
-|  upper('Health Services')  |  HEALTH SERVICES  |
+=====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:lower|Lower(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 uppercase.|
-^  Example  ^  Industry  ^  Result  ^
+**Return value type:** Text
-|  upper([Industry])  |  Energy  |  ENERGY  |
-**See also**
+\\
-  * [[syntax:functions:lower]]
+=====Remarks=====
+This function has no effect on numbers, symbols, or non-printing characters.
+\\
+=====Examples=====
+  upper('Health Services') = 'HEALTH SERVICES'
+  upper('all lowercase') = 'ALL LOWERCASE'
+  upper([Industry]) = 'ENERGY'  //Using a field name; [Industry] = 'Energy'
+  upper([YourIndustry]) = upper([MyIndustry])  //Case insensitive comparison between two fields
+\\
+===== See also =====
+  * [[syntax:functions:lower|Lower(text)]]
+  * [[syntax:functions:proper|Proper(text)]]