十、 C++ 函數庫

10.1 域名Namespace

MdcCppApi

10.2 MdcSessionApi 連線物件

10.2.1 靜態方法

10.2.1.1 CreateSession 方法

建立連線物件

函數原型:

static MdcSessionApi* CreateSession(MdcSessionSpi *objSessionSpi, Mdct_Bool auto_reconnect, Mdct_Bool keep_subscribe);

參數: objSessionSpi: 實作事件處理實體物件指標 auto_reconnect: 自動重連 keep_subscribe: 保留訂閱資訊(自動重訂閱)

回傳: 成功，取得連線實體物件 失敗，NULL 已達連線上限，或是系統資源不足以建立。

10.2.1.2 ReleaseSession 方法

釋放連線物件

函數原型:

static void ReleaseSession(MdcSessionApi *objSession);

參數: objSession: 由 CreateSession 建立的連線實體物件指標

特別說明: 這個行為若在連線尚存時，會中斷並回收連線

10.2.1.3 Terminal 方法

釋放 Api 所有資源, 包含連線中物件

函數原型:

static void Terminal();

備註: 因為函數庫自體管理執行緒運作，因此在呼叫此方法時，會完全回收資源後，才會退出，此時你方可安心結束程式。

特別說明: 資源回收，包含背景緒處理的中止，因此本方法會阻斷線目前程直至回收完畢。

10.2.2 連線資訊

10.2.2.1 Start 方法

要求物件開始連線登入程序 細節請參 mdca_connection_start，除 Handle 外。

10.2.2.2 Close 方法

要求關閉回收連線 細節請參 mdca_connection_close，除 Handle 外。

10.2.3 行情快照訂閱

10.2.3.1 QuotationSubscribe 方法

訂閱即時行情 細節請參 mdca_quotation_subscribe，除 Handle 外。

10.2.3.2 QuotationUnsubscribe 方法

解訂閱即時行情 細節請參 mdca_quotation_unsubscribe，除 Handle 外。

10.2.3.3 QuotationRequest 方法

行情快照查詢 細節請參 mdca_quotation_request，除 Handle 外。

10.2.4 即時與歷史查詢

10.2.4.1 HistoryRequest 方法

歷史資料查詢訂閱 細節請參 mdca_history_request，除 Handle 外。

10.2.4.2 HistoryUnsubscribe 方法

取消歷史資料訂閱 細節請參 mdca_history_unsubscribe，除 Handle 外。

10.3 MdcSessionSpi 事件介面

10.3.1 OnConnectionState 函數

連線狀態事件 細節請參 mdca_listener::connection_state，除 Handle 外。

10.3.2 OnQuotationChange 函數

初始化快照資料 及 即時行情變動 事件 細節請參 mdca_listener::quotation_change，除 Handle 外。

10.3.3 OnHistoryResponse 函數

歷史資料查詢訂閱回應

細節請參 mdca_listener::history_response，除 Handle 外。

10.3.4 OnQuotationResponse 函數

快照行情查詢回傳事件 細節請參 mdca_listener::quotation_response，除 Handle 外。

10.3.5 OnCommodityResponse 函數

商品資料查詢回傳事件 細節請參 mdca_listener::commodity_response，除 Handle 外。

10.3.6 OnCommodityChange 函數

商品資訊變動回傳事件 細節請參 mdca_listener::commodity_change，除 Handle 外。

10.3.7 OnContinuousChange 函數

連續月資訊變動回傳事件 細節請參 mdca_listener::continuous_change，除 Handle 外。

10.4 MdcToolkitApi 工具函式物件

10.4.1 價格處理函式

10.4.1.1 PriceString 方法

價格轉換字串 細節請參 mdca_price_string。

10.4.1.2 StringPrice 方法

字串轉換為價格 細節請參 mdca_string_price。

10.4.1.3 PricescaleOffset 方法

價格檔位偏移工具 細節請參 mdca_pricescale_offset。

10.4.1.4 PricescaleValues 方法

展開價格檔位至價格陣列 細節請參 mdca_pricescale_values。

10.4.1.5 PricescaleStrings 方法

展開價格檔位至字串串列 細節請參 mdca_pricescale_strings。

10.4.1.6 PricescaleDetail 方法

取出價格資訊 細節請參 mdca_pricescale_detail。

10.4.2 共用函式

10.4.2.1 Free 方法

釋放 MDC 中建立回傳的資源指標 細節請參 mdca_free。

10.5 MdcCommonApi 通用資訊物件

10.5.1 Version 方法

函數庫相容版本號 細節請參 mdca_version。

10.5.2 FileVersion 方法

函數庫相容版本號 細節請參 mdca_file_version。

10.5.3 LogFile 方法

設定 Log 檔案路徑及檔名 細節請參 mdca_log_file。