Lista de funções de análise

Descubra a lista completa de funções compatíveis com o Custom Parser: regex, XPath, CSS e muito mais.

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

Processamento de HTML

element_text

• Nome: element_text
• Descrição: Extrai texto de html. Remove os espaços em branco no início e no fim.
• Argumentos: não se aplica
• Tipos de entrada válidos: html
• Tipos de saída esperados: string

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. A versão 1.0 do XPath é suportada. A versão 1.0 do XSLT é suportada.
• Argumentos:

  • xpath_expressions

    • Tipo: [str]
    • Obrigatório: verdadeiro
• Tipos de entrada válidos:

  • html
• Tipos de saída esperados:

  • [str]
  • [html]
  • string
  • float
  • booleano

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.
• Argumentos:

  • xpath_expressions

    • Tipo: [str]
    • Obrigatório: verdadeiro
• Tipos de entrada válidos:

  • html
• Tipos de saída esperados:

  • string
  • html
  • string
  • float
  • booleano

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. Observe que a saída da css função é sempre um array JSON contendo elementos HTML (incluindo as 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.
• Argumentos:

  • css_expressions

    • Tipo: [str]
    • Obrigatório: verdadeiro
• 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. Observe que a saída da css_one função é sempre um elemento HTML (incluindo as 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.
• Argumentos:

  • css_expressions

    • Tipo: [str]
    • Obrigatório: verdadeiro
• 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.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • string
• 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 float.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • string
• Tipos de saída esperados:

  • [float]

join

• Nome: join
• Descrição: Concatena uma lista de strings em uma única string. Os valores unidos são separados pelo valor do separador valor.
• Argumentos:

  • separador

    • Tipo: string
    • Obrigatório: falso
    • Padrão: ""
• Tipos de entrada válidos:

  • [str]
• Tipos de saída esperados:

  • string

regex_find_all

• Nome: regex_find_all
• Descrição: Encontra todas as strings que correspondem a uma expressão RegEx fornecida.
• Argumentos:

  • regex_pattern

    • Tipo: string
    • Obrigatório: verdadeiro
• Tipos de entrada válidos:

  • string
• Tipos de saída esperados:

  • [str]

regex_search

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

  • regex_pattern

    • Tipo: string
    • Obrigatório: verdadeiro
  • group_to_return

    • Tipo: inteiro
    • Obrigatório: falso
    • Padrão: 0
• Tipos de entrada válidos:

  • string
• Tipos de saída esperados:

  • string

regex_substring

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

  • regex_pattern

    • Tipo: string
    • Obrigatório: verdadeiro
  • group_to_return

    • Tipo: inteiro
    • Obrigatório: falso
    • Padrão: 0
• Tipos de entrada válidos:

  • string
• Tipos de saída esperados:

  • string

Comum

length

• Nome: length
• Descrição: Obtém o tamanho do array. Se um array multidimensional for fornecido como entrada, a função operará no array mais interno.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • [OneDimensionalArray]
• Tipos de saída esperados:

  • inteiro

select_nth

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

  • index

    • Tipo: inteiro
    • Obrigatório: verdadeiro
• 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 inteiro para float.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • string
  • inteiro
• Tipos de saída esperados:

  • float

convert_to_int

• Nome: convert_to_int
• Descrição: Converte uma string ou um float para inteiro.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • string
  • float
• Tipos de saída esperados:

  • inteiro

convert_to_str

• Nome: convert_to_str
• Descrição: Converte um inteiro ou um float para string.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • inteiro
  • float
• Tipos de saída esperados:

  • texto

Matemática

média

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

  • round_precision

    • Tipo: inteiro
    • Obrigatório: falso
• Tipos de entrada válidos:

  • [inteiro]
  • [float]
• Tipos de saída esperados:

  • float

máximo

• Nome: máximo
• Descrição: Encontra o maior valor em um array.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • [float]
  • [inteiro]
• Tipos de saída esperados:

  • float
  • inteiro

mínimo

• Nome: mínimo
• Descrição: Encontra o menor valor em um array.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • [float]
  • [inteiro]
• Tipos de saída esperados:

  • float
  • inteiro

produto

• Nome: produto
• Descrição: Retorna o produto da multiplicação de todos os valores do array.
• Argumentos: não se aplica
• Tipos de entrada válidos:

  • [float]
  • [inteiro]
• Tipos de saída esperados:

  • float
  • inteiro