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.