Initial Commit.

2026-06-23 21:47:51 +08:00
commit d17f68e979
5201 changed files with 318318 additions and 0 deletions
@@ -0,0 +1,64 @@
+# StringGetCharacter
+
+Returns value of a symbol, located in the specified position of a string.
+
+```
+ushort  StringGetCharacter(
+   string  string_value,     // string
+   int     pos               // symbol position in the string
+   );
+
+```
+
+Parameters
+
+string_value
+
+[in]  String.
+
+pos
+
+[in]  Position of a symbol in the string. Can be from 0 to [StringLen](/en/docs/strings/stringlen)(text) -1.
+
+Return Value
+
+Symbol code or 0 in case of an error. To get the [error code](/en/docs/constants/errorswarnings/errorcodes) call [GetLastError()](/en/docs/check/getlasterror).
+
+Example:
+
+```
+void OnStart()
+  {
+//--- delete all comments on the chart
+   Comment("");
+//--- declare a string, from which we will obtain the values of symbol codes and remember the string length
+   string message = "The script demonstrates the operation of the StringGetCharacter() function";
+   int    length  = StringLen(message);
+//--- declare a string variable, to which we will add the obtained symbols from the demo string
+   string text    = "";
+//--- in the loop by the demo string length
+   for(int i=0; i<length; i++)
+     {
+      //--- wait 1/10 seconds
+      Sleep(100);
+      //--- get a symbol from a string located at the loop index in the demo string
+      ushort char_code=StringGetCharacter(message, i);
+      //--- add a symbol to the displayed string and display the resulting string as a chart comment
+      text+=ShortToString(char_code);
+      Comment(text);
+     }
+//--- wait two seconds and remove the comment from the chart
+   Sleep(2000);
+   Comment("");
+   
+   /*
+   Result: the demo string appears on the screen character by character
+   The script demonstrates the operation of the StringGetCharacter() function
+   */
+  }
+
+```
+
+See also
+
+[StringSetCharacter](/en/docs/strings/stringsetcharacter),[ StringBufferLen](/en/docs/strings/stringbufferlen), [StringLen](/en/docs/strings/stringlen), [StringFill](/en/docs/strings/stringfill), [StringInit](/en/docs/strings/stringinit), [StringToCharArray](/en/docs/convert/stringtochararray), [StringToShortArray](/en/docs/convert/stringtoshortarray)