この記事を開いてくださったこと、心から感謝しています。文字列で受け取った数字を、計算に使える数にしたいとき、どちらの関数を選べばよいのか、迷っている人も、きっと多いはずです。
結論から言うと、小数点以下まで数として読み取りたいときはStringToDouble、整数として取り出したいときはStringToIntegerです。公式サンプルでは、小数点を含む文字列を整数用の関数に渡すと、小数の部分が切り捨てられた形で表示されます。
また、確認した公式ページに書かれていない点もありました。たとえば、数字ではない文字列を渡したときの動きや、空白が混ざったときの扱いです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
StringToDoubleとStringToIntegerは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも文字列を数に変えますが、受け取る数の型が違います。
StringToDoubleは、文字列を小数の型の数に変える関数である
StringToDoubleは、数字を表す文字を含む文字列を渡すと、double型の数を返す関数です。引数は、文字列ひとつだけです。double型は、小数点以下を持てる数の型です。
公式サンプルでは、「12345.54321」という文字列を変換し、小数点以下8桁で表示しています。結果は、12345.54321000と表示されます。
- 引数は、文字列がひとつ
- 戻り値は、double型の数
- 小数点以下を持つ数も、そのまま表せる
StringToIntegerは、文字列を整数の型の数に変える関数である
StringToIntegerは、数字を含む文字列を渡すと、long型の数を返す関数です。引数は、こちらも文字列ひとつだけです。long型は、整数を表す型です。
公式サンプルでは、StringToDoubleと同じ「12345.54321」を渡しています。結果は、小数の部分が切り捨てされた12345と表示されます。公式のコメントにも、小数の部分を切り捨てして表示すると書かれています。
- 引数は、文字列がひとつ
- 戻り値は、long型の数
- 小数の部分は、切り捨てされる
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | StringToDouble | StringToInteger |
|---|---|---|
| 戻り値の型 | double型 | long型 |
| 小数点以下 | そのまま読み取る | 切り捨てされる(サンプルより) |
| 数字ではない文字列を渡したとき | 記載なし | 記載なし |
| 空白や符号の扱い | 記載なし | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
StringToDoubleは、どんな場面で使うのか?
StringToDoubleは、小数を含む数を、文字列から取り出して計算に使いたいときの選択肢です。公式の説明から、動き方を確認します。
小数点を含む文字列を、そのまま数にできる
公式サンプルでは、小数点を含む文字列を、そのまま小数の数に変えています。表示するときは、PrintFormatの「%.8f」で、小数点以下8桁まで出しています。
価格のように、小数点を含む数を文字で受け取る場面を想像すると、イメージしやすくなります。ただし、公式ページには、価格に使うという説明はありません。あくまで、考え方の一例です。
- 小数点を含む文字列を変換できる
- 表示は、PrintFormatで桁数を決める
- 価格への使い方は、公式には記載なし
数字ではない文字列を渡したときは、確認できない
公式ページには、数字ではない文字や、空の文字列を渡したときの戻り値が書かれていません。エラーコードを取得できるのかどうかも、記載なしです。
そのため、外から受け取った文字列を変換するときは、変換前に中身を確かめておくと安心です。文字列の中身の探し方は、StringFindとStringSubstrの記事で整理しています。
- 数字ではない文字列は、記載なし
- 空の文字列は、記載なし
- エラーコードは、記載なし
空白、符号、指数表記、区切りの扱いも、確認できない
前後に空白があるとき、プラスやマイナスの符号があるとき、指数の形で書かれているときも、公式には説明がありません。小数点の代わりにカンマが使われる表記や、3桁ごとの区切りについても、記載なしです。
公式ページには、「関連項目」として、NormalizeDoubleと、実数型の説明が載っています。変換した後の数の丸めは、別の関数で扱う流れが想定されていると読み取れます。
- 空白の扱いは、記載なし
- 符号や指数表記は、記載なし
- 区切りの文字は、記載なし
StringToIntegerは、どんな場面で使うのか?
StringToIntegerは、整数として扱いたい数を、文字列から取り出したいときの選択肢です。公式の説明から、動き方を確認します。
戻り値は、long型の整数である
戻り値は、long型です。公式サンプルでは、表示するときに「%I64d」という書式を使っています。これは、long型の数を表示するための書式です。
コードを写して使うときは、表示の書式が型に合っているかを、あわせて確認してください。型と書式が合わないと、表示がおかしくなる可能性があります。
- 戻り値は、long型
- 表示には、「%I64d」を使っている
- 書式は、型に合わせる
小数点を含む文字列は、小数の部分が切り捨てされる
公式サンプルでは、「12345.54321」が12345として表示されています。小数の部分が、四捨五入ではなく、切り捨てされたように見えます。
ただし、文章での説明は、サンプルのコメントにしかありません。マイナスの小数、たとえば「-12.7」のときに、どちらの向きに切り捨てされるのかは、公式のサンプルには出ていません。確かめたい場合は、自分の環境で試してください。
- 12345.54321は、12345になる
- 四捨五入ではないように見える
- マイナスの小数は、記載なし
大きすぎる数や、数字以外の文字は、確認できない
long型で表せる範囲を超える数を渡したときの動きは、公式には書かれていません。16進数のような表記や、数字ではない文字を渡したときの動きも、記載なしです。
また、パラメータの説明は、StringToDoubleでは「数を表す文字を含む文字列」、StringToIntegerでは「数を含む文字列」と、少し言い方が違います。内容に大きな違いがあるかどうかは、公式からは分かりません。
- 範囲を超える数は、記載なし
- 16進数は、記載なし
- 説明の言い方は、少し違う
どう使い分ければよいのか?
小数点以下まで必要ならStringToDouble、整数だけでよいならStringToIntegerです。ただし、受け取る文字列の中身を、あらかじめ考えておくことが大切です。
小数が含まれる可能性があるなら、StringToDoubleを選ぶ
受け取る文字列に、小数点が含まれる可能性があるなら、StringToDoubleが向いています。小数の部分を残したまま、数として扱えるためです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
整数だけでよいなら、StringToIntegerを選ぶ
個数や、番号のように、整数だけでよい数なら、StringToIntegerが向いています。ただし、小数点を含む文字列が来たときは、小数の部分が落ちることを、知っておく必要があります。
- 整数だけを使う
- 小数の部分は、落ちる
- 戻り値は、long型
変換した後の型にも、注意する
StringToDoubleはdouble型、StringToIntegerはlong型で値を返します。受け取る変数の型が合っていないと、思わぬ変換が起きる可能性があります。型の変換は、公式の「関連項目」にある、型の変換の説明で確認できます。
- 受け取る変数の型を合わせる
- 型の変換は、公式の説明を確認する
- 表示の書式も、型に合わせる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、短い文字列を使って確かめるのが安心です。
まずは、公式サンプルの文字列で試す
最初は、公式サンプルと同じ「12345.54321」を使って、2つの関数の結果を並べて表示します。小数の部分が残るか、落ちるかを、自分の目で確かめます。
- 同じ文字列を、2つの関数に渡す
- 結果を、ログに表示する
- 小数の部分の違いを確かめる
次に、書かれていない入力を試す
次に、空の文字列、数字ではない文字列、空白つきの文字列などを渡して、結果を記録します。公式に書かれていない部分なので、自分の環境での結果が、そのまま判断材料になります。
- 空の文字列を渡す
- 数字ではない文字列を渡す
- 空白つきの文字列を渡す
最後に、使う場面に合った型を決める
最後に、実際に使う場面で、小数が必要かどうかを決めます。必要なら、StringToDouble。不要なら、StringToIntegerです。迷ったときは、まず小数を残せるほうで受け取るのも、ひとつの考え方です。









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










