# 十、 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](/3jSr3fihTyCjq2eTkUKUcw#9132-mdca_connection_start-%E6%96%B9%E6%B3%95)，除 Handle 外。 --- #### 10.2.2.2 Close 方法 要求關閉回收連線 細節請參 [mdca_connection_close](/3jSr3fihTyCjq2eTkUKUcw#9133-mdca_connection_close-%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.2.3 行情快照訂閱 --- #### 10.2.3.1 QuotationSubscribe 方法 訂閱即時行情 細節請參 [mdca_quotation_subscribe](/3jSr3fihTyCjq2eTkUKUcw#9161-mdca_quotation_subscribe-%E6%96%B9%E6%B3%95)，除 Handle 外。 --- #### 10.2.3.2 QuotationUnsubscribe 方法 解訂閱即時行情 細節請參 [mdca_quotation_unsubscribe](/3jSr3fihTyCjq2eTkUKUcw#9162-mdca_quotation_unsubscribe-%E6%96%B9%E6%B3%95)，除 Handle 外。 --- #### 10.2.3.3 QuotationRequest 方法 行情快照查詢 細節請參 [mdca_quotation_request](/3jSr3fihTyCjq2eTkUKUcw#9163-mdca_quotation_request-%E6%96%B9%E6%B3%95)，除 Handle 外。 ### 10.2.4 即時與歷史查詢 --- #### 10.2.4.1 HistoryRequest 方法 歷史資料查詢訂閱 細節請參 [mdca_history_request](/3jSr3fihTyCjq2eTkUKUcw#9171-mdca_history_request-%E6%96%B9%E6%B3%95)，除 Handle 外。 --- #### 10.2.4.2 HistoryUnsubscribe 方法 取消歷史資料訂閱 細節請參 [mdca_history_unsubscribe](/3jSr3fihTyCjq2eTkUKUcw#9172-mdca_history_unsubscribe-%E6%96%B9%E6%B3%95)，除 Handle 外。 ## 10.3 MdcSessionSpi 事件介面 ### 10.3.1 OnConnectionState 函數 連線狀態事件 細節請參 [mdca_listener::connection_state](/3jSr3fihTyCjq2eTkUKUcw#9211-connection_state-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.2 OnQuotationChange 函數 初始化快照資料 及 即時行情變動 事件 細節請參 [mdca_listener::quotation_change](/3jSr3fihTyCjq2eTkUKUcw#9212-quotation_change-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.3 OnHistoryResponse 函數 歷史資料查詢訂閱回應 細節請參 [mdca_listener::history_response](/3jSr3fihTyCjq2eTkUKUcw#9213-history_response-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.4 OnQuotationResponse 函數 快照行情查詢回傳事件 細節請參 [mdca_listener::quotation_response](/3jSr3fihTyCjq2eTkUKUcw#9214-quotation_response-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.5 OnCommodityResponse 函數 商品資料查詢回傳事件 細節請參 [mdca_listener::commodity_response](/3jSr3fihTyCjq2eTkUKUcw#9215-commodity_response-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.6 OnCommodityChange 函數 商品資訊變動回傳事件 細節請參 [mdca_listener::commodity_change](/3jSr3fihTyCjq2eTkUKUcw#9216-commodity_change-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 --- ### 10.3.7 OnContinuousChange 函數 連續月資訊變動回傳事件 細節請參 [mdca_listener::continuous_change](/3jSr3fihTyCjq2eTkUKUcw#9217-continuous_change-%E4%BA%8B%E4%BB%B6%E6%96%B9%E6%B3%95)，除 Handle 外。 ## 10.4 MdcToolkitApi 工具函式物件 ### 10.4.1 價格處理函式 --- #### 10.4.1.1 PriceString 方法 價格轉換字串 細節請參 [mdca_price_string](/3jSr3fihTyCjq2eTkUKUcw#9181-mdca_price_string-%E6%96%B9%E6%B3%95)。 --- #### 10.4.1.2 StringPrice 方法 字串轉換為價格 細節請參 [mdca_string_price](/3jSr3fihTyCjq2eTkUKUcw#9182-mdca_string_price-%E6%96%B9%E6%B3%95)。 --- #### 10.4.1.3 PricescaleOffset 方法 價格檔位偏移工具 細節請參 [mdca_pricescale_offset](/3jSr3fihTyCjq2eTkUKUcw#9183-mdca_pricescale_offset-%E6%96%B9%E6%B3%95)。 --- #### 10.4.1.4 PricescaleValues 方法 展開價格檔位至價格陣列 細節請參 [mdca_pricescale_values](/3jSr3fihTyCjq2eTkUKUcw#9184-mdca_pricescale_values-%E6%96%B9%E6%B3%95)。 --- #### 10.4.1.5 PricescaleStrings 方法 展開價格檔位至字串串列 細節請參 [mdca_pricescale_strings](/3jSr3fihTyCjq2eTkUKUcw#9185-mdca_pricescale_strings-%E6%96%B9%E6%B3%95)。 --- #### 10.4.1.6 PricescaleDetail 方法 取出價格資訊 細節請參 [mdca_pricescale_detail](/3jSr3fihTyCjq2eTkUKUcw#9186-mdca_pricescale_detail-%E6%96%B9%E6%B3%95)。 --- ### 10.4.2 共用函式 #### 10.4.2.1 Free 方法 釋放 MDC 中建立回傳的資源指標 細節請參 [mdca_free](/3jSr3fihTyCjq2eTkUKUcw#9191-mdca_free-%E6%96%B9%E6%B3%95)。 --- ## 10.5 MdcCommonApi 通用資訊物件 ### 10.5.1 Version 方法 函數庫相容版本號 細節請參 [mdca_version](/3jSr3fihTyCjq2eTkUKUcw#9111-mdca_version-%E6%96%B9%E6%B3%95)。 --- ### 10.5.2 FileVersion 方法 函數庫相容版本號 細節請參 [mdca_file_version](/3jSr3fihTyCjq2eTkUKUcw#9112-mdca_file_version-%E6%96%B9%E6%B3%95)。 --- ### 10.5.3 LogFile 方法 設定 Log 檔案路徑及檔名 細節請參 [mdca_log_file]()。 --- ###### tags: `行情API技術文件`