---
# System prepended metadata

title: 十、 C++ 函數庫
tags: [行情API技術文件]

---

# 十、 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技術文件`