> For the complete documentation index, see [llms.txt](https://jihsunfutures.gitbook.io/mdcapi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jihsunfutures.gitbook.io/mdcapi/shi-c++-han-shu-ku.md).

# 十、 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](/mdcapi/jiuc-han-shu-ku.md#9-1-32-mdcaconnectionstart-fang-fa)，除 Handle 外。

#### 10.2.2.2 Close 方法

要求關閉回收連線\
細節請參 [mdca\_connection\_close](/mdcapi/jiuc-han-shu-ku.md#9-1-33-mdcaconnectionclose-fang-fa)，除 Handle 外。

### 10.2.3 行情快照訂閱

#### 10.2.3.1 QuotationSubscribe 方法

訂閱即時行情\
細節請參 [mdca\_quotation\_subscribe](/mdcapi/jiuc-han-shu-ku.md#9-1-61-mdcaquotationsubscribe-fang-fa)，除 Handle 外。

#### 10.2.3.2 QuotationUnsubscribe 方法

解訂閱即時行情\
細節請參 [mdca\_quotation\_unsubscribe](/mdcapi/jiuc-han-shu-ku.md#9-1-62-mdcaquotationunsubscribe-fang-fa)，除 Handle 外。

#### 10.2.3.3 QuotationRequest 方法

行情快照查詢\
細節請參 [mdca\_quotation\_request](/mdcapi/jiuc-han-shu-ku.md#9-1-63-mdcaquotationrequest-fang-fa)，除 Handle 外。

### 10.2.4 即時與歷史查詢

#### 10.2.4.1 HistoryRequest 方法

歷史資料查詢訂閱\
細節請參 [mdca\_history\_request](/mdcapi/jiuc-han-shu-ku.md#9-1-71-mdcahistoryrequest-fang-fa)，除 Handle 外。

#### 10.2.4.2 HistoryUnsubscribe 方法

取消歷史資料訂閱\
細節請參 [mdca\_history\_unsubscribe](/mdcapi/jiuc-han-shu-ku.md#9-1-72-mdcahistoryunsubscribe-fang-fa)，除 Handle 外。

## 10.3 MdcSessionSpi 事件介面

### 10.3.1 OnConnectionState 函數

連線狀態事件\
細節請參 [mdca\_listener::connection\_state](/mdcapi/jiuc-han-shu-ku.md#9-2-11-connectionstate-shi-jian-fang-fa)，除 Handle 外。

### 10.3.2 OnQuotationChange 函數

初始化快照資料 及 即時行情變動 事件\
細節請參 [mdca\_listener::quotation\_change](/mdcapi/jiuc-han-shu-ku.md#9-2-12-quotationchange-shi-jian-fang-fa)，除 Handle 外。

### 10.3.3 OnHistoryResponse 函數

歷史資料查詢訂閱回應

細節請參 [mdca\_listener::history\_response](/mdcapi/jiuc-han-shu-ku.md#9-2-13-historyresponse-shi-jian-fang-fa)，除 Handle 外。

### 10.3.4 OnQuotationResponse 函數

快照行情查詢回傳事件\
細節請參 [mdca\_listener::quotation\_response](/mdcapi/jiuc-han-shu-ku.md#9-2-14-quotationresponse-shi-jian-fang-fa)，除 Handle 外。

### 10.3.5 OnCommodityResponse 函數

商品資料查詢回傳事件\
細節請參 [mdca\_listener::commodity\_response](/mdcapi/jiuc-han-shu-ku.md#9-2-15-commodityresponse-shi-jian-fang-fa)，除 Handle 外。

### 10.3.6 OnCommodityChange 函數

商品資訊變動回傳事件\
細節請參 [mdca\_listener::commodity\_change](/mdcapi/jiuc-han-shu-ku.md#9-2-16-commoditychange-shi-jian-fang-fa)，除 Handle 外。

### 10.3.7 OnContinuousChange 函數

連續月資訊變動回傳事件\
細節請參 [mdca\_listener::continuous\_change](/mdcapi/jiuc-han-shu-ku.md#9-2-17-continuouschange-shi-jian-fang-fa)，除 Handle 外。

## 10.4 MdcToolkitApi 工具函式物件

### 10.4.1 價格處理函式

#### 10.4.1.1 PriceString 方法

價格轉換字串\
細節請參 [mdca\_price\_string](/mdcapi/jiuc-han-shu-ku.md#9-1-81-mdcapricestring-fang-fa)。

#### 10.4.1.2 StringPrice 方法

字串轉換為價格\
細節請參 [mdca\_string\_price](/mdcapi/jiuc-han-shu-ku.md#9-1-82-mdcastringprice-fang-fa)。

#### 10.4.1.3 PricescaleOffset 方法

價格檔位偏移工具\
細節請參 [mdca\_pricescale\_offset](/mdcapi/jiuc-han-shu-ku.md#9-1-83-mdcapricescaleoffset-fang-fa)。

#### 10.4.1.4 PricescaleValues 方法

展開價格檔位至價格陣列\
細節請參 [mdca\_pricescale\_values](/mdcapi/jiuc-han-shu-ku.md#9-1-84-mdcapricescalevalues-fang-fa)。

#### 10.4.1.5 PricescaleStrings 方法

展開價格檔位至字串串列\
細節請參 [mdca\_pricescale\_strings](/mdcapi/jiuc-han-shu-ku.md#9-1-85-mdcapricescalestrings-fang-fa)。

#### 10.4.1.6 PricescaleDetail 方法

取出價格資訊\
細節請參 [mdca\_pricescale\_detail](/mdcapi/jiuc-han-shu-ku.md#9-1-86-mdcapricescaledetail-fang-fa)。

### 10.4.2 共用函式

#### 10.4.2.1 Free 方法

釋放 MDC 中建立回傳的資源指標\
細節請參 [mdca\_free](/mdcapi/jiuc-han-shu-ku.md#9-1-91-mdcafree-fang-fa)。

## 10.5 MdcCommonApi 通用資訊物件

### 10.5.1 Version 方法

函數庫相容版本號\
細節請參 [mdca\_version](/mdcapi/jiuc-han-shu-ku.md#9-1-11-mdcaversion-fang-fa)。

### 10.5.2 FileVersion 方法

函數庫相容版本號\
細節請參 [mdca\_file\_version](/mdcapi/jiuc-han-shu-ku.md#9-1-12-mdcafileversion-fang-fa)。

### 10.5.3 LogFile 方法

設定 Log 檔案路徑及檔名\
細節請參 [mdca\_log\_file](/mdcapi/jiuc-han-shu-ku.md#9-1-91-mdcafree-fang-fa)。