解析函数列表
探索自定义解析器支持的完整函数列表:正则表达式、XPath、CSS 等。
你可以在以下页面找到每个函数的使用示例 解析函数示例 页面。
如何传递参数
每个函数通过以下方式接收其设置: _args。使用两种形式,且二者不可互换:
数组 - 方括号中的一个或多个值
xpath, xpath_one, css, css_one, regex_find_all, regex_search, regex_substring
"_args": ["//h4/text()"]
单个值 - 不使用方括号
join, select_nth
"_args": 0 · "_args": " "
对于选择器和 RegEx 函数,数组还允许列出回退表达式:当前一个未找到结果时,会尝试下一个。没有设置的函数(element_text, amount_from_string, length, max,…)不需要 _args 任何设置。
使用错误的形式不会导致任务失败:字段会返回 null, parse_status_code 是 12005,且 _warnings 包含 接收到的参数类型无效 数组 (或 字符串).
HTML 处理
element_text
名称:
element_text描述:从
html中提取文本。去除前导和尾随空白字符。参数:不适用
有效输入类型:
html预期输出类型:
字符串
xpath
名称:
xpath描述:在给定输入值上执行 XPath 表达式。如果执行未产生结果,则使用数组中的下一个表达式。表达式中可以使用 XSLT 函数。支持 XPath 1.0 版本。支持 XSLT 1.0 版本。
参数:
xpath_expressions类型:
[字符串]必需:
true
有效输入类型:
html
预期输出类型:
[字符串][HTML]字符串浮点数布尔值
xpath_one
名称:
xpath_one描述:与
xpath相同,但即使提供的 XPath 选中了多个值,也只返回第一个值。参数:
xpath_expressions类型:
[字符串]必需:
true
有效输入类型:
html
预期输出类型:
字符串html字符串浮点数布尔值
css
名称:
css描述:在给定输入值上执行 CSS 表达式。如果执行未产生结果,则使用数组中的下一个表达式。 请注意,
css函数的输出始终是一个包含 HTML 元素(包括开始和结束标签)的 JSON 数组。如果你想提取该元素的内容,可以随后执行element_text该函数。参数:
css_expressions类型:
[字符串]必需:
true
有效输入类型:
html
预期输出类型:
[HTML 元素]
css_one
名称:
css_one描述:与
css,但即使提供的 CSS 表达式选中了多个值,也只返回第一个值。 请注意,css_one函数的输出始终是一个 HTML 元素(包括开始和结束标签)。如果你想提取该元素的内容,可以随后执行element_text该函数。参数:
css_expressions类型:
[字符串]必需:
true
有效输入类型:
html
预期输出类型:
html_element
字符串处理
amount_from_string
名称:
amount_from_string描述:在字符串中查找第一个数值并将其转换为浮点数。
参数:不适用
有效输入类型:
字符串
预期输出类型:
浮点数
amount_range_from_string
名称:
amount_range_from_string描述:查找字符串中所有数值并将其转换为浮点数。
参数:不适用
有效输入类型:
字符串
预期输出类型:
[浮点数]
join
名称:
join描述:将字符串列表合并为一个字符串。合并后的值由
separator值分隔。参数:
separator类型:
字符串必需:
false默认值:
""
有效输入类型:
[字符串]
预期输出类型:
字符串
regex_find_all
名称:
regex_find_all描述:查找所有匹配给定 RegEx 表达式的字符串。
参数:
regex_pattern类型:
字符串必需:
true
有效输入类型:
字符串
预期输出类型:
[字符串]
regex_search
名称:
regex_search描述:查找与给定 RegEx 表达式匹配的字符串。返回指定的匹配组(默认为
0).参数:
regex_pattern类型:
字符串必需:
true
group_to_return类型:
整数必需:
false默认值:
0
有效输入类型:
字符串
预期输出类型:
字符串
regex_substring
名称:
regex_substring描述:将输入字符串中所有匹配给定 RegEx 表达式的部分替换为
replacement值。\\1)支持在替换内容中使用回溯引用;空替换会删除匹配项。参数:
regex_pattern类型:
字符串必需:
true
replacement类型:
字符串必需:
true
有效输入类型:
字符串
预期输出类型:
字符串
通用
length
名称:
length描述:获取数组长度。如果输入的是多维数组,函数将作用于最内层数组。
参数:不适用
有效输入类型:
[一维数组]
预期输出类型:
整数
select_nth
名称:
select_nth描述:返回数组的第 n 个元素。索引从 0 开始。支持负索引以选择最后一个(
-1)、倒数第二个(-2)项,…参数:
索引类型:
整数必需:
true
有效输入类型:
[任意类型]
预期输出类型:
任意类型
convert_to_float
名称:
convert_to_float描述:将字符串或整数转换为浮点数。
参数:不适用
有效输入类型:
字符串整数
预期输出类型:
浮点数
convert_to_int
名称:
convert_to_int描述:将字符串或浮点数转换为整数。
参数:不适用
有效输入类型:
字符串浮点数
预期输出类型:
整数
convert_to_str
名称:
convert_to_str描述:将整数或浮点数转换为字符串。
参数:不适用
有效输入类型:
整数浮点数
预期输出类型:
字符串
数学
average
名称:
average描述:计算数组中各值的平均值。
参数:
round_precision类型:
整数必需:
false
有效输入类型:
[整数][浮点数]
预期输出类型:
浮点数
max
名称:
max描述:查找数组中的最大值。
参数:不适用
有效输入类型:
[浮点数][整数]
预期输出类型:
浮点数整数
min
名称:
min描述:查找数组中的最小值。
参数:不适用
有效输入类型:
[浮点数][整数]
预期输出类型:
浮点数整数
product
名称:
product描述:返回数组中所有值的乘积。
参数:不适用
有效输入类型:
[浮点数][整数]
预期输出类型:
浮点数整数
最后更新于
这有帮助吗?