Initial Commit.

2026-06-23 21:47:51 +08:00
commit d17f68e979
5201 changed files with 318318 additions and 0 deletions
@@ -0,0 +1,48 @@
+# StringToUpper
+
+Transforms all symbols of a selected string into capitals.
+
+```
+bool  StringToUpper(
+   string&  string_var      // string to process
+   );
+
+```
+
+Parameters
+
+string_var
+
+[in][out]  String.
+
+Return Value
+
+In case of success returns true, otherwise - false. To get the [error code](/en/docs/constants/errorswarnings/errorcodes) call [GetLastError()](/en/docs/check/getlasterror).
+
+Example:
+
+```
+void OnStart()
+  {
+//--- define the source string in lowercase
+   string text=" - this string, written in lowercase, must be written in uppercase";
+//--- Display the source string in the log
+   Print("Source line:\n", text);
+//--- convert all string characters to uppercase and display the result in the log
+   if(StringToUpper(text))
+      Print("The original string after using the StringToUpper() function:\n", text);
+      
+   /*
+   Result
+   Source line:
+    - this string, written in lowercase, must be written in uppercase
+   The original string after using the StringToUpper() function:
+    - THIS STRING, WRITTEN IN LOWERCASE, MUST BE WRITTEN IN UPPERCASE
+   */
+  }
+
+```
+
+See also
+
+[StringToLower](/en/docs/strings/stringtolower), [StringTrimLeft](/en/docs/strings/stringtrimleft), [StringTrimRight](/en/docs/strings/stringtrimright)