変換関数

string  CharToString(
  uchar  char_code      // シンボルの数値コード
  );

string  CharArrayToString(
  uchar  array[],              // 配列
  int    start=0,              // 配列の開始位置
  int    count=-1              // シンボル数
  uint    codepage=CP_ACP      // コードページ
  );

bool  CharArrayToStruct(
  void&         struct_object,    // 構造体
  const uchar&  char_array[],    // 配列
  uint          start_pos=0      // 配列での開始位置
  );

bool  StructToCharArray(
  const void& struct_object,    // 構造体
  uchar&      char_array[],      // 配列
  uint        start_pos=0        // 配列の開始位置
  );

uint  ColorToARGB(
  color  clr,          // color フォーマットに変換された色
  uchar  alpha=255     // 色の透明度を管理するアルファチャンネル
  );

//+——————————————————————+
//| スクリプトプログラムを開始する関数                                          |
//+——————————————————————+
void OnStart()
 {
//— 透明度を設定する
  uchar alpha=0x55; // 0x55 は 55/255=21.6 % 透明度を意味する
  //— clrBlue 色のために、ARGBへの変換を導き出す
  PrintFormat("0x%.8X – clrBlue",clrBlue);
  PrintFormat("0x%.8X – clrBlue ARGB with alpha=0x55 (transparency 21.6%%)",ColorToARGB(clrBlue,alpha));
  //— clrGreen 色のために、ARGB への変換を導き出す
  PrintFormat("0x%.8X – clrGreen",clrGreen);
  PrintFormat("0x%.8X – clrGreen ARGB with alpha=0x55 (transparency 21.6%%)",ColorToARGB(clrGreen,alpha));
  //— clrRed 色のために、ARGB への変換を導き出す
  PrintFormat("0x%.8X – clrRed",clrRed);
  PrintFormat("0x%.8X – clrRed ARGB with alpha=0x55 (transparency 21.6%%)",ColorToARGB(clrRed,alpha));
 }

string  ColorToString(
  color  color_value,    // color 値
  bool  color_name      // 色の名称を表示するかどうか
  );

  string clr=ColorToString(C'0,255,0'); // 緑
  Print(clr);
 
  clr=ColorToString(C'0,255,0',true);   // カラー定数を取得
  Print(clr);

string  DoubleToString(
  double  value,      // 数
  int    digits=8    // 小数点以下の桁数
  );

  Print("DoubleToString(120.0 + M_PI) : ",DoubleToString(120.0+M_PI));
  Print("DoubleToString(120.0 + M_PI,16) : ",DoubleToString(120.0+M_PI,16));
  Print("DoubleToString(120.0 + M_PI,-16) : ",DoubleToString(120.0+M_PI,-16));
  Print("DoubleToString(120.0 + M_PI,-1) : ",DoubleToString(120.0+M_PI,-1));
  Print("DoubleToString(120.0 + M_PI,-20) : ",DoubleToString(120.0+M_PI,-20));

string  EnumToString(
  any_enum  value      // 任意型の列挙値
  );

enum interval // 名前付き定数の列挙
 {
  month=1,     // 1 ヶ月の間隔
  two_months, // 2 ヶ月
  quarter,     // 3 ヶ月（四半期）
  halfyear=6, // 半年
  year=12,     // 1 年（ 12ヶ月）
 };
//+——————————————————————+
//| スクリプトプログラムを開始する関数                                          |
//+——————————————————————+
void OnStart()
 {
//— 時間間隔を 1 ヶ月に設定する
  interval period=month;
  Print(EnumToString(period)+"="+IntegerToString(period));
 
//— 時間間隔を四半期（3 ヶ月）に設定する
  period=quarter;
  Print(EnumToString(period)+"="+IntegerToString(period));
 
//— 時間間隔を 1 年（12ヶ月）に設定する
  period=year;
  Print(EnumToString(period)+"="+IntegerToString(period));
 
//— 注文の種類の表示をチェックする
  ENUM_ORDER_TYPE type=ORDER_TYPE_BUY;
  Print(EnumToString(type)+"="+IntegerToString(type));
 
//— 不正な値の表示をチェックする
  type=WRONG_VALUE;
  Print(EnumToString(type)+"="+IntegerToString(type));
 
// 結果：
// month=1
// quarter=3
// year=12
// ORDER_TYPE_BUY=0
// ENUM_ORDER_TYPE::-1=-1
 }

string  IntegerToString(
  long    number,              // 数
  int    str_len=0,          // 結果の文字列の長さ
  ushort  fill_symbol=' '      // フィラー
  );

string  ShortToString(
  ushort  symbol_code      // シンボル
  );

string  ShortArrayToString(
  ushort  array[],      // 配列
  int    start=0,      // 配列でのコピー開始位置
  int    count=-1      // シンボル
  );

string  TimeToString(
  datetime  value,                          // 数
  int      mode=TIME_DATE|TIME_MINUTES      // 出力フォーマット
  );

double  NormalizeDouble(
  double  value,      // 正規化数
  int    digits      // 小数点以下の桁数
  );

  double a=76.671;             // 小数点以下3桁の正規化数
  Print("Print(76.671)=",a);   // そのまま出力
  Print("DoubleToString(a,8)=",DoubleToString(a,8)); // 事前定義された精度で出力

 DoubleToString(a,8)=76.67100000

 Print(76.671)=76.67100000000001

  double pi=M_PI;
  Print("pi = ",DoubleToString(pi,16));
     
  double pi_3=NormalizeDouble(M_PI,3);
  Print("NormalizeDouble(pi,3) = ",DoubleToString(pi_3,16))
  ;
  double pi_8=NormalizeDouble(M_PI,8);
  Print("NormalizeDouble(pi,8) = ",DoubleToString(pi_8,16));
 
  double pi_0=NormalizeDouble(M_PI,0);
  Print("NormalizeDouble(pi,0) = ",DoubleToString(pi_0,16));
/*
  結果:
  pi= 3.1415926535897931
  NormalizeDouble(pi,3)= 3.1419999999999999
  NormalizeDouble(pi,8)= 3.1415926499999998
  NormalizeDouble(pi,0)= 3.0000000000000000
*/

int  StringToCharArray(
  string  text_string,        // ソースの文字列
  uchar& array[],            // 配列
  int    start=0,            // 配列でのコピー開始位置
  int    count=-1            // シンボル数
  uint    codepage=CP_ACP      // コードページ
  );

color  StringToColor(
  string  color_string      // 色の文字列表現
  );

  color str_color=StringToColor("0,127,0");
  Print(str_color);
  Print((string)str_color);
//— 色を少し変更する
  str_color=StringToColor("0,128,0");
  Print(str_color);
  Print((string)str_color);

double  StringToDouble(
  string  value      // 文字列
  );

long  StringToInteger(
  string  value      // 文字列
  );

int  StringToShortArray(
  string  text_string,    // ソース文字列
  ushort& array[],        // 配列
  int    start=0,        // 配列でのコピー開始位置
  int    count=-1        // シンボル数
  );

datetime  StringToTime(
  const string  time_string      // 日付の文字列
  );

string  StringFormat(
  string  format,    // フォーマット記述した文字列
  …    …        // パラメータ
  );

void OnStart()
{
//– 文字列変数
  string output_string;
  string temp_string;
  string format_string;
//— ヘッダを準備
  temp_string=StringFormat("Contract specification for %s:n",_Symbol);
  StringAdd(output_string,temp_string);
//— int 値の出力
  int digits=(int)SymbolInfoInteger(_Symbol,SYMBOL_DIGITS);
  temp_string=StringFormat("   SYMBOL_DIGITS = %d (number of digits after the decimal point)n",
                          digits);
  StringAdd(output_string,temp_string);
//— double 値の出力(小数点以下の桁数は変動）
  double point_value=SymbolInfoDouble(_Symbol,SYMBOL_POINT);
  format_string=StringFormat("   SYMBOL_POINT = %%.%df (point value)n",
                            digits);
  temp_string=StringFormat(format_string,point_value);
  StringAdd(output_string,temp_string);
//— int value output
  int spread=(int)SymbolInfoInteger(_Symbol,SYMBOL_SPREAD);
  temp_string=StringFormat("   SYMBOL_SPREAD = %d (current spread in points)n",
                          spread);
  StringAdd(output_string,temp_string);
//— int 値の出力
  int min_stop=(int)SymbolInfoInteger(_Symbol,SYMBOL_TRADE_STOPS_LEVEL);
  temp_string=StringFormat("   SYMBOL_TRADE_STOPS_LEVEL = %d (minimal indention in points for Stop orders)n",
                          min_stop);
  StringAdd(output_string,temp_string);
//— double （分数部なし）
  double contract_size=SymbolInfoDouble(_Symbol,SYMBOL_TRADE_CONTRACT_SIZE);
  temp_string=StringFormat("   SYMBOL_TRADE_CONTRACT_SIZE = %.f (contract size)n",
                          contract_size);
  StringAdd(output_string,temp_string);
//— デフォルト精度での double 値の出力
  double tick_size=SymbolInfoDouble(_Symbol,SYMBOL_TRADE_TICK_SIZE);
  temp_string=StringFormat("   SYMBOL_TRADE_TICK_SIZE = %f (minimal price change)n",
                          tick_size);
  StringAdd(output_string,temp_string);
//— スワップ計算モードの決定
  int swap_mode=(int)SymbolInfoInteger(_Symbol,SYMBOL_SWAP_MODE);
  string str_swap_mode;
  switch(swap_mode)
    {
    case SYMBOL_SWAP_MODE_DISABLED: str_swap_mode="SYMBOL_SWAP_MODE_DISABLED (no swaps)"; break;
    case SYMBOL_SWAP_MODE_POINTS: str_swap_mode="SYMBOL_SWAP_MODE_POINTS (in points)"; break;
    case SYMBOL_SWAP_MODE_CURRENCY_SYMBOL: str_swap_mode="SYMBOL_SWAP_MODE_CURRENCY_SYMBOL (in money, in base currency of the symbol)"; break;
    case SYMBOL_SWAP_MODE_CURRENCY_MARGIN: str_swap_mode="SYMBOL_SWAP_MODE_CURRENCY_MARGIN (in money, in margin currency of the symbol)"; break;
    case SYMBOL_SWAP_MODE_CURRENCY_DEPOSIT: str_swap_mode="SYMBOL_SWAP_MODE_CURRENCY_DEPOSIT (in money, in client deposit currency)"; break;
    case SYMBOL_SWAP_MODE_INTEREST_CURRENT: str_swap_mode="SYMBOL_SWAP_MODE_INTEREST_CURRENT (as the specified annual interest from the instrument price at calculation of swap)"; break;
    case SYMBOL_SWAP_MODE_INTEREST_OPEN: str_swap_mode="SYMBOL_SWAP_MODE_INTEREST_OPEN (as the specified annual interest from the position open price)"; break;
    case SYMBOL_SWAP_MODE_REOPEN_CURRENT: str_swap_mode="SYMBOL_SWAP_MODE_REOPEN_CURRENT (by reopening positions by the close price +/- specified number of points)"; break;
    case SYMBOL_SWAP_MODE_REOPEN_BID: str_swap_mode="SYMBOL_SWAP_MODE_REOPEN_BID (by reopening positions by the current Bid price +/- specified number of points)"; break;
    }
//— 文字列値の出力
  temp_string=StringFormat("   SYMBOL_SWAP_MODE = %sn",
                          str_swap_mode);
  StringAdd(output_string,temp_string);
//— デフォルト精度でのdouble 値の出力
  double swap_long=SymbolInfoDouble(_Symbol,SYMBOL_SWAP_LONG);
  temp_string=StringFormat("   SYMBOL_SWAP_LONG = %f (long swap value)n",
                          swap_long);
  StringAdd(output_string,temp_string);
//— デフォルト精度でのdouble 値の出力
  double swap_short=SymbolInfoDouble(_Symbol,SYMBOL_SWAP_SHORT);
  temp_string=StringFormat("   SYMBOL_SWAP_SHORT = %f (short swap value)n",
                          swap_short);
  StringAdd(output_string,temp_string);
//— 取引モードの決定
  int trade_mode=(int)SymbolInfoInteger(_Symbol,SYMBOL_TRADE_MODE);
  string str_trade_mode;
  switch(trade_mode)
    {
    case SYMBOL_TRADE_MODE_DISABLED: str_trade_mode="SYMBOL_TRADE_MODE_DISABLED (trade is disabled for the symbol)"; break;
    case SYMBOL_TRADE_MODE_LONGONLY: str_trade_mode="SYMBOL_TRADE_MODE_LONGONLY (only long positions are allowed)"; break;
    case SYMBOL_TRADE_MODE_SHORTONLY: str_trade_mode="SYMBOL_TRADE_MODE_SHORTONLY (only short positions are allowed)"; break;
    case SYMBOL_TRADE_MODE_CLOSEONLY: str_trade_mode="SYMBOL_TRADE_MODE_CLOSEONLY (only position close operations are allowed)"; break;
    case SYMBOL_TRADE_MODE_FULL: str_trade_mode="SYMBOL_TRADE_MODE_FULL (no trade restrictions)"; break;
    }
//— 文字列値の出力
  temp_string=StringFormat("   SYMBOL_TRADE_MODE = %sn",
                          str_trade_mode);
  StringAdd(output_string,temp_string);
//— コンパクトな形式での double 値の出力
  double volume_min=SymbolInfoDouble(_Symbol,SYMBOL_VOLUME_MIN);
  temp_string=StringFormat("   SYMBOL_VOLUME_MIN = %g (minimal volume for a deal)n",volume_min);
  StringAdd(output_string,temp_string);
//— コンパクトな形式での double 値の出力
  double volume_step=SymbolInfoDouble(_Symbol,SYMBOL_VOLUME_STEP);
  temp_string=StringFormat("   SYMBOL_VOLUME_STEP = %g (minimal volume change step)n",volume_step);
  StringAdd(output_string,temp_string);
//— コンパクトな形式での double 値の出力
  double volume_max=SymbolInfoDouble(_Symbol,SYMBOL_VOLUME_MAX);
  temp_string=StringFormat("   SYMBOL_VOLUME_MAX = %g (maximal volume for a deal)n",volume_max);
  StringAdd(output_string,temp_string);
//— 契約金計算モードの決定
  int calc_mode=(int)SymbolInfoInteger(_Symbol,SYMBOL_TRADE_CALC_MODE);
  string str_calc_mode;
  switch(calc_mode)
    {
    case SYMBOL_CALC_MODE_FOREX:str_calc_mode="SYMBOL_CALC_MODE_FOREX (Forex)";break;
    case SYMBOL_CALC_MODE_FUTURES:str_calc_mode="SYMBOL_CALC_MODE_FUTURES (futures)";break;
    case SYMBOL_CALC_MODE_CFD:str_calc_mode="SYMBOL_CALC_MODE_CFD (CFD)";break;
    case SYMBOL_CALC_MODE_CFDINDEX:str_calc_mode="SYMBOL_CALC_MODE_CFDINDEX (CFD for indices)";break;
    case SYMBOL_CALC_MODE_CFDLEVERAGE:str_calc_mode="SYMBOL_CALC_MODE_CFDLEVERAGE (CFD at leverage trading)";break;
    case SYMBOL_CALC_MODE_EXCH_STOCKS:str_calc_mode="SYMBOL_CALC_MODE_EXCH_STOCKS (trading securities on a stock exchange)";break;
    case SYMBOL_CALC_MODE_EXCH_FUTURES:str_calc_mode="SYMBOL_CALC_MODE_EXCH_FUTURES (trading futures contracts on a stock exchange)";break;
    case SYMBOL_CALC_MODE_EXCH_FUTURES_FORTS:str_calc_mode="SYMBOL_CALC_MODE_EXCH_FUTURES_FORTS (trading futures contracts on FORTS)";break;
    }
//— 文字列値の出力
  temp_string=StringFormat("   SYMBOL_TRADE_CALC_MODE = %sn",
                          str_calc_mode);
  StringAdd(output_string,temp_string);
//— 小数点以下の桁数が 2 桁の double 値の出力
  double margin_initial=SymbolInfoDouble(_Symbol,SYMBOL_MARGIN_INITIAL);
  temp_string=StringFormat("   SYMBOL_MARGIN_INITIAL = %.2f (initial margin)n",
                          margin_initial);
  StringAdd(output_string,temp_string);
//— 小数点以下の桁数が 2 桁の double 値の出力
  double margin_maintenance=SymbolInfoDouble(_Symbol,SYMBOL_MARGIN_MAINTENANCE);
  temp_string=StringFormat("   SYMBOL_MARGIN_MAINTENANCE = %.2f (maintenance margin)n",
                          margin_maintenance);
  StringAdd(output_string,temp_string);
//— int 値の出力
  int freeze_level=(int)SymbolInfoInteger(_Symbol,SYMBOL_TRADE_FREEZE_LEVEL);
  temp_string=StringFormat("   SYMBOL_TRADE_FREEZE_LEVEL = %d (order freeze level in points)",
                          freeze_level);
  StringAdd(output_string,temp_string);
  Print(output_string);
  Comment(output_string);
/* execution result
  Contract specification for EURUSD:
    SYMBOL_DIGITS = 5 (number of digits after the decimal point)
    SYMBOL_POINT = 0.00001 (point value)
    SYMBOL_SPREAD = 10 (current spread in points)
    SYMBOL_TRADE_STOPS_LEVEL = 18 (minimal indention in points for Stop orders)
    SYMBOL_TRADE_CONTRACT_SIZE = 100000 (contract size)
    SYMBOL_TRADE_TICK_SIZE = 0.000010 (minimal price change)
    SYMBOL_SWAP_MODE = SYMBOL_SWAP_MODE_POINTS (in points)
    SYMBOL_SWAP_LONG = -0.700000 (buy order swap value)
    SYMBOL_SWAP_SHORT = -1.000000 (sell order swap value)
    SYMBOL_TRADE_MODE = SYMBOL_TRADE_MODE_FULL (no trade restrictions)
    SYMBOL_VOLUME_MIN = 0.01 (minimal volume for a deal)
    SYMBOL_VOLUME_STEP = 0.01 (minimal volume change step)
    SYMBOL_VOLUME_MAX = 500 (maximal volume for a deal)
    SYMBOL_TRADE_CALC_MODE = SYMBOL_CALC_MODE_FOREX (Forex)
    SYMBOL_MARGIN_INITIAL = 0.00 (initial margin)
    SYMBOL_MARGIN_MAINTENANCE = 0.00 (maintenance margin)
    SYMBOL_TRADE_FREEZE_LEVEL = 0 (order freeze level in points)
*/
}