この記事を開いてくださったこと、心から感謝しています。MathSinとMathCosは名前が似ていて、どちらを使えばよいのか、角度は何で渡すのか、迷っている人も多いはずです。
結論から言うと、MathSinは角度の正弦(サイン)を返す関数、MathCosは角度の余弦(コサイン)を返す関数です。どちらも角度はラジアンで渡し、戻り値は-1から1の範囲になる、と公式に書かれています。
また、確認した公式ページに書かれていない点もありました。たとえば、非数や無限大を渡したときの動き、計算の精度、度数で渡したいときの方法です。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、引数、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathSinとMathCosは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。形はほとんど同じで、返す値の種類が違います。
MathSinは、角度の正弦を返す関数である
MathSinの形は、double MathSin(double value) です。引数のvalueは、ラジアンで表した角度です。
戻り値は、その角度の正弦で、-1から1の範囲の実数です。公式には、MathSinの代わりにsinという名前も使える、という説明があります。
- 引数は、ラジアンの角度を1つ
- 戻り値は、-1から1の範囲の実数
- sinという別名も使える
MathCosは、角度の余弦を返す関数である
MathCosの形は、double MathCos(double value) です。引数のvalueは、MathSinと同じく、ラジアンで表した角度です。
戻り値は、その角度の余弦で、-1から1の範囲の実数です。公式には、MathCosの代わりにcosという名前も使える、という説明があります。
- 引数は、ラジアンの角度を1つ
- 戻り値は、-1から1の範囲の実数
- cosという別名も使える
なお、MathCosのページでは、関数の形の横の注釈が「number」となっています。一方、引数の説明には「ラジアンの角度」と書かれています。この表記のずれは、公式ページ側のものです。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathSin | MathCos |
|---|---|---|
| 役割 | 正弦を返す | 余弦を返す |
| 引数 | ラジアンの角度 | ラジアンの角度 |
| 戻り値の範囲 | -1から1 | -1から1 |
| 別名 | sin | cos |
| 非数や無限大 | 記載なし | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
角度は、どう渡せばよいのか?
2つの関数で、最も気をつけたいのは、角度の単位です。公式の説明を、順に整理します。
角度は、度ではなくラジアンで渡す
公式には、どちらの関数も、角度はラジアンで渡す、と書かれています。度数をそのまま渡すと、意図とは違う値になります。
- 角度は、ラジアンで渡す
- 度数のままでは、意図と違う値になる
- 度数からの変換方法は、記載なし
公式のこのページには、度数からラジアンへの変換の書き方は載っていません。サンプルでは、円周率を表す定数が使われていますが、その定義も、このページには書かれていません。
戻り値は、-1から1の範囲に収まる
公式には、どちらの戻り値も、-1から1の範囲の実数、と書かれています。MathSinもMathCosも、値の大きさは1を超えません。
この性質から、値を大きさの目安として使うときは、範囲が決まっていて扱いやすい、と考えられます。これは、公式の説明そのものではなく、筆者の読み取りです。
- 最小は、-1
- 最大は、1
- 範囲を超える値は、返らない
たとえば、戻り値が、ちょうど1や-1になる角度を渡したとき、表示がどうなるかは、公式には書かれていません。小数の桁の扱いによって、わずかに違う表示になることもあります。
表示の桁数をそろえたいときは、丸めの関数と組み合わせる方法があります。違いは、NormalizeDoubleとMathRoundの記事で整理しています。
書かれていない点は、自分で確かめる
非数や無限大を渡したときの動き、計算の精度、エラーのときの扱いは、公式のページには書かれていません。また、ベクトルを渡す形の説明も、関数の形のところにはありません。
- 非数や無限大を渡したとき:記載なし
- 計算の精度:記載なし
- GetLastErrorとの関係:記載なし
- ベクトルを渡す形:記載なし
このため、結果をそのまま使う前に、値が範囲に収まっているかを確かめる流れにしておくと安心です。値の判定の仕組みは、別の関数で扱われます。
公式サンプルは、どう読めばよいのか?
公式ページのサンプルは、どちらも同じ作りです。0から2π(円周率の2倍)までの値に関数を当てて、曲線にします。
MathSinのサンプルは、サイン波を描いている
MathSinのサンプルでは、101個の要素を持つベクトルを作り、0から2πまでを等しい間隔で入れます。そのベクトルにMathSinを当てて、結果を曲線として描きます。
描いたあとは、ESCキーで終了、PgDnキーで画面の保存ができる作りです。公式の結果の欄は、画像で示されており、文字としての出力はありません。
- 0から2πまでを、101個の点に分ける
- MathSinを当てて、曲線を描く
- ESCで終了、PgDnで保存
- 文字の出力は、ない
MathCosのサンプルは、同じ形でコサイン波を描いている
MathCosのサンプルも、同じ作りです。0から2πまでの101個の値にMathCosを当てて、曲線として描きます。結果の欄も、画像で示されています。
2つの曲線は、同じ形の波ですが、横にずれた位置から始まります。これは、三角関数の一般的な性質で、公式の説明そのものではなく、筆者の補足です。
- 0から2πまでの101個の値を用意する
- MathCosを当てて、曲線を描く
- サイン波とは、波の位置がずれている
サンプルの意図は、関数の動きを、数字ではなく、曲線の形で見せることだと考えられます。数字だけを見るより、波の形を目で見たほうが、値の増え方や減り方が分かりやすくなります。
ただし、これは、サンプルの作りから読み取った筆者の見方です。公式ページには、サンプルの狙いについての説明は書かれていません。
サンプルが、ベクトルを渡している点に注意する
公式の形の説明は、実数を1つ受け取る関数ですが、サンプルでは、ベクトルをそのまま渡しています。ベクトルを渡す形の説明は、確認した公式ページには、書かれていません。
- 形の説明は、実数1つ
- サンプルは、ベクトルを渡している
- ベクトル版の説明は、記載なし
使う場合は、自分の環境で動くかどうかを、先に確かめておくと安心です。角度を、決まった周期で割った余りにそろえたいときは、MathAbsとMathModの記事も参考になります。
どう使い分ければよいのか?
正弦がほしいならMathSin、余弦がほしいならMathCosです。波の形が同じで、位置がずれているだけなので、目的に合わせて選びます。
波の上下のゆれを作りたいなら、MathSinを選ぶ
0から始まって、上下にゆれる波がほしいときは、MathSinを使います。角度を少しずつ増やしながら呼ぶと、-1から1の間をゆれる値が得られます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
波の位置をずらして使いたいなら、MathCosを選ぶ
同じ形の波を、ずれた位置から使いたいときは、MathCosを選びます。MathSinと組み合わせれば、2つの波を、位置をずらして並べられます。
- 同じ形の波を、ずれた位置から使いたい
- 角度は、ラジアンで渡す
- MathSinと、組み合わせられる
2つの関数は、同じ角度を渡しても、返ってくる値が違います。角度が0のとき、正弦は0で、余弦は1になります。これは、三角関数の一般的な値で、公式の説明そのものではありません。
- 角度が0のとき、MathSinは0
- 角度が0のとき、MathCosは1
- どちらも、-1から1の範囲に収まる
正接を求めたいなら、MathTanもある
公式には、正接を返すMathTanという関数もあります。引数はラジアンの角度で、とても大きな値を渡すと、有効な桁が失われ、不定の値が返ることがある、と書かれています。
この「とても大きな値」の境目は、2の63乗にあたる値と読み取れますが、確認した範囲では、表記が崩れていました。正確な数字は、公式ページで確かめてください。
- MathTanは、正接を返す
- とても大きな値では、不定の値が返る
- 不定の値が非数なのかは、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、簡単な角度を使って確かめるのが安心です。
まずは、0とπの値を確かめる
最初は、0と、円周率にあたる値を渡して、MathSinとMathCosの結果を表示します。値が、-1から1の範囲に収まることを、自分の目で確かめます。
- 0を渡す
- 円周率にあたる値を渡す
- 値が範囲に収まるか見る
次に、度数をラジアンに直して確かめる
次に、度数で持っている角度を、自分でラジアンに直してから渡します。変換の方法は、公式のこのページにはないため、計算式を自分で確認しておく必要があります。
- 度数を、ラジアンに直す
- 直した値を渡す
- 結果を表示して確かめる
最後に、曲線で形を確かめる
最後に、公式サンプルのように、0から2πまでを細かく分けて、曲線にしてみます。MathSinとMathCosの波が、位置をずらした形になっているかを見比べます。









- まず、0と円周率の値を確かめる
- 次に、度数をラジアンに直して確かめる
- 最後に、曲線で形を確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
度数のまま渡しても、使えるのか?
公式には、角度はラジアンで渡す、と書かれています。度数のまま渡すと、意図とは違う値になるため、先にラジアンに直してから渡すのが安心です。
- 角度は、ラジアンで渡す
- 度数は、先に直す
非数や無限大を渡すと、どうなるのか?
確認した公式ページには、書かれていません。記載なしなので、自分の環境で、実際に試してから使うのが安心です。
- 公式には、記載なし
- 自分の環境で確かめる
戻り値が、ちょうど1や-1になることはあるのか?
公式には、戻り値は-1から1の範囲、と書かれています。ちょうど1や-1になる角度で、実際にどう表示されるかは、記載がありません。自分の環境で表示して、確かめておくと安心です。
- 範囲は、-1から1と書かれている
- ぴったりの値になるかは、記載なし
- 表示して確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMathSinとMathCos、サイン波の上下のゆれを取り出す見通しの良さとコサイン波のずれた位置から始まる扱いやすさどっちを使う?」
正弦ならMathSin、余弦ならMathCosです。角度はラジアンで渡し、記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










