Show/Hide Toolbars

EmEditor 說明

EmEditor 首頁 - EmEditor 說明 - 外掛程式參考 - 內嵌函數

Editor_Join

按指定索引鍵資料欄,用一個與 JOIN 操作類似的方法合併兩個 CSV 文檔,并創建一個新文檔。您可以用該內嵌函數或直接發送 EE_JOIN 消息。

Editor_Join( HWND hwnd, UINT nFlags, LPCWSTR pszDocument1, LPCWSTR pszColumn1, LPCWSTR pszDocument2, LPCWSTR pszColumn2, LPCWSTR pszSelect, int* piDocument3 );

參數

hwnd

指定 EmEditor 視圖或方塊架的視窗句柄。

nFlags

您能指定下列值的一個組合。

JOIN_FLAG_UNIQUE_KEY_1

第一個文檔中指定的索引鍵資料欄包含一個唯一索引鍵。

JOIN_FLAG_UNIQUE_KEY_2

第二個文檔中指定的索引鍵資料欄包含一個唯一索引鍵。

JOIN_FLAG_INCLUDE_ALL_1

第一個文檔中的所有資料列都會被包括在輸出中。輸出文檔將包含空的資料格如果第一個文檔中的行沒有符合的結果。

JOIN_FLAG_INCLUDE_ALL_2

第一個文檔中的所有資料列都會被包括在輸出中。輸出文檔將包含空的資料格如果第一個文檔中的行沒有符合的結果。

JOIN_FLAG_MATCH_CASE

大小寫符合。

pszDocument1

指定字串來識別第一個文檔。這個值可以是檔案名,檔案名以及路徑,或一個冒號 (:) 后跟目前的群組中指定文檔的索引號。例如,"filename.csv","C:\data\filename.csv" (如果是 JavaScript,"C:\\data\\filename.csv"),或 ":2"。

pszColumn1

指定字串來識別第一個文檔的索引鍵資料欄。這個值可以是指定欄的第一行或一個冒號 (:) 后跟指定欄的索引號。例如,"first_name" 或 ":5"。

pszDocument2

指定字串來識別第二個文檔。這個值的格式與 pszDocument1 格式相同。

pszColumn2

指定字串來識別第二個文檔的索引鍵資料欄。這個值的格式與 pszColumn1 格式相同。

pszSelect

指定字串來選擇要包括在輸出文檔中的欄。例如,"file1.csv>column1,file2.csv>column2"。

piDocument3

這個欄位將充滿輸出文檔的索引,當函數返回時。如果這個值為 NULL,這個欄位會被忽略。

返回值

返回值是新文檔的行數。返回值為負數如果發生錯誤的話。如果發生錯誤,返回值是下列值之一:

E_DOCUMENT_1_NOT_FOUND

無法找到第一個文檔。

E_DOCUMENT_2_NOT_FOUND

無法找到第二個文檔。

E_COLUMN_1_NOT_FOUND

無法找到第一欄。

E_COLUMN_2_NOT_FOUND

無法找到第二欄。

E_SELECT_SYNTAX

選擇的字串中有語法錯誤。

E_SELECT_DOCUMENT_NOT_FOUND

無法在選擇的字串中找到指定的文檔。

E_SELECT_COLUMN_NOT_FOUND

無法在選擇的字串中找到指定欄。

E_DIFFERENT_CSV_MODE

不同的 CSV 模式。

E_NOT_MDI

必須啟用 Tab。

E_WRITE_TEMP_FILE

臨時檔案寫入錯誤。

E_ABORT

被使用者中止。

E_FAIL

未指定的錯誤。

版本

支持 EmEditor 14.8 或之后的版本。

Copyright © 2003-2016 by Emurasoft, Inc.