49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
|
# 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)
|