この記事を開いてくださったこと、心から感謝しています。文字列の中の一部を書きかえたいのか、区切り文字で分けて取り出したいのか、どちらの関数を選べばよいのか、迷っている人も、きっと多いはずです。
結論から言うと、文字列の中の特定の部分を別の文字列に置きかえたいときはStringReplace、区切り文字で分けて配列に取り出したいときはStringSplitです。2つは役目が違い、ひとつの文字列を整える場面で、組み合わせて使うこともあります。
また、確認した公式ページに書かれていない点もありました。たとえば、大文字と小文字の区別や、区切り文字が連続したときの扱いです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
StringReplaceとStringSplitは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも文字列を扱いますが、結果の受け取り方が大きく違います。
StringReplaceは、見つけた部分をすべて置きかえる関数である
StringReplaceは、元の文字列、探したい部分、置きかえる文字列の3つを渡すと、見つかった部分をすべて置きかえる関数です。元の文字列は、参照で渡す形で、関数の中で書きかえられます。
戻り値は、置きかえた回数です。見つからなかったときは0が返り、エラーのときは-1が返ります。エラーの原因は、GetLastErrorで取得できると説明されています。
- 元の文字列は、参照で渡して書きかえられる
- 戻り値は、置きかえた回数
- エラーのときは、-1が返る
StringSplitは、区切り文字で分けて配列に取り出す関数である
StringSplitは、分けたい文字列、区切り文字の文字コード、結果を受け取る配列の3つを渡すと、区切り文字で分けた部分を配列に入れる関数です。分けたい文字列そのものは、変更されないと説明されています。
戻り値は、配列に入れた部分の数です。区切り文字が見つからないときは、元の文字列がそのまま、ひとつだけ入ります。文字列が空のときは0、エラーのときは-1が返ります。
- 区切り文字は、文字コードで渡す
- 結果は、配列に入る
- 元の文字列は、変更されない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | StringReplace | StringSplit |
|---|---|---|
| 主な役目 | 部分を置きかえる | 区切って配列に取り出す |
| 元の文字列 | 書きかえられる | 変更されない |
| 戻り値 | 置きかえた回数 | 取り出した部分の数 |
| エラーのとき | -1 | -1 |
| 大文字と小文字の区別 | 記載なし | 記載なし |
| エラーコードの種類 | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
StringReplaceは、どんな場面で使うのか?
StringReplaceは、文字列の中の決まった部分を、別の文字列にそろえたいときの選択肢です。公式の説明から、動き方を確認します。
見つかった部分は、すべて置きかわる
公式サンプルでは、英語の文の中の単語を、3回に分けて置きかえています。quickをslowに、brownをblackに、foxをbearに置きかえ、置きかえた回数の合計は3と表示されています。
同じ部分が複数あるときも、すべて置きかわると説明されています。ただし、重なって見つかる場合の数え方は、公式には書かれていません。
- 見つかった部分は、すべて置きかわる
- サンプルの合計は、3回
- 重なる場合は、記載なし
見つからないときは0、エラーのときは-1になる
置きかえる部分が見つからなかったときは、エラーではなく、0が返ります。そのため、戻り値が0かどうかと、-1かどうかは、分けて確かめる必要があります。
エラーの原因として、空の文字列や、初期化されていない文字列を渡したときと、メモリが足りないときが挙げられています。細かい条件は、公式には書かれていません。
- 見つからないときは、0
- エラーのときは、-1
- 原因は、空や未初期化の文字列など
大文字と小文字や、空の置きかえ文字は、確認できない
大文字と小文字を区別するのかどうかは、公式には書かれていません。置きかえる文字列が空のとき、つまり部分を削除したいときの動きも、記載なしです。
見つけたい部分の位置を調べるときは、StringFindとStringSubstrの記事で整理した関数が役立ちます。置きかえの前に、対象が含まれているかを確かめておくと安心です。
- 大文字と小文字の区別は、記載なし
- 空の置きかえ文字は、記載なし
- 事前に含まれるか確かめておく
StringSplitは、どんな場面で使うのか?
StringSplitは、区切り文字でつながった文字列を、部分ごとに取り出したいときの選択肢です。公式の説明から、動き方を確認します。
区切り文字は、文字コードで渡す
区切り文字は、文字そのものではなく、文字コードで渡します。公式サンプルでは、StringGetCharacterを使って、区切りにしたい文字の文字コードを取得してから、渡しています。
関数の形では、区切り文字は1つの文字コードだけを受け取る形です。そのため、複数の文字でできた区切りには、そのままでは使えないと読み取れますが、公式には、はっきりとは書かれていません。
- 区切り文字は、文字コードで渡す
- 文字コードは、StringGetCharacterで取得できる
- 複数文字の区切りは、記載なし
区切り文字が見つからないときは、元の文字列がひとつだけ入る
区切り文字が見つからないときは、元の文字列がそのまま、ひとつだけ配列に入ると説明されています。元の文字列が空のときは0が返り、エラーのときは-1が返ります。
戻り値が1のときは、分けられなかった可能性もあるため、中身も一緒に確かめておくと安心です。変換して数として使いたいときは、StringToDoubleとStringToIntegerの記事も参考になります。
- 見つからないときは、元の文字列がひとつ入る
- 空の文字列のときは、0
- エラーのときは、-1
連続する区切りや、前後の区切りの扱いは、確認できない
公式サンプルの文字列は、前後に区切り文字がついた形です。ただし、公式ページには、サンプルを実行したときの表示結果が載っていません。そのため、前後の区切りが、空の要素になるのかどうかは、確認できません。
区切り文字が続いたときに、空の要素ができるのかも、記載なしです。また、パラメータの説明の見出しが、関数の形の名前と違う点にも、注意が必要です。読むときは、混乱しないようにしてください。
- 前後の区切りの扱いは、記載なし
- 連続する区切りは、記載なし
- サンプルの表示結果は、載っていない
どう使い分ければよいのか?
置きかえたいならStringReplace、区切って取り出したいならStringSplitです。ただし、整える手順の中で、続けて使うこともあります。
書きかえたいなら、StringReplaceを選ぶ
文字列の中の特定の部分を、別の文字列にそろえたいなら、StringReplaceが向いています。元の文字列が書きかわる点を、あらかじめ知っておく必要があります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
分けて取り出したいなら、StringSplitを選ぶ
区切り文字でつながった文字列を、部分ごとに扱いたいなら、StringSplitが向いています。元の文字列は変更されないため、元の形を残したいときにも使いやすい関数です。
- 区切り文字で分けたい
- 元の文字列は、変更されない
- 結果は、配列で受け取る
整えてから分ける、という流れも考えられる
たとえば、区切りの種類がそろっていない文字列を、StringReplaceで1種類にそろえてから、StringSplitで分ける、という流れが考えられます。ただし、これは筆者の考え方で、公式ページには、この使い方の説明はありません。
- 先に、StringReplaceでそろえる
- 次に、StringSplitで分ける
- 順番は、自分の環境で確かめる
どちらの関数も、書き方は短く、引数の数も少ないため、まずは小さな文字列で動きを確かめてから、実際のコードに組み込む流れが、無理なく進められます。
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、短い文字列を使って確かめるのが安心です。
まずは、公式サンプルの文字列で試す
最初は、公式サンプルと同じ文字列を使って、置きかえた回数と、分けた部分の数を表示します。StringSplitは、公式に表示結果がないため、自分の環境での結果を、記録しておきます。
- 置きかえた回数を、表示する
- 分けた部分の数を、表示する
- 分けた中身も、1つずつ表示する
表示した結果は、使った環境や設定で変わる可能性があります。あとで見返せるように、入力した文字列と、表示された結果を、セットでメモに残しておきましょう。
次に、書かれていない入力を試す
次に、大文字と小文字を変えた文字列、空の文字列、区切り文字が続く文字列などを渡して、結果を記録します。公式に書かれていない部分なので、自分の環境での結果が、そのまま判断材料になります。
- 大文字と小文字を変えて試す
- 空の文字列を渡す
- 区切り文字が続く文字列を渡す
最後に、戻り値で失敗を見分ける
最後に、戻り値が-1のときの処理を決めます。GetLastErrorで、エラーコードを取得して、記録しておくと、あとで原因を調べるときに役立ちます。









- まず、公式サンプルの文字列で試す
- 次に、書かれていない入力を試す
- 最後に、戻り値で失敗を見分ける
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
StringReplaceは、大文字と小文字を区別するのか?
確認した公式ページには、書かれていません。記載なしなので、自分の環境で、大文字と小文字を変えて試すのが安心です。
- 公式には、記載なし
- 自分の環境で確かめる
StringSplitで、前後の区切りはどうなるのか?
公式サンプルには、前後に区切り文字がついた文字列が使われていますが、表示結果が載っていないため、確認できません。自分の環境で、実際に試してから使うのが安心です。
- 公式には、表示結果がない
- 自分の環境で確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のStringReplaceとStringSplit、文字列の一部をまとめて置きかえる手軽さと区切り文字で分けて配列に取り出す便利さどっちを選ぶ?」
置きかえるならStringReplace、区切って取り出すならStringSplitです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










