65 lines
2.3 KiB
Markdown
65 lines
2.3 KiB
Markdown
|
# 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)
|