【MQL5】StringToLower関数について

StringToLower関数の働き・役割
StringToLower関数の引数について
StringToLower関数の戻り値について
StringToLower関数を使う際の注意点
StringToLower関数を使ったサンプルコード
サンプルコードに使われた関数や文法要素の簡単な解説

StringToLower関数の働き・役割

StringToLower関数は、指定した文字列内のすべての文字を小文字に変換するために使用されます。StringToLower関数を使用することで、文字列の大文字と小文字を統一し、比較や検索を行いやすくすることができます。

StringToLower関数の引数について

StringToLower関数は以下の引数を取ります。

string StringToLower(const string text);

第1引数は、変換対象の文字列です。種類はstring型で、[in][out]属性を持ちます。このため、StringToLower関数呼び出し後に文字列自体が変更されます。

※このあたりの仕組みについては↓の参照渡しに関する記事をご参照ください。

StringToLower関数の戻り値について

StringToLower関数は、操作が成功した場合にtrueを返し、失敗した場合にfalseを返します。エラーが発生した場合は、GetLastError関数を使用してエラーコードを取得できます。

※GetLastError関数についての詳細は↓の記事をご参照ください

StringToLower関数を使う際の注意点

元の文字列自体が変更されます。新しい文字列は戻り値としては返されません。
特殊文字（アルファベット以外の記号や数字）はそのまま保持され、小文字に変換されるのはアルファベット文字のみです。

StringToLower関数を使ったサンプルコード

以下は、StringToLower関数を使用して文字列を小文字に変換するサンプルコードです。

void OnStart()
  {
   // 操作対象の文字列を大文字で定義します
   string text = "HELLO WORLD!";
   
   // ソース文字列をログで表示します
   Print("元の文字列:　", text);
   
   // すべての文字列文字を小文字に変換し、結果をログに表示します
   if(StringToLower(text))
     Print("変更後の文字列：　", text);
  
  }