For the complete documentation index, see llms.txt. This page is also available as Markdown.

解析函数列表

探索自定义解析器支持的完整函数列表:正则表达式、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 表达式匹配的字符串。返回指定的匹配组(默认为 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

  • 描述:返回数组中所有值的乘积。

  • 参数:不适用

  • 有效输入类型:

    • [浮点数]

    • [整数]

  • 预期输出类型:

    • 浮点数

    • 整数

最后更新于

这有帮助吗?