Join 方法 (Editor 對象)¶
按指定索引鍵資料欄,用一個與 JOIN 操作類似的方法合併兩個 CSV 文檔,并創建一個新文檔。 nFlags 您能從如下值中指定一個組合。不能組合 eeJoinSimpleMerge,eeJoinContain,eeJoinStartWith,和 eeJoinEndWith。 eeJoinUniqueKey1 第一個文檔中指定的索引鍵資料欄包含一個唯一索引鍵。 eeJoinUniqueKey2 第二個文檔中指定的索引鍵資料欄包含一個唯一索引鍵。 eeJoinIncludeAll1 第一個文檔中的所有資料列都會被包括在輸出中。輸出文檔將包含空的資料格如果第一個文檔中的行沒有符合的結果。 eeJoinIncludeAll2 第一個文檔中的所有資料列都會被包括在輸出中。輸出文檔將包含空的資料格如果第一個文檔中的行沒有符合的結果。 eeJoinMatchCase 大小寫符合。 eeJoinSimpleMerge 不比較索引鍵,直接合併兩個文檔。如果指定該選項,那么 strColumn1 和 strColumn2 的參數會被忽略。 eeJoinIgnoreHeadings1 忽略第一個文檔中的標題,讓第一個文檔中的標題能在合併后的檔案中保留。 eeJoinIgnoreHeadings2 忽略第二個文檔中的標題。 eeJoinContain Key1 包含 Key2。 eeJoinStartWith Key1 以 Key2 開始。 eeJoinEndWith Key1 以 Key2 結尾。 eeJoinMatchSplitBoth 兩個分割的字串都符合。 eeJoinMatchSplitOne Key1 符合分割的 Key2。 eeJoinFuzzy 使用模糊比對。 此旗標不能與 eeJoinEndWith、eeJoinMatchSplitBoth 或 eeJoinMatchSplitOne 結合使用。此旗標會使過程變慢。 eeJoinSwap Key1 和 Key2 互換,如果還指定了 eeJoinContain,eeJoinStatWith,eeJoinEndWith,或 eeJoinMatchSplitOne。 strDocument1 指定字串來識別第一個文檔。這個值可以是檔案名,檔案名以及路徑,或一個冒號 (:) 后跟目前的群組中指定文檔的索引號。例如,"filename.csv","C:\data\filename.csv" (如果是 JavaScript,"C:\\data\\filename.csv"),或 ":2"。 strColumn1 指定字串來識別第一個文檔的索引鍵資料欄。這個值可以是指定欄的第一行或一個冒號 (:) 后跟指定欄的索引號。例如,"first_name",":5","1-5",或 "2-"。 strDocument2 指定字串來識別第二個文檔。這個值的格式與 strDocument1 格式相同。 strColumn2 指定字串來識別第二個文檔的索引鍵資料欄。這個值的格式與 strColumn1 格式相同。 strSelect 指定字串來選擇要包括在輸出文檔中的欄。例如,"file1.csv>column1,file2.csv>column2"。 strSeperator 在分割儲存格時,將字串指定為分隔符號。除非指定 eeJoinMatchSplitBoth 或 eeJoinMatchSplitOne,否則將忽略此參數。 nLimit 指定每個儲存格的最大分割次數。如果省略或指定為 0,則該方法將不限制分割次數。除非指定 eeJoinMatchSplitBoth 或 eeJoinMatchSplitOne,否則將忽略此參數。 返回值是與指定字串符合的行數。 支持 EmEditor 14.8 或之後的版本。¶
[JavaScript]¶
n = editor.Join( nFlags, strDocument1, strColumn1, strDocument2, strColumn2, strSelect, strSeparator, nLimit );
[VBScript]¶
n = editor.Join( nFlags, strDocument1, strColumn1, strDocument2, strColumn2, strSelect, strSeparator, nLimit)
參數¶
返回值¶
版本¶