この記事を開いてくださったこと、心から感謝しています。通貨ペアの名前から通貨の部分を取り出したいとき、文字列の中を探すのか、切り出すのか、迷っている人も、きっと多いはずです。
結論から言うと、文字列の中に目的の文字があるか、どこにあるかを知りたいときはStringFind、位置が分かっている部分を取り出したいときはStringSubstrです。2つは役目が違い、組み合わせて使う場面も多くなります。
また、確認した公式ページに書かれていない点もありました。たとえば、大文字と小文字の区別や、範囲外の位置を渡したときの動きです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
StringFindとStringSubstrは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも文字列を扱いますが、やることが違います。
StringFindは、文字列の中から探した位置を返す関数である
StringFindは、探される文字列と、探したい文字列を渡すと、その文字列が始まる位置を返す関数です。3つ目の引数で、探し始める位置も指定できます。初期値は0です。
探した文字列が見つからないときは、-1が返ります。公式には、この-1以外の失敗の値は書かれていません。
- 探される文字列と、探したい文字列を渡す
- 探し始める位置は、初期値が0
- 見つからないときは、-1が返る
StringSubstrは、指定した位置から文字列を切り出す関数である
StringSubstrは、元の文字列と、切り出しを始める位置、切り出す長さを渡すと、その部分の文字列を返す関数です。長さを省くか、-1にすると、指定した位置から最後までを取り出します。
取り出せないときは、空の文字列が返ると説明されています。どんな条件で取り出せないのかは、はっきりとは書かれていません。
- 元の文字列と、始める位置を渡す
- 長さを省くと、最後まで取り出す
- 取り出せないときは、空の文字列
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | StringFind | StringSubstr |
|---|---|---|
| 主な役目 | 位置を探す | 部分を切り出す |
| 戻り値 | 位置の番号 | 切り出した文字列 |
| 見つからない・取り出せないとき | -1 | 空の文字列 |
| 位置の範囲 | 記載なし | 0から文字数マイナス1まで |
| 大文字と小文字の区別 | 記載なし | 該当なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
StringFindは、どんな場面で使うのか?
StringFindは、文字列の中に目的の文字列が含まれているかを調べたいときに使います。公式の説明から、動き方を確認します。
戻り値が0以上なら、見つかったと判断できる
見つからないときが-1なので、戻り値が0以上かどうかで、見つかったかどうかを判断できます。公式サンプルでも、戻り値が0以上のときだけ、結果を表示しています。
位置の数え方は、先頭が0番目です。サンプルでは、EURUSDの先頭のEURが、位置0として表示されています。
- 0以上なら、見つかった
- -1なら、見つからなかった
- 先頭の位置は、0番目
探し始める位置を、変えられる
3つ目の引数で、探し始める位置を変えられます。ただし、指定できる範囲は、公式には書かれていません。マイナスの値や、文字列の長さ以上の値を渡したときの動きも、記載なしです。
また、同じ文字列が複数あるとき、どの位置が返るのかも、公式の文章には書かれていません。必要な場合は、自分の環境で確かめておくと安心です。
- 探し始める位置を指定できる
- 指定できる範囲は、記載なし
- 複数あるときの扱いは、記載なし
公式サンプルは、通貨を含む銘柄を探している
公式サンプルは、チャートの銘柄から、基準になる通貨と決済に使われる通貨のコードを取得します。そのうえで、取引できる銘柄の一覧から、それらを含む銘柄を探して、位置と一緒に表示します。
銘柄の一覧の取り方は、SymbolsTotalとSymbolNameの記事で整理しています。表示される銘柄は、接続しているサーバーによって変わるため、公式の例と同じになるとは限りません。
- 通貨のコードを取得する
- 銘柄の一覧から、含むものを探す
- 結果は、サーバーによって変わる
大文字と小文字や、文字の数え方は、確認できない
公式サンプルは、大文字の通貨コードだけを使っているため、大文字と小文字を区別するのかどうかは、ここからは分かりません。日本語のような、複数のバイトで表される文字の扱いも、記載なしです。
空の文字列を探したときの動きも、書かれていません。大文字と小文字が混ざる可能性がある文字列を調べるときは、事前にテストしておくと安心です。
- 大文字と小文字の区別は、記載なし
- 日本語の扱いは、記載なし
- 空の文字列の動きは、記載なし
StringSubstrは、どんな場面で使うのか?
StringSubstrは、位置が分かっている部分を、文字列から取り出したいときに使います。公式の説明から、動き方を確認します。
開始位置と長さで、取り出す範囲を決める
開始位置は、0から文字数マイナス1までと書かれています。長さを省くか、-1にすると、開始位置から最後までが取り出されます。
なお、公式の説明文では、文字列の名前が「text」と書かれていて、関数の形に出てくる名前とは違っています。内容は同じ文字列を指していると読み取れますが、読むときは混乱しないように注意してください。
- 開始位置は、0から文字数マイナス1
- 長さを省くと、最後まで取り出す
- 説明文の名前は、関数の形と少し違う
範囲を超えたときの動きは、はっきりしない
開始位置が範囲の外のときや、長さが文字列の残りより長いときの動きは、公式には詳しく書かれていません。長さがマイナスの値のときや、0のときも、記載なしです。
そのため、切り出す前に、文字列の長さを確かめておくのが基本です。長さの確かめ方は、公式の「関連項目」に載っている関数でできます。
- 範囲外の開始位置は、記載なし
- 長さが残りより長いときは、記載なし
- 長さが0やマイナスのときは、記載なし
公式サンプルは、通貨ペアを3文字ずつ切り出している
公式サンプルは、チャートの銘柄の名前から、先頭の3文字と、その次の3文字を切り出しています。EURUSDなら、EURとUSDが取り出され、それぞれが基準の通貨と、相手の通貨として表示されます。
ただし、このサンプルは、銘柄の名前が6文字の通貨ペアだけを想定しています。名前の前後に文字が付く銘柄の場合は、この切り出し方では合わないことがあります。そのため、実際の銘柄の名前を、事前に確かめておきましょう。
- 先頭の3文字を切り出す
- 次の3文字も、切り出す
- 6文字の通貨ペアを想定している
どう使い分ければよいのか?
探したいならStringFind、切り出したいならStringSubstrです。ただし、実際には、探してから切り出す、という流れで使うことも多くなります。
含まれているか知りたいなら、StringFindを選ぶ
ある文字列が含まれているかどうかや、どこから始まるのかを知りたいときは、StringFindが向いています。戻り値が0以上かどうかを調べるだけで、判断できます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
決まった位置の部分を取りたいなら、StringSubstrを選ぶ
通貨ペアの名前の最初の3文字のように、位置が決まっている部分を取りたいときは、StringSubstrが向いています。位置と長さを渡すだけなので、考え方は分かりやすいです。
- 位置が決まっている部分を取る
- 長さを省くと、最後まで取れる
- 範囲外の動きは、記載なし
探してから切り出すのが、よくある組み合わせになる
文字列の中の目印の位置を、StringFindで探し、その位置を使って、StringSubstrで前後の部分を切り出す、という組み合わせがあります。このとき、目印が見つからなかったときの-1を、切り出しに渡さないように注意します。
- 先に、StringFindで位置を探す
- 見つかったか、-1かを確かめる
- 次に、StringSubstrで切り出す
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、短い文字列を使って確かめるのが安心です。
まずは、StringFindの戻り値を表示する
最初は、短い文字列を使って、探したい文字列を含むものと、含まないものの両方で、戻り値を表示します。見つからないときに-1になることを、自分の目で確かめます。
- 含む文字列で、位置を表示する
- 含まない文字列で、-1を確かめる
- 大文字と小文字でも試す
次に、StringSubstrで切り出してみる
次に、通貨ペアの名前を使って、先頭の3文字と、その次の3文字を切り出します。長さを省いたときの動きも、あわせて確かめます。
- 先頭の3文字を切り出す
- 長さを省いて、最後まで取る
- 結果をログに表示する
最後に、範囲外の値で動きを確かめる
最後に、文字列の長さを超える位置や、長めの長さを渡して、どんな結果になるかを確かめます。公式に書かれていない部分なので、自分の環境での結果を、記録しておきます。









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










