CDouble & CDoubleVector - MetaTrader 5のためのライブラリ

MQL開発、型 (double) のプリミティブラッパークラス、および CDouble オブジェクトのベクターで使用される一般的なラウンディングメソッドライブラリ。 MQL5 と MQL4 の互換性!

CDouble

CDouble クラスは、オブジェクトのプリミティブ型 double の値をラップします。 さらに、このクラスには、double 型の浮動小数の四捨五入のメソッドと静的メソッドが用意されています。

宣言

class CDouble : public CObject

Title

#include <Double.mqh>

継承階層

• CObject
  • CDouble

CObject クラスから実装またはオーバーライドされた仮想メソッド:型、読み込み、保存、比較。

CDouble 型のオブジェクトには、次の5つのデータフィールドがあります。

string

m_symbol

double

m_value

uchar

m_step

uchar

m_digits

ENUM_PRECISION

m_mode

ドキュメントにさらに入る前に、ここでは、ラッパークラスの簡単な実用例を示します。

MqlTick tick;
   SymbolInfoTick(_Symbol,tick);
   CDouble  price = tick.ask - 0.0087263487676283476,
            sl    = price - 500*_Point,
            tp    = price + 500*_Point,
            lots  = 5.25 / 3.78789;
   MqlTradeRequest r={0};
   r.symbol= _Symbol;
   r.price = price.AsRoundedTick();
   r.sl    = sl.AsRoundedTick();
   r.tp    = tp.AsRoundedTick();
   r.volume= lots.AsRoundedLots();
...

静的ライブラリメソッドを使用する別の例:

MqlTick tick;
   SymbolInfoTick(_Symbol,tick);
   MqlTradeRequest r={0};
   r.symbol= _Symbol;
   r.price = tick.ask - 0.0087263487676283476,
   r.sl    = price - 500*_Point,
   r.tp    = price + 500*_Point,
   r.volume= 5.25 / 3.78789;
   ...
   CDouble::RoundTradeRequest(r);
   //価格フィールドをティックサイズに自動的に丸める
   //そしてロットステップへのボリューム

静的メソッドの概要

注意: このライブラリを使用するには、OOP を知る必要も、ラッパークラスのインスタンスを使用する必要もありません。 CDouble スコープの解決で静的関数を呼び出すだけです。 構文は次のとおりです。

type variable_name = CDouble::Method(args);

static bool

IsEqual
(double number1,
 double number2,
 double step);

static bool

IsEqual
(double number1,
 double number2,
 int digits);

static int

Compare
(double number1,
 double number2,
 double step)

static double

RoundToStep
(const double number, 
 double step)

static double

RoundToDigit
(const double number, 
 int digits)

static double

RoundToStepUp
(const double number, 
 double step)

static double

RoundToStepDown
(const double number, 
 double step)

static double

RoundToTick
(const double number, 
 string symbol=NULL)

static double

RoundToLots
(const double number,
 string symbol=NULL,
 bool always_return_valid=true)

static void (MQL5)

RoundTradeRequest
(MqlTradeRequest &request)

static void

RoundArrayToStep
(double &arr[],
 double step = NULL)

static void

RoundArrayToStep
(CArrayDouble &arr,
 double step = NULL)

static int

GetDigits
(double floating_point)

static double 

GetPoint
(int digits)

static string

ToString
(double number,
 int digits)

例:

MqlTick tick;
   SymbolInfoTick(_Symbol,tick);
   double rnd_by_step   = CDouble::RoundToStep(tick.bid*1.052565465,_Point);
   double rnd_by_digits = CDouble::RoundToDigit(tick.bid*1.052565465,_Digits);
   double by_lot_step   = CDouble::RoundToLots(0.123423,_Symbol);
   double by_tick_size  = CDouble::RoundToTick(tick.ask-100*_Point,_Symbol);
   double roundup       = CDouble::RoundToStepUp(3.999999999,_Point);
   double rounddn       = CDouble::RoundToStepDown(3.999999999,_Point);
   int    digits        = CDouble::GetDigits(0.0000025);
   double point         = CDouble::GetPoint(10);
   bool   equal         = CDouble::IsEqual(tick.bid,tick.bid+0.00000009,_Point);
   string tostr         = CDouble::ToString(3.1399999999999999);
   int    compare       = CDouble::Compare(tick.ask,tick.bid);
   
#ifdef __MQL5__
   MqlTradeRequest r={0};
   r.symbol= _Symbol;
   r.price = tick.ask+0.000089849847658759198199999;
   r.sl    = r.price - 503 * _Point;
   r.tp    = r.price + 503 * _Point;
   r.volume= 1.127984984;
   
   CDouble::RoundTradeRequest(r);
#endif 

コンストラクタの概要

CDouble
(const ENUM_PRECISION mode = PRECISION_DEFAULT,
 const string symbol = NULL)

CDouble
(const CDouble &other)

例:

CDouble num;
CDouble bid(PRECISION_TICK_SIZE, _Symbol);
CDouble ask(bid)
CDouble ask2 = bid;
CDouble lots(PRECISION_LOT_STEP, _Symbol);

割り当ての概要-オーバーロードされた代入演算子

void

Set(const double value)

void

Set(const CDouble &other)

void

注: = 代入演算子は、宣言と同じ行で呼び出すことができます。

例:

CDouble bid;
bid.Set(tick.bid);
CDouble ask = tick.ask;

CDouble pi = 3.14;
CDouble factor = 2;
pi*=factor;
Print(pi.ToString());
//6.28

オーバーロードされた算術演算子の概要

double

注: 1 つのステートメントにつき使用できる算術演算子は一つだけです。

オーバーロードされた演算子算術の構文:

type_double_result <-- CDouble_object <-- operator <-- double
//CDouble オブジェクトは、常に演算子の左側に移動します。

type_double_result <-- CDouble_object1 <-- operator <-- CDouble_object2
//2つの CDouble オブジェクトを使用する場合、順序は重要ではありません。

例:

CDouble foo    = 3.14;
CDouble bar    = 10;
CDouble foobar = bar + foo;          //13.14
CDouble err    = bar + foo + foobar; //エラー-不正な操作の使用

double var = bar / foo;

オーバーロードされた比較演算子の概要

bool

例:

CDouble foo = 3.14, bar = 3.139999999999999999999;
   
   Print(foo == bar); //true
   Print(foo <= bar); //true
   Print(foo >  bar); //false

インスタンスメソッドの概要

精密制御 (デフォルト): 数字 = 8;ステップ = 1e-08

• 精度を制御するには、ステップ、数字、または PrecisionMode (ENUM_PRECISION) の3つのメソッドがあります。 setter メソッドのいずれかを呼び出すと、前の設定が上書きされます。
• ステップは、_Point または LOT_STEP または TickSize のいずれかです。浮動小数点 (0.00001、0.025 など) として表されます。
• RoundToTick と RoundToLot は丸めリターンに対して適切なステップ値を自動的に使用するため、ステップを設定する必要はありません。

void

PrecisionMode
(const ENUM_PRECISION mode)

ENUM_PRECISION

PrecisionMode()

void

Step
(const double step_or_point)

double

Step()

void

Digits
(const int digits)

int

Digits()

double

AsRawDouble()

double

AsRounded()

double

AsRoundedUp()

double

AsRoundedDown()

double

AsRoundedTick()

double

AsRoundedLots
(bool always_return_valid = true)

int

ToInt()

long

ToLong()

string

ToStringPrecision()

string

ToString()

string

Symbol()

string

シンボル(const 文字列シンボル)

例:

CDouble pi2 = 3.14159265359;
   
   //値を取得... 
   double raw_double             = pi2.AsRawDouble();
   double round_double_to_step   = pi2.AsRounded();
   double tick_size_double       = pi2.AsRoundedTick();
   double lot_step_double        = pi2.AsRoundedLots();
   double rounded_up             = pi2.AsRoundedUp();
   double rounded_down           = pi2.AsRoundedDown();
   int    double_to_int          = pi2.ToInt();
   long   double_to_long         = pi2.ToLong();
   string precision_str          = pi2.ToStringPrecision();
   pi2 = 3.140000000009;
   pi2.Digits(8);
   string truncated_str          = pi2.ToString();

仮想メソッドの概要

CObject からオーバーライドされたメソッド:

仮想 int

Compare
(const CObject *node,
 const int mode=0)

仮想 int

Type()

virtual bool

Save(const int file_handle)

virtual bool

Load(const int file_handle)

例は以下の CDoubleVector を参照してください。

CDoubleVector

CDoubleVector クラスは、CDouble 動的インスタンスに特化したオブジェクトポインターコレクションです。

宣言

class CDoubleVector : public CArrayObj

Title

#include <Double.mqh>

継承階層

• CObject
  • CArray
    • CArrayObj
      • CDoubleVector

クラス CArrayObj から実装またはオーバーライドされた仮想メソッド: CreateElement。

インスタンスメソッドの概要

* * 継承されたパブリックメソッドのCArrayObjを参照してください。

CDouble*

operator[]
(const int index)

bool

Add(const double value)

bool

AssignDoubleArray
(const double &array[])

bool

CopyOut(double &arr[])

bool

CopyOut(CArrayDouble &arr)

virtual bool

Save(const int file_handle)

virtual bool

Load(const int file_handle)

例:

CDoubleVector *vect = new CDoubleVector;
   
   double dubs[]={3.14,1.21,55.555};
   vect.AssignDoubleArray(dubs);
   vect.Add(tick.bid);
   
   //インデックスによる CDouble オブジェクトの呼び出し
   Print(vect[vect.Total()-1].ToString());
   
   //新しい CDouble オブジェクトを追加する
   CDouble *lot = new CDouble(PRECISION_LOT_STEP);
   lot = 1.22;
   vect.Add(lot);
   
   //並べ替えベクトル昇順
   vect.Sort();
   
   int total = vect.Total();
   
   //CDouble オブジェクトの状態と値を含むファイルへのベクタの保存
   string f = "testdub.bin";
   int    h = FileOpen(f,FILE_WRITE|FILE_BIN);
   if(vect.Save(h))
      Print("save successful");
   FileClose(h);
   delete vect;
   
   //ファイルからベクトルをロード
   CDoubleVector vect_reborn;
   h=FileOpen(f,FILE_READ|FILE_BIN);
   if(vect_reborn.Load(h))
      Print("load successful");
   FileClose(h);
   total = vect_reborn.Total();
   Print("Total vector size = ",sizeof(vect_reborn)," bytes");
   for(int i=0;i<vect_reborn.Total();i++)
      Print(vect_reborn[i].ToString());
      
   //double arr にコピーします。
   double arr2[];
   vect_reborn.CopyOut(arr2);
   Print(ArraySize(arr2));