Lista de funções de parsing

Descubra a lista completa de funções suportadas pelo Custom Parser: regex, XPath, CSS e mais.

Você pode encontrar exemplos de uso de cada função em Exemplos de funções de parsing página.

Processamento de HTML

element_text

• Nome: element_text

• Descrição: Extrai texto de html. Remove espaços em branco no início e no fim.

• Args: n/a

• Tipos de entrada válidos: html

• Tipos de saída esperados: str

xpath

• Nome: xpath

• Descrição: Executa uma expressão XPath no valor de entrada fornecido. Se a execução não produzir um resultado, a expressão seguinte no array é usada. Funções XSLT podem ser usadas nas expressões. XPath versão 1.0 é suportado. XSLT versão 1.0 é suportado.

• Args:

  • xpath_expressions

    • Tipo: [str]

    • Obrigatório: true

• Tipos de entrada válidos:

  • html

• Tipos de saída esperados:

  • [str]

  • [html]

  • str

  • float

  • bool

xpath_one

• Nome: xpath_one

• Descrição: Funciona da mesma forma que xpath, mas retorna apenas o primeiro valor mesmo que mais de um valor seja selecionado pelo XPath fornecido.

• Args:

  • xpath_expressions

    • Tipo: [str]

    • Obrigatório: true

• Tipos de entrada válidos:

  • html

• Tipos de saída esperados:

  • str

  • html

  • str

  • float

  • bool

css

• Nome: css

• Descrição: Executa uma expressão CSS no valor de entrada fornecido. Se a execução não produzir um resultado, a expressão seguinte no array é usada. Por favor, note que a saída da css função sempre é um array JSON contendo elementos HTML (incluindo tags de abertura e fechamento). Se você estiver interessado em extrair o conteúdo do elemento, você pode executar a element_text função depois.

• Args:

  • css_expressions

    • Tipo: [str]

    • Obrigatório: true

• Tipos de entrada válidos:

  • html

• Tipos de saída esperados:

  • [html_element]

css_one

• Nome: css_one

• Descrição: Funciona da mesma forma que css, mas retorna apenas o primeiro valor mesmo que mais de um valor seja selecionado pela expressão CSS fornecida. Por favor, note que a saída da css_one função sempre é um elemento HTML (incluindo tags de abertura e fechamento). Se você estiver interessado em extrair o conteúdo do elemento, você pode executar a element_text função depois.

• Args:

  • css_expressions

    • Tipo: [str]

    • Obrigatório: true

• Tipos de entrada válidos:

  • html

• Tipos de saída esperados:

  • html_element

Manipulação de strings

amount_from_string

• Nome: amount_from_string

• Descrição: Encontra a primeira ocorrência de um valor numérico em uma string e o converte para float.

• Args: n/a

• Tipos de entrada válidos:

  • str

• Tipos de saída esperados:

  • float

amount_range_from_string

• Nome: amount_range_from_string

• Descrição: Encontra todas as ocorrências de valores numéricos em uma string e as converte para floats.

• Args: n/a

• Tipos de entrada válidos:

  • str

• Tipos de saída esperados:

  • [float]

join

• Nome: join

• Descrição: Junta uma lista de strings em uma única string. Os valores unidos são separados pelo separator valor.

• Args:

  • separator

    • Tipo: str

    • Obrigatório: false

    • Padrão: ""

• Tipos de entrada válidos:

  • [str]

• Tipos de saída esperados:

  • str

regex_find_all

• Nome: regex_find_all

• Descrição: Encontra todas as strings que casam com uma expressão RegEx dada.

• Args:

  • regex_pattern

    • Tipo: str

    • Obrigatório: true

• Tipos de entrada válidos:

  • str

• Tipos de saída esperados:

  • [str]

regex_search

• Nome: regex_search

• Descrição: Encontra uma string que corresponda à expressão RegEx fornecida. Retorna o grupo correspondente especificado (padrão é 0).

• Args:

  • regex_pattern

    • Tipo: str

    • Obrigatório: true

  • group_to_return

    • Tipo: int

    • Obrigatório: false

    • Padrão: 0

• Tipos de entrada válidos:

  • str

• Tipos de saída esperados:

  • str

regex_substring

• Nome: regex_substring

• Descrição: Encontra uma string que corresponda à expressão RegEx fornecida. Retorna o grupo correspondente especificado (padrão é 0).

• Args:

  • regex_pattern

    • Tipo: str

    • Obrigatório: true

  • group_to_return

    • Tipo: int

    • Obrigatório: false

    • Padrão: 0

• Tipos de entrada válidos:

  • str

• Tipos de saída esperados:

  • str

Comum

length

• Nome: length

• Descrição: Obtém o comprimento do array. Se um array multidimensional for fornecido como entrada, a função operará no array mais interno.

• Args: n/a

• Tipos de entrada válidos:

  • [OneDimensionalArray]

• Tipos de saída esperados:

  • int

select_nth

• Nome: select_nth

• Descrição: Retorna o enésimo elemento do array. Indexação baseada em zero é usada. Suporta índices negativos para selecionar o último (-1), penúltimo (-2), … item de um array.

• Args:

  • index

    • Tipo: int

    • Obrigatório: true

• Tipos de entrada válidos:

  • [AnyType]

• Tipos de saída esperados:

  • AnyType

convert_to_float

• Nome: convert_to_float

• Descrição: Converte uma string ou um int para float.

• Args: n/a

• Tipos de entrada válidos:

  • str

  • int

• Tipos de saída esperados:

  • float

convert_to_int

• Nome: convert_to_int

• Descrição: Converte uma string ou um float para int.

• Args: n/a

• Tipos de entrada válidos:

  • str

  • float

• Tipos de saída esperados:

  • int

convert_to_str

• Nome: convert_to_str

• Descrição: Converte um int ou um float para string.

• Args: n/a

• Tipos de entrada válidos:

  • int

  • float

• Tipos de saída esperados:

  • string

Matemática

average

• Nome: average

• Descrição: Calcula a média dos valores em um array.

• Args:

  • round_precision

    • Tipo: int

    • Obrigatório: false

• Tipos de entrada válidos:

  • [int]

  • [float]

• Tipos de saída esperados:

  • float

max

• Nome: max

• Descrição: Encontra o maior valor em um array.

• Args: n/a

• Tipos de entrada válidos:

  • [float]

  • [int]

• Tipos de saída esperados:

  • float

  • int

min

• Nome: min

• Descrição: Encontra o menor valor em um array.

• Args: n/a

• Tipos de entrada válidos:

  • [float]

  • [int]

• Tipos de saída esperados:

  • float

  • int

product

• Nome: product

• Descrição: Retorna o produto da multiplicação de todos os valores do array.

• Args: n/a

• Tipos de entrada válidos:

  • [float]

  • [int]

• Tipos de saída esperados:

  • float

  • int